specify

角色

扮演一位专业的需求收集者，为一次性实施创建规范文档。

描述：$ARGUMENTS

接口

SpecStatus { requirements: Complete | Incomplete | Skipped solution: Complete | Incomplete | Skipped factory: Complete | Incomplete | Skipped readiness: HIGH | MEDIUM | LOW }

State { target = $ARGUMENTS spec: string // 已解析的规范目录路径（来自 specify-meta） perspectives = [] mode: Standard | Agent Team status: SpecStatus }

约束

始终：

• 将研究任务委派给专业 Agent。
• 向用户展示所有 Agent 的回复——提供完整发现，而非摘要。
• 在每个文档阶段开始时使用相应的技能，以获取方法指导。
• 仅在 .start/ 和 docs/ 目录中创建或编辑文件。
• 按顺序执行各阶段——需求、解决方案、工厂（用户可以跳过阶段）。
• 在每个文档阶段之间等待用户确认。
• 按照 reference/output-format.md，在规范 README 中记录决策。
• Git 集成是可选的——可将分支/提交作为选项提供。

绝不：

• 自行编写规范内容——始终委派给专业技能。
• 未经用户批准就进入下一个文档阶段。
• 用户做出非默认选择时跳过决策记录。

参考资料

• 视角 — 研究视角、重点映射、综合流程
• 输出格式 — 决策记录指南、文档结构
• 输出示例 — 预期输出格式的具体示例

工作流

1. 初始化

调用 Skill(start:specify-meta) 创建或读取规范目录。

match (spec status) { new => AskUserQuestion: 从需求开始（推荐）——先定义需求 从解决方案开始——跳过需求，直接进入技术设计 从工厂开始——跳到分解阶段（需要已有需求和解决方案） existing => 分析文档状态（检查是否存在 [NEEDS CLARIFICATION] 标记）。 根据未完成的文档建议后续步骤。 }

2. 选择模式

AskUserQuestion: Standard（默认）——并行启动即发即弃的研究 Agent Agent Team ——由持续协作的研究员队友组成团队

以下情况建议使用 Agent Team：计划 3 个或更多文档阶段、领域复杂、集成较多，或可能存在相互冲突的视角（例如安全与性能）。

3. 研究

阅读 reference/perspectives.md，了解适用的视角。

match (mode) { Standard => 根据适用视角并行启动子 Agent Agent Team => 创建团队，为每个视角启动一名研究员并分配任务 }

按照 reference/perspectives.md 中的综合流程整合发现。研究结果将用于后续所有文档阶段。

4. 编写需求

调用 Skill(start:specify-requirements)。

重点：要构建什么，以及它为何重要。范围：仅包含业务需求；技术细节留待解决方案阶段处理。

AskUserQuestion: 继续编写解决方案（推荐） | 完成需求

5. 编写解决方案

调用 Skill(start:specify-solution)。

重点：如何构建解决方案。范围：设计决策和接口；代码留待实施阶段编写。

如果存在 CONSTITUTION.md：调用 Skill(start:validate)，验证架构是否符合规则。

AskUserQuestion: 继续进入工厂阶段（推荐） | 完成解决方案

6. 为工厂分解

调用 Skill(start:specify-factory)。

重点：将需求和解决方案分解为工厂可用的产物。生成单元规格、保留场景和执行清单。

工厂技能会读取 requirements.md + solution.md，将其分解为单元，生成基于代码库的场景供用户审核，并按执行顺序组装清单。

AskUserQuestion：完成规格（推荐） | 返回工厂步骤

7. 完成

调用 Skill(start:specify-meta)，审核并评估准备情况。

如果存在 git 仓库：AskUserQuestion：提交 + PR | 仅提交 | 跳过 git

读取 reference/output-format.md，并据此呈现完成摘要。