Repomix

# Agent Skills 生成 Repomix 可以生成 [Claude Agent Skills](https://docs.anthropic.com/en/docs/claude-code/skills) 格式的輸出，建立一個結構化的 Skills 目錄，可作為 AI 助手的可重複使用程式碼庫參考。 當您想要參考遠端儲存庫的實作時，此功能特別強大。透過從開源專案生成 Skills，您可以輕鬆讓 Claude 在您編寫程式碼時參考特定的模式或實作。 Skills 生成不是生成單一打包檔案，而是建立一個包含多個參考檔案的結構化目錄，這些檔案針對 AI 理解和 grep 友善搜尋進行了最佳化。 > [!NOTE] > 這是一個實驗性功能。輸出格式和選項可能會根據使用者回饋在未來版本中發生變化。 ## 基本用法 從本地目錄生成 Skills： ```bash # 從當前目錄生成 Skills repomix --skill-generate # 使用自訂 Skills 名稱生成 repomix --skill-generate my-project-reference # 從特定目錄生成 repomix path/to/directory --skill-generate # 從遠端儲存庫生成 repomix --remote https://github.com/user/repo --skill-generate ``` ## Skills 儲存位置選擇 執行命令時，Repomix 會提示您選擇 Skills 的儲存位置： 1. **Personal Skills** (`~/.claude/skills/`) - 在您機器上的所有專案中可用 2. **Project Skills** (`.claude/skills/`) - 透過 git 與團隊共享 如果 Skills 目錄已存在，系統會提示您確認是否覆蓋。 > [!TIP] > 生成 Project Skills 時，建議將其新增到 `.gitignore` 以避免提交大型檔案： > ```gitignore > .claude/skills/repomix-reference-*/ > ``` ## 生成的結構 Skills 按以下結構生成： ```text .claude/skills/<skill-name>/ ├── SKILL.md # Skills 主要中繼資料和文件 └── references/ ├── summary.md # 目的、格式和統計資訊 ├── project-structure.md # 帶行數的目錄樹 ├── files.md # 所有檔案內容（grep 友善） └── tech-stack.md # 語言、框架、相依性 ``` ### 檔案說明 #### SKILL.md 主要 Skills 檔案包含： - Skills 名稱、描述和專案資訊 - 檔案數、行數和 token 數 - Skills 使用方法概述 - 檔案位置和格式說明 - 常見用例和提示 #### references/summary.md 包含： - **目的**：說明這是供 AI 使用的參考程式碼庫 - **檔案結構**：記錄每個參考檔案的內容 - **使用指南**：如何有效使用 Skills - **統計資訊**：按檔案類型、語言和最大檔案的分類 #### references/project-structure.md 帶有每個檔案行數的目錄樹，便於檔案發現： ```text src/ index.ts (42 lines) utils/ helpers.ts (128 lines) math.ts (87 lines) ``` #### references/files.md 所有帶語法高亮標頭的檔案內容，針對 grep 友善搜尋最佳化： ````markdown ## File: src/index.ts ```typescript import { sum } from './utils/helpers'; export function main() { console.log(sum(1, 2)); } ``` ```` #### references/tech-stack.md 從相依性檔案自動偵測的技術堆疊： - **語言**：TypeScript、JavaScript、Python 等 - **框架**：React、Next.js、Express、Django 等 - **執行環境版本**：Node.js、Python、Go 等 - **套件管理器**：npm、pnpm、poetry 等 - **相依性**：所有直接相依和開發相依 - **設定檔**：所有偵測到的設定檔 偵測來源檔案：`package.json`、`requirements.txt`、`Cargo.toml`、`go.mod`、`.nvmrc`、`pyproject.toml` 等。 ## 自動生成的 Skills 名稱 如果未提供名稱，Repomix 會使用以下模式自動生成： ```bash repomix src/ --skill-generate # → repomix-reference-src repomix --remote user/repo --skill-generate # → repomix-reference-repo repomix --skill-generate CustomName # → custom-name（規範化為 kebab-case） ``` Skills 名稱會： - 轉換為 kebab-case（小寫，連字號分隔） - 限制最多 64 個字元 - 防止路徑遍歷攻擊 ## 與 Repomix 選項整合 Skills 生成支援所有標準 Repomix 選項： ```bash # 使用檔案過濾生成 Skills repomix --skill-generate --include "src/**/*.ts" --ignore "**/*.test.ts" # 使用壓縮生成 Skills repomix --skill-generate --compress # 從遠端儲存庫生成 Skills repomix --remote yamadashy/repomix --skill-generate # 使用特定輸出格式選項生成 Skills repomix --skill-generate --remove-comments --remove-empty-lines ``` ### 僅文件 Skills 使用 `--include`，您可以生成僅包含 GitHub 儲存庫文件的 Skills。當您希望 Claude 在編寫程式碼時參考特定函式庫或框架的文件時，這很有用： ```bash # Claude Code Action 文件 repomix --remote https://github.com/anthropics/claude-code-action --include docs --skill-generate # Vite 文件 repomix --remote https://github.com/vitejs/vite --include docs --skill-generate # React 文件 repomix --remote https://github.com/reactjs/react.dev --include src/content --skill-generate ``` ## 限制 `--skill-generate` 選項不能與以下選項一起使用： - `--stdout` - Skills 輸出需要寫入檔案系統 - `--copy` - Skills 輸出是目錄，無法複製到剪貼簿 ## 使用生成的 Skills 生成後，您可以在 Claude 中使用這些 Skills： 1. **Claude Code**：如果儲存到 `~/.claude/skills/` 或 `.claude/skills/`，Skills 會自動可用 2. **Claude Web**：將 Skills 目錄上傳到 Claude 進行程式碼庫分析 3. **團隊共享**：將 `.claude/skills/` 提交到儲存庫供團隊使用 ## 範例工作流程 ### 建立個人參考庫 ```bash # 複製並分析一個有趣的開源專案 repomix --remote facebook/react --skill-generate react-reference # Skills 儲存到 ~/.claude/skills/react-reference/ # 現在您可以在任何 Claude 對話中參考 React 的程式碼庫 ``` ### 團隊專案文件 ```bash # 在您的專案目錄中 cd my-project # 為團隊生成 Skills repomix --skill-generate # 提示時選擇 "Project Skills" # Skills 儲存到 .claude/skills/repomix-reference-my-project/ # 提交並與團隊共享 git add .claude/skills/ git commit -m "Add codebase reference Skills" ``` ## 相關資源 - [Claude Code 外掛](/zh-tw/guide/claude-code-plugins) - 了解 Claude Code 的 Repomix 外掛 - [MCP 伺服器](/zh-tw/guide/mcp-server) - 替代整合方法 - [程式碼壓縮](/zh-tw/guide/code-compress) - 透過壓縮減少 token 數 - [設定](/zh-tw/guide/configuration) - 自訂 Repomix 行為