安装本地技能
不是用户命令。不要将其作为斜杠技能提供。永远不要将此工作流程应用于本技能(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。当新的符号链接属于git时,将它们与PR一起提交。
不要
- 在仍处于起草技能阶段、尚未请求PR时提示
- 通过此工作流程安装
install-local-skill - 全局(
-g)安装 - 将目录树复制到
.agents/skills/或.claude/skills/