菜单
清理 Git 仓库历史中的特定文件或目录以减小仓库体积，或移除误提交到历史中的敏感/二进制文件。用户提到以下需求时使用： - "清理 git 仓库"、"减小仓库大小"、"清理历史文件" - "删除 git 历史中的大文件"、"清理 bin/ 目录历史" - "git filter-repo"、"BFG 清理" - "仓库太大"、"reduce repo size"、"clean up git history" - 任何涉及删除 Git 历史记录中特定文件、目录或 glob 模式文件的需求
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
基于 SOC 职业分类
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ccwq/ccwq-skill-list --skill git-history-cleaner命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
使用渐进式披露结构创建、改写或审查中文技术文章。适用于需要同时服务快速阅读与深度阅读的技术科普、教程、调查、对比、架构分析、事故复盘和观点文章。
显式调用的工程方法论选择器：根据目标、上下文、阶段、产物、质量属性与风险，诊断问题并组合推荐可验证的工程方法。
用于本机、SSH、容器、CI/CD、服务器、云服务、代码与接口的联调排障。 先识别执行环境，再选择最小只读 probe；统一生成脱敏 debug_report，优先复制到剪切板， 不可用时回退到终端和临时文件。支持动态轮次、风险分级授权、截图补证和内部并行复核。
| name | git-history-cleaner |
| description | 清理 Git 仓库历史中的特定文件或目录以减小仓库体积，或移除误提交到历史中的敏感/二进制文件。用户提到以下需求时使用： - "清理 git 仓库"、"减小仓库大小"、"清理历史文件" - "删除 git 历史中的大文件"、"清理 bin/ 目录历史" - "git filter-repo"、"BFG 清理" - "仓库太大"、"reduce repo size"、"clean up git history" - 任何涉及删除 Git 历史记录中特定文件、目录或 glob 模式文件的需求 |
| version | 1.0.0 |
| disable-model-invocation | true |
清理 Git 仓库历史中的特定文件，支持预览、确认和自动三种执行方式。
.git 备份git filter-repo| 参数 | 说明 | 默认值 |
|---|---|---|
--repo | 仓库路径 | 当前目录 |
--path | 要删除的路径模式。支持目录（如 bin/）、精确路径（如 secrets.txt）和 glob（如 *.log） | 必填 |
--dry-run | 只分析历史，不创建备份、不改写历史 | false |
--auto | 自动模式，无需确认 | false |
# 交互模式
python scripts/cleaner.py --repo /path/to/repo --path bin/
# 自动模式
python scripts/cleaner.py --repo /path/to/repo --path "*.log" --auto
# 预览模式
python scripts/cleaner.py --repo /path/to/repo --path bin/ --dry-run
核心逻辑位于 scripts/cleaner.py：
analyze_history()：分析历史中受影响的提交、文件和大小build_filter_repo_cmd()：根据目录、精确路径或 glob 模式构建 git filter-repo 命令create_backup()：备份 .git 目录execute_clean()：执行历史改写restore_backup()：清理失败时恢复备份git filter-repo 可用；脚本会检查 git filter-repo --version.git 备份，避免误操作无法回滚git push --force/ 与 \git filter-repo 会直接删除匹配路径的全部历史，不会保留部分版本