project-specification

委派

对于详细的规格编写工作流，此技能会将任务委派给 spec-kit:spec-writing，作为规范的实现方式。快速编写规格时使用此技能；编写全面的规格文档时使用 spec-kit。

适用场景

• 完成头脑风暴阶段后
• 已有项目简介，但需要详细需求
• 需要可测试的实施验收标准
• 规划验证和测试策略
• 将业务需求转化为技术规格
• 定义范围边界和范围外事项

不适用场景

• 仍在探索问题空间（改用 Skill(attune:project-brainstorming)）
• 已有详细规格（改用 Skill(attune:project-planning)）
• 正在完善现有实现（使用代码审查技能）
• 正在做战略决策（遇到复杂选择时使用 Skill(attune:war-room)）

集成

使用 spec-kit 时：

• 委派给 Skill(spec-kit:spec-writing) 以采用其方法
• 使用 spec-kit 模板和验证机制
• 启用澄清工作流

不使用 spec-kit 时：

• 使用独立的规格框架
• 使用需求模板
• 使用验收标准模式

文档受众

将简介中的 Doc audience 字段带入规格中， 并将其视为需求，而非备注：它决定项目的 README、指南和教程 可以包含哪些内容。如果简介未设置该字段，请询问，不要猜测。

同时指定深入内容的存放位置，以便在编写第一份文档前， 为抽取的内容提供去处：技能使用 modules/， 仓库文档使用 docs/deep-dive/<topic>.md。层级表格 和删减测试：scribe:slop-detector 模块 audience-targeting.md。

记录权衡（决策日志）

如果规格确定了一项存在实际备选方案的设计决策（例如选定数据模型、接口边界或接受某项约束），请在继续前将其记录到 docs/tradeoffs.md（先起草并确认）：

• 如果已安装 leyline，请调用 Skill(leyline:decision-journal) 并追加一条权衡记录（包括决策、权衡过的选项以及做出的牺牲；将 phase 设为 specify）。展示草稿；确认后再追加。
• 回退方案（未安装 leyline）：使用文件内的 ENTRY TEMPLATE 追加到 docs/tradeoffs.md；分配下一个 TR-NNN ID。

完成后：工作流续接（必需）

自动触发：质量检查通过且 docs/specification.md 已保存后，必须自动调用下一阶段。

调用续接时：

1. 验证 docs/specification.md 存在且非空
2. 向用户显示检查点消息：

   Specification complete. Saved to docs/specification.md.
   Proceeding to planning phase...
   

3. 调用下一阶段：

   Skill(attune:project-planning)
   

跳过条件（仅在符合以下任一条件时跳过续接）：

• 用户提供了 --standalone 标志
• docs/specification.md 不存在或为空（阶段失败）
• 用户明确要求在规格完成后停止

不要提示用户确认：这是一个轻量检查点，不是交互式关卡。如有需要，用户随时可以中断。

退出标准

• docs/specification.md 存在、非空且通过质量检查。
• 每项功能需求都有可测试的验收标准。
• 已注明文档受众层级，该信息来自简介，或在简介未注明时已询问。
• 任何存在实际备选方案的设计决策都已记录到 docs/tradeoffs.md（或不存在有意义的设计分歧）。
• 除非符合跳过条件，否则已自动调用下一阶段。

相关技能

• Skill(spec-kit:spec-writing) - Spec-kit 方法（如可用）
• Skill(attune:project-brainstorming) - 上一阶段
• Skill(attune:project-planning) - 规格完成后的自动调用下一阶段
• Skill(attune:mission-orchestrator) - 完整生命周期编排

相关命令

• /attune:specify - 调用此技能
• /attune:specify --clarify - 运行澄清工作流
• /attune:blueprint - 工作流中的下一步

示例

完整示例请参阅 /attune:specify 命令文档。