gsd-audit-milestone 是一个里程碑审计技能,其定位是在里程碑归档之前,对照原始意图审查完成情况。
用途 该技能解决的问题是:里程碑表面完成并不等于符合最初目标。它把审计放在归档动作之前,读取已存在的验证产物并结合跨阶段检查,帮助确认里程碑的真实完成度。
主要能力
- 读取已有的 VERIFICATION.md 文件。这些文件对应在 execute-phase 阶段已经完成的各阶段验证。
- 聚合技术债务(tech debt)与推迟处理的缺口(deferred gaps)。
- 启动集成检查器(integration checker),执行跨阶段接线(cross-phase wiring)核查。
- 作为编排器工作,串联上述步骤,而非单一检查动作。
使用方式 该技能通过提及 $gsd-audit-milestone 来调用。 调用后跟随的用户文本会被作为 {{GSD_ARGS}} 参数处理;如果没有提供参数,{{GSD_ARGS}} 视为空。
该技能包含一段 Codex 技能适配说明(codex_skill_adapter),用于把 GSD 工作流中的 Claude Code 语法映射到 Codex 环境:
- AskUserQuestion → request_user_input:参数 header 映射为 header,question 映射为 question,选项中 "Label" — description 格式映射为 {label: "Label", description: "description"},并由 header 生成 id(小写、空格替换为下划线)。批量调用时,AskUserQuestion([q1, q2]) 变为一次 request_user_input,在 questions[] 中包含多个条目。由于 Codex 没有 multiSelect,多选需求采用连续单选,或展示带编号的自由填写列表,让用户输入以逗号分隔的编号。当 request_user_input 在执行模式(Execute mode)下被拒绝时,回退为纯文本编号列表并选取合理默认值。
- Task() → spawn_agent:映射为 Task(subagent_type="X", prompt="Y") → spawn_agent(agent_type="X", message="Y");Task(model="...") 映射为省略,因为 Codex 使用按角色配置而非内联模型选择;fork_context 默认为 false,GSD 智能体通过 <files_to_read> 块自行加载上下文。并行分发时启动多个智能体、收集智能体 ID,再用 wait(ids) 等待全部完成;通过智能体输出中的结构化标记(如 CHECKPOINT、PLAN COMPLETE、SUMMARY 等)解析结果;收集结果后用 close_agent(id) 关闭各智能体。
核心规划文件在工作流内解析(init milestone-op),并仅在需要时加载。已完成工作的定位方式为:对 .planning/phases//-SUMMARY.md 和 .planning/phases//-VERIFICATION.md 进行 Glob 匹配。
适用场景 适用于在里程碑归档前需要核验完成度与原始意图一致性的工作流,尤其是存在多阶段、且已由 execute-phase 生成验证文件的项目。
限制 当前提供的资料未说明该技能的收费、价格、支持平台、具体执行效果或完整使用步骤。技能原始设计面向 Claude Code 语法,在 Codex 环境下需要依赖上述适配映射。若缺失 VERIFICATION.md 等前置验证文件,资料未说明其降级行为。