用途：把 OpenSpec 作为仓库的规格与变更控制平面，管理非平凡改动，例如 skills/、agents/、mcp/、AGENTS.md、instructions/、agent-bundle.json、插件清单、同步清单、可移植技能 CLI 行为、生成文档与 OpenSpec 规格等。小型孤立拼写修复或单文件本地改动可跳过。
主要能力：通过 openspec_cli.py 提供 doctor（诊断工具链与项目状态）、init/update（本地生成下游 OpenSpec 技能与命令）、status（以 JSON 读取变更工件状态）、instructions（获取 AI 可读的下一步指令）、validate（校验全部规格与变更）、archive（校验并归档已完成变更）。支持自然语言变更请求，先判断是否值得使用 OpenSpec。
使用方式：先运行 uv run python skills/openspec-workflow/scripts/openspec_cli.py doctor；需要机器可读状态时用 status --change <change> --format json 或 instructions <artifact> --change <change> --format json；完成前运行 validate。下游工具映射包括 claude-code→claude、codex→codex、crush→crush、cursor→cursor、opencode→opencode。
工件顺序：proposal、affected-surfaces、design、validation-matrix、tasks。归档前须完成实现与校验，并保持各工件与最终状态一致。
限制：生成的 .claude、.cursor、.opencode、.agent、.crush、.codex 等工件默认不提交，除非明确提升为仓库自有源。若缺少 Node/OpenSpec 工具链，应报告阻塞并给出安装 Node >=20.19.0 后的确切重试命令。完成标准包括 scripts/check.py 退出 0、doctor 与 validate 通过或给出后续命令、技能目录不含仓库控制平面 CLI 引用。