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 命令就會開始針對這個新的技能庫正常運作。