Communitygithub.com

nattergabriel/reseed

一個用於管理與分發 AI Agent 技能檔案的 CLI 工具,能跨專案同步技能。

reseed 是什麼?

reseed 是一款 CLI 工具,用於管理個人技能庫,並將技能安裝到專案中。技能是包含 `SKILL.md` 檔案的目錄,遵循 [Agent Skills 規範](https://agentskills.io)。它們存放在每個專案的技能目錄中(預設為 `.agents/skills/`,Claude Code 則為 `.claude/skills/`),能被 30 多種 Agent(如 Claude Code、Cursor、Copilot、Codex、Gemini CLI 等)讀取。您的角色主要負責專案端操作:檢查已安裝的項目、新增所需技能,以及保持同步。您也可以在使用者想要從 GitHub 拉取技能到其技能庫時執行 `reseed install`。此工具支援的平臺包括所有支援技能目錄標準化的 AI 編程助手。其核心運作方式為:`reseed add` 將技能從技能庫複製到專案中(實際檔案副本,非符號連結),而 `reseed sync` 則重新複製已安裝的技能以取得更新。

相容平台✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add nattergabriel/reseed

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

reseed:Agent 技能管理員

reseed 管理個人技能庫,並將技能安裝到專案中。技能是包含 SKILL.md 檔案的目錄,遵循 Agent Skills 規範。它們存放在每個專案的技能目錄中(預設為 .agents/skills/,Claude Code 則為 .claude/skills/),能被 30 多種 Agent(Claude Code、Cursor、Copilot、Codex、Gemini CLI 等)讀取。

您的工作主要位於專案端:檢查目前已安裝的內容、新增所需項目,以及保持同步。您也可以在使用者想要從 GitHub 將技能拉取到其技能庫時執行 reseed install,但除此之外,請讓使用者自行管理技能庫的結構與內容。

注意:單純執行 reseed(不帶參數)會開啟互動式 TUI。這是給使用者在他們自己的終端機中執行的,不是給您用的。如果他們想以視覺方式瀏覽技能庫,請告訴他們自行執行 reseed。對於其他所有操作,請使用下方的 CLI 命令。

快速參考

reseed                              # 互動式 TUI(供使用者執行,非您使用)
reseed init <path>                  # 建立新的技能庫(首次設定)
reseed status                       # 檢視此專案已安裝的內容
reseed list -l                      # 檢視使用者技能庫中的項目(含描述)
reseed add <skills-or-packs...>     # 將技能/技能包從技能庫複製到專案中
reseed add --all                    # 新增技能庫中的所有技能
reseed remove <skills...>           # 從專案中移除技能
reseed sync                         # 重新複製已安裝的技能(取得更新)
reseed install <user/repo>          # 從 GitHub 將技能擷取到技能庫中

運作方式

  • 使用者擁有一個技能庫:這是在他們機器上存放所有技能的目錄。其中可以包含技能包(具有名稱的相關技能群組)。
  • reseed add 將技能從技能庫複製到專案的技能目錄中。這些是真實的檔案副本,而非符號連結,因此它們會出現在 git 中,並且每位團隊成員都能取得。
  • reseed sync 重新複製同時存在於專案與技能庫中的技能,並拉入所有更新。不在技能庫中的技能會被保留不動,包括孤立技能:如果某個技能在新增到專案後被從技能庫中移除,sync 不會刪除這個過時的副本。如需刪除,請使用 reseed remove。
  • 沒有專案清單。同步是透過資料夾名稱進行比對。

典型工作流程

0. 確認目標目錄

在執行專案端命令之前,請先檢查 reseed 的目標目錄:

reseed config dir

如果輸出為 .agents/skills (default),但使用者使用的是 Claude Code(會從 .claude/skills/ 讀取),建議使用者執行 reseed config dir .claude/skills 一次以切換全域預設值。由於這會更改使用者層級的設定,執行前請先取得使用者同意。如果使用者不想變更預設值,可以在每個命令中傳入 --dir .claude/skills:

reseed --dir .claude/skills add commit

如果 reseed config dir 已經顯示正確的路徑,則無需覆寫。請直接執行下列命令。

1. 檢查已存在的內容

reseed status

如果技能目錄尚未存在也沒關係,reseed 會在您新增技能時自動建立。

2. 查看可用的技能

reseed list -l

這會顯示使用者技能庫中所有的技能與技能包,並附帶描述。請使用此命令了解可用項目,再建議要新增的內容。

3. 將技能新增到專案中

reseed add commit review python-base   # 在單一命令中混合技能與技能包
reseed add --all                       # 或一次新增所有內容

您可以在單一 reseed add 命令中傳入任意數量的技能與技能包,reseed 會自動將技能包展開為個別技能。請根據專案的技術棧與需求選擇合適的項目。

4. 保持技能更新

reseed sync

當使用者想要將技能的最新版本拉取到專案中時,執行此命令。

從 GitHub 安裝技能

install 與 add 執行不同功能:

  • reseed install 從 GitHub 擷取技能到使用者的技能庫中。它接受 user/repo[/path][@version] 格式的參考,而非 URL。
  • reseed add 將技能從技能庫複製到專案中。它接受本機的技能或技能包名稱。
reseed install user/repo                 # 來自儲存庫的所有技能
reseed install user/repo/path/to/skills  # 特定目錄下的技能
reseed install user/[email protected]            # 固定到某個版本標籤
reseed install user/repo --pack mypack   # 將它們分組為一個技能包

安裝完成後,使用 reseed add 將它們帶入專案中。

GitHub 的公開 API 每小時僅允許約 60 次未經驗證的請求,因此在短時間內連續執行多次安裝可能會觸發速率限制。如果 reseed install 因速率限制錯誤而失敗,建議使用者在環境中設定 GITHUB_TOKEN 以進行身分驗證。

當未安裝 reseed 時

如果找不到 reseed,請引導使用者執行安裝命令:

curl -fsSL https://raw.githubusercontent.com/nattergabriel/reseed/main/install.sh | sh

在 Windows 上,使用者可以從最新版本發佈頁面下載二進位檔案。

當尚未建立技能庫時

如果 reseed 已安裝,但命令失敗並顯示「library not initialized」,使用者需要先建立一個技能庫:

reseed init ~/skills    # 或任何使用者偏好的路徑

完成後,CLI 命令就會開始針對這個新的技能庫正常運作。

相關技能