用途:按 ID 删除 spec 条目。条目 ID 格式为 spec-{file-stem}-{NNN},是 WikiIndexer 原子索引中的子节点 ID。
主要能力:解析并校验条目 ID;通过 maestro wiki get <entry-id> --json 查找条目,确认其为 type=spec 且带 parent 的子节点;展示详情并让用户确认;调用 maestro wiki remove-entry <entry-id> 删除,WikiIndexer 自动更新 wiki-index.json;--cascade 在条目 ref 属性指向 knowhow 文档时一并删除该文件,避免留下孤立文件;-y 跳过确认立即删除;删除后用 maestro wiki get 验证应返回 not-found,并显示被删 ID、来源文件及验证/重加命令。
查找方式:maestro search --type spec --json 列出全部 spec 条目;$spec-load --keyword <term> 按关键词查找;maestro search "<query>" 使用 BM25 搜索。
必读文件:@~/.maestro/workflows/specs-remove.md。
阶段门(强制阻塞):GATE 1 解析到查找,缺少条目 ID 报 E001;GATE 2 查找至确认,要求 .workflow/specs/ 存在、条目在 wiki 索引中为 spec 子节点、内容已加载供预览,否则报 E002/E003/E004;GATE 3 确认至删除,要求用户经 request_user_input 确认(除非 -y),若 --cascade 且条目有 ref 属性还需额外确认删除 knowhow,拒绝则中止不改动。
输出边界:文件修改只允许作用于 spec 容器文件(.workflow/specs/.md),使用 --cascade 时可选作用于被引用的 knowhow 文件(.workflow/knowhow/);绝不修改源代码或这些路径之外的文件。
错误码:E001 缺少条目 ID;E002 specs 未初始化,需先运行 $spec-setup;E003 索引中未找到条目;E004 条目不是 spec 子节点(类型错误或无 parent)。以上均为 fatal。
限制:条目 ID、平台支持、价格等信息暂未提供。