Skip to content

Commit 4f39ee4

Browse files
committed
fix session doc
1 parent 665831c commit 4f39ee4

39 files changed

Lines changed: 286 additions & 235 deletions

README-ja.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -26,27 +26,27 @@
2626

2727
> **s01**   *"One loop & Bash is all you need"* — 1つのツール + 1つのループ = エージェント
2828
>
29-
> **s02**   *"ループは変わらない"* — ツール追加はハンドラー追加であり、ループの作り直しではない
29+
> **s02**   *"ツールを足すなら、ハンドラーを1つ足すだけ"* — ループは変わらない。新ツールは dispatch map に登録するだけ
3030
>
31-
> **s03**   *"行動する前に計画せよ"* — 可視化された計画がタスク完了率を向上させる
31+
> **s03**   *"計画のないエージェントは行き当たりばったり"* — まずステップを書き出し、それから実行
3232
>
33-
> **s04**   *"プロセス分離 = コンテキスト分離"* — サブエージェントごとに新しい messages[]
33+
> **s04**   *"大きなタスクを分割し、各サブタスクにクリーンなコンテキストを"* — サブエージェントは独立した messages[] を使い、メイン会話を汚さない
3434
>
35-
> **s05**   *"必要な時にロード、事前にではなく"* — system prompt ではなく tool_result で知識を注入
35+
> **s05**   *"必要な知識を、必要な時に読み込む"* — system prompt ではなく tool_result で注入
3636
>
37-
> **s06**   *"戦略的忘却"* — 古いコンテキストを忘れて無限セッションを実現
37+
> **s06**   *"コンテキストはいつか溢れる、空ける手段が要る"* — 3層圧縮で無限セッションを実現
3838
>
39-
> **s07**   *"状態は圧縮を生き延びる"* — ファイルベースの状態はコンテキスト圧縮に耐える
39+
> **s07**   *"大きな目標を小タスクに分解し、順序付けし、ディスクに記録する"* — ファイルベースのタスクグラフ、マルチエージェント協調の基盤
4040
>
41-
> **s08**   *"撃ちっ放し"* — ノンブロッキングスレッド + 通知キュー
41+
> **s08**   *"遅い操作はバックグラウンドへ、エージェントは次を考え続ける"* — デーモンスレッドがコマンド実行、完了後に通知を注入
4242
>
43-
> **s09**   *"追記で送信、排出で読取"* — 永続チームメイトのための非同期メールボックス
43+
> **s09**   *"一人で終わらないなら、チームメイトに任せる"* — 永続チームメイト + 非同期メールボックス
4444
>
45-
> **s10**   *"同じ request_id、2つのプロトコル"* — 1つの FSM パターンでシャットダウン + プラン承認
45+
> **s10**   *"チームメイト間には統一の通信ルールが必要"* — 1つの request-response パターンが全交渉を駆動
4646
>
47-
> **s11**   *"ポーリング、クレーム、作業、繰り返し"* — コーディネーター不要、エージェントが自己組織化
47+
> **s11**   *"チームメイトが自らボードを見て、仕事を取る"* — リーダーが逐一割り振る必要はない
4848
>
49-
> **s12**   *"ディレクトリで分離し、タスクIDで調整する"* — タスクボード + 必要時の worktree レーン
49+
> **s12**   *"各自のディレクトリで作業し、互いに干渉しない"* — タスクは目標を管理、worktree はディレクトリを管理、IDで紐付け
5050
5151
---
5252

