SuperAPI AI 工具集

blueprint

编程与开发

查看项目

更新于 10-16 08:34

技能介绍

用途:为当前任务编写规范的 ai-env 蓝图(计划文件),是 /task 流程的第 3 步,需在 /orient 已识别任务后运行。

主要流程:先检查前置条件(存在 worktree 且 /orient 已识别任务,否则停止并提示);调用 /brainstorming 就任务描述进行一轮头脑风暴(仅一轮,捕获方向不迭代);读取仓库根目录的 ai-workspace/plans/TEMPLATE.md;在 ai-workspace/plans/<branch-slug>.md 生成包含全部模板字段的计划,复杂计划可参考 references/planning-quality.md 的检查清单但不整份复制。

模板字段:Branch(当前分支名)、Target(合并目标分支,默认经 reflog 父分支检测,回退 main,仅有意改目标时覆盖,/ship 读取此字段)、Created(当天日期 YYYY-MM-DD)、Status(In Progress)、Threat model、Scope ceiling(模板默认 400/6 软、800/10 硬,固定不变)、Task(1-3 句说明做什么与为何)、Steps(具体实现步骤的复选框列表)、Confidence Scaffold(对抗性必填,复杂咨询性建议填)、Outcomes & Learnings(留空,由 /archive 填充)。

提交:计划文件须在交接给 /review 前提交:git -C "$WORKTREE" add ai-workspace/plans/<name>.md 与 git -C "$WORKTREE" commit -m "blueprint: <name>"。因为 /review 针对已提交状态工作;若跳过,会话崩溃或 /clear 会丢失头脑风暴成果,恢复路径见 ADR-008(refs/wip/checkpoints/<branch> Stop-hook backstop)。

Target 检测:通过 git reflog show HEAD --pretty=format:'%gs' 查找 "branch: Created from" 得到默认目标分支并去除 origin/ 前缀,为空时回退 main;纯 git 实现,无需额外工具。

威胁模型选择:内部工具、重构、文档、测试、配置用 advisory;认证、密钥、输入校验、CI、钩子、权限用 adversarial;不确定用 adversarial。

限制:不要在本技能中审查蓝图(属 /review)、不要开始实现、不要跳过任何模板字段、未提交前不得进入 /review;若头脑风暴发现任务仅一句话范围则说明并跳过;步骤须是可勾选的具体动作并显式包含测试步骤,TDD 合同下测试需与实现列为不同任务;不得调用其他规划技能。

完成后报告:计划路径、威胁模型、步骤数,以及下一步 /review(第 4 步)。