用途:把代码仓库整理成单个、token 高效的上下文包,包含目录树、关键文件与架构说明,供 AI 智能体推理。适合让智能体熟悉陌生代码库、代码审查、调试或开发新功能,以及生成可粘贴给模型或附加到任务的快照。若任务只涉及少数已知文件,直接读取即可,无需打包。
主要能力与流程:
- 先测绘再打包。用 git ls-files 查看顶层布局与文件数,用 tokei 或 cloc 统计各语言规模,识别入口点、主要模块和定义结构的配置。
- 严格排除。不包含 lockfile、node_modules/vendor/build 产物、.git、压缩或生成代码、二进制、媒体、快照与 fixtures、dist/coverage。可用 grep 过滤,或使用 npx repomix、files-to-prompt 等工具生成结构化包,但需检查其排除列表。
- 按预算分层。必含目录树、README、主要入口、公共接口/类型、关键配置;预算允许时加入核心业务逻辑;大叶子模块、测试、重复处理器只写一行用途摘要;其余仅作引用。先声明 token 预算,从底层逐级裁剪。
- 输出包结构:仓库名、结构(限深目录树)、架构(3–6 句说明组成、入口与数据流)、文件(路径加内容或摘要)、Omitted(被排除的 glob 及原因)。Omitted 部分为必需,让智能体知道自己看不到什么,从而主动索取而非臆测。
质量要求:在声明预算内保留架构摘要;仅凭目录树与摘要即可定位功能所在;不内联生成、锁或二进制内容;遗漏项需列出而非静默省略。
反模式:把所有文件倾倒到截断、为完整性内联 lockfile 或 dist/、只有目录树没有架构说明、静默遗漏导致智能体对未见代码自信推理。
限制:资料未提供具体安装命令、收费、价格、平台或效果数据;实际使用需依赖 git、tokei/cloc 等工具,且需自行设定 token 预算。