@@ -167,17 +167,17 @@ learn-claude-code/
167167
| セッション | トピック | モットー |
168168
|-----------|---------|---------|
169169
| [s01](./docs/ja/s01-the-agent-loop.md) | エージェントループ | *One loop & Bash is all you need* |
170-
| [s02](./docs/ja/s02-tool-use.md) | Tool Use | *ループは変わらない* |
171-
| [s03](./docs/ja/s03-todo-write.md) | TodoWrite | *行動する前に計画せよ* |
172-
| [s04](./docs/ja/s04-subagent.md) | サブエージェント | *プロセス分離 = コンテキスト分離* |
173-
| [s05](./docs/ja/s05-skill-loading.md) | Skills | *必要な時にロード、事前にではなく* |
174-
| [s06](./docs/ja/s06-context-compact.md) | Context Compact | *戦略的忘却* |
175-
| [s07](./docs/ja/s07-task-system.md) | タスクシステム | *状態は圧縮を生き延びる* |
176-
| [s08](./docs/ja/s08-background-tasks.md) | バックグラウンドタスク | *撃ちっ放し* |
177-
| [s09](./docs/ja/s09-agent-teams.md) | エージェントチーム | *追記で送信、排出で読取* |
178-
| [s10](./docs/ja/s10-team-protocols.md) | チームプロトコル | *同じ request_id、2つのプロトコル* |
179-
| [s11](./docs/ja/s11-autonomous-agents.md) | 自律エージェント | *ポーリング、クレーム、作業、繰り返し* |
180-
| [s12](./docs/ja/s12-worktree-task-isolation.md) | Worktree + タスク分離 | *ディレクトリで分離し、タスクIDで調整する* |
170+
| [s02](./docs/ja/s02-tool-use.md) | Tool Use | *ツールを足すなら、ハンドラーを1つ足すだけ* |
171+
| [s03](./docs/ja/s03-todo-write.md) | TodoWrite | *計画のないエージェントは行き当たりばったり* |
172+
| [s04](./docs/ja/s04-subagent.md) | サブエージェント | *大きなタスクを分割し、各サブタスクにクリーンなコンテキストを* |
173+
| [s05](./docs/ja/s05-skill-loading.md) | Skills | *必要な知識を、必要な時に読み込む* |
174+
| [s06](./docs/ja/s06-context-compact.md) | Context Compact | *コンテキストはいつか溢れる、空ける手段が要る* |
175+
| [s07](./docs/ja/s07-task-system.md) | タスクシステム | *大きな目標を小タスクに分解し、順序付けし、ディスクに記録する* |
176+
| [s08](./docs/ja/s08-background-tasks.md) | バックグラウンドタスク | *遅い操作はバックグラウンドへ、エージェントは次を考え続ける* |
177+
| [s09](./docs/ja/s09-agent-teams.md) | エージェントチーム | *一人で終わらないなら、チームメイトに任せる* |
178+
| [s10](./docs/ja/s10-team-protocols.md) | チームプロトコル | *チームメイト間には統一の通信ルールが必要* |
179+
| [s11](./docs/ja/s11-autonomous-agents.md) | 自律エージェント | *チームメイトが自らボードを見て、仕事を取る* |
180+
| [s12](./docs/ja/s12-worktree-task-isolation.md) | Worktree + タスク分離 | *各自のディレクトリで作業し、互いに干渉しない* |
181181

182182
## 次のステップ -- 理解から出荷へ
183183

README-zh.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -26,27 +26,27 @@
2626

