Documentation
README
Harness Step 3: 建立跨 Session 状态管理
目标
创建三个文件,让 agent 在任何新 session 开始时能在 30 秒内恢复工作状态:
init.sh:环境初始化脚本,验证项目可以正常启动tasks.json:当前任务清单,agent 的工作指令来源progress.md:人类可读的进度摘要,记录每次 session 的关键信息
核心原则:状态靠文件传递,不靠 agent 的记忆。git log 是主记录,这三个文件是辅助。
执行步骤
Step 1:扫描项目启动方式
在写 init.sh 之前,先确认项目如何启动和测试:
# 读 package.json 的 scripts(Node.js 项目)
cat package.json 2>/dev/null | grep -A 20 '"scripts"'
# 或读 Makefile(多语言项目)
cat Makefile 2>/dev/null | head -40
# 或读 pyproject.toml(Python 项目)
cat pyproject.toml 2>/dev/null | grep -A 20 '\[tool.poetry.scripts\]'
# 确认现有 AGENTS.md 里的启动命令
grep -A 5 '启动命令\|start\|dev\|run' AGENTS.md 2>/dev/null
收集:
- 开发服务器启动命令
- 测试命令
- 类型检查/lint 命令(如果有)
- 有没有需要先跑的初始化步骤(如数据库迁移)
Step 2:创建 init.sh
This is the opening of the README. Read the full README on GitHub.