Warp Common Skills：跨仓库复用的代理工作流

适合谁

当你有一套可复用的代理工作流、约定或操作程序，并且它在多个仓库都有用，需要放到共享位置而不是绑死在单个仓库时，再用这个仓库。它存放的是「跨仓库通用」的 agent skills，不是某个项目的私有脚本。

前置条件：当前代理按说明走 Warp。推荐安装命令带 --agent warp --global，不要把这条命令改成未点名的其他代理。技能必须真的对多于一个仓库有用；只在一个仓库需要时，不要硬塞进这个共享库。

编写侧：每个技能独占 .agents/skills/ 下的一个目录，必需文件是带 YAML frontmatter 的 SKILL.md，至少包含 kebab-case 的 name，以及说明做什么、何时该用的 description。不要编其他必填字段。

3 分钟完成第一次尝试

官方页面：

https://github.com/warpdotdev/common-skills

推荐安装（--global 会改本机全局技能，先确认仓库和 --agent warp 再执行）：

npx skills@latest add warpdotdev/common-skills --skill '*' --agent warp --global

说明没有写出 npx 装到磁盘的哪个目录。装完后回到 Warp，看这些 common skills 是否可被选用。不要把仓库里的 .agents/skills/ 直接当成你机器上的安装路径。

第一次不要改共享技能内容，也不要 fork。只选一个低风险的只读任务，让 Warp 按某个已装技能的 description 判断是否该用它。

成功信号：Warp 里能看到刚装上的技能，并且助手是按 description 决定是否调用。命令失败就停下，不要去掉 --agent warp 或改用未出现的安装器。

使用案例

案例一：给 Warp 全局装入全部 common skills。执行上面的 add ... --skill '*' --agent warp --global。--skill '*' 表示这个共享库里的技能集合。装完只核 Warp 能否选用，不要同时再装一套未点名的副本。

案例二：之后更新已安装的 Warp 技能。说明给出的命令是：

npx skills@latest update --global --agent warp

同样是全局写入。先确认当前 Warp 环境，再执行，然后看技能是否仍可选用。若某个共享技能需要仓库特例，说明要求加一个小的 local companion skill，而不是 fork 共享技能，除非改动对所有仓库都有用。第一次更新不要做 fork。

使用边界

主路径只证据到 Warp：add 与 update 都带 --agent warp --global。不要套到其他代理。

仓库内布局只证据到 .agents/skills/ 与 SKILL.md 的 name / description。不要把该目录写成 npx 的本机安装位置。

优先只复制仓库真正需要的技能；特例用 local companion，不要轻易 fork。

说明没有给出语言范围、定价或其他代理的安装命令。缺依据的项目保持未知。