让 Claude 像资深工程师一样干活：SpecWeave 这套 spec-first 框架值得开发者认真看看

做了这么多年开发，最近越来越觉得：让 AI 写代码不难，难的是让 AI 像资深工程师一样工作。今天聊一个我盯了几周的小众框架——specweave，把 spec-first 理念做到了 CLI 层，而不是停在 markdown 文档里。

为什么大多数 skill 都缺一块

你看 obra/superpowers 强调 TDD，garrytan/gstack 走 role-based 流程，主流插件的共同问题是：流程再严，最后还是把 spec 写完就忘了。Claude 完成 plan.md，第二天的新会话读不到，agent 继续拍脑袋瞎写。

specweave 的解法很工程化：

• Append-only ledger：每次 task claim / done 都写进 ledger.jsonl，跨会话、跨工具共享状态
• 六个命令闭环：create-increment → task next/claim/done → verify → review → complete，每一步强制依赖上一步的产物
• spec.md 必填 + AC 编号：写不出验收标准？specweave done 直接拒绝关闭

它跟 GSD（get-shit-done）的本质区别

同样是 spec-driven，GSD 把 spec 塞进 plan 里，specweave 直接做成了增量（increment）单元。每个 .specweave/increments/NNNN-slug/ 是一个独立单元，含 spec / tasks / ledger / handoff / reports，可以原子化合并。

更狠的是 sw:team——多个 agent 在 git worktree 里并行干活，claim 用 ledger 仲裁，不会出现两个 agent 改同一个文件的惨剧。这不是 plugin 玩具，是真的能跑 20+ 微服务的中型团队用的东西（看作者用 EasyChamp 跑了 4 年生产）。

跨工具 + 自带 NPM CLI

这是我最喜欢的设计：npm install -g specweave 之后，specweave init . 会在任何 AI 工具里生成一致的项目结构。Claude Code、Codex、Cursor、Copilot 都能跑同一套 spec/ledger，因为它本质是文件系统协议，不是 prompt 魔法。

对团队协作也友好：specweave sync-github / sync-jira / sync-azure-devops 直接跟现有工单系统打通，不会变成另一个文档孤岛。

实操怎么用

npm install -g specweave     # Node 20.12+
cd your-project
specweave init .
specweave create-increment "add user auth via OAuth2"
# → 生成 spec.md（Problem / Scope / ACs / Approach），等你 approve 才往下走
/sw:do                         # Claude Code skill 触发 claim → implement → test → done
specweave verify               # 跑测试 + 写 verify.json
/sw:review                     # 独立 fresh-context 评审
specweave complete 0001        # verify.json 绿色才能关

我的判断

160 stars（2026 年 9 月数据），不算火，但完成度极高。如果你的痛点是「AI 写代码没规矩、AI 干活不闭环、AI 跟工单脱节」，specweave 是当下少有的把这三件事串起来的工程化方案。比一堆 prompt 模板扎实得多。

GitHub 链接：https://github.com/anton-abyzov/specweave

GitHub: https://github.com/anton-abyzov/specweave