OpenSpec 入门：把 AI 编程需求变成可审阅的变更材料
评估 OpenSpec 成本：规划时间是否减少了返工
设计可比较的小型试验，不把 Markdown 数量或勾选任务数当作生产力。
评估 OpenSpec 成本：规划时间是否减少了返工知识学习CN编辑简报更新 2026-09-23
你将学会
- 先定义可比较的变更
- 单独计算助手开销
- 保留失败与不确定性
开始前需要
- 基本 Git 与 Node 知识
- 可独立试验的样例仓库
用合成模式解释阻塞原因，把规划状态与实现证据放在不同列中。
先看结论
- 以验收通过的变更为单位。
- 助手费用需要单独记录。
- 图算法正确不等于效率提升。
先定义可比较的变更
选择范围相近、验收测试已知的小变更，分别记录需求澄清、材料编写、实现审阅与失败修正的时间。有效单位是通过验收的变更，而不是生成的文档数。
不要用熟悉的简单任务对比陌生的跨服务功能，再把时间差归因于 OpenSpec。仓库熟悉程度、助手版本和需求模糊程度都应随测量一起记录。
单独计算助手开销
OpenSpec 的 MIT 许可不包含外部编程助手或模型费用。环境允许时记录调用量和审阅时间，没有带日期的来源时，不在静态文章中填入当前供应商报价。
合理的规格可能减少重复上下文，冗长和重复的计划也可能增加消耗。应观察实际使用量与被退回的提案，不要默认多写一份材料就节省了 token。
保留失败与不确定性
记录遗漏场景、实现返工以及写代码前就放弃的计划。一个流程可能增加规划时间，却减少后续返工，两种结果都应该出现在报告里。
本系列没有执行延迟、费用或生产力基准测试。下面的表格只是实验设计；六项图算法断言只能证明对应排序行为，不能支持百分比效率提升。
如何选择
| 比较维度 | 方案 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
报告失败样本和测量边界。
可复制示例
csv
change,scope,planning_minutes,review_minutes,rework_minutes,accepted,assistant_usage
trial-export,small,,,,,常见问题
任务数量能表示生产力吗？
不能，任务范围不同，也可能没有足够证据就被勾选。
本系列证明了节省费用吗？
没有进行工作流对照基准测试。
资料来源
- OpenSpec / README.md来源核查 2026-09-23
- OpenSpec / src/core/artifact-graph/graph.ts来源核查 2026-09-23