lilinxin75 / task_kit

# Task Kit
**管理任务版 Spec Kit — 把契约化开发思想迁移到职场任务的结构化工作系统**
*任务澄清 → 方案编制 → 答疑确认 → 执行追踪 → 复盘沉淀*
**简体中文** | English
---
## 📖 这是什么
Task Kit 把 GitHub Spec Kit 的四个核心机制——**markdown 契约、阶段化命令、产物落盘、状态跟踪**——从代码开发迁移到管理工作任务。系统状态全部落盘在文件里而不在对话里，跨会话可续接，跨 agent 可迁移。
Spec Kit 的核心理念：**先定义"做什么、为什么做"，再决定"怎么做"**，规格本身就是后续执行的可执行契约。放到管理任务上，就是在三个失败节点设置强制对齐闸门：
| 任务失败模式 | Task Kit 的闸门 |
|---|---|
| 任务理解偏差（做完才发现方向错） | 阶段一：五要素澄清 + 复述确认 |
| 方案未对齐就开干（两周工作被一句话推翻） | 阶段三：SCQA + 选择题评审 |
| 执行中前提变了没人叫停 | 契约校验 + 沉没成本停机规则 |
写方案阶段的修改成本约为执行阶段的 1/10、汇报失败后的 1/100——本系统的全部设计就是把返工成本前置到最便宜的阶段。
## 🗺️ 与 Spec Kit 的命令映射
| 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 都能执行
## 📦 安装
### WorkBuddy（原生技能）
 [code] 
重启会话后按语义自动触发，说「task.init 某项目」即可。
### Claude Code（Agent Skills，推荐）
 [code] 
Claude Code 与 WorkBuddy 使用同一套 SKILL.md 规范，按需自动加载。
### Claude Code（斜杠命令，备用）
 [code] 
之后用 `/task-kit 推进XX任务` 调用。
### claude.ai（网页版）
Settings → Capabilities → Skills 上传本仓库 zip（SKILL.md 须在顶层或一级目录内）。
### Cursor / ChatGPT / 其他 Agent
把 `adapters/portable-rules.md` 全文粘贴进规则文件（`.cursorrules`、Custom Instructions、system prompt 等）。该版本自包含，模板结构已内联。
## 🆕 v2.0.0 — 流程阶段分隔
- **阶段硬停止**：每条阶段命令（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 调整）
### v2.0.0 迁移说明（旧项目两步操作）
1. 任务目录上移：`mv .t