寫一次 · 任何 agent、任何項目、任何機器都執行到 · 永遠唔會被修剪


你個 agent 會畫出你成個系統嘅地圖。之後每個會話都會載入它。

操作手冊係一份一次寫好嘅流程——部署、翻譯執行、每週報告——任何一個你嘅代理都可以喺任何專案、任何機器上,每次都用同樣方式執行。筆記負責喺會話之間交接。而地圖集就係操作手冊帶嚟嘅可能:你嘅代理會根據代碼同實際運行嘅系統,繪出成個系統嘅地圖,之後每個會話都會以佢開場。

免費方案 · $0 · 所有方案都附有操作手冊及筆記

程序寫一次就得。每個agent都會執行。

操作手冊就係普通嘅 Markdown:用標題分階段,用圍欄區塊放指令,仲有執行完之後應該讀返啲咩嚟確認成功。佢會儲存喺你成個帳戶,而唔係單一專案——各專案保持獨立,但流程可以共享。任何代理都可以攞到佢,並喺自己嘅環境入面執行。講聲「將呢個儲存做操作手冊」,佢就係一份操作手冊。講聲「用 deploy 操作手冊」,佢就會執行——而且通常連講都唔使:只要提示嘅字眼符合某份操作手冊,系統就會喺代理開始回答之前將佢交俾個代理。

永遠唔會被修剪

經整理嘅記錄保存目前嘅真相,並隨住情況變化而整理。操作手冊保存點樣做,而冇人會修剪一份流程。你為部署寫嘅嗰個 md 檔案,喺第一次改動接線嗰陣就已經過時,之後再冇人打開——而操作手冊就會由即將執行佢嘅代理每次都打開。花咗一個星期先搵到嘅做法,會保持最初搵到嗰陣嘅樣。

同一個方式,到處都係

一個專案有五個代理,或者一個代理喺五部機器——部署都係同一個部署。你喺某次執行學到嘅嘢,之後每次執行都會知道。

📋

用你會交畀同事嘅方式寫

步驟、確實嘅指令、之後要檢查啲咩、上次出咗咩問題同幾時出。你嘅agent會喺同一個工作階段度,加入佢執行時學到嘅嘢。

Notes——交接

工作階段停喺邊、而家運行緊啲咩、下一步係咩——由你嘅agent寫,每個專案一份,最近五份隨時在手。下一個工作階段一開始就會讀到。開機,話聲「continue」,佢就會繼續。

Atlas:一張你成個系統嘅地圖,時刻保持準確

地圖集係一份教你的代理點樣為專案繪製地圖嘅操作手冊——而佢繪出嚟嘅地圖本身都係一份操作手冊,所以每個會話都可以打開。每個專案一張根地圖:各個方塊、連線同上面傳送嘅嘢、各個儲存位置,仲有一個圖版索引。四至八張圖版,每張對應系統嘅一個層面,相關嘅流程就寫喺所屬嘅圖版入面。你的代理會讀代碼同實際運行嘅系統,喺落筆寫地圖之前核實每一條連線。

地圖嘅三條規則

  • 拓撲結構喺根地圖畫一次。圖版永遠唔會重複畫連線;佢只載自己嘅細節同自己嘅程序。重複就係偏差嘅起點,所以由設計上就冇重複。
  • 數值唔會出現喺地圖任何地方。冇連接埠、上限、價格或數量——頁面只會話個數字喺邊度,唔會話佢係咩。載住數值嘅地圖,一個星期內就會出錯。
  • 邊個改咗連線,就喺同一個工作階段更新地圖。根地圖載有一行——已於<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 · 每個專案

叫佢畫地圖

喺專案入面,同你嘅agent講:use playbook atlas to write the map of this project。佢會讀程式碼同實際運行系統,驗證每一條連線,然後寫出根地圖同各個圖版。

3 · 由方法完成

呢個項目得知自己有地圖。

呢個方法嘅最後一步會為專案儲存一條規則:地圖存放嘅位置,改動任何線路之前先閱讀該地圖,並喺同一個會話入面更新佢。由現在開始,每次開啟會話都會知道地圖喺度。

每個計劃都附有操作手冊、筆記以及地圖集,免費計劃都唔例外。立即免費開始使用

計劃:專案想做咩,同埋點解

地圖集講明一個專案係點運作。計劃就講明你想用佢做咩。每個專案一份操作手冊,四個部分,仲有一條保持誠實嘅法則:完成即係移走。佢嘅首幾行喺每個會話都會同筆記一齊打開,令下一個會話可以接住最頂嗰項。

四個部分,再冇其他

  • 已決定 — 每項生效中嘅決定一行:日期、決定人,以及原因。提案永遠唔會寫成已決定。
  • 下一步 — 按次序排列,最多十項。每行寫明嗰件事,同埋完成之後係咩樣。次序就係計劃唯一嘅狀態。
  • 已擱置 — 已提出但未決定嘅諗法,每項都註明提出日期。
  • 需由人類決定 — 只有人先可以做出嘅決定,每項一行,並註明日期。

防止佢腐壞嘅法則

  • 「完成」就意味著已移除。無論是誰完成了某項任務,都會在當次操作中將其移除,並把有變動的內容放回適當的位置:電線放回地圖集中,決定或測量數據記錄在相關檔案中,代碼則存入提交記錄中。並沒有「已完成」這個區段。
  • 該記錄會被移入其中。那些仍然重要的被抓取的記錄會變成「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計劃來撰寫此項目的計劃。其內容會參考現已生效的決策,而「Next」部分則來自於相關筆記及賬本。

3 · 每個會話之後

它以工作內容作為開端。

計劃中的首批「Next」行內容會與會話簡介一同出現,附在筆記旁邊。一個會話的開始,就是先了解其目的。

呢張表:產品承諾咗啲乜

出貨嗰陣先聽啦

新版本、真實基準測試,同埋偶爾嘅深入分析。冇垃圾郵件,一鍵取消訂閱。

我哋整嘅所有嘢

外部: YouTube · GitHub