product-spec-kit

概述

此技能可帮助产品经理为产品开发编写结构清晰、质量上乘的文档。它支持全面的文档工作流（PRD → 计划 → 用户故事），也支持独立的快速问题（单个用户故事、任务或 Bug）。

始终使用用户交互时所用的语言创建最终文件，包括模板中的标题和默认内容。如果用户明确要求使用其他语言，则按要求使用。

何时使用？

用户提出以下要求时，请使用此技能：

• 创建 PRD 规格说明
• 创建史诗及其用户故事/任务
• 需要创建或澄清产品规格说明，例如产品需求文档（PRD）、发布计划或用户故事。
• 也可用于创建独立的 PRD、计划、用户故事、任务或 Bug。

核心原则宪章

所有文档都必须遵循 rules/product-speckit-constitution.md 中定义的宪章。此宪章包含一组不可妥协的原则，适用于使用此技能创建的所有产品文档。无论使用何种语言、工作流类型（完整或快速）或文档格式，这些原则都适用。

原则 I：需求完整且明确

每项需求都必须清晰到足以让没有相关背景的读者理解需要什么以及原因。

原则 II：以设计为依据的验收标准

验收标准应基于视觉设计、用户流程和具体 UI 元素编写，绝不能凭假设编写。

原则 III：侧重功能，而非描述

标准必须描述系统的行为，而不是外观。重点关注行为、操作和结果。

原则 IV：详略得当

• PRD：宏观层面的需求和通用规则
• 用户故事：详细的功能验收标准
• 每份文档都应各司其职，避免内容重叠

原则 V：切勿假设，务必验证

信息缺失或含糊不清时：

• 提出具体问题
• 请求提供设计稿/模型图
• 参考之前的讨论
• 标记待验证的不确定事项
• 等待确认后再定稿

工作流或命令

• 开始交互——如何开始编写新规格说明：如果用户没有说明要编写哪种规格说明，始终按照 workflows/prod-start.md 中的说明询问。若用户已说明要编写哪种规格说明，则跳过开始步骤。
• 创建 PRD：用户想要创建 PRD 时，按照 workflows/prod-spec-prd.md 中的说明操作。
• 澄清规格说明：用户想要澄清规格说明（例如 PRD、计划、用户故事、任务或 Bug）时，按照 workflows/prod-clarify.md 中的说明操作。如果用户没有提供现有规格说明，请向其索取。
• 拆分规格说明：用户想要将 PRD 拆分为更小的部分（例如史诗 → 用户故事/任务）时，按照 workflows/prod-spec-breakdown.md 中的说明操作。拆分之前，必须验证现有 PRD 或先创建 PRD。如果用户没有提供现有 PRD，请向其索取。
• 创建用户故事：用户想要创建用户故事时，按照 workflows/prod-spec-story.md 中的说明操作。
• 创建任务：用户想要创建任务时，按照 workflows/prod-spec-task.md 中的说明操作。