用途:驱动 delivery-chain Claude Code 插件的 agent-memory 运行时,验证持久化与注入的完整往返,并保持 Python 测试套件通过。
主要能力:sidecar 由 harness 在 SubagentStart(按角色注入记忆)和 SubagentStop/Stop(持久化 episode)调用;提供 driver.sh 端到端驱动。
使用方式:前置只需 python3(仅标准库,无需 pip、venv 或网络,已验证 3.14,侧车面向 3.x)。无需安装或构建,克隆即运行。可选 export OPENAI_API_KEY=...(仅 Phase 2-3 的 OpenAI 课程提取与嵌入检索读取,缺失则静默跳过,且切勿提交进 hooks/hooks.json)。
驱动运行时:.claude/skills/run-delivery-chain/driver.sh,成功输出 === ALL CHECKS PASSED — the agent-memory runtime round-trips end to end ===。它可在任意 cwd 运行,用 mktemp -d 临时目录作 CLAUDE_PROJECT_DIR,并 unset OPENAI_API_KEY 保持离线无密钥;store 位于该临时目录的 .claude/agent-memory/ 并在退出时删除。四步断言:subagent-stop 带 transcript_path JSONL 写入恰好 1 个含 taskId 的 episode;subagent-start 输出被一个 === AGENT MEMORY === 包裹,episode 与种子 lesson 各归其标签;prose-only 消息不改变 episode 数;垃圾 stdin 仍退出 0。
手动单阶段:echo '{"agent_type":"frontend-engineer"}' | python3 scripts/agent_memory_hook.py subagent-start。无 store 时返回空 additionalContext 且退出 0。
测试:全套 (cd scripts/tests && python3 -m unittest discover)(695 个测试);单文件须先 cd:cd scripts/tests && python3 test_memory_store.py(86 个测试);静态密钥扫描 bash scripts/secret_scan.sh。
限制:单文件测试从仓库根目录运行会误报。记忆信封仅在富化添加块时出现,仅 episode 且无 lesson 无密钥时不套 === AGENT MEMORY ===。hook 永不非零退出(Stop hook 退出 2 会阻塞并可能递归),勿靠退出码判错。无 agent_type 的 Stop/主线程事件不持久化;未知 agent_type 会被跳过。这是测试驱动工具,无界面可截图。