只需编写一次 · 任何智能体、任何项目、任何机器都能运行 · 永不修剪


你的智能体会绘制出整个系统的地图,之后的每次会话都会加载它。

操作手册是只需编写一次的流程——部署、翻译运行、每周报告——可由您的任何智能体在任何项目、任何机器上,以每次完全相同的方式执行。笔记承载会话之间的交接。而图谱正是操作手册所成就的:您的智能体根据代码和运行中的系统绘制整个系统的地图,之后的每次会话都以它开场。

免费套餐 · $0 · 每个套餐均含操作手册和笔记

流程只需编写一次。每个智能体都会执行它。

操作手册就是普通的 markdown:各阶段用标题、命令用代码块、之后要读回什么以确认成功。它为整个账户存储,而非单个项目——项目彼此独立,流程共享。任何智能体都能获取它并在自己的工具中运行。说一句"把这个存为操作手册",它就是一份操作手册。说一句"使用部署操作手册",它就会运行——通常您甚至不必开口:与某份操作手册匹配的提示,会在智能体开始作答之前把手册递到它手上。

永不修剪

精选记录保存当前的真相,并随真相推移而整理。操作手册保存的是怎么做,没有人会修剪流程。您为部署写的那个 md 文件,在线路第一次变动时就过时了,再也没人打开——而操作手册每次都会被即将执行它的智能体打开。花了一周才找到的方案,会保持被发现时的原样。

处处以相同的方式执行

五个智能体做一个项目,或一个智能体管五台机器——部署都是同一个部署。您在某次运行中学到的东西,从此每次运行都知道。

📋

以可以直接交给同事的方式撰写

步骤、确切的命令、之后需要检查什么、上次出了什么问题以及何时出现的。你的智能体会在同一会话中记录下执行过程中学到的东西。

笔记——交接

会话停在哪里、哪些在运行、接下来做什么——由你的智能体撰写,按项目保存,最近五条始终随手可用。下次会话以它开始。启动电脑,说“继续”,它就会接着做下去。

图集:一张保持准确的整个系统地图

图谱是一份教您的智能体如何为项目绘制地图的操作手册——而它画出的地图本身就是一份操作手册,因此每次会话都能打开它。每个项目一张根地图:组件、连线及其上传输的内容、存储,以及图版索引。四到八张图版,每张对应系统的一个层面,相关流程就放在所属的图版内。您的智能体会阅读代码和运行中的系统,在写下地图的任何一行之前验证每一条连线。

地图的三条规则

  • 拓扑只在根图中绘制一次。图版绝不重述连线;它只承载自己的细节和流程。重复是偏差的起点,因此从构造上就不存在重复。
  • 地图上不存放任何数值。没有端口、电容、价格或数量——页面只说明数值存放在哪里,而不说明它是什么。携带数值的地图一周之内就会出错。
  • 谁改动了连线,就在同一会话中更新地图。根图中有一行——已于 <date> 针对 <what> 验证——读者对地图的信任也仅止于此。

根图所包含的内容,按顺序排列

  • 用两句话说明这个项目是什么,以及验证行。
  • 图表:方框和箭头,每条连线一个箭头,并标明其上传输的内容。方向比页面上其他任何东西都重要。
  • 连线列表:由谁发起、传输什么、绝不传输什么。正是这一节能识破谎言。
  • 存储区:状态所在的每一处、它保存什么、它绝不保存什么。
  • 索引:每张图版按名称列出,每项流程按图版和章节列出。

图版包含什么

  • 对于其层面的每个部分:它是什么、保存什么、与什么通信以及方向、它绝不做什么,以及运行时会发生什么。
  • 数值存放在哪里——只有指针,绝无数值。
  • 它的流程:确切的命令、查看什么以确认操作成功,以及实际出过什么问题,附日期。

某个星期二,您的智能体打开地图,看到它即将触碰的那条连线,并在做出任何更改之前先核对验证行上的日期。

my-app-map — verified 2026-09-04 against commit a1b2c3d and the live containers

  browser ──(requests, session cookie)──▶ api ──(SQL)──▶ postgres
                                          │
                                          └──(jobs)──▶ worker ──(files)──▶ object store