2727
> **s01**   *"One loop & Bash is all you need"* — 一个工具 + 一个循环 = 一个智能体
2828
>
29-
> **s02**   *"循环没有变"* — 加工具就是加 handler, 不是重写循环
29+
> **s02**   *"加一个工具, 只加一个 handler"* — 循环不用动, 新工具注册进 dispatch map 就行
3030
>
31-
> **s03**   *"先计划再行动"* — 可见的计划提升任务完成率
31+
> **s03**   *"没有计划的 agent 走哪算哪"* — 先列步骤再动手, 完成率翻倍
3232
>
33-
> **s04**   *"进程隔离 = 上下文隔离"* — 每个子智能体独立 messages[]
33+
> **s04**   *"大任务拆小, 每个小任务干净的上下文"* — 子智能体用独立 messages[], 不污染主对话
3434
>
35-
> **s05**   *"按需加载, 而非预装"* — 通过 tool_result 注入知识, 而非塞进 system prompt
35+
> **s05**   *"用到什么知识, 临时加载什么知识"* — 通过 tool_result 注入, 不塞 system prompt
3636
>
37-
> **s06**   *"策略性遗忘"* — 忘掉旧上下文, 换来无限会话
37+
> **s06**   *"上下文总会满, 要有办法腾地方"* — 三层压缩策略, 换来无限会话
3838
>
39-
> **s07**   *"状态在压缩后存活"* — 文件持久化的状态不怕上下文压缩
39+
> **s07**   *"大目标要拆成小任务, 排好序, 记在磁盘上"* — 文件持久化的任务图, 为多 agent 协作打基础
4040
>
41-
> **s08**   *"发射后不管"* — 非阻塞线程 + 通知队列
41+
> **s08**   *"慢操作丢后台, agent 继续想下一步"* — 后台线程跑命令, 完成后注入通知
4242
>
43-
> **s09**   *"追加即发送, 排空即读取"* — 异步邮箱实现持久化队友通信
43+
> **s09**   *"任务太大一个人干不完, 要能分给队友"* — 持久化队友 + 异步邮箱
4444
>
45-
> **s10**   *"同一个 request_id, 两个协议"* — 一个 FSM 模式驱动关机 + 计划审批
45+
> **s10**   *"队友之间要有统一的沟通规矩"* — 一个 request-response 模式驱动所有协商
4646
>
47-
> **s11**   *"轮询, 认领, 工作, 重复"* — 无需协调者, 智能体自组织
47+
> **s11**   *"队友自己看看板, 有活就认领"* — 不需要领导逐个分配, 自组织
4848
>
49-
> **s12**   *"目录隔离, 任务 ID 协调"* — 任务板协调 + 按需 worktree 隔离通道
49+
> **s12**   *"各干各的目录, 互不干扰"* — 任务管目标, worktree 管目录, 按 ID 绑定
5050
5151
---
5252

@@ -167,17 +167,17 @@ learn-claude-code/
167167
| 课程 | 主题 | 格言 |
168168
|------|------|------|
169169
| [s01](./docs/zh/s01-the-agent-loop.md) | Agent 循环 | *One loop & Bash is all you need* |
170-
| [s02](./docs/zh/s02-tool-use.md) | Tool Use | *循环没有变* |
171-
| [s03](./docs/zh/s03-todo-write.md) | TodoWrite | *先计划再行动* |
172-
| [s04](./docs/zh/s04-subagent.md) | 子智能体 | *进程隔离 = 上下文隔离* |
173-
| [s05](./docs/zh/s05-skill-loading.md) | Skills | *按需加载, 而非预装* |
174-
| [s06](./docs/zh/s06-context-compact.md) | Context Compact | *策略性遗忘* |
175-
| [s07](./docs/zh/s07-task-system.md) | 任务系统 | *状态在压缩后存活* |
176-
| [s08](./docs/zh/s08-background-tasks.md) | 后台任务 | *发射后不管* |
177-
| [s09](./docs/zh/s09-agent-teams.md) | 智能体团队 | *追加即发送, 排空即读取* |
178-
| [s10](./docs/zh/s10-team-protocols.md) | 团队协议 | *同一个 request_id, 两个协议* |
179-
| [s11](./docs/zh/s11-autonomous-agents.md) | 自治智能体 | *轮询, 认领, 工作, 重复* |
180-
| [s12](./docs/zh/s12-worktree-task-isolation.md) | Worktree + 任务隔离 | *目录隔离, 任务 ID 协调* |
170+
| [s02](./docs/zh/s02-tool-use.md) | Tool Use | *加一个工具, 只加一个 handler* |
171+
| [s03](./docs/zh/s03-todo-write.md) | TodoWrite | *没有计划的 agent 走哪算哪* |
172+
| [s04](./docs/zh/s04-subagent.md) | 子智能体 | *大任务拆小, 每个小任务干净的上下文* |
173+
| [s05](./docs/zh/s05-skill-loading.md) | Skills | *用到什么知识, 临时加载什么知识* |
174+
| [s06](./docs/zh/s06-context-compact.md) | Context Compact | *上下文总会满, 要有办法腾地方* |
175+
| [s07](./docs/zh/s07-task-system.md) | 任务系统 | *大目标要拆成小任务, 排好序, 记在磁盘上* |
176+
| [s08](./docs/zh/s08-background-tasks.md) | 后台任务 | *慢操作丢后台, agent 继续想下一步* |
177+
| [s09](./docs/zh/s09-agent-teams.md) | 智能体团队 | *任务太大一个人干不完, 要能分给队友* |
178+
| [s10](./docs/zh/s10-team-protocols.md) | 团队协议 | *队友之间要有统一的沟通规矩* |
179+
| [s11](./docs/zh/s11-autonomous-agents.md) | 自治智能体 | *队友自己看看板, 有活就认领* |
180+
| [s12](./docs/zh/s12-worktree-task-isolation.md) | Worktree + 任务隔离 | *各干各的目录, 互不干扰* |
181181

