用途:为开发会话提供运行时变更日志,自动追踪文件创建/修改、测试通过/失败、git 提交等事件,帮助子代理理解先前操作,并支持会话恢复与调试。
主要能力:通过 PostToolUse 钩子自动记录事件;超过 500 行时自动轮转归档;提供 /changelog 命令查询、统计、按类型过滤、导出与归档;与 checkpoint 互补(checkpoint 保存当前状态,changelog 记录历史事件流)。
使用方式:钩子随 Director Mode Lite 安装,配置在 .claude/settings.local.json 的 PostToolUse 中,脚本为 log-file-change.sh 与 log-bash-event.sh。常用命令:/changelog、/changelog --summary、/changelog --type test、/changelog --list-archives、/changelog --export log.json。也可用 Bash 查询,如 tail -n 5 .director-mode/changelog.jsonl | jq '.'。
适用场景:TDD 迭代、代码审查、调试、会话中断后恢复(/auto-loop --resume 或 --force)。
限制:状态为实验性,钩子接口未来可能变化;若钩子未触发,可通过 auto-loop 提示手动记录事件。事件写入 .director-mode/changelog.jsonl,轮转后归档为 changelog.YYYYMMDD_HHMMSS.jsonl。同一项目仅允许一个 auto-loop 会话,存在 in_progress 检查点时会阻止新会话。安装与具体收费、平台支持等细节资料未提供。