Repomix Explorer Skill 使用指南让 AI 助手打包、检索并洞察代码库【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix本文面向 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent 等 AI 编码助手的使用者讲解如何在当前 Repomix 仓库中安装并运用Repomix Explorer这个即用型 Agent Skill。读完本文你将掌握三种安装方式Claude Code 插件、Skills CLI、Hermes 原生命令、自然语言驱动的远程/本地代码库分析流程以及背后 Repomix CLI 打包、grep 检索与洞察输出的完整工作原理。什么是 Repomix Explorer SkillRepomix 仓库内置了一个开箱即用的 Agent Skill ——Repomix Explorer。它的作用很简单让 AI 编码助手借助 Repomix CLI把一段代码库远程或本地打包成单个 AI 友好文件再通过读取与模式搜索grep分析这份输出最终给出结构、指标与可执行的建议。该 Skill 面向 Claude Code 以及所有兼容Agent Skills 格式的 AI 助手。它的实体定义位于仓库的 skills/repomix-explorer/SKILL.md其中明确规定了触发与不触发场景应该触发的场景结构/概览类请求analyze this repo、whats the structure、whats in vercel/next.js跨文件的模式发现find all auth code、where are the API endpoints、show me all React components指标统计how many files/tokens、largest files、TypeScript vs JavaScript ratio远程仓库任意 github.com URL 或用户想探索的 owner/repo 简写不应该触发的场景对当前项目做编辑、重构或写代码读取或搜索本地项目中已知的具体文件这种情况应直接用 Read 或 grep本地项目中用一次 grep 就能回答的单个符号查询Git 操作、运行测试、构建或安装一句话概括定位它面向对陌生或大型仓库的高层理解而不是对已知文件的定点修改。快速安装1. Claude Code安装官方插件如果使用 Claude Code直接安装官方 Repomix Explorer 插件/plugin marketplace add yamadashy/repomix /plugin install repomix-explorerrepomix安装后Claude Code 会提供带命名空间的命令例如/repomix-explorer:explore-local与/repomix-explorer:explore-remote。完整的配置说明见 Claude Code 插件指南。2. Codex、Cursor、OpenClaw 等Skills CLI 安装独立 Skill对于 Codex、Cursor、OpenClaw 及其他兼容 Agent Skills 格式的助手使用 Skills CLI 安装独立 Skillnpx skills add yamadashy/repomix --skill repomix-explorer如果要指定目标助手传入--agent参数npx skills add yamadashy/repomix --skill repomix-explorer --agent codex npx skills add yamadashy/repomix --skill repomix-explorer --agent openclaw3. Hermes Agent单文件安装对于 Hermes Agent使用其原生 skills 命令安装单文件 Skillhermes skills install https://raw.githubusercontent.com/yamadashy/repomix/main/skills/repomix-explorer/SKILL.md如果你主要用 Hermes Agent 做仓库分析MCP Server 指南 也值得关注——它会直接把 Repomix 以 MCP Server 形式运行是另一种集成方式。安装后如何使用自然语言分析代码库安装完成后你可以直接用自然语言向 AI 助手下达分析指令。分析远程仓库Whats the structure of this repo? https://github.com/facebook/react探索本地代码库Whats in this project? ~/projects/my-app这不只对看懂别人的代码有用——当你希望参照自己其他仓库的实现来开发功能时同样高效让 AI 分析你的另一个项目再对照它的模式落地到当前代码。工作原理三步走的核心工作流Repomix Explorer Skill 引导 AI 助手完成一条完整链路运行 repomix 命令—— 把仓库打包成 AI 友好格式XML 等分析输出文件—— 用 grep 模式搜索定位相关代码提供洞察—— 汇报结构、指标与可操作建议细化到 Skill 内部见 skills/repomix-explorer/SKILL.md实际执行的是四步工作流步骤动作关键点Step 1打包仓库远程仓库--remote本地目录直接给路径远程输出一律写/tmp避免污染当前项目目录Step 2检查命令输出记录 Files processed、Total characters、Total tokens、输出文件位置Step 3分析输出文件先看文件树与指标摘要再用 grep 做模式搜索Step 4提供洞察汇报指标、描述结构、高亮发现、给出下一步建议Repomix 命令与核心参数详解命令基本形态# 远程仓库输出到 /tmp 避免污染当前项目 npx repomixlatest --remote repo --output /tmp/repo-name-analysis.xml # 本地目录 npx repomixlatest [directory] [options]常用参数一览参数作用默认值 / 说明--style format输出格式xml / markdown / json / plain默认xml推荐优先使用--compress启用 Tree-sitter 压缩约减少 70% token大仓库10 万行务必使用--include patterns只包含匹配的 glob 模式如src/**/*.ts,**/*.md可多模式逗号分隔--ignore patterns额外排除模式如*.test.js,docs/**--output path自定义输出路径默认repomix-output.xml--remote-branch name指定远程仓库的分支、标签或 commit默认远程仓库默认分支实际命令示例# 基本远程打包输出到 /tmp npx repomixlatest --remote yamadashy/repomix --output /tmp/repomix-analysis.xml # 基本本地打包 npx repomixlatest # 打包指定目录 npx repomixlatest ./src # 大仓库开启压缩输出到 /tmp npx repomixlatest --remote facebook/react --compress --output /tmp/react-analysis.xml # 只包含特定文件类型 npx repomixlatest --include **/*.{ts,tsx,js,jsx}这些参数与仓库 CLI 的完整定义一一对应可对照 src/cli/cliRun.ts 中的 Repomix Output Options、File Selection Options 与 Remote Repository Options 分组核实。例如--style支持xml, markdown, json, plain四种取值--remote支持 GitHub URL 或user/repo简写--remote-branch可指定分支、标签或 commit。命令运行后的输出信息repomix 打包完成后会在控制台显示四类信息AI 助手应记录它们并用于后续洞察Files processed—— 纳入打包的文件数Total characters—— 内容总字符数Total tokens—— 预估 AI token 数Output file location—— 输出文件保存位置默认./repomix-output.xml高效分析技巧grep 优先按需读取Skill 内置了一条明确的最佳实践大文件优先用 grep 模式搜索而不是整文件读取。结构概览先行搜索输出文件中的文件树file tree区块通常靠近文件开头检查 metrics 摘要获取整体统计常用 grep 模式# 函数与类 grep -iE export.*function|export.*class|function |class file.xml # 导入与依赖 grep -iE import.*from|require\( file.xml # 配置 grep -iE config|Config|configuration file.xml # 认证/授权 grep -iE auth|login|password|token|jwt file.xml # API 端点 grep -iE router|route|endpoint|api file.xml # 数据库/模型 grep -iE model|schema|database|query file.xml # 错误处理 grep -iE error|exception|try.*catch file.xml带上下文的搜索与分段读取# 带上下文搜索 grep -iE -A 5 -B 5 authentication|auth repomix-output.xml # 读取具体区块 # 大输出文件用 offset/limit 分段读小文件可整体读输出格式选型建议格式特点适用场景XML默认结构化最强、文件边界清晰结构化分析无特殊需求时首选Plain更易 grep但结构弱纯文本检索Markdown人类可读性好文档化产出JSON机器可读程序化分析文件管理默认输出./repomix-output.xml用--output指定自定义路径分析多个仓库时避免互相覆盖大文件分析结束后建议清理rm repomix-output.xml空间充足也可保留备用Skill 内置内容拆解Repomix Explorer Skill 的 SKILL.md 本身就是一个高质量 Agent Skill 模板包含四个核心模块用户意图识别User Intent Examples—— 覆盖远程仓库、本地仓库、模式发现、指标统计四大类提问方式帮助 AI 从自然语言中准确判断用户想要什么分析Repomix 命令指南Responsibilities / Workflow—— 知道何时用--remote、何时直接打包目录、何时加--compress、何时用--include收窄范围如仓库超过 10 万行时优先压缩分析工作流Workflow—— 打包 → 检查输出 → grep 定位 → 阅读 → 汇报的结构化方法最佳实践Best Practices—— 效率优先原则先 grep 再整读、自定义输出路径防覆盖、按需清理大文件、信任 Repomix 内置安全检查自动排除敏感文件此外 SKILL.md 还附带了错误处理与自检清单Self-Verification Checklist包括命令是否成功运行是否记录了输出指标是否在整读大区块前先用了 grep洞察是否基于输出中的真实数据是否给出了文件路径与行号引用是否提示了下一步探索方向是否提及输出文件位置与清理建议——这些约束保证了 AI 的分析结果可追溯、可验证。延伸用--skill-generate从任意代码库生成自己的 Skill理解了 Repomix Explorer 之后值得了解它的反向能力Repomix 本身可以从任意代码库自动生成 Agent Skill这正是 Agent Skills 生成指南 的主题。CLI 侧提供了三个相关参数见 src/cli/cliRun.ts--skill-generate [name]—— 以 Claude Agent Skills 格式输出到.claude/skills/name/目录省略 name 时自动生成--skill-project-name name—— 覆盖生成的 Skill 描述中的项目名--skill-output path—— 直接指定 Skill 输出目录跳过交互式位置询问从源码看生成流程由 src/core/skill/packSkill.ts 驱动分三步先生成 Skill 引用文件summary、structure、files、tech-stacks再基于 files 区块计算精确 token 数最后渲染 SKILL.md。输出目录结构由 src/core/skill/writeSkillOutput.ts 保证skillDir/ ├── SKILL.md └── references/ ├── summary.md # 用途、格式说明与统计 ├── project-structure.md # 带行数的目录树 ├── files.md # 全部文件内容 └── tech-stacks.md # 检测到技术栈时生成SKILL.md 的渲染模板在 src/core/skill/skillStyle.ts遵循 Agent Skills 的渐进式披露progressive disclosure最佳实践入口只放元数据与用法指引正文内容全部放在references/下供 AI 按需检索。Skill 名称的规范化转 kebab-case、最长 64 字符、拒绝路径穿越由 src/core/skill/skillUtils.ts 的validateSkillName完成远程场景下默认名形如repomix-reference-repo-name。这条能力同样暴露在 MCP Server 中generate_skill工具见 src/mcp/tools/generateSkillTool.ts接收目录、skillName、compress、includePatterns、ignorePatterns 等参数直接在project/.claude/skills/name/下生成项目级 Skill与团队通过版本控制共享。相关资源Agent Skills 生成指南 —— 从代码库生成你自己的 SkillClaude Code 插件指南 —— Repomix 的 Claude Code 插件配置MCP Server 指南 —— 把 Repomix 作为 MCP Server 运行的替代集成方式若想查看 CLI 的全部可用选项可随时运行npx repomixlatest --help。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Repomix Explorer Skill 使用指南：让 AI 助手打包、检索并洞察代码库
Repomix Explorer Skill 使用指南让 AI 助手打包、检索并洞察代码库【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix本文面向 Claude Code、Codex、Cursor、OpenClaw、Hermes Agent 等 AI 编码助手的使用者讲解如何在当前 Repomix 仓库中安装并运用Repomix Explorer这个即用型 Agent Skill。读完本文你将掌握三种安装方式Claude Code 插件、Skills CLI、Hermes 原生命令、自然语言驱动的远程/本地代码库分析流程以及背后 Repomix CLI 打包、grep 检索与洞察输出的完整工作原理。什么是 Repomix Explorer SkillRepomix 仓库内置了一个开箱即用的 Agent Skill ——Repomix Explorer。它的作用很简单让 AI 编码助手借助 Repomix CLI把一段代码库远程或本地打包成单个 AI 友好文件再通过读取与模式搜索grep分析这份输出最终给出结构、指标与可执行的建议。该 Skill 面向 Claude Code 以及所有兼容Agent Skills 格式的 AI 助手。它的实体定义位于仓库的 skills/repomix-explorer/SKILL.md其中明确规定了触发与不触发场景应该触发的场景结构/概览类请求analyze this repo、whats the structure、whats in vercel/next.js跨文件的模式发现find all auth code、where are the API endpoints、show me all React components指标统计how many files/tokens、largest files、TypeScript vs JavaScript ratio远程仓库任意 github.com URL 或用户想探索的 owner/repo 简写不应该触发的场景对当前项目做编辑、重构或写代码读取或搜索本地项目中已知的具体文件这种情况应直接用 Read 或 grep本地项目中用一次 grep 就能回答的单个符号查询Git 操作、运行测试、构建或安装一句话概括定位它面向对陌生或大型仓库的高层理解而不是对已知文件的定点修改。快速安装1. Claude Code安装官方插件如果使用 Claude Code直接安装官方 Repomix Explorer 插件/plugin marketplace add yamadashy/repomix /plugin install repomix-explorerrepomix安装后Claude Code 会提供带命名空间的命令例如/repomix-explorer:explore-local与/repomix-explorer:explore-remote。完整的配置说明见 Claude Code 插件指南。2. Codex、Cursor、OpenClaw 等Skills CLI 安装独立 Skill对于 Codex、Cursor、OpenClaw 及其他兼容 Agent Skills 格式的助手使用 Skills CLI 安装独立 Skillnpx skills add yamadashy/repomix --skill repomix-explorer如果要指定目标助手传入--agent参数npx skills add yamadashy/repomix --skill repomix-explorer --agent codex npx skills add yamadashy/repomix --skill repomix-explorer --agent openclaw3. Hermes Agent单文件安装对于 Hermes Agent使用其原生 skills 命令安装单文件 Skillhermes skills install https://raw.githubusercontent.com/yamadashy/repomix/main/skills/repomix-explorer/SKILL.md如果你主要用 Hermes Agent 做仓库分析MCP Server 指南 也值得关注——它会直接把 Repomix 以 MCP Server 形式运行是另一种集成方式。安装后如何使用自然语言分析代码库安装完成后你可以直接用自然语言向 AI 助手下达分析指令。分析远程仓库Whats the structure of this repo? https://github.com/facebook/react探索本地代码库Whats in this project? ~/projects/my-app这不只对看懂别人的代码有用——当你希望参照自己其他仓库的实现来开发功能时同样高效让 AI 分析你的另一个项目再对照它的模式落地到当前代码。工作原理三步走的核心工作流Repomix Explorer Skill 引导 AI 助手完成一条完整链路运行 repomix 命令—— 把仓库打包成 AI 友好格式XML 等分析输出文件—— 用 grep 模式搜索定位相关代码提供洞察—— 汇报结构、指标与可操作建议细化到 Skill 内部见 skills/repomix-explorer/SKILL.md实际执行的是四步工作流步骤动作关键点Step 1打包仓库远程仓库--remote本地目录直接给路径远程输出一律写/tmp避免污染当前项目目录Step 2检查命令输出记录 Files processed、Total characters、Total tokens、输出文件位置Step 3分析输出文件先看文件树与指标摘要再用 grep 做模式搜索Step 4提供洞察汇报指标、描述结构、高亮发现、给出下一步建议Repomix 命令与核心参数详解命令基本形态# 远程仓库输出到 /tmp 避免污染当前项目 npx repomixlatest --remote repo --output /tmp/repo-name-analysis.xml # 本地目录 npx repomixlatest [directory] [options]常用参数一览参数作用默认值 / 说明--style format输出格式xml / markdown / json / plain默认xml推荐优先使用--compress启用 Tree-sitter 压缩约减少 70% token大仓库10 万行务必使用--include patterns只包含匹配的 glob 模式如src/**/*.ts,**/*.md可多模式逗号分隔--ignore patterns额外排除模式如*.test.js,docs/**--output path自定义输出路径默认repomix-output.xml--remote-branch name指定远程仓库的分支、标签或 commit默认远程仓库默认分支实际命令示例# 基本远程打包输出到 /tmp npx repomixlatest --remote yamadashy/repomix --output /tmp/repomix-analysis.xml # 基本本地打包 npx repomixlatest # 打包指定目录 npx repomixlatest ./src # 大仓库开启压缩输出到 /tmp npx repomixlatest --remote facebook/react --compress --output /tmp/react-analysis.xml # 只包含特定文件类型 npx repomixlatest --include **/*.{ts,tsx,js,jsx}这些参数与仓库 CLI 的完整定义一一对应可对照 src/cli/cliRun.ts 中的 Repomix Output Options、File Selection Options 与 Remote Repository Options 分组核实。例如--style支持xml, markdown, json, plain四种取值--remote支持 GitHub URL 或user/repo简写--remote-branch可指定分支、标签或 commit。命令运行后的输出信息repomix 打包完成后会在控制台显示四类信息AI 助手应记录它们并用于后续洞察Files processed—— 纳入打包的文件数Total characters—— 内容总字符数Total tokens—— 预估 AI token 数Output file location—— 输出文件保存位置默认./repomix-output.xml高效分析技巧grep 优先按需读取Skill 内置了一条明确的最佳实践大文件优先用 grep 模式搜索而不是整文件读取。结构概览先行搜索输出文件中的文件树file tree区块通常靠近文件开头检查 metrics 摘要获取整体统计常用 grep 模式# 函数与类 grep -iE export.*function|export.*class|function |class file.xml # 导入与依赖 grep -iE import.*from|require\( file.xml # 配置 grep -iE config|Config|configuration file.xml # 认证/授权 grep -iE auth|login|password|token|jwt file.xml # API 端点 grep -iE router|route|endpoint|api file.xml # 数据库/模型 grep -iE model|schema|database|query file.xml # 错误处理 grep -iE error|exception|try.*catch file.xml带上下文的搜索与分段读取# 带上下文搜索 grep -iE -A 5 -B 5 authentication|auth repomix-output.xml # 读取具体区块 # 大输出文件用 offset/limit 分段读小文件可整体读输出格式选型建议格式特点适用场景XML默认结构化最强、文件边界清晰结构化分析无特殊需求时首选Plain更易 grep但结构弱纯文本检索Markdown人类可读性好文档化产出JSON机器可读程序化分析文件管理默认输出./repomix-output.xml用--output指定自定义路径分析多个仓库时避免互相覆盖大文件分析结束后建议清理rm repomix-output.xml空间充足也可保留备用Skill 内置内容拆解Repomix Explorer Skill 的 SKILL.md 本身就是一个高质量 Agent Skill 模板包含四个核心模块用户意图识别User Intent Examples—— 覆盖远程仓库、本地仓库、模式发现、指标统计四大类提问方式帮助 AI 从自然语言中准确判断用户想要什么分析Repomix 命令指南Responsibilities / Workflow—— 知道何时用--remote、何时直接打包目录、何时加--compress、何时用--include收窄范围如仓库超过 10 万行时优先压缩分析工作流Workflow—— 打包 → 检查输出 → grep 定位 → 阅读 → 汇报的结构化方法最佳实践Best Practices—— 效率优先原则先 grep 再整读、自定义输出路径防覆盖、按需清理大文件、信任 Repomix 内置安全检查自动排除敏感文件此外 SKILL.md 还附带了错误处理与自检清单Self-Verification Checklist包括命令是否成功运行是否记录了输出指标是否在整读大区块前先用了 grep洞察是否基于输出中的真实数据是否给出了文件路径与行号引用是否提示了下一步探索方向是否提及输出文件位置与清理建议——这些约束保证了 AI 的分析结果可追溯、可验证。延伸用--skill-generate从任意代码库生成自己的 Skill理解了 Repomix Explorer 之后值得了解它的反向能力Repomix 本身可以从任意代码库自动生成 Agent Skill这正是 Agent Skills 生成指南 的主题。CLI 侧提供了三个相关参数见 src/cli/cliRun.ts--skill-generate [name]—— 以 Claude Agent Skills 格式输出到.claude/skills/name/目录省略 name 时自动生成--skill-project-name name—— 覆盖生成的 Skill 描述中的项目名--skill-output path—— 直接指定 Skill 输出目录跳过交互式位置询问从源码看生成流程由 src/core/skill/packSkill.ts 驱动分三步先生成 Skill 引用文件summary、structure、files、tech-stacks再基于 files 区块计算精确 token 数最后渲染 SKILL.md。输出目录结构由 src/core/skill/writeSkillOutput.ts 保证skillDir/ ├── SKILL.md └── references/ ├── summary.md # 用途、格式说明与统计 ├── project-structure.md # 带行数的目录树 ├── files.md # 全部文件内容 └── tech-stacks.md # 检测到技术栈时生成SKILL.md 的渲染模板在 src/core/skill/skillStyle.ts遵循 Agent Skills 的渐进式披露progressive disclosure最佳实践入口只放元数据与用法指引正文内容全部放在references/下供 AI 按需检索。Skill 名称的规范化转 kebab-case、最长 64 字符、拒绝路径穿越由 src/core/skill/skillUtils.ts 的validateSkillName完成远程场景下默认名形如repomix-reference-repo-name。这条能力同样暴露在 MCP Server 中generate_skill工具见 src/mcp/tools/generateSkillTool.ts接收目录、skillName、compress、includePatterns、ignorePatterns 等参数直接在project/.claude/skills/name/下生成项目级 Skill与团队通过版本控制共享。相关资源Agent Skills 生成指南 —— 从代码库生成你自己的 SkillClaude Code 插件指南 —— Repomix 的 Claude Code 插件配置MCP Server 指南 —— 把 Repomix 作为 MCP Server 运行的替代集成方式若想查看 CLI 的全部可用选项可随时运行npx repomixlatest --help。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考