OpenSpec 入门：把 AI 编程需求变成可审阅的变更材料
动手做 OpenSpec 就绪检查器：展示依赖，不自动执行
用合成模式解释阻塞原因，把规划状态与实现证据放在不同列中。
动手做 OpenSpec 就绪检查器：展示依赖，不自动执行知识学习CN编辑简报更新 2026-09-23
你将学会
- 先实现只读检查器
- 复用图算法的六种检查
- 演示最重要的状态差异
开始前需要
- 基本 Git 与 Node 知识
- 可独立试验的样例仓库
用合成模式解释阻塞原因，把规划状态与实现证据放在不同列中。
先看结论
- 这是建议的扩展练习。
- 就绪与证据需要不同状态。
- 不要自动执行推荐命令。
先实现只读检查器
做一个本地界面显示材料标识、依赖与完成状态。规格完成但设计缺失时，应解释任务为何仍阻塞；先用固定的合成模式，再考虑读取真实项目。
这是本系列提出的扩展练习，不声称已经存在于所检查的仪表盘中。交付物除了就绪说明，还应独立显示人工审阅与应用测试证据。
复用图算法的六种检查
覆盖初始提案、规格设计分叉、剩余设计、任务就绪与全部材料完成。选择并审阅模式验证器后再增加无效输入测试，不要假定 fromSchema 自带验证。
界面里的下一条命令应作为待审阅文字显示，不应自动交给 shell。名称和路径按数据处理，第一版练习不包含任何命令执行功能。
演示最重要的状态差异
展示一个规划材料全部存在、应用测试却失败的变更。界面应该显示规划完成以及实现未验证或失败，不能仅凭材料完成集合点亮发布成功标志。
最后提交可复现的样例报告、源码版本与阻塞说明截图。增加真实助手、共享规划仓库或实时执行命令之前，还需要另做安全和行为审查。
如何选择
| 比较维度 | 方案 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
演示规划完成但测试失败。
可复制示例
json
{"planning":"complete","implementation":"test-failed","release":"not-verified","nextCommand":"display-only"}常见问题
原型必须调用模型吗？
不需要，合成图状态足以支持第一版。
怎样判断练习完成？
状态用例可复现，而且界面不会把规划完成误标为实现已验证。
资料来源
- OpenSpec / src/core/artifact-graph/graph.ts来源核查 2026-09-23
- OpenSpec / src/core/change-status-policy.ts来源核查 2026-09-23
- OpenSpec / schemas/spec-driven/schema.yaml来源核查 2026-09-23