换会话、换工具、换人，
项目都能接着干

每项需求为什么做、定了什么、做到哪，都跟代码一起存在 Git 里

  • 一个人同时开几个会话、用几个 AI 工具
  • 团队几个人一起做一个项目
一项需求写成一段乐谱：会话 A 用 Claude Code 定需求、实现、验证；换到会话 B 用 Codex 审查、修复、重测、再审；最后你拍板，整段存进 Git。

上下文归项目，不归某个人

AI 工具自带的记忆是围着人设计的，BuildBeat 是围着项目重新设计的。

01 · 换人、换工具都还在

  • 工具自带的记忆

    记在某个人的账号里、某台电脑上

    BuildBeat

    跟代码放在同一个 Git 仓库里，拉下代码就有

  • 工具自带的记忆

    同事接手你的模块时看不到

    BuildBeat

    你、同事、新会话、另一个 AI 工具读的是同一份

  • 工具自带的记忆

    你离开项目，来龙去脉也跟着没了

    BuildBeat

    人走了，来龙去脉还留在项目里

  • 工具自带的记忆

    改了什么、为什么改，没处对照

    BuildBeat

    跟代码一起进 PR 审查、一起留版本历史

  • 工具自带的记忆

    换个 AI 工具就用不上

    BuildBeat

    用什么 AI 工具都能读，没装 BuildBeat 也能读

记录是干活时顺手留下的，做没做完看证据

需求文档和决定记录，大家都知道该写，但没人有空写，写了也很快过时。在 BuildBeat 里不用另外写；AI 说「改好了」也不算数，要看测试和审查的记录。

02 · 做完再留一份 result.md

work.md1 / 4

delivery/work/WORK-LOGIN-REMEMBER/work.md

# 登录记住我

登录页加「记住我」，勾上后 7 天免登录；测试全过才算完。

你行，开工。

点头记进 decisions.jsonl，谁、什么时候同意的都在

这份文档别人读不读得懂也能试：让一个没看过任何上下文的只读 AI 只读这一份，看它读出了什么、哪里只能猜。

一项工作，就是一份写好的乐谱

一个你能看到的结果，比如登录页加个「记住我」，就是一项工作。要做什么、每一步怎么走的、审出过什么、你拍过什么板，都写在这份谱上，跟代码一起存在 Git 里。谁接手都从这里接着干，回头也能翻出来看它是怎么做成的。

03 · 一项工作一个文件夹

delivery/work/WORK-LOGIN-REMEMBER/CLOSED
「登录记住我」这项工作写成一份乐谱：起草时你点头开工；第 1 轮实现、验证、审查，审出没勾也记住了；第 2 轮修复、重测、再审，没有新问题；最后你在 10 月 25 日 14:02 批准，尾声写着做成了什么。
标题和开头的说明
work.md
要做什么、做到什么算完
音符
runs/RUN-*/run-record.json
每一轮走了哪几步，结果、证据和成本
音符上的问题
review-findings.jsonl
审查挑出的问题，和你怎么裁决
落款
decisions.jsonl
谁、什么时候点头、批准、关窗
终止线后的尾声
result.md
做成了什么、还剩什么

从一行代码，查回当初的需求

三个月后看到一段代码，没人记得当时为什么这么写，问 AI 它也只能猜。指着这行代码，就能查出它是为哪项需求写的、当时定了什么、谁批准的。

04 · 也能按工单号查

src/login.jsJavaScript
// 登录：勾了「记住我」就保持 7 天，没勾关掉浏览器就要重新登录const WEEK = 7 * 24 * 60 * 60;export function sessionCookie(token, remember) {  const maxAge = remember ? WEEK : undefined;  return { name: "session", value: token, maxAge, httpOnly: true };}
终端
$ buildbeat history --repo . --path src/login.js:5
src/login.js:5 — 1 line, 1 work
  WORK-LOGIN-REMEMBER  CLOSED  登录记住我 (1 line; via run RUN-LOGIN-REMEMBER-02; via Work trailer)
    approved: 2026-10-25T06:02:00.000Z by you (person) (RUN-LOGIN-REMEMBER-02)
    closed: 2026-10-25T06:10:00.000Z by you (person)
    result: 勾上「记住我」7 天免登录；第 1 轮审查发现没勾也记住了，已修好并重新测过。
    read: delivery/work/WORK-LOGIN-REMEMBER/work.md, delivery/work/WORK-LOGIN-REMEMBER/result.md

用起来是什么样？用平常的话说就行

装好之后，你只管说要做什么，命令都由 AI 来跑。它会停下来找你的情况只有几种：工作说明要你确认、审完等你拍板、审查的问题要你裁决、环境出了问题。

05 · 点开看对话

  • 登录页加个「记住我」。
    AI
    写好了 work.md：勾上「记住我」7 天免登录，测试全过才算完。你看行吗？
    行，开工。

开始用：把这段话复制给你的 AI 编程工具

Claude Code、Codex、Cursor 都行，它会自己装好、配好，弄好后告诉你可以开始了。

复制给 AI
请帮我在这个项目里用上 BuildBeat（https://github.com/HaiYangBG1/BuildBeat）：

1. 检查本机有没有 Node 20 以上和 Git，缺了就告诉我怎么装。
2. 安装或升级 BuildBeat 运行时：
   npm view @haiyangbg/buildbeat@latest version
   npm install --global @haiyangbg/buildbeat@latest
   buildbeat --version
   如果本机装的是 6 以前的版本，并且还有没跑完的工作，先用旧版跑完或取消，再升级。
3. 读一遍 npm 包里的 SKILL.md 和 docs/guide/01-quickstart.md（在 $(npm root -g)/@haiyangbg/buildbeat/ 下），之后都按 SKILL.md 的方式干活。
4. 按快速开始把模板放进这个项目、补好 .gitignore。代码由你来写；审查默认用本机已登录的另一个 AI 命令行工具，拿不准就问我。
5. 弄好后用一两句话告诉我可以开始了。之后我只用平常的话跟你说要做什么，命令都由你来跑。
用 Claude Code？也可以装插件
/plugin marketplace add HaiYangBG1/BuildBeat
/plugin install buildbeat@buildbeat-plugins
/buildbeat:buildbeat
想自己动手一步步装
npm install --global @haiyangbg/buildbeat
看快速开始
不想装 Node 或运行时
只让 AI 工具读项目文件，大部分照样能用；从代码查需求、自己读测试结果、代码变了的提醒需要运行时。只用 Skill 和项目文件