Spec Kit：从可测试意图到可追踪验收
什么时候使用 Spec Kit，什么时候只需要问题单或确定性测试
根据不确定性、协作范围和功能寿命决定流程重量，并区分一致性分析、实现收敛与需求检查表。
什么时候使用 Spec Kit，什么时候只需要问题单或确定性测试知识学习CN编辑简报更新 2026-09-14
你将学会
- 选择足以保留证据的流程
- 选择对应证据缺口的检查阶段
- 先理解基础流程，再增加定制
开始前需要
- 了解基本需求、Git 与测试
- 分清本地开发和应用部署
追踪小功能从意图到证据的过程，区分流程约定与已验证行为。
先看结论
- 流程重量应匹配歧义与协作需要。
- 分析、收敛和需求检查关注不同证据。
- 增加定制层之前先理解核心流程。
选择足以保留证据的流程
一个能稳定复现、范围很小的错误，可能只需要问题单、针对性修改和回归测试。跨存储、用户体验和团队边界的功能，更需要明确决策和可追踪任务。Spec Kit 的价值在于减少反复歧义，而不是助手能生成很多文档。
确定性测试与规格回答不同问题：测试在特定环境下检查实现行为，规格定义预期结果和约束，二者不能相互替代。没有具体协作需要时，不必把每次代码修改都变成大型文档工程。
选择对应证据缺口的检查阶段
analyze 在实现前比较规格、计划和任务；converge 在实现后比较当前代码与这些文档并追加剩余工作；需求检查表关注清晰度和完整性。它们是互补视角，不是同一验证命令的三个名称。
如果用户意图尚未确定，应该澄清，而不是让收敛检查自行创造产品方向。如果行为已经实现但部署失败，应调查交付证据，而不是为了得到干净评估就重写规格。工具选择应对应真正缺少的证据。
先理解基础流程，再增加定制
从小功能和核心流程开始，识别反复出现的阻力。单项目格式调整适合本地覆盖，可复用格式或方法适合预设，新能力适合扩展，角色组件集合适合组合包。每增加一层，都先检查它改变了什么。
这里提供的是决策方法，不是供应商排名，也不声称结构化助手总比直接提示更好。可以在得到有价值文档后停止，或在流程开销超过任务收益时继续采用普通代码审阅。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
明确不确定性和协作成本。
- 2
选择与证据缺口对应的检查阶段。
- 3
进行有边界的基础流程试验。
- 4
只为已证实的重复需要增加定制。
可复制示例
json
{
"选型示例": true,
"问题": "计划和任务对存储方式存在矛盾",
"下一步": "一致性分析",
"执行实现": false,
"部署": false
}常见问题
每个微小修复都应该跑完整流程吗？
不一定，采用能保留该修改所需证据的流程即可。
converge 能替用户决定产品需求吗？
它应对照已有意图进行检查，而不是创造新的产品方向。
资料来源
- Spec Kit / README.md来源核查 2026-09-14
- Spec Kit / templates/commands/analyze.md来源核查 2026-09-14
- Spec Kit / templates/commands/converge.md来源核查 2026-09-14