用途:将 *.plan.md 实施计划转换为 OpenSpec 变更工作流,先读取并总结计划的范围、候选 change-id 与受影响能力,再生成或更新 OpenSpec 变更工件,包括 proposal、design、tasks 和 spec deltas。
主要能力:检查 OpenSpec CLI 可用性;在 macOS、Linux、Windows 上提供 npm 安装指引;通过 openspec init 初始化项目,或在已有项目中用 openspec list、openspec status、openspec show 查看;用 openspec validate --all 校验,完成后用 openspec archive 归档。
使用方式:所有 OpenSpec 命令须在包含 openspec/ 文件夹的父目录执行。开始前先阅读并总结提供的 *.plan.md,运行 openspec --version 检查 CLI;缺失时先按平台安装。无项目时仅运行 openspec init,不要加 --tools 选项。使用稳定 change-id(如 add-dark-mode)执行 status/show/archive,归档前运行 openspec validate --all。功能完成(所有清单任务勾选)后引导归档,例如 openspec archive us-001-god-analysis-api。tasks.md 只生成单一 OpenSpec 清单(- [ ] / - [x]),不要添加第二个基于表格的任务列表。需说明本次是新建还是更新变更。
适用场景:把 *.plan.md 转为 OpenSpec;从计划新增变更提案;更新已有 OpenSpec 项目;在 requirements 文件夹初始化 OpenSpec;校验并归档变更。
限制:不得编造 *.plan.md 中不存在的需求;只在计划意图范围内转换为显式 OpenSpec 变更工件。范围不明确时先停下提问;缺少必要输入、文件或工具时报告缺失并询问是否继续设置指引。