Wires: the browser never talks to the worker; the worker never reads a cookie.
Stores: postgres (users, orders — never card numbers) · object store (uploads).
Plates: my-app-map-api · my-app-map-worker · my-app-map-data · my-app-map-ops
Procedures: deploy → my-app-map-ops, deploy · restore → my-app-map-data, restore

对你的智能体说一句话

图谱法随你的记忆一同提供——从第一次会话起,它就在你的操作指南中。为项目绘制图谱只需一句话,而图谱自身的最后一步会确保之后的每次会话都知道图谱的存在。

1 · 已就位

这些方法随你的记忆一同提供。

atlas、plan以及prospectus从第一轮会议起就存在于您的工具包中,两个版本都是如此。它们属于您:对其中任意一份进行修改后,其内容仍会保持原样。当某个项目尚未有相关文件时,您的代理就会提供这些文件。

2 · 每个项目

让地图绘制完成

在项目中,告诉你的代理:使用 playbook atlas 为这个项目绘制地图。它会读取代码和运行中的系统,核实每一条连接,并写出根地图及其各分图。

3 · 由该方法完成

项目知道自己拥有一张地图

该方法的最后一步会为项目保存一条规则:地图存放在哪里,改动线路前先读取它,并在同一会话中更新它。从今往后,每次会话开启时都知道地图就在那里。

操作指南、笔记和地图集在所有套餐中均可用,包括免费套餐。免费开始使用

计划:项目的意图与缘由

图谱说明项目如何运作。计划说明您想用它做什么。每个项目一份操作手册,四个部分,以及一条让它保持诚实的法则:完成即移除。它的开头几行在每次会话开始时与笔记一同打开,让下一次会话从最上面的一项继续。

四个部分,仅此而已。

  • 已决定——每项有效决定占一行:注明日期、决策者以及决策原因。提案永远不会被标记为“已决定”。
  • 下一步——按顺序排列,最多10项。每行会注明物品名称以及完成后的样子。顺序是计划所具有的唯一状态。
  • 已暂停——已提出但尚未决定的想法,每个想法都标注了提出日期。
  • 从人类决策开始——只有人类才能做出的决定,每条决定单独一行,并标注日期。

防止其腐坏的法则

  • “完成”意味着该事项已被处理掉。一旦有人完成了某项任务,他就会在当前会话中将其移除,并将相关内容放到合适的位置:电线则放回地图中,决策或测量结果则记录在相应文档里,代码则被保存到版本控制中。不存在所谓的“已完成”板块。
  • 该记录会被纳入其中。那些仍重要的被捕获行会变成“Next”或“Parked”中的某一行,从而离开原记录表;其余的则会被丢弃。
  • 一次只处理一位作者的文本。在重新撰写之前先阅读原计划,然后整体重写。
my-app-plan — walked 2026-09-10 by the Tuesday session

## Decided
2026-08-14 · you · Postgres, not SQLite — two writers, one box
2026-09-02 · you · ship the importer before the dashboard — nobody can try it empty

## Next
1. Importer accepts CSV with a header row. Finished: a real customer file lands.
2. Retry the webhook on 5xx. Finished: one blip stops costing a record.
3. Dashboard: one chart, last 30 days. Finished: it answers "is it working".

## Parked
2026-08-30 · a public status page — nothing to show yet

## Open with your user
2026-09-08 · free tier: how many rows before it asks for money

对你的智能体说一句话

计划法随你的记忆一同提供,与图谱一样。任何项目都可以保留一份。

1 · 已就位

该方法就在你的操作指南中。

从第一次会话开始,plan就会随每个记忆一同存在。对其进行编辑后,它就属于你了。

2 · 每个项目

让计划被写好

在项目中,请告诉你的代理:使用 playbook plan 来制定本项目的计划。它会根据现有的有效决策生成“已决定”,并根据笔记和记录表生成“下一步”。

3 · 之后的每次会话

它以工作内容作为开头

计划的第一批“Next”行会随会话简报一同出现,位于笔记旁边。一场会话在明确其目的之后才开始。

产品说明书:产品的承诺

产品上市时再听吧

最新作品、真实评测,还有偶尔的深度分析。无垃圾信息,一键即可取消订阅。

我们打造的一切

外部: YouTube · GitHub