SuperAPI AI 工具集

update-docs

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:在代码变更后同步维护 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。