Skip to content

规格生命周期工具(流程 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 验证将规格在生命周期中推进。

状态流程: draftreadyin_progressreviewdone

每次状态转换都会验证相应的检查列表。在满足 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 打包交接包"