mcpField
P
prd-creator

prd-creator

github.com/pageai-pro开发3335.1k 次安装17 周前更新
代码仓库

关于 prd-creator

面向初级开发者的技能,通过结构化提问和前置条件检查,将软件构想整理为 PRD 和实施任务清单。它还会生成项目概要,并要求敏感值仅使用占位符。

主要功能

  1. 01结构化需求提问
  2. 02前置条件与访问检查
  3. 03生成并修订 PRD
  4. 04生成 JSON 实施任务清单
  5. 05生成项目概要

适用场景

  1. 01记录初期软件构想
  2. 02将获批的 PRD 转成开发任务
  3. 03编写规格前检查项目条件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/pageai-pro/ralph-loop --skill prd-creator

安装后在 Claude Code 中输入/prd-creator确认已加载。

附带文件JSON.mdPRD.md

详细介绍

PRD 创建助手

通过两个部分的流程,将软件构想转化为完整的 PRD 和可执行的实施任务。

概述

此技能旨在帮助初级开发者。

  1. 接收用户提供的实施说明
  2. 通过结构化提问创建详细的 PRD 文档
  3. 验证实施前提条件,包括访问权限、MCP、文档、环境变量和测试用户
  4. 为开发者生成 JSON 格式的实施任务清单
  5. 编写项目的整体说明。撰写一份执行摘要,概述应用及其主要功能。
第 1 部分:实施说明

你将收到用户提供的、内容不够完整的实施说明。 主要目标是理解用户意图,并考虑更大的架构以及稳健的实施方式,补齐遗漏的信息。

第 2 部分:创建 PRD

文件:PRD.md

你需要提出澄清问题,以明确了解实施需求。

适用场景:用户希望记录软件构想或创建功能规格

功能:

  • 引导用户通过结构化提问提供所有需求
  • 在最终确定 PRD 前验证项目的前提条件
  • 使用占位值创建或更新 .env.local
  • 创建供用户确认的执行摘要
  • 调研竞争格局
  • 生成完整的 PRD.md,包含:
    • 应用概述和目标
    • 目标受众
    • 成功指标和 KPI
    • 竞争分析
    • 核心功能和用户流程
    • 技术栈建议
    • 前提条件和访问权限
    • 安全注意事项
    • 假设和依赖项

流程:

  1. 使用 AskUserQuestion 工具提出澄清问题
  2. 验证前提条件并创建或更新 .env.local 占位值
  3. 创建执行摘要,供用户审批
  4. 通过 WebSearch 调研竞争情况
  5. 生成完整的 PRD
  6. 根据反馈迭代

阅读 PRD.md 了解完整说明。


第 3 部分:生成实施任务

文件:JSON.md

你需要分析已完成的 PRD,并以 JSON 格式生成完整的任务清单。

适用场景:PRD 完成并获批后,或用户要求拆分任务时

功能:

  • 分析已完成的 PRD
  • 生成 TASK-1,作为必需的前提条件验证任务
  • 以 JSON 格式生成完整的实施任务清单,涵盖 PRD 中的所有功能和需求
  • 确保任务规模小且易于管理
  • 按类型对任务分类(功能、UI/UX、API 端点、安全等)
  • 为每项任务定义验证(“通过”)步骤
  • 创建开发者可直接使用的检查清单

重要事项:

  • 每项任务都应足够简单,最多可在 10 分钟内完成。
  • 如果任务过于复杂,应将其拆分为更小的任务。

阅读 JSON.md 了解完整说明。

第 4 部分:整体说明

你需要阅读已完成的 PRD,并在 PROJECT_ROOT/.agent/prd/SUMMARY.md 中生成项目整体说明。

说明应简短精炼,并包含:

  • 项目整体说明
  • 应用的主要功能
  • 关键用户流程
  • 关键需求简要清单

快速开始

如果用户想创建 PRD:

  1. 阅读 PRD.md
  2. 按照 PRD 创建工作流操作
  3. 验证前置条件,并仅使用占位值创建或更新 .env.local
  4. 如有需要,更新整体说明 SUMMARY.md
  5. 完成 PRD 后,询问:“您想让我生成实现任务吗?请参阅第 2 部分。”

如果用户想为现有 PRD 创建实现任务:

  1. 阅读 JSON.md
  2. 阅读 PRD 文件
  3. 生成完整的 JSON 格式任务列表,并以 TASK-1 前置条件验证任务开头
  4. 保存为 tasks.json

如果用户两者都想要:

  1. 先完成 PRD 创建 PRD.md,包括前置条件验证和 .env.local 占位值
  2. 获取用户对 PRD 的批准
  3. 如有需要,更新整体说明 SUMMARY.md
  4. 继续生成实现任务 JSON.md

如果用户想更新 PRD:

  1. 阅读 PRD.md
  2. 更新 PRD
  3. 保存为 PRD.md
  4. 如有需要,更新整体说明 SUMMARY.md
  5. 询问用户是否想生成实现任务

如果用户想更新实现任务:

  1. 阅读 JSON.md
  2. 更新实现任务
  3. 保存为 tasks.json
  4. 询问用户是否想再次更新 PRD

如果用户想同时更新 PRD 和实现任务:

  1. 先更新 PRD PRD.md
  2. 如有需要,更新整体说明 SUMMARY.md
  3. 更新实现任务 JSON.md
  4. 保存为 PRD.md 和 tasks.json

完成后

确保以下必需文件均已存在:

  • PROJECT_ROOT/.agent/prd/PRD.md
  • PROJECT_ROOT/.agent/prd/SUMMARY.md
  • PROJECT_ROOT/.agent/tasks.json

如果这些文件不存在,请提醒用户,并询问是否要创建其中任何文件。

重要约束

  • 不要生成代码——专注于文档和任务规范
  • 在第 1 部分广泛使用 AskUserQuestion 来明确需求
  • 切勿在 PRD、任务、聊天、日志或 .env.local 中写入真实的机密值;请使用占位值,并告知用户手动填写真实值
  • 在第 2 部分生成完整的任务列表(典型项目包含 50–200 项以上任务)
  • 在第 2 部分始终将 TASK-1 生成为功能工作开始前的前置条件验证任务
  • 初始化任务时始终使用 "passes": false——生成过程中切勿将任务标记为已完成
  • 使用可用工具:AskUserQuestion、WebSearch、Sequential Thinking、Read

评论

支持 Markdown