规格生命周期工具(流程 B)
流程 B 包含 11 个工具,管理完整的规格生命周期 — 从第一个澄清问题到将生产就绪的规格交接给 AI 代理。
clarify_requirements
在创建规格之前生成有针对性的澄清问题。
适用场景: 在需求模糊、来自简短的口头交流或涉及多个系统时,在 create_spec 之前使用。
输出内容: 一份按优先级排列的问题清单,涵盖范围边界、边缘情况、非功能性需求、错误处理和外部依赖。
提示词:"使用 specforge 澄清为项目 proj_abc123 添加 Stripe 支付的需求"TIP
先运行 clarify_requirements 会产生更完整的验收标准,减少规格修订次数。这是 30 秒的投入,能节省数小时的时间。
create_spec
创建带有自动生成章节的完整 SDD 规格。
生成内容:
| 章节 | 描述 |
|---|---|
| 用户故事 | 标准格式的谁、什么、为什么 |
| 验收标准 | 可测试、无歧义的标准,带编号便于追溯 |
| DoR 检查列表 | 准备就绪定义关卡 |
| 数据库架构提示 | 表、列、关系、索引 |
| UI 契约 | 组件契约、数据流、状态管理 |
| 架构决策记录提示 | Architecture Decision Records |
| PLAN.md | 逐步 RED/GREEN/VERIFY 执行计划 |
AI 原生附加内容(检测到 AI 架构时):
- 延迟预算和回退链
- 提示词版本控制标准
- LLM 可观测性需求
前端附加内容(检测到性能设置时):
- Core Web Vitals 标准
- SSR 水合需求
- 微前端边界定义
提示词:"为项目 proj_abc123 创建一个添加 Google OAuth 身份验证的规格"list_specs
列出项目的所有规格,可选择按状态筛选。
适用场景: 查看待办事项、进行中的项目或需要审查的内容。
提示词:"列出项目 proj_abc123 的所有规格"
提示词:"显示项目 proj_abc123 中正在进行的规格"
提示词:"项目 proj_abc123 中有哪些被阻塞的规格?"update_status
通过 DoR/DoD 验证将规格在生命周期中推进。
状态流程: draft → ready → in_progress → review → done
每次状态转换都会验证相应的检查列表。在满足 DoD 标准之前,无法将规格标记为 done。
提示词:"将项目 proj_abc123 中规格 SPEC-003 的状态更新为 in_progress"
提示词:"将项目 proj_abc123 中的规格 SPEC-007 标记为完成"summarize_spec
生成规格的简洁摘要 — 适用于团队更新、PR 描述或站立会议笔记。
提示词:"总结项目 proj_abc123 中的规格 SPEC-005"generate_checklist
为规格生成质量检查列表 — 涵盖实现就绪度、测试覆盖率、文档、安全性和性能。
提示词:"为项目 proj_abc123 中的规格 SPEC-002 生成质量检查列表"reconcile_spec
将规格与实现变更协调,逐项变更审批并检查章程合规性。
适用场景: 当实现有意偏离规格,需要更新规格以匹配实际情况时。
该工具会逐项呈现变更供你审批 — 由你决定什么成为新的规格真相。
提示词:"将项目 proj_abc123 中的规格 SPEC-004 与实现变更协调"manage_scope
管理项目范围定义和待办事项 — 添加项目、删除、重新排优先级,或导出为结构化待办清单。
提示词:"将'深色模式支持'以高优先级添加到项目 proj_abc123 的待办事项中"
提示词:"显示项目 proj_abc123 的当前待办事项"detect_contradictions
分析项目中所有规格是否存在语义矛盾。
适用场景: 在开始冲刺之前、重大产品调整之后,或不同团队成员独立更新规格之后。
提示词:"检测项目 proj_abc123 规格中的矛盾"示例输出:"SPEC-002 说用户可以删除账号。SPEC-008 说账号数据因审计目的不可更改。"
check_readiness
评估规格是否已准备好实现 — 完整性、标准质量和依赖状态。
执行的检查:
- 所有验收标准是否可测试且无歧义?
- 所有阻塞依赖是否已解决?
- DoR 检查列表是否完整?
- 规格是否通过章程合规性检查?
提示词:"检查项目 proj_abc123 中的规格 SPEC-006 是否已准备好实现"package_handoff
为 AI 代理生成实现规格的结构化交接包。
输出内容:
- 实现目标
- 编号的验收标准
- 带归属的文件列表
- 约束和保护措施
- 为 Claude 或任何 AI 代理准备好的可直接粘贴的提示词
适用场景: 将实现委托给自主 AI 代理会话或未参与规格创建的团队成员时。
提示词:"为项目 proj_abc123 中的规格 SPEC-009 打包交接包"