让 AI 改代码，麻烦常常不在它不会写，而在它还没把需求想清楚就开工。OpenSpec 给编码 Agent——能读取代码库、规划并执行修改的 AI 程序——加了一道“先交施工方案”的流程：先探索现有代码，再用 /opsx:propose 生成提案、需求场景、技术设计和任务清单。人确认后，Agent 才通过 /opsx:apply 实施，最后把记录归档。
这些规格使用普通 Markdown，不要求学习特殊语法。比如增加深色模式，会明确写出“用户点击切换按钮后，界面进入深色模式并保存选择”。这对 Brownfield——已有代码和历史约束的项目——尤其有用：需求、设计决定和实际改动都留在仓库里，人可以在写码前审计划，也能在事后追查 Agent 是否偏离原意。OpenSpec 还提出用独立规格仓库协调跨代码库功能，但该能力目前仍处于 beta。