Task Kit 把 GitHub Spec Kit 的四个核心机制——markdown 契约、阶段化命令、产物落盘、状态跟踪——从代码开发迁移到管理工作任务。系统状态全部落盘在文件里而不在对话里，跨会话可续接，跨 agent 可迁移。
Spec Kit 的核心理念：先定义"做什么、为什么做"，再决定"怎么做"，规格本身就是后续执行的可执行契约。放到管理任务上，就是在三个失败节点设置强制对齐闸门：
| 任务失败模式 | Task Kit 的闸门 |
|---|---|
| 任务理解偏差（做完才发现方向错） | 阶段一：五要素澄清 + 复述确认 |
| 方案未对齐就开干（两周工作被一句话推翻） | 阶段三：SCQA + 选择题评审 |
| 执行中前提变了没人叫停 | 契约校验 + 沉没成本停机规则 |
写方案阶段的修改成本约为执行阶段的 1/10、汇报失败后的 1/100——本系统的全部设计就是把返工成本前置到最便宜的阶段。
| Task Kit | Spec Kit | 动作 |
|---|---|---|
task.constitution |
/constitution |
项目宪法：使命/价值优先级/决策原则/红线，约束所有任务 |
task.new |
/specify |
建任务目录，specify 新任务 |
task.clarify |
/specify + /clarify |
五要素澄清 → 复述确认 → 问题定义书 |
task.plan |
/plan + /tasks |
MECE 议题树 + 优先级打分 + 可证伪假设 + 行动计划 |
task.review |
规格评审 | SCQA 汇报稿 + 方案 A/B/C 选择题 + 拍板记录 |
task.check |
/analyze |
宪法合规 + 跨产物一致性 pass/fail 校验 |
task.track |
/implement |
五段式周志 + 契约校验（追溯/假设/预警） |
task.aar |
/converge |
四问复盘，项目级规则晋升进宪法 |
task.init / task.done |
— | 项目初始化 / 任务收尾（生命周期补充） |
- 宪法先行 — 项目级
CONSTITUTION.md约束所有任务，AAR 产出的项目级规则可晋升进宪法（带来源任务与修订记录） - 阶段硬停止 — 每条阶段命令停在自己的边界上，输出阶段完成报告；连跑需显式授权且闸门必停，用户始终掌握推进节奏（v2.0.0）
- 任务循环 — 项目内多任务生命周期：
init → constitution → new → clarify → plan → review → track → aar → done → 下一个任务 - 产物落盘 — 每个任务一个目录、六份 markdown 文件，
00-STATE.md是跨会话续接的锚点 - 轻量对齐 — 给决策人做选择题（A/B/C + 推荐 + 风险 + 预案），一页纸、≤15 分钟、结论前置 30 秒
- 按返工成本裁剪 — 日常事务型 30 秒过五要素即可，专项任务型才跑全五段，突发问题型事后补 AAR
- 零依赖 — 纯 markdown，无代码、无运行时，任何能读文件的 agent 都能执行
cp -r core/ ~/.workbuddy/skills/task-kit/重启会话后按语义自动触发，说「task.init 某项目」即可。
cp -r core/ ~/.claude/skills/task-kit/Claude Code 与 WorkBuddy 使用同一套 SKILL.md 规范，按需自动加载。
mkdir -p .claude/commands && cp adapters/claude-code-command.md .claude/commands/task-kit.md之后用 /task-kit 推进XX任务 调用。
Settings → Capabilities → Skills 上传本仓库 zip（SKILL.md 须在顶层或一级目录内）。
把 adapters/portable-rules.md 全文粘贴进规则文件（.cursorrules、Custom Instructions、system prompt 等）。该版本自包含，模板结构已内联。
- 阶段硬停止：每条阶段命令（constitution/new/clarify/plan/review/track/aar/done）完成自身产物与闸门后停止，输出「阶段完成报告」（产物清单 / 当前状态 / 下一步）；用户未授权禁止自动推进下一阶段
- 连跑授权：说"接下来连着跑"授权推进 1 个阶段（"连跑 N 个阶段"=N）；两个确认闸门（复述确认、三拍板）在授权下仍然必停；授权存于 00-STATE 跨会话持久；不提供无上限连跑
- 回溯规则：假设被推翻/方向变更按回溯边表回到 review 或 clarify，到达目标阶段即停
- 深入沟通：clarify 最多 2 轮提问（每轮 ≤6 问）；plan 只做分析展示与权衡讨论（调研落 06-research.md），正式 A/B/C 方案留给 review；plan/review 新增"分析记录/沟通过程"留痕字段
- 目录契约 v2：
tasks/上移至项目根（对齐 Spec Kit 的specs/模式）；01-problem.md更名01-task.md；新增00-state.md（frontmatter 状态卡）、06-research.md（调研记录）、quickstart.md（首个 task.new 生成）；根级materials/（共享素材库）与outputs/（共享输出），任务级materials//outputs/分工明确 - 回溯边表：track→review（假设推翻）、track→clarify（方向性推翻）、review→plan（方案被否）、review→clarify、plan→clarify
- quickstart 就位：
quickstart.md由首个task.new生成到任务目录（仅一次），不再生成于项目根（v2.0.1 调整）
- 任务目录上移：
mv .task-kit/tasks ./tasks（然后可删除空的.task-kit/tasks/） - 任务定义书更名：在每个任务目录内
mv 01-problem.md 01-task.md
你：task.init 仓储系统选型
AI：建立 .task-kit/ 骨架。项目还没有宪法，建议先立：这个项目的价值优先级是什么？
你：task.constitution（…对话后生成 CONSTITUTION.md）
你：task.new Picking 方案调研
AI：建任务目录。先澄清五个要素——这件事为什么现在做？成功标准是什么？…
你：（回答后）
AI：复述确认："我理解这件事是……最终要交……" 确认后落盘问题定义书。
你：task.plan / task.review / task.track / task.aar …
任务产物落盘在当前项目根目录（v2.0.0 布局）：
项目根/
├── .task-kit/
│ ├── CONSTITUTION.md # 项目宪法
│ ├── PROJECT.md # 项目索引 + Backlog
│ └── scripts/task-new.sh
├── materials/ # 共享素材库（导入整理归类）
├── outputs/ # 跨任务共享输出
└── tasks/NNN-slug/
├── 00-STATE.md # 状态卡（跨会话续接锚点，含连跑授权余量）
├── 01-task.md # 任务定义书
├── 02-plan.md # 方案骨架
├── 03-review.md # 评审卡
├── 04-log.md # 执行周志（追加式）
├── 05-aar.md # 复盘卡
├── 06-research.md # 调研记录（按需）
├── quickstart.md # 快速上手（首个 task.new 生成）
├── materials/ # 任务私有素材
└── outputs/ # 任务默认输出
task_kit/
├── README.md # 本文件（简体中文）
├── README.en.md # 英文版
├── LICENSE # MIT
├── docs/
│ └── spec-driven.md # 方法论详解：底层逻辑、五段式拆解、裁剪规则
├── core/
│ ├── SKILL.md # 工作流定义（Agent Skills 标准格式）
│ ├── scripts/
│ │ └── task-new.sh # 可选脚手架：自动分配三位编号建任务目录
│ └── templates/ # 11 个契约模板
│ ├── 00-constitution.md # 项目宪法（版本号 + Sync Impact Report + Governance）
│ ├── 00-project.md # 项目索引
│ ├── 00-state.md # 任务状态卡（frontmatter + 状态卡四栏）
│ ├── 01-task.md # 任务定义书（五要素 + 澄清记录 + 复述确认）
│ ├── 02-plan.md # 方案骨架（含分析记录/沟通过程）
│ ├── 03-review.md # 评审卡（含分析记录/沟通过程）
│ ├── 04-log.md # 执行周志
│ ├── 05-aar.md # AAR 复盘卡
│ ├── 06-research.md # 调研记录（按需）
│ ├── quickstart.md # 快速上手（首个 task.new 生成到任务目录）
│ └── checklist.md # 质量门清单（task.check 落盘用）
└── adapters/
├── claude-code-command.md # Claude Code 斜杠命令适配
└── portable-rules.md # 任意 Agent 通用规则（自包含）
- 任务目录编号化：
tasks/NNN-slug/（如tasks/001-rgbd技术调研/），三位序号保证排序与跨会话定位，兼容旧的无编号目录 - 宪法修订纪律：版本号语义化（MAJOR/MINOR/PATCH）+ 文件头 Sync Impact Report 块 + Governance 修订规则
- 质量门落盘：
task.check产出checklists/<类型>.md，CHKxxx 编号、reviewer-owned 语义（[x]= 复核通过，≠ 做完） - 任务目录扩展区：
00-05核心编号保留；素材进materials/，质量门进checklists/，任务特定产物从06起编号 - 闸门语义显式化：clarify/review 为 approve/reject 门，未过闸不得进入下一阶段
- 可选脚手架：
core/scripts/task-new.sh自动分配编号并初始化 00-STATE.md（bash 零依赖，无脚本时按编号规则手工执行）
McKinsey 七步法 / MECE / 金字塔原理（SCQA）提供骨架；假设驱动（Day-1 answer）与收益闭环来自咨询业通行实践；PDCA 提供闭环；Spec Kit 提供契约化与阶段闸门的工程化形式。重型咨询交付件（steering committee、多工作组、QC 链）被有意裁剪——本系统定位是个人与中小团队的工作法，不是咨询公司交付方法论。详见 docs/spec-driven.md。
欢迎提 Issue / PR：新增任务类型裁剪规则、新平台适配器、模板改进。