Claude Code 上下文管理：长时间运行代理系统完整指南#

{
  "id": "feature_001",
  "category": "functional",
  "description": "用户可以看到待办事项列表",
  "steps": [
    "打开应用主页",
    "等待数据加载完成",
    "验证列表显示至少一个待办事项",
    "检查待办事项格式正确"
  ],
  "passes": false,
  "priority": 100
}

Implement feature_006: 用户可以标记待办事项完成

- 添加了复选框组件
- 实现了状态切换逻辑
- 更新了数据存储
- 添加了单元测试
- 所有测试通过

状态: Completed

2026-02-21 10:30:00 [Session abc123] 完成特性 feature_005
2026-02-21 10:35:00 [Session abc123] Git commit [a1b2c3d]: Implement feature_005
2026-02-21 10:40:00 [Session abc123] 遇到了问题：复选框状态不同步
2026-02-21 10:45:00 [Session abc123] 解决方案：修复状态管理逻辑
2026-02-21 10:50:00 [Session abc123] Session ended. Summary: 完成特性 feature_005

{
  "features": [
    {
      "id": "feature_001",
      "description": "用户可以看到待办列表",
      "steps": [...],
      "passes": false,
      "priority": 100
    },
    {
      "id": "feature_002", 
      "description": "用户可以添加新待办",
      "steps": [...],
      "passes": false,
      "priority": 90
    }
  ]
}

# 会话结束时的状态检查
git status --porcelain

# 如果返回非空，说明有未提交的更改
# 代理必须处理这些更改

// 使用浏览器自动化测试
const page = await browser.newPage();
await page.goto('http://localhost:3000');
await page.click('#new-todo-input');
await page.type('Buy milk');
await page.click('#add-button');
const text = await page.$eval('#todo-list li:last-child', el => el.textContent);
assert(text.includes('Buy milk'), '待办事项应该已添加');

#!/bin/bash
# init.sh - 标准化启动脚本

echo "🚀 启动待办事项应用..."

# 安装依赖
if [ ! -d "node_modules" ]; then
    npm install
fi

# 启动开发服务器
npm run dev &
SERVER_PID=$!

# 等待服务器启动
sleep 3

# 运行基础测试
npm run test:basic

echo "✓ 应用已启动，服务器PID: $SERVER_PID"

{
  "features": [
    {"id": "f001", "description": "用户可以看到登录按钮", "category": "ui"},
    {"id": "f002", "description": "用户点击登录弹出表单", "category": "ui"},
    {"id": "f003", "description": "用户可以输入用户名", "category": "functional"},
    {"id": "f004", "description": "用户可以输入密码", "category": "functional"},
    {"id": "f005", "description": "登录按钮可以点击", "category": "functional"},
    {"id": "f006", "description": "登录请求发送到服务器", "category": "api"},
    {"id": "f007", "description": "登录成功跳转到主页", "category": "functional"},
    {"id": "f008", "description": "登录失败显示错误消息", "category": "functional"}
  ]
}

{
  "features": [
    {"id": "f001", "description": "用户注册API", "category": "api"},
    {"id": "f002", "description": "用户登录API", "category": "api"},
    {"id": "f003", "description": "创建资源API", "category": "api"},
    {"id": "f004", "description": "获取资源列表API", "category": "api"},
    {"id": "f005", "description": "获取单个资源API", "category": "api"},
    {"id": "f006", "description": "更新资源API", "category": "api"},
    {"id": "f007", "description": "删除资源API", "category": "api"},
    {"id": "f008", "description": "数据验证中间件", "category": "backend"},
    {"id": "f009", "description": "错误处理中间件", "category": "backend"}
  ]
}

{
  "features": [
    {"id": "f001", "description": "数据加载模块", "category": "data"},
    {"id": "f002", "description": "数据清洗函数", "category": "data"},
    {"id": "f003", "description": "探索性数据分析", "category": "analysis"},
    {"id": "f004", "description": "特征工程", "category": "ml"},
    {"id": "f005", "description": "模型训练", "category": "ml"},
    {"id": "f006", "description": "模型评估", "category": "ml"},
    {"id": "f007", "description": "结果可视化", "category": "visualization"}
  ]
}

用户请求
    ↓
任务路由
    ↓
[测试代理] [部署代理] [文档代理] [代码代理]
    ↓
结果整合
    ↓
输出给用户

# 1. 安装系统
git clone <repository-url>
cd long-running-agent-harness

# 2. 初始化项目
python -m src.main "创建一个待办事项Web应用" "./todo_project"

# 3. 查看生成的特性列表
cd todo_project
cat feature_list.json

# 4. 继续开发
python -m src.main

# config.yaml
project:
  name: "我的项目"
  root_dir: "./workspace"

agent:
  model: "claude-opus-4.5"
  max_context_window: 200000

files:
  progress_file: "claude-progress.txt"
  feature_list: "feature_list.json"
  init_script: "init.sh"

git:
  auto_commit: true
  commit_message_template: "[Agent] {summary}"

testing:
  browser: "chromium"
  headless: false
  screenshot_on_error: true