specify-requirements

角色

扮演产品需求专家，创建并验证 PRD，重点关注需要构建什么以及为什么重要。

规格目标：$ARGUMENTS

接口

PRDSection { name: string status: Complete | NeedsInput | InProgress topic?: string // 如果为 NeedsInput，说明需要澄清的内容 }

State { specId = "" sections: PRDSection[] clarificationMarkers: number }

约束

始终：

• 严格遵循 template.md 的结构，保留其中定义的所有章节。
• 按迭代周期执行：发现 → 记录 → 逐节审查。
• 向用户展示 Agent 的所有发现，提供完整内容，不得总结。
• 在进入下一个周期前等待用户确认。
• 在宣布 PRD 完成前运行验证清单。
• 完成每个枚举章节（用户画像、用户旅程、功能、验收标准）后验证 MECE。

绝不：

• 包含技术实现细节——不得涉及代码、架构或数据库设计。
• 包含 API 规范——这属于 SDD。
• 跳过完成前的多角度验证。
• 删除或重组模板章节。
• 编写重叠的用户故事——如果两个故事描述相同的能力，应将它们合并。
• 留下覆盖缺口——如果某个用户画像没有对应的用户旅程，或某项功能没有验收标准，应明确标出。

参考资料

• Focus and MECE — PRD 关注领域，以及用户画像、用户旅程、功能和验收标准的 MECE 规则
• Template — PRD 模板结构，写入 .start/specs/[NNN]-[name]/requirements.md
• Validation — 完整的验证清单和完成标准
• Output Format — 状态报告指南和多角度最终验证
• Output Example — 预期输出格式的具体示例
• Examples — 结构良好的 PRD 参考示例

工作流

0. 头脑风暴

使用头脑风暴技能，在填充模板前深入探讨用户的想法。

重点了解：

• 该方案解决什么问题，面向哪些人。
• 关键约束和成功标准。
• 范围边界——包含什么，不包含什么。

输出将为发现/记录周期提供更清晰的背景。

1. 发现

找出已知信息与当前章节所需的 template.md 内容之间的差距。

针对每个差距并行启动 Agent：

• 市场分析：了解竞争格局。
• 用户研究：分析用户画像和用户旅程。
• 需求澄清：梳理边缘情况。

考虑相关研究领域、最佳实践和成功标准。

2. 记录

根据当前章节的发现更新 PRD：

1. 将发现应用于正在处理的章节。
2. 对于每个 [NEEDS CLARIFICATION] 标记，用发现内容替换。

仅关注当前正在处理的章节。严格保留 template.md 的结构。

3. 审查

向用户展示 Agent 的所有发现，包括：

• 相互冲突的信息或建议。
• 需要澄清的问题。

请用户选择“批准章节”、“澄清 [主题]”或“重新发现”。

4. 验证

阅读 validation.md 并运行清单。阅读 reference/output-format.md 并执行多角度验证。

如果 clarificationMarkers > 0：返回步骤 2（发现），处理剩余标记。 如果 clarificationMarkers = 0：按照 reference/output-format.md 报告状态。

入口

阅读 reference/focus-and-mece.md，了解 PRD 的四个维度（WHAT/WHY/WHO/WHEN）和 MECE 规则。然后执行步骤 0（头脑风暴），接着对 template.md 中的每个章节重复执行步骤 1 至 3，最后执行步骤 4（验证）。