mirror of
https://github.com/shareAI-lab/analysis_claude_code.git
synced 2026-03-22 02:15:42 +08:00
109 lines
3.4 KiB
Markdown
109 lines
3.4 KiB
Markdown
# s07: Tasks
|
|
|
|
`s01 > s02 > s03 > s04 > s05 > s06 | [ s07 ] s08 > s09 > s10 > s11 > s12`
|
|
|
|
> *"State survives /compact"* -- file-based state outlives context compression.
|
|
|
|
## Problem
|
|
|
|
In-memory state (TodoManager from s03) dies when context compresses (s06). After auto_compact replaces messages with a summary, the todo list is gone. The agent can only reconstruct from summary text -- lossy and error-prone.
|
|
|
|
File-based tasks solve this: write state to disk, and it survives compression, process restarts, and eventually multi-agent sharing (s09+).
|
|
|
|
## Solution
|
|
|
|
```
|
|
.tasks/
|
|
task_1.json {"id":1, "status":"completed", ...}
|
|
task_2.json {"id":2, "blockedBy":[1], "status":"pending"}
|
|
task_3.json {"id":3, "blockedBy":[2], "status":"pending"}
|
|
|
|
Dependency resolution:
|
|
+----------+ +----------+ +----------+
|
|
| task 1 | --> | task 2 | --> | task 3 |
|
|
| complete | | blocked | | blocked |
|
|
+----------+ +----------+ +----------+
|
|
| ^
|
|
+--- completing task 1 removes it from
|
|
task 2's blockedBy list
|
|
```
|
|
|
|
## How It Works
|
|
|
|
1. TaskManager: one JSON file per task, CRUD with dependency graph.
|
|
|
|
```python
|
|
class TaskManager:
|
|
def __init__(self, tasks_dir: Path):
|
|
self.dir = tasks_dir
|
|
self.dir.mkdir(exist_ok=True)
|
|
self._next_id = self._max_id() + 1
|
|
|
|
def create(self, subject, description=""):
|
|
task = {"id": self._next_id, "subject": subject,
|
|
"status": "pending", "blockedBy": [],
|
|
"blocks": [], "owner": ""}
|
|
self._save(task)
|
|
self._next_id += 1
|
|
return json.dumps(task, indent=2)
|
|
```
|
|
|
|
2. Completing a task clears its ID from every other task's `blockedBy` list.
|
|
|
|
```python
|
|
def _clear_dependency(self, completed_id):
|
|
for f in self.dir.glob("task_*.json"):
|
|
task = json.loads(f.read_text())
|
|
if completed_id in task.get("blockedBy", []):
|
|
task["blockedBy"].remove(completed_id)
|
|
self._save(task)
|
|
```
|
|
|
|
3. `update` handles status transitions and dependency wiring.
|
|
|
|
```python
|
|
def update(self, task_id, status=None,
|
|
add_blocked_by=None, add_blocks=None):
|
|
task = self._load(task_id)
|
|
if status:
|
|
task["status"] = status
|
|
if status == "completed":
|
|
self._clear_dependency(task_id)
|
|
self._save(task)
|
|
```
|
|
|
|
4. Four task tools go into the dispatch map.
|
|
|
|
```python
|
|
TOOL_HANDLERS = {
|
|
# ...base tools...
|
|
"task_create": lambda **kw: TASKS.create(kw["subject"]),
|
|
"task_update": lambda **kw: TASKS.update(kw["task_id"], kw.get("status")),
|
|
"task_list": lambda **kw: TASKS.list_all(),
|
|
"task_get": lambda **kw: TASKS.get(kw["task_id"]),
|
|
}
|
|
```
|
|
|
|
From s07 onward, Task is the default for multi-step work. Todo remains for quick checklists.
|
|
|
|
## What Changed From s06
|
|
|
|
| Component | Before (s06) | After (s07) |
|
|
|---|---|---|
|
|
| Tools | 5 | 8 (`task_create/update/list/get`) |
|
|
| State storage | In-memory only | JSON files in `.tasks/` |
|
|
| Dependencies | None | `blockedBy + blocks` graph |
|
|
| Persistence | Lost on compact | Survives compression |
|
|
|
|
## Try It
|
|
|
|
```sh
|
|
cd learn-claude-code
|
|
python agents/s07_task_system.py
|
|
```
|
|
|
|
1. `Create 3 tasks: "Setup project", "Write code", "Write tests". Make them depend on each other in order.`
|
|
2. `List all tasks and show the dependency graph`
|
|
3. `Complete task 1 and then list tasks to see task 2 unblocked`
|
|
4. `Create a task board for refactoring: parse -> transform -> emit -> test`
|