【AI工具】Task Kit：把 Spec Kit 的契约化思想搬来管日常工作

文章目录

- 一、日常工作里的任务，是怎么翻车的
- [二、Task Kit 是什么：给日常工作补上 Spec Kit 那一层](#二、Task Kit 是什么：给日常工作补上 Spec Kit 那一层)
- 三、五段式工作流实际跑起来是什么样
- 四、按返工成本裁剪：不是所有任务都值得跑全流程
- [五、安装：WorkBuddy / Claude Code / Cursor 多平台](#五、安装：WorkBuddy / Claude Code / Cursor 多平台)
- - [WorkBuddy / Claude Code（Agent Skills，推荐）](#WorkBuddy / Claude Code（Agent Skills，推荐）)
  - [Claude Code（斜杠命令，备用）](#Claude Code（斜杠命令，备用）)
  - [Cursor / ChatGPT / 其他 Agent](#Cursor / ChatGPT / 其他 Agent)
- 六、适合谁，不适合谁
- 七、FAQ

Task Kit 是一款开源（MIT）的工作任务管理系统，以 Agent Skill 形式分发，把 GitHub Spec Kit 的契约化开发思想迁移到日常工作 ：项目宪法约束所有任务，任务按五段式（任务澄清 → 方案编制 → 答疑确认 → 执行追踪 → 复盘沉淀）推进，所有产物落盘为 markdown 文件，支持跨会话续接、宪法校验与按返工成本裁剪。本文给出 Task Kit 与 Spec Kit 的逐环节对标、三类典型任务失败模式的闸门设计、WorkBuddy / Claude Code / Cursor 多平台安装方法与常见问题解答。

TL;DR：把 AI Agent 变成任务管理搭子，两条命令装好
bash 复制代码
git clone https://gitee.com/lilinxin75/task_kit.git
cp -r task_kit/core ~/.workbuddy/skills/task-kit/   # WorkBuddy 用户
# 或 cp -r task_kit/core ~/.claude/skills/task-kit/  # Claude Code 用户
之后对 AI 说一句 task.init 某项目，它会引导你走完五段式：任务澄清 → 方案编制 → 答疑确认 → 执行追踪 → 复盘沉淀。所有状态落在 .task-kit/ 目录的 markdown 文件里，不在对话里，跨会话可续接。

仓库地址：https://github.com/lilinxin75/task_kit ｜ https://gitee.com/lilinxin75/task_kit （MIT，纯 markdown，零依赖）

一、日常工作里的任务，是怎么翻车的

日常工作里的任务返工，原因归纳起来逃不出三类：输出结果不达标、沟通不到位、需求变更。

失败模式	典型场景
输出结果不达标	接到"调研一下 XX"的任务，交付物是什么没确认清楚，埋头做完，交出去的是调研报告，对方要的是选型建议。方向从第一天就是偏的
沟通不到位	方案没和干系人对齐就闷头推进，中途无人确认，收尾时才发现双方理解差了一截，全部重来
需求变更	执行到一半需求或前提变了，没人明确叫停，旧方案被硬推完，做了一堆无用功

这三类问题表面看是执行出了差错，根子都在前面：该对齐的节点没对齐。返工成本发生在最贵的阶段，写方案阶段的修改成本大概是执行阶段的 1/10，是收尾推翻后的 1/100。日常任务和代码不一样，代码有 Spec Kit 这类工具把规格变成契约，任务管理基本靠脑子和聊天记录。

用 AI Agent 辅助工作还有一个更直接的痛点：任务状态在对话里，不在文件里。上周和 AI 讨论到一半的方案，这周开新会话，它全忘了，背景得重新讲一遍。对话式交互舒服，但对持续两周以上的任务来说，对话本身就是最不可靠的存储。

二、Task Kit 是什么：给日常工作补上 Spec Kit 那一层

先看一张对照表。写代码这件事，这两年被 Spec Kit 这类工具武装到了牙齿：需求有规格、规格有契约、执行有追踪、经验有沉淀。而日常工作干的其实是同一件事：接需求、出方案、执行、交付，对应的支撑却基本是空的。

环节	代码开发：Spec Kit 的解法	日常工作：过去靠什么	Task Kit 的对应物
立项目规则	`constitution.md`，约束所有规格	基本没有	`CONSTITUTION.md` 项目宪法（`task.constitution`）
定义需求	`/specify`，spec.md 规格即契约	口头传达、聊天记录	`01-problem.md` 问题定义书（`task.clarify`）
拆方案	`/plan` + `/tasks`	想到哪干到哪	`02-plan.md` 议题树 + 优先级打分（`task.plan`）
对齐评审	规格评审	开会凭感觉	`03-review.md` SCQA 汇报稿 + A/B/C 选择题（`task.review`）
执行追踪	`/implement`	周报，写完没人看	`04-log.md` 五段式周志 + 契约校验（`task.track`）
一致性检查	`/analyze`	没有	`task.check`，产物间 pass/fail 校验
沉淀经验	`/converge`	散落在工单和邮件里	`05-aar.md` 四问复盘，规则晋升宪法（`task.aar`）

两边是同构的。Spec Kit 用四个机制，markdown 契约、阶段化命令、产物落盘、状态跟踪，让 AI 写代码有章法；Task Kit 把同一套机制原样搬到工作任务上。理念也是同一句：先定义"做什么、为什么做"，再决定"怎么做"，规格本身就是执行的契约。

落到日常工作，这套对标不是概念游戏，它补上的是三样最容易丢的东西：

明确的规格：问题定义书落盘，交付物、成功标准、范围边界写下来，不留歧义。
可追溯的状态：执行到哪、拍板了什么、假设是否还成立，翻文件不翻回忆。
可复用的经验：复盘产出的是可执行规则而不是感受，项目级规则晋升进宪法，下一个任务直接继承。

整体结构可以用几个数字概括：2 份项目级文件 （宪法 + 项目索引），每个任务 6 份产物文件 ，11 条语义命令 ，5 个推进阶段。

在此基础上，Task Kit 在三个跑偏节点上设了强制闸门：

跑偏节点	Task Kit 的闸门
输出结果不达标	阶段一：五要素澄清 + AI 复述确认，确认后才落盘问题定义书
沟通不到位	阶段三：SCQA 汇报稿 + 方案 A/B/C 选择题，决策人拍板后才进执行
需求变更	执行中假设被推翻，强制回到阶段三重走确认，不允许硬推

项目层面还有一层约束：先立 CONSTITUTION.md（项目宪法），写清楚这个项目的价值优先级、决策原则和红线。之后每个任务的产物都要过宪法校验，冲突即停。复盘沉淀下来的项目级规则，可以晋升进宪法，越用越贴合。

三、五段式工作流实际跑起来是什么样

以一个选型任务为例（节选），从 task.new 开始：

复制代码

你：task.new 仓储系统选型
AI：建任务目录。先澄清五个要素，这件事为什么现在做？成功标准是什么？
    范围边界在哪？关键前提有哪些？最终要交付什么？
你：（回答后）
AI：复述确认："我理解这件事是......最终要交......" 确认后落盘 01-problem.md
你：task.plan
AI：基于问题定义书拆 MECE 议题树，按收益/成本打分排序，列可证伪假设
你：task.review
AI：把方案压缩成一页纸：SCQA 汇报稿 + 方案 A/B/C + 推荐项 + 风险 + 预案

三个设计值得单独说：

1. 澄清阶段 AI 只问一轮，然后复述确认。 不是无限追问，最多六个问题，问完它用自己的话复述一遍给你确认。这一步挡掉了大部分理解偏差，成本是五分钟。

2. 评审阶段给决策人出选择题，不出问答题。 方案 A/B/C 加推荐项加风险预案，一页纸，口头汇报 15 分钟以内，结论前置 30 秒能说完。决策人的时间是稀缺资源，让他做选择比让他想方案成本低得多。

3. 状态全部落盘。 每个任务一个目录六份文件：

复制代码

.task-kit/
├── CONSTITUTION.md        # 项目宪法
├── PROJECT.md             # 项目索引 + Backlog
└── tasks/<任务slug>/
    ├── 00-STATE.md        # 状态卡，跨会话续接的锚点
    ├── 01-problem.md      # 问题定义书
    ├── 02-plan.md         # 方案骨架
    ├── 03-review.md       # 评审卡 + 拍板记录
    ├── 04-log.md          # 执行周志，追加式
    └── 05-aar.md          # 复盘卡

新开会话，AI 读一眼 00-STATE.md 就知道任务推到哪了。执行有争议的时候回到文件校验，不靠回忆。

四、按返工成本裁剪：不是所有任务都值得跑全流程

这点是它没有变成形式主义的关键。Task Kit 按返工成本裁剪：

任务类型	保留阶段
日常事务型（例行周报、常规审批）	30 秒过五要素，直接干，不落盘
临时协调型（跨部门拉通、临时会议）	澄清 + 口头方案确认，只落盘问题定义书
专项任务型（降本、上线、年度规划）	全五段完整落盘
突发问题型（客诉、事故）	5 分钟澄清就执行，事后补复盘

实际使用时按这个原则取舍：周报这类直接过，选型、方案调研这类跑全流程。工具服务于任务，不是反过来。

五、安装：WorkBuddy / Claude Code / Cursor 多平台

WorkBuddy / Claude Code（Agent Skills，推荐）

bash 复制代码

git clone https://github.com/lilinxin75/task_kit.git   # GitHub，国内可加 fastgit.cc/ 前缀提速
# 或 git clone https://gitee.com/lilinxin75/task_kit.git  # Gitee，国内直连快
cp -r task_kit/core ~/.workbuddy/skills/task-kit/
# Claude Code 用户：cp -r task_kit/core ~/.claude/skills/task-kit/

重启会话后按语义自动触发，说"task.init 某项目"即可。

Claude Code（斜杠命令，备用）

bash 复制代码

mkdir -p .claude/commands && cp task_kit/adapters/claude-code-command.md .claude/commands/task-kit.md

之后用 /task-kit 推进XX任务 调用。

Cursor / ChatGPT / 其他 Agent

把 adapters/portable-rules.md 全文粘进规则文件（.cursorrules、Custom Instructions、system prompt 都行）。这个版本是自包含的，模板结构已经内联。

零依赖，纯 markdown，没有任何代码和运行时，只要 AI 能读文件就能跑。

六、适合谁，不适合谁

适合：

同时挂着 3 个以上持续两周的任务的人
用 AI Agent 干活，但烦于每次开新会话都重新交代背景的人
方案要向他人汇报、经常被一句话推翻的人

不适合：

任务碎片化、当天清零的工作，五段式对你是负担
期待自动化调度工具的，这是工作法不是项目管理软件，没有甘特图没有提醒

七、FAQ

Q1：Task Kit 是什么？

一款开源（MIT）的任务管理工作系统，以 Agent Skill 形式分发。它把 GitHub Spec Kit 的契约化开发思想迁移到日常任务管理：先立项目宪法，任务按五段式推进（任务澄清 → 方案编制 → 答疑确认 → 执行追踪 → 复盘沉淀），每个阶段的产物落盘为 markdown 文件，跨会话可续接，任何能读文件的 AI Agent 都能执行。

Q2：Task Kit 和 Spec Kit 是什么关系？

Spec Kit 是 GitHub 官方的规格驱动开发工具，面向代码开发；Task Kit 是它的工作任务版，四机制同构（markdown 契约、阶段化命令、产物落盘、状态跟踪），命令一一对应（如 task.clarify 对应 /specify，task.plan 对应 /plan），但面向的是日常而非写代码。两者相互独立，装 Task Kit 不需要装 Spec Kit。

Q3：和直接让 AI"帮我规划一下这个任务"有什么区别？

区别在状态存哪。直接对话规划，状态在对话里，会话一关就没了，也没有阶段闸门，AI 给个计划你就开干了，对没对齐没人负责。Task Kit 的状态在文件里，澄清和评审两个闸门不确认不放行。

Q4：产物文件会不会越积越多成为负担？

每个任务固定六份文件，模板都定好了格式，不会膨胀。任务关闭后目录归档，项目索引 PROJECT.md 里只剩一行状态记录。

Q5：方法论来源是什么？

McKinsey 七步法、MECE、金字塔原理（SCQA）提供骨架，PDCA 提供闭环，Spec Kit 提供契约化和阶段闸门的工程化形式。咨询业那套重型交付件（steering committee、多工作组）被有意裁掉了，定位是个人和中小团队的工作法。

Q6：AI 记不住宪法和模板怎么办？

WorkBuddy 和 Claude Code 的 Agent Skills 机制会按语义自动加载 SKILL.md，模板在 templates/ 目录下按阶段对应，生成产物时严格套用。每份产物落盘前还有一道自查：是否违反宪法红线，各产物之间是否互相矛盾（01 目标 vs 02 计划 vs 03 拍板 vs 04 进度），输出 pass/fail 清单。

Q7：可以一个人用吗，还是必须团队？

一个人用完全成立。宪法、评审这些环节看起来像团队流程，实际上"决策人"可以是你自己，价值在于强迫自己在便宜的阶段想清楚，别在贵的阶段返工。