OpenSpec 入门：把 AI 编程需求变成可审阅的变更材料
如何选择 OpenSpec：什么时候值得维护完整变更材料
围绕具体协作问题，比较变更目录、问题清单和已有规格流程。
如何选择 OpenSpec：什么时候值得维护完整变更材料知识学习CN编辑简报更新 2026-09-23
你将学会
- 先确认协作缺口
- 公平计算接入成本
- 让采用决定可撤回
开始前需要
- 基本 Git 与 Node 知识
- 可独立试验的样例仓库
用合成模式解释阻塞原因，把规划状态与实现证据放在不同列中。
先看结论
- 行为变更需要明确场景。
- 避免重复维护两套计划。
- 竞品判断需要独立验证。
先确认协作缺口
当需求散落在聊天中，或变更需要从提案追踪到测试时，可以评估 OpenSpec。没有行为变化的拼写修正，可能只需要一条明确的问题记录和代码审阅。
默认模式为不改变规格层行为的变更提供 skip_specs。不要为了填满模板而虚构需求，应先判断这个变更是否真的改变了用户可观察的行为。
公平计算接入成本
如果团队已有清楚的规格和验收测试，应判断新的材料指引是否有帮助，还是重复维护既有流程。指引刷新、审阅培训和助手兼容性都属于成本。
README 包含与其他产品的比较，但本系列没有把这些供应方评价当作验证过的事实。没有安装或测试竞品，实际选择应另做受控试点。
让采用决定可撤回
从一个仓库、一位审阅人和少量变更开始，扩展前要求场景与测试可追踪。如果规划开销超过收益，应预先写明停止试点的条件。
独立规划仓库可能解决跨项目所有权问题，但 beta 状态需要单独评估。先采用能解决已观察协作问题的最小方案，不急着增加组织结构。
如何选择
| 比较维度 | 方案 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
约定采用与退出条件。
可复制示例
yaml
pilot:
repository: one
change: csv-export
success: traceable-scenarios-and-tests
exit_if: duplicated-planning-without-review-benefit常见问题
重构也必须编造新规格吗？
默认模式允许没有规格层行为变化的变更使用 skip_specs。
这是一份竞品排名吗？
不是，这里提供选型方法，没有运行对比测试。
资料来源
- OpenSpec / README.md来源核查 2026-09-23
- OpenSpec / schemas/spec-driven/schema.yaml来源核查 2026-09-23