changelog

Changelog 技能为使用 Claude Code 的开发者提供了一套先进的审计与可观测性工具。通过 PostToolUse 钩子直接整合至开发循环中，它能在您工作时自动捕捉事件的时间序列。这使子代理、调试器与人类开发者能够重构导致项目当前状态的操作序列，有效回答关于项目配置如何演变的问题。此技能维护一个持久性的 JSONL（JSON Lines）日志文件，确保事件数据结构化，适合机器读取与人工分析。它是 auto-loop 检查点系统的重要伙伴，提供与检查点静态快照互补的历史脉络流。专为软件工程师与技术团队设计，特别适用于调试复杂故障、执行开发会话的事后分析，以及为多代理团队协作提供背景信息。

• 使用 PostToolUse 钩子自动记录文件创建与修改事件，实现实时可观测性。

• 记录 Bash 级别的活动，包括测试执行结果（通过/失败）与 Git 提交事件。

• 实作自动化日志轮替逻辑，将当前日志文件保持在 500 行以内，以防止性能下降或过度占用磁盘空间。

• 通过使代理能够查询历史日志来了解先前的项目交互与环境状态，促进会话恢复。

• 通过使用 CLAUDE_PROJECT_DIR 环境变量，支持可移植路径管理。

• 请确保该技能在您的项目环境中启用，以利于 Write、Edit 与 Bash 工具使用时触发自动钩子。

• 请检查所生成的 .director-mode/changelog.jsonl 文件，以获取当前会话的完整审计追踪。

• 若钩子被绕过或失效，开发者可通过 auto-loop 提示手动触发事件记录，以维持审计流的一致性。

• 系统强制要求每个项目仅能执行一个 auto-loop 会话；请使用 --resume 或 --force 标志来管理会话冲突或重新初始化日志。

• 归档文件以时间戳命名存储，允许对项目随时间的演变进行长期历史分析。