SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场prd

prd

写作与研究

查看项目

更新于 10-16 06:37

技能介绍

用途

PRD 是一个“PRD 生成器 + Issue 拆解器”技能，用于在规划新功能或启动新项目时，把模糊的功能想法转化为清晰、可执行、适合实施的产品需求文档，并进一步拆解为可独立实施的 Issue。它明确不负责实现代码，只负责产出 PRD 和 Issue。

主要能力

  1. 澄清提问：接收用户的功能描述后，提出 3-5 个关键澄清问题，问题带字母选项，便于用户用类似“1A, 2C, 3B”的方式快速回答。问题聚焦问题/目标、核心功能、范围/边界、成功标准。
  2. 生成结构化 PRD：根据回答生成包含以下章节的 PRD：介绍/概述、目标、用户故事、功能需求、非目标（范围外）、设计考虑（可选）、技术考虑（可选）、成功指标、开放问题。
  3. 用户故事规范：每个用户故事包含标题、描述（As a [user], I want [feature] so that [benefit]）和验收标准，编号规则为 US-001、US-002、US-003……（三位数字，从 001 开始）。验收标准必须可观察、可测试或可验证，否则视为“模糊”需重写。涉及 UI 变更的故事需包含“使用 dev-browser 技能在浏览器中验证”。
  4. 功能需求规范：以 FR-N: 开头（N 从 1 递增），使用“系统必须/系统应”措辞，每条描述一个具体行为，避免用“和”连接多个行为。
  5. PRD 审阅与保存：向用户展示 PRD 并请求审阅，用户可要求调整或回复 OK 确认；确认后保存到 tasks/prd-[feature-name].md（kebab-case）。
  6. Issue 拆解：根据用户故事和功能需求生成 Issue 列表。规则包括：每个 US-XXX 至少对应一个 Issue；验收标准达 5 条以上或横跨前后端的大故事拆成 2-3 个更小 Issue 并标明依赖；只有 1-2 条琐碎标准的小故事合并；每个 Issue 必须可独立实施；Issue 从 1 开始顺序编号。Issue 格式包含标题、描述、验收标准、依赖、类型（backend/frontend/fullstack/ui/infra）、优先级（high/medium/low）。
  7. Issue 创建模式：用户确认 Issue 列表后，可选择三种创建模式：
    • GitHub：通过 gh CLI 创建，命令为 gh issue create --title "[Title]" --body "[Description + Acceptance Criteria]" --label "[type]" --label "priority: [priority]"；若标签不存在则先创建或跳过 --label。
    • 本地：保存为 .md 文件，默认目录 .autoresearch/issues，文件名 issue-NNN-[slug].md（补零到 3 位）。
    • 百度 iCafe：通过 icafe-cli 创建，命令为 icafe-cli card create --space [SPACE] --title "[Title]" --description "[Description + Acceptance Criteria]" --cardtype "[Task/Bug/Story]"；类型映射 bug→Bug、ui/frontend→Story、其他→Task；优先级映射 high→高、medium→中、low→低。
  8. 汇总报告：创建完成后打印汇总，包含模式、PRD 路径、Issue 数量及每个 Issue 的标题与标识符，并给出 autoresearch 使用提示，例如 ./run.sh 42（GitHub 模式）、./run.sh 1（本地模式）、./run.sh --issue-source=baidu --space=[SPACE] 22210（百度 iCafe 模式）。

使用方式

用户提供功能描述后，技能先提问澄清，再生成 PRD 并请用户审阅确认，保存到 tasks/prd-[feature-name].md。随后拆解为 Issue 列表，请用户审阅（可删除、合并、新增、调整优先级或确认），确认后选择创建模式并收集对应参数（本地模式询问保存目录，百度 iCafe 模式询问 --space 前缀代码，可选询问 iCode CR 目标分支，默认 master），最后创建 Issue 并输出汇总。

边界与回退处理

  • 用户跳过澄清问题（如回复“随便”“直接写”）：用合理默认值填充，在 PRD 中标记 [Assumption]，并在审阅时提示用户确认。
  • 用户输入过于模糊（如“加个功能”）：先追问一次具体信息；若仍模糊，则根据项目上下文推断并标记假设。
  • tasks/ 目录不存在：自动创建。
  • 难以从输入提取 feature-name：直接询问用户确认或修改建议的文件名。
  • 审阅后用户要求修改 PRD：应用修改并重新保存，不重新运行澄清流程。
  • PRD 内容超过 500 行：建议用户考虑拆分为多个子功能 PRD。
  • 用户拒绝创建 Issue：仅保存 PRD，跳过 Issue 创建步骤。
  • GitHub 模式下 gh CLI 未认证：显示错误，建议 gh auth login，并提供切换到本地模式的选项。
  • 百度模式下 icafe-cli / icode-cli 未安装：显示错误，建议安装，并提供切换到本地模式的选项。
  • 本地模式下 Issue 文件夹不存在：自动创建。
  • 百度 iCafe 模式下某个 Issue 创建失败：记录错误并继续创建剩余 Issue。

适用场景

适合在规划新功能、启动新项目、需要把产品想法整理为可执行需求并拆解为开发任务时使用。产出物为 Markdown 格式的 PRD 和 Issue，可对接 GitHub、本地文件或百度 iCafe 工作流。

限制

该技能不进入实际编码实现，只生成 PRD 和 Issue。GitHub 模式依赖 gh CLI 已安装并认证；百度 iCafe 模式依赖 icafe-cli 已安装并登录。其他平台或收费、价格等信息暂未提供。