安裝本地技能
非使用者指令。請勿將其提供為斜線技能。絕不要將此工作流程應用於此技能(install-local-skill)。
時機
在使用者要求您建立 PR(或您正在建立該 PR)之後執行,且僅限於此次操作建立或更新了 skills/<name>/ 目錄下的技能(install-local-skill 除外)。
以下情況完全跳過:
- 僅觸及
install-local-skill技能 - 使用者從未要求建立 PR,且您也未開啟 PR
- 上下文已顯示技能已發布且本地安裝與來源一致(請見延後)
延後(暫勿提示)
若不確定技能是否已發布,或 PR 正在進行中,請先檢查安裝狀態 — 在確認技能遺失或過時之前,不要詢問。
從儲存庫根目錄執行:
node skills/install-local-skill/scripts/diff-install.mjs --skill <name>
省略 --skill 則掃描所有編寫的技能(此技能除外)。
快速路徑:如果 .agents/skills/<name> 和 .claude/skills/<name> 已解析為與 skills/<name> 相同的真實路徑,則狀態為 ok — 請勿提示。僅在安裝非此符號連結佈局時才執行目錄 diff。
僅當 needsInstall 為非空(或該技能的 status 為 missing、stale 或 wrong-link)時才提示。
詢問
僅詢問一次,並提及技能名稱:
在本儲存庫中安裝
<name>本地版本(將.agents/.claude符號連結到skills/),以便 Cloud Agents 和其他工具能夠使用?
沉默不等於同意。僅在明確表示「是」後才繼續。
安裝(與此儲存庫相同的方法)
請勿使用 npx skills add(它會將內容複製到 .agents/skills/ 中)。在同意後:
node skills/install-local-skill/scripts/install.mjs <name>
這會將專案安裝替換為相對符號連結:
.agents/skills/<name>→../../skills/<name>.claude/skills/<name>→../../.agents/skills/<name>
然後重新執行 diff-install.mjs --skill <name> 並確認 status 為 ok。將新的符號連結與 PR 一起提交(若它們應納入 Git)。
不要
- 在仍在草擬技能、尚未要求 PR 時提示
- 透過此工作流程安裝
install-local-skill - 進行全域(
-g)安裝 - 將目錄樹複製到
.agents/skills/或.claude/skills/