用途:在代码变更后同步维护 CLAUDE.md,使其中的技能列表与仓库结构保持最新,并记录本次更新所依据的提交。
主要能力:读取 _/.last-update-docs 中的 commit_hash 作为上次更新基准(文件不存在时按首次处理,以最近提交为基准);用 git log 与 git diff 查看变更;更新 CLAUDE.md 的 ## Current Skills 段落(技能数量与逗号分隔的技能名列表)以及 Repository Structure 结构树;在安装方式、约定或技能结构变化时同步更新相应内容;最后把最新提交信息写回 _/.last-update-docs。
使用方式:按流程执行。先读取 _/.last-update-docs 获取 commit_hash;再运行 git log <commit_hash>..HEAD --oneline 与 git diff <commit_hash>..HEAD --stat 掌握变更;技能列表可用 ls -d skills/*/SKILL.md | sed 's|skills/||;s|/SKILL.md||' | sort 获取;随后更新 CLAUDE.md;再用 git log -1 --format="%H"、git log -1 --format="%s"、git log -1 --format="%cI" 取得提交哈希、标题与 ISO 8601 日期并写入 _/.last-update-docs;最后报告更新文件与变更内容。
记录文件格式:commit_hash=<hash>、commit_subject=<1行目>、commit_date=<ISO 8601>,该文件由 .gitignore 排除,仅本地使用。
适用场景:仓库中维护 CLAUDE.md 与 skills/ 目录、需要随代码提交持续同步文档的项目。
限制:仅更新 CLAUDE.md,不涉及各技能的 SKILL.md 或 references/;自动生成文件不在更新范围内;需确认 _/.last-update-docs 已加入 .gitignore。