182182
## 学完之后 -- 从理解到落地
183183

README.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -26,27 +26,27 @@
2626

2727
> **s01**   *"One loop & Bash is all you need"* — one tool + one loop = an agent
2828
>
29-
> **s02**   *"The loop didn't change"* — adding tools means adding handlers, not rewriting the loop
29+
> **s02**   *"Adding a tool means adding one handler"* — the loop stays the same; new tools register into the dispatch map
3030
>
31-
> **s03**   *"Plan before you act"* — visible plans improve task completion
31+
> **s03**   *"An agent without a plan drifts"* — list the steps first, then execute; completion doubles
3232
>
33-
> **s04**   *"Process isolation = context isolation"* — fresh messages[] per subagent
33+
> **s04**   *"Break big tasks down; each subtask gets a clean context"* — subagents use independent messages[], keeping the main conversation clean
3434
>
35-
> **s05**   *"Load on demand, not upfront"* — inject knowledge via tool_result, not system prompt
35+
> **s05**   *"Load knowledge when you need it, not upfront"* — inject via tool_result, not the system prompt
3636
>
37-
> **s06**   *"Strategic forgetting"* — forget old context to enable infinite sessions
37+
> **s06**   *"Context will fill up; you need a way to make room"* — three-layer compression strategy for infinite sessions
3838
>
39-
> **s07**   *"State survives /compact"* — file-based state outlives context compression
39+
> **s07**   *"Break big goals into small tasks, order them, persist to disk"* — a file-based task graph with dependencies, laying the foundation for multi-agent collaboration
4040
>
41-
> **s08**   *"Fire and forget"* — non-blocking threads + notification queue
41+
> **s08**   *"Run slow operations in the background; the agent keeps thinking"* — daemon threads run commands, inject notifications on completion
4242
>
43-
> **s09**   *"Append to send, drain to read"* — async mailboxes for persistent teammates
43+
> **s09**   *"When the task is too big for one, delegate to teammates"* — persistent teammates + async mailboxes
4444
>
45-
> **s10**   *"Same request_id, two protocols"* — one FSM pattern powers shutdown + plan approval
45+
> **s10**   *"Teammates need shared communication rules"* — one request-response pattern drives all negotiation
4646
>
47-
> **s11**   *"Poll, claim, work, repeat"* — no coordinator needed, agents self-organize
47+
> **s11**   *"Teammates scan the board and claim tasks themselves"* — no need for the lead to assign each one
4848
>
49-
> **s12**   *"Isolate by directory, coordinate by task ID"* — task board + optional worktree lanes
49+
> **s12**   *"Each works in its own directory, no interference"* — tasks manage goals, worktrees manage directories, bound by ID
5050
5151
---
5252

