关于 skill-prd
面向 Codex CLI 的 PRD 编写技能,先要求澄清用户、问题、成功标准和约束,再按结构撰写、评估并保存 PRD。还提供可选的跨提供方对抗性审查步骤。
主要功能
- 01撰写前强制澄清需求
- 02按规定结构组织 PRD
- 03可选跨提供方对抗性审查
- 04按 100 分框架自评
- 05保存到指定或生成的文件名
适用场景
- 01在需求不明确时先收集背景
- 02为新功能整理目标、要求和实施阶段
- 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
结构:
- 执行摘要 — 愿景与核心价值主张
- 问题陈述 — 按用户细分群体量化痛点
- 目标与指标 — SMART 目标、P0/P1/P2 优先级、成功指标表格
- 非目标 — 明确边界(我们不会做什么)
- 用户画像 — 2–3 个具体画像及其使用场景
- 功能需求 — 采用 FR-001 格式,并附验收标准
- 实施阶段 — 按依赖关系排序,并设定时间范围
- 风险与缓解措施 — 列出 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 的澄清问题开始。