用途:为 AI 编程 agent 建立跨 session 状态管理,让 agent 在任何新 session 开始时能在 30 秒内恢复工作状态。核心原则是状态靠文件传递,不靠 agent 记忆,git log 为主记录,三个文件为辅助。
主要能力:创建三个文件。init.sh 为环境初始化脚本,验证项目可正常启动;tasks.json 为任务清单,是 agent 的工作指令来源;progress.md 为人类可读的进度摘要。同时更新 AGENTS.md 写入任务管理规则。
使用方式:先扫描项目启动方式,读取 package.json 的 scripts、Makefile、pyproject.toml 或 AGENTS.md 中的启动命令,收集开发服务器、测试、类型检查/lint 命令及初始化步骤。再创建 init.sh,运行 bash init.sh 验证无报错。接着创建 tasks.json,字段包括 id、title、description、status、priority、blocked_by、verify、requires_eval,其中 verify 必须可执行,requires_eval 需对照标准判断。然后创建 progress.md 并追加初始记录。最后模拟新 session 启动流程验证联动。
适用场景:使用 Claude Code 等编程 agent 进行多 session 开发、需要 agent 记住进度、建立任务管理的项目。
限制:资料未提供具体收费、价格、平台支持范围等信息。任务粒度建议 1-2 小时完成,冒烟测试需快于 30 秒。requires_eval 判断标准中,新功能、涉及安全权限、改动超 3 个文件或重构设为 true;纯 bug 修复、文档更新、配置调整、单元测试补充设为 false。禁止跳过 verify 步骤自行判断任务完成,禁止不经判断直接将 requires_eval 设为 false。