@@ -167,17 +167,17 @@ Available in [English](./docs/en/) | [中文](./docs/zh/) | [日本語](./docs/j
167167
| Session | Topic | Motto |
168168
|---------|-------|-------|
169169
| [s01](./docs/en/s01-the-agent-loop.md) | The Agent Loop | *One loop & Bash is all you need* |
170-
| [s02](./docs/en/s02-tool-use.md) | Tool Use | *The loop didn't change* |
171-
| [s03](./docs/en/s03-todo-write.md) | TodoWrite | *Plan before you act* |
172-
| [s04](./docs/en/s04-subagent.md) | Subagents | *Process isolation = context isolation* |
173-
| [s05](./docs/en/s05-skill-loading.md) | Skills | *Load on demand, not upfront* |
174-
| [s06](./docs/en/s06-context-compact.md) | Context Compact | *Strategic forgetting* |
175-
| [s07](./docs/en/s07-task-system.md) | Tasks | *State survives /compact* |
176-
| [s08](./docs/en/s08-background-tasks.md) | Background Tasks | *Fire and forget* |
177-
| [s09](./docs/en/s09-agent-teams.md) | Agent Teams | *Append to send, drain to read* |
178-
| [s10](./docs/en/s10-team-protocols.md) | Team Protocols | *Same request_id, two protocols* |
179-
| [s11](./docs/en/s11-autonomous-agents.md) | Autonomous Agents | *Poll, claim, work, repeat* |
180-
| [s12](./docs/en/s12-worktree-task-isolation.md) | Worktree + Task Isolation | *Isolate by directory, coordinate by task ID* |
170+
| [s02](./docs/en/s02-tool-use.md) | Tool Use | *Adding a tool means adding one handler* |
171+
| [s03](./docs/en/s03-todo-write.md) | TodoWrite | *An agent without a plan drifts* |
172+
| [s04](./docs/en/s04-subagent.md) | Subagents | *Break big tasks down; each subtask gets a clean context* |
173+
| [s05](./docs/en/s05-skill-loading.md) | Skills | *Load knowledge when you need it, not upfront* |
174+
| [s06](./docs/en/s06-context-compact.md) | Context Compact | *Context will fill up; you need a way to make room* |
175+
| [s07](./docs/en/s07-task-system.md) | Tasks | *Break big goals into small tasks, order them, persist to disk* |
176+
| [s08](./docs/en/s08-background-tasks.md) | Background Tasks | *Run slow operations in the background; the agent keeps thinking* |
177+
| [s09](./docs/en/s09-agent-teams.md) | Agent Teams | *When the task is too big for one, delegate to teammates* |
178+
| [s10](./docs/en/s10-team-protocols.md) | Team Protocols | *Teammates need shared communication rules* |
179+
| [s11](./docs/en/s11-autonomous-agents.md) | Autonomous Agents | *Teammates scan the board and claim tasks themselves* |
180+
| [s12](./docs/en/s12-worktree-task-isolation.md) | Worktree + Task Isolation | *Each works in its own directory, no interference* |
181181

182182
## What's Next -- from understanding to shipping
183183

docs/en/s02-tool-use.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
`s01 > [ s02 ] s03 > s04 > s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
44

5-
> *"The loop didn't change"* -- adding tools means adding handlers, not rewriting the loop.
5+
> *"Adding a tool means adding one handler"* -- the loop stays the same; new tools register into the dispatch map.
66
77
## Problem
88

docs/en/s03-todo-write.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
`s01 > s02 > [ s03 ] s04 > s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
44

5-
> *"Plan before you act"* -- visible plans improve task completion.
5+
> *"An agent without a plan drifts"* -- list the steps first, then execute.
66
77
## Problem
88

docs/en/s04-subagent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
`s01 > s02 > s03 > [ s04 ] s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
44

5-
> *"Process isolation = context isolation"* -- fresh messages[] per subagent.
5+
> *"Break big tasks down; each subtask gets a clean context"* -- subagents use independent messages[], keeping the main conversation clean.
66
77
## Problem
88

docs/en/s05-skill-loading.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
`s01 > s02 > s03 > s04 > [ s05 ] s06 | s07 > s08 > s09 > s10 > s11 > s12`
44

5-
> *"Load on demand, not upfront"* -- inject knowledge via tool_result, not system prompt.
5+
> *"Load knowledge when you need it, not upfront"* -- inject via tool_result, not the system prompt.
66
77
## Problem
88

docs/en/s06-context-compact.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
`s01 > s02 > s03 > s04 > s05 > [ s06 ] | s07 > s08 > s09 > s10 > s11 > s12`
44

5-
> *"Strategic forgetting"* -- forget old context to enable infinite sessions.
5+
> *"Context will fill up; you need a way to make room"* -- three-layer compression strategy for infinite sessions.
66
77
## Problem
88

0 commit comments

Comments
 (0)