技能介绍

解决什么问题

把整个代码库喂给大模型时，最大的麻烦不是模型看不懂代码，而是输入上下文怎么准备。临时复制文件容易遗漏目录、漏掉依赖说明，还会把注释、测试和构建产物一起带上，既浪费 token 又干扰判断。直接对仓库做分析、评审或安全审计时，你更需要一个结构完整、范围可控、能先跑一遍敏感信息检查的上下文包。仓库打包技能基于 Repomix，就是把这类“把仓库变成单一 AI 友好文件”的流程固化下来。

技能如何工作

它的核心能力是把本地路径或远程 owner/repo 仓库打包为 XML、Markdown、JSON 或纯文本，支持按路径包含与排除，也支持 --remove-comments 去注释。安全方面会用 Secretlint 检测 API key、密码、私钥、AWS 密钥等敏感信息，并在交付前给出安全警告。

关键步骤可以归纳为四步：

安装校验：确认环境里已有 repomix，能跑通版本检查。
选格式与范围：按模型用途选择输出格式；用 include、exclude、去注释、是否忽略 .gitignore 控制包内内容。
安全与 token 管理：开启安全检查，必要时用 .repomixignore 排除敏感文件；对照目标模型上下文上限核对 token 数。
验证交付：确认生成文件路径、格式、token 数和安全警告，再把 RepoPack 交给下游评审、文档、调试或审计流程。

适用边界与注意点

适合需要把完整仓库作为上下文给 Claude、ChatGPT、Gemini 做分析、评审、审计或文档生成的场景，也适合跨大代码库排查问题或规划实现。如果只是改一个文件，没必要先打包；仓库里如果有 .env、硬编码凭据或密钥文件，要格外谨慎，建议先排除再打包。不要默认关闭安全检查，交付前仍要人工复核警告。