SuperAPI AI 工具集

implement-plan-preflight

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:执行 /itp:go 工作流的 Preflight 阶段,生成 ADR 与 Design Spec 两类产物,并完成交叉链接与验证。触发场景包括:由 /itp:go 命令在 Preflight 阶段调用、用户要求为某功能创建 ADR、用户提到 design spec 或 MADR 格式、需要手动 preflight 验证。

主要能力与流程:P.1 创建功能分支(仅当指定 -b 标志);P.2 创建 ADR 文件(MADR 4.0),路径为 /docs/adr/$ADR_ID.md,ADR ID 格式为 YYYY-MM-DD-slug;P.3 从全局计划创建 Design Spec,先 mkdir -p docs/design/$ADR_ID,再 cp ~/.claude/plans/<adj-verb-noun>.md docs/design/$ADR_ID/spec.md,并在 spec 头部添加 ADR 反向链接;P.4 强制验证检查点。

交叉链接为强制要求:ADR 头部需含 Design Spec: Implementation Spec;spec.md 头部需含 ADR: Feature Name ADR。

验证方式:运行 uv run scripts/preflight_validator.py $ADR_ID,或使用手动清单。清单要求 ADR 文件存在、含全部 7 个必填 YAML frontmatter 字段、头部含 Design Spec 链接、含 Before/After 图(Context 段)与 Architecture 图(Architecture 段)共两张图、Design Spec 存在且头部含 ADR 反向链接。任一缺失须立即补齐,不得进入 Phase 1。

限制:ADR 必须恰好包含两张图,未嵌入前不得进入设计规格阶段;frontmatter 字段缺失会导致校验失败;spec 阶段值需为 preflight、phase-1、phase-2 或 phase-3;ADR 状态由工作流管理,不应手动修改;设计目录路径须为 docs/design/YYYY-MM-DD-slug/spec.md。该技能为自进化技能,仅在问题真实且可复现时更新自身文件。

适用场景:需要规范化记录架构决策、生成设计规格并保证文档间可追溯链接的研发流程。