spec-execute
Installation
SKILL.md
spec-execute(I2:执行 / plan.md + 可选 Task Pack)
概览
I2 的目标是把 {FEATURE_DIR}/implementation/plan.md 中的任务按批次执行,运行最小验证,并按模式回写状态(见 design/aidlc_spec_implementation.md、design/aidlc_collaboration.md §3、design/aidlc_tooling_taskpack_skills.md)。
本技能是 skills/executing-plans/SKILL.md 的 Spec 实现阶段版:重度复用其“五步执行 + 批次检查点 + 遇阻塞即停”骨架,但将“计划文件”的语义对齐为:
plan.md(必做):Spec 级编排 SSOT — 范围、依赖、子仓、NEEDS CLARIFICATION、任务清单与任务级完成勾选、Merge-back 待办等。- Task Pack 模式(可选):若
spec-context给出TASK_WORK_BRANCH=true且TASK_PACK_DIR非空,或{FEATURE_DIR}/implementation/tasks/下存在带task.md/status.yaml的子目录,则:- 当前任务的可执行步骤优先以对应
{TASK_PACK_DIR}/task.md(或implementation/tasks/<TASK_DIR>/task.md)为准; - 高频状态(活动阶段、路由状态、验证摘要、
updated_at等)回写到该目录的status.yaml; - 任务完成时仍须在
plan.md将对应 Task 标为- [x]并补摘要级审计(避免多人争改plan.md全文)。
- 当前任务的可执行步骤优先以对应
- 仅 plan 模式(无 Task Pack):与历史一致 — 步骤与状态只在
plan.md。 - 默认每批执行前 3 个未完成任务
- 任何
NEEDS CLARIFICATION/ 关键计划缺陷 / 阻塞:立即停止并汇报(禁止脑补推进) - 若执行中产生决策/契约变更:仅在
{FEATURE_DIR}内草拟,并在plan.md追加 Merge-back 待办清单(本阶段禁止直接更新project/*) - 若仓库存在
.gitmodules:执行前必须根据plan.md校验受影响且required的子仓是否已切到与根项目同名的 Spec 分支