菜单
为指定 commit 创建项目浅克隆（--depth=1）快照到 .claude/repo/project/。显式触发，无自动 hook。 适用于存档项目历史版本、对比不同 commit 之间的快照、回滚参考分析。 触发场景： - "为这个 commit 创建快照" - "快照当前项目状态" - "查看项目历史快照" - "管理快照保留数量" - "为快照创建索引"
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | git-commit-clone |
| description | 为指定 commit 创建项目浅克隆（--depth=1）快照到 .claude/repo/project/。显式触发，无自动 hook。 适用于存档项目历史版本、对比不同 commit 之间的快照、回滚参考分析。 触发场景： - "为这个 commit 创建快照" - "快照当前项目状态" - "查看项目历史快照" - "管理快照保留数量" - "为快照创建索引" |
| type | workflow |
为指定 commit 显式创建浅克隆（--depth=1）快照到 .claude/repo/project/，形成可浏览的项目快照存档。
无自动 hook，每次快照都需要显式调用。
snapshot — 为指定 commit 创建快照# 为当前 HEAD 创建快照
bash .claude/skills/git-commit-clone/reference/clone-snapshot.sh
# 为指定 commit 创建快照
bash .claude/skills/git-commit-clone/reference/clone-snapshot.sh a1b2c3d
list — 查看快照列表# 查看目录树
ls -la .claude/repo/project/
# 查看索引（如果支持 jq）
jq '.' .claude/repo/project/snapshots.json 2>/dev/null
show — 查看某个快照SNAP=$(ls -1d .claude/repo/project/*-* | sort | tail -1)
echo "=== Snapshot: $(basename $SNAP) ==="
cat "$SNAP/.snapshot-meta.json"
echo "---"
ls -la "$SNAP/"
prune — 清理旧快照保留最近 N 个快照，删除更早的。默认保留 10 个。
# 保留最近 10 个
bash .claude/skills/git-commit-clone/reference/prune-snapshots.sh
# 自定义保留数量（保留 5 个）
bash .claude/skills/git-commit-clone/reference/prune-snapshots.sh 5
index — 为快照创建索引为每个快照生成 PROJECT_INDEX.md 和 PROJECT_INDEX.json，使快照可浏览。
复用
index-reposskill 的并行 subagent 机制。
.claude/repo/project/
├── 2026-06-04-a1b2c3d/ # 快照目录（日期-短哈希）
│ ├── (项目文件全量浅克隆)
│ └── .snapshot-meta.json # 快照元数据
├── 2026-06-04-e4f5g6h/
├── 2026-06-05-xyz7890/
├── snapshots.json # 全局快照索引（机器可读）
└── snapshots.log # 快照日志（备选，当 jq 不可用时）
.claude/skills/git-commit-clone/
├── SKILL.md # 本文档
└── reference/
├── clone-snapshot.sh # Linux: 创建快照
├── clone-snapshot.ps1 # Windows: 创建快照
└── prune-snapshots.sh # 清理旧快照
# 1. 为当前 commit 创建快照
bash .claude/skills/git-commit-clone/reference/clone-snapshot.sh
# 2. 查看快照
ls -la .claude/repo/project/
# 3. 为历史 commit 创建快照
bash .claude/skills/git-commit-clone/reference/clone-snapshot.sh a1b2c3d
| 症状 | 原因 | 解决 |
|---|---|---|
| commit 不存在 | 本地没有该 commit | 先 git fetch 拉取目标 commit |
| 快照目录为空 | file:// 克隆失败 | 检查 .gitignore 是否排除自身 |
| 快照太多占用空间 | 保留数量默认 10 个 | 使用 prune 命令减少 |
jq 命令未找到 | 未安装 jq | 回退到 snapshots.log 文本日志 |
| 快照跳过 | 同一 commit 已存在快照 | 这是预期的幂等行为 |
| 技能 | 集成方式 |
|---|---|
index-repos | index 命令为每个快照创建 PROJECT_INDEX.md，实现可浏览的历史存档 |
repo-gitlink | 快照元数据包含 remote_url，可追加到 git.remote |
snapshot 后 .claude/repo/project/ 生成了快照目录list 能看到所有快照prune 正确保留最近 N 个.snapshot-meta.json 内容完整当用户希望整理需求、明确目的、描述问题，或要求"生成文档"、"整理意图"、"明确现象"时触发。用于通过多轮对话收集和整理需求，不执行任何代码修改。
当用户说 "boot work-flow"、"初始化 work-flow"、"为这个仓库创建 work-flow skill"、"创建 <仓库名>-work-flow" 时触发。这是一个元skill：自动检测 git 仓库名 → 在项目本地创建 <repo>-work-flow skill → 仅写入项目启动方法和启动信息作为最小骨架 → 标注后续通过 /key_board_3 添加 references 增强。
清理git嵌套仓库，保持仓库隔离性，让 git add . 干净无污染。 适用于 .claude/repo/ 或其他包含克隆仓库的目录。 当用户提到"清理git"、"处理嵌套仓库"、"git隔离"、"保持干净"、 "部分跟踪"、"白名单子目录"、"忽略但保留子目录"、"gitignore 否定规则"、 "忽略 .tool/"、"工具目录不入库"时触发。
当用户要求"总结成skill"、"保存对话为skill"、"提取提示词"、"做成技能"时触发。这是元技能模板，用于指导创建其他技能，而非被创建的技能本身。
当用户要求"拆分到references"、"给skill加ref引导"、"把xx沉淀为reference"、"优化skill结构"、"重构skill"、"skill膨胀了"、"合并skill"、或要求"探索/扫描现有skill看哪些可合并"时触发。本 skill 专用于按主题把已有 skill 组织成渐进式指导文档——主 SKILL.md 承担主干主题、references/ 承担特化专项的特化指导，整个 skill 包高内聚、单文档承担一个主题；长度只是边缘参考。不创建新 skill、不改变前置 skill (key_board / key_board_2) 的职责。探索模式详见 [[场景E-合并审计]]。
阅读任意代码库目录（不限语言/框架），分析模块与代码结构，生成防腐蚀规范 SKILL.md、更新已有 skill 使其与代码库一致、或在使用 skill 后反思同步项目经验。覆盖"创建"、"同步"、"反思"三个场景。不生成孤儿文档。