用途:在技能开发过程中用 Git 跟踪文件变更,支持回滚、对比与打包前检查。
主要能力:初始化仓库、按逻辑变更提交、查看提交历史、生成 diff 文件、撤销提交、创建实验分支、比较两个技能版本、打包时排除 .git。
使用方式:运行 init_skill.sh 后立即执行 git init、git add .、git commit -m "Initial commit: skill structure";每次逻辑变更后提交,提交信息采用 Add/Fix/Update/Refactor/Remove 前缀。用户询问变更时,用 git log --oneline 查看历史,并将 diff 重定向到文件后提供链接,例如 git diff <commit-hash-1> <commit-hash-2> > /mnt/user-data/outputs/changes.diff。撤销可用 git reset --soft HEAD~1、git reset --hard HEAD~1、git revert <commit-hash> 或 git restore .,优先使用 git revert 保留历史。实验性修改可创建分支:git checkout -b experiment-new-approach,成功后合并,失败则删除。比较两个版本可分别初始化仓库后用 git diff --no-index . ../v2,或直接 diff -ur compare/v1 compare/v2。打包前用 git status 确认干净,再用 zip -r ... -x ".git" 排除 .git。
适用场景:技能创建、编辑、实验、版本对比与交付打包。
限制:/home/claude 中的 Git 仓库在会话之间会重置,版本控制仅在单次开发会话内持久;网络限制导致无法 push/pull 到远程仓库。不要预先创建 CHANGELOG.md 或变更摘要,仅在用户明确要求时生成 diff 或变更日志。