blueprint

/blueprint

为当前任务编写规范的 ai-env 蓝图（计划文件）。要求先运行 /orient。

执行顺序

1. 检查前置条件。 确认工作树存在，且 /orient 已识别任务。如果没有，则停止并告知用户。
2. 头脑风暴（一轮）。 根据任务描述调用 /brainstorming。仅进行一轮——确定方向，不要反复讨论。
3. 读取模板。 从仓库根目录读取 ai-workspace/plans/TEMPLATE.md。
4. 编写计划。 创建 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	adversarial 必填；复杂的 advisory 建议填写。
Outcomes & Learnings	留空——由 /archive 填写

5. 提交计划。 在交接给 /review 之前暂存并提交计划文件：

   git -C "$WORKTREE" add ai-workspace/plans/<name>.md
   git -C "$WORKTREE" commit -m "blueprint: <name>"
   

   这是必需步骤，因为 /review 基于已提交的状态执行。如果写完计划后、运行 /review 前会话崩溃或执行 /clear，头脑风暴的成果就会丢失。若跳过此步骤，可参见 ADR-008（refs/wip/checkpoints/<branch> 停止钩子后备机制）了解恢复方法。

检测目标分支

默认的 Target 是创建当前分支时所基于的分支，从 reflog 中读取：

TARGET=$(
  git reflog show HEAD --pretty=format:'%gs' \
    | grep "^branch: Created from" \
    | head -1 \
    | sed 's/branch: Created from //' \
    | sed 's|^origin/||'
)
TARGET=${TARGET:-main}

如果 reflog 为空（Web 会话、从分离 HEAD 创建分支），则回退到 main。如果用户没有明确指定 Target，请始终使用此方法。纯 Git 操作——在任何环境中都可使用，无需安装工具。

威胁模型选择

信号	模型
内部工具、重构、文档、测试、配置	advisory
身份验证、机密、输入验证、CI、钩子、权限	adversarial
不确定	adversarial

防护原则

• 不要审查蓝图。此任务属于 /review（第 4 步）。
• 不要开始实施。蓝图就是交付物。
• 不要跳过任何模板字段。
• 未先提交蓝图文件，不要继续执行 /review。
• 如果头脑风暴发现任务只有一句话的工作范围，请明确说明并跳过。
• 范围上限值是固定的——不要更改。
• 步骤必须是带复选框的具体操作，不能是含糊的阶段描述。
• 明确列出测试步骤。如果测试需要由单独的作者负责（TDD 契约），请将其作为与实施不同的独立任务列出，以便 /build 分别分派测试编写者和实施者。
• 不要调用其他规划技能；此技能负责编写 ai-env 计划。

输出

编写完成后，报告：

Plan written: ai-workspace/plans/<name>.md
Threat model: advisory|adversarial
Steps: <count>
Next step: /review (Step 4)