mcpField
S
skill-prd

skill-prd

github.com/nyldn开发4.3k57 次安装今天更新
代码仓库

关于 skill-prd

面向 Codex CLI 的 PRD 编写技能,先要求澄清用户、问题、成功标准和约束,再按结构撰写、评估并保存 PRD。还提供可选的跨提供方对抗性审查步骤。

主要功能

  1. 01撰写前强制澄清需求
  2. 02按规定结构组织 PRD
  3. 03可选跨提供方对抗性审查
  4. 04按 100 分框架自评
  5. 05保存到指定或生成的文件名

适用场景

  1. 01在需求不明确时先收集背景
  2. 02为新功能整理目标、要求和实施阶段
  3. 03通过审查与自评分检查 PRD 完整性

安装

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

$npx skills add https://github.com/nyldn/claude-octopus --skill skill-prd

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

附带文件agents/openai.yaml

详细介绍

宿主:Codex CLI — 此技能为 Claude Code 设计,并已适配 Codex。 交叉引用命令在 Codex 中使用已安装的技能名称,而不是 /octo:* 斜杠命令。 使用当前启用的 Codex shell 和子 Agent 工具。当前会话未提供某个提供方、模型或宿主子 Agent 之前,不要声称其可用。 有关宿主工具的对应项,请参阅 skills/blocks/codex-host-adapter.md。

停止——技能已加载

不要再次调用 Skill()。不要加载任何其他技能。直接执行。

阶段 0:澄清(必须)

在撰写任何 PRD 内容之前,必须先询问用户以下问题:

I need to understand your requirements before creating the PRD.

1. **Target Users**: Who will use this? (developers, end-users, admins, etc.)
2. **Core Problem**: What specific pain point does this solve? Any metrics?
3. **Success Criteria**: How will you measure if this succeeds?
4. **Constraints**: Any technical, budget, or timeline constraints?
5. **Existing Context**: Is this greenfield or integrating with existing systems?

Please answer these (even briefly) so I can create a more targeted PRD.

等待用户回复后,再继续阶段 1。

如果用户说“跳过”,或直接提供了功能描述,请提取可用信息并注明假设。

阶段 1:快速调研(最多 2 次搜索)

只有在主题不熟悉时才进行搜索。最多进行 2 次网络搜索:

  • 一次了解领域/市场背景
  • 如有需要,再搜索一次技术模式

不要过度调研。本阶段最多 60 秒。

阶段 2:撰写 PRD

结构:

  1. 执行摘要 — 愿景与核心价值主张
  2. 问题陈述 — 按用户细分群体量化痛点
  3. 目标与指标 — SMART 目标、P0/P1/P2 优先级、成功指标表格
  4. 非目标 — 明确边界(我们不会做什么)
  5. 用户画像 — 2–3 个具体画像及其使用场景
  6. 功能需求 — 采用 FR-001 格式,并附验收标准
  7. 实施阶段 — 按依赖关系排序,并设定时间范围
  8. 风险与缓解措施 — 列出 3–5 项主要风险及缓解策略

阶段 2.5:对抗式 PRD 审查(推荐)

完成 PRD 初稿后、进行自评分之前,将初稿交由另一家提供方进行对抗式审查。 单一模型撰写的 PRD 存在盲点;跨提供方质疑有助于发现错误假设、遗漏场景和相互矛盾的需求。

将 PRD 初稿交给不同的提供方(Codex、Antigravity,或作为后备选项的 Sonnet),并附上以下提示词:

“请质疑这份 PRD。哪些假设是错误的?遗漏了哪些用户场景?哪些需求相互矛盾?首位用户会提出什么投诉?这份 PRD 忽视了哪些风险?”

收到质疑后:

  • 修订 PRD,处理合理的质疑
  • 若某些质疑虽未采纳但有一定道理,请在“风险”部分说明
  • 在 PRD 页脚添加:对抗式审查:已应用

使用 --fast 时,或用户要求优先速度而非全面性时,可跳过。 完整的分发语法请参阅 prd.md 命令。

阶段 3:自评分

按 100 分制框架评分:

  • AI 专项优化:25 分(顺序化阶段、非目标、结构化格式)
  • 传统 PRD 核心内容:25 分(问题陈述、目标、用户画像、规格)
  • 实施清晰度:30 分(带编号的 FR、NFR、架构、阶段)
  • 完整性:20 分(风险、依赖关系、示例、文档质量)

阶段 4:保存

保存到用户指定的文件名,或根据功能名称生成文件名。

现在从阶段 0 的澄清问题开始。

评论

支持 Markdown