用途：在代码提交后同步维护 CLAUDE.md。它读取本地文件 /.last-update-docs 中的上次更新提交，比较差异，然后更新 CLAUDE.md 的 Current Skills 列表、仓库结构树、安装方法、约定与技能结构等章节，最后把最新提交的哈希、标题与 ISO 8601 时间写回该文件。/.last-update-docs 为本地专用并应在 .gitignore 中排除。
主要能力：区分两类技能来源。系统 A 为可分发技能，存在 skills/ 时枚举 skills/，否则枚举 .agents/skills/，其数量写入“## Current Skills (N)”。系统 B 枚举 .claude/skills 与 .agents/skills 下带 SKILL.md 的目录，并通过物理解析路径（cd -P 后 pwd -P）分类：B1 为与系统 A 实体一致、计入 N；B2 为仅存在于 .claude/skills 的仓库管理技能；B3 为上游布局中指向 .agents/skills 的参照技能；B4 为无法判定或误配置，仅输出警告、不写入文档。带 skills-lock.json 时用 jq 做一次判定，jq 缺失或解析失败按无法判定处理。
使用方式：按流程先读 _/.last-update-docs，再用 git log 与 git diff 查看变更，随后执行 find -L 等命令更新对应章节，最后用 git log -1 写回文件。更新后可核对技能数量与实目录数量是否一致，并检查 B1、B2、B3 是否互斥。
适用场景：维护含技能目录的 agent 仓库文档，包括新增或删除技能、修改 .claude/agents/ 与 .claude/rules/、调整安装方式或技能结构时。
限制：只更新 CLAUDE.md，不修改各技能的 SKILL.md 或 references/，也不更新自动生成文件，不自动更改仓库结构；判定规则依赖具体的目录布局，遇到符号链接、路径不一致或缺少 jq 等情形会转为人工处理。具体计数示例仅适用于 agent-cli-skills 上游仓库。