WordPress Agent Skills 打包分发指南：skillpack 一键构建 Codex、Claude、Cursor 多目标
【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills
WordPress Agent Skills（agent-skills）是一套为 AI 编程助手提供专家级 WordPress 知识的技能包，涵盖块开发、主题、插件与最佳实践。而skillpack是项目内置的打包分发工具，只需两条命令，就能把skills/目录下的全部技能按 Codex、Claude、Cursor、VS Code 乃至 Antigravity 的目录布局，构建并安装到你的 WordPress 项目中，无需手动复制或配置软链接。
📦 什么是 skillpack？为什么需要它
agent-skills 仓库以skills/目录为唯一的"事实来源"，每个技能是一个独立文件夹（含SKILL.md指令、references/深度文档和可选脚本）。但不同 AI 助手的技能目录约定各不相同——Codex 认.codex/skills/，Claude Code 认.claude/skills/，Cursor 认.cursor/skills/。
skillpack 解决了三个痛点：
- 一套源码，多端输出：一次构建，生成各助手对应布局的打包副本
- 纯文件复制，拒绝软链接：因为部分助手（如 Codex）会忽略被软链接的目录，脚本内部会主动检测并拒绝复制软链接
- 可增量、可预览：支持按技能名筛选、dry-run 预览、replace/merge 两种安装模式
核心就两个脚本：
| 脚本 | 职责 |
|---|---|
| skillpack-build.mjs | 从skills/构建dist/打包副本 |
| skillpack-install.mjs | 将dist/安装到目标仓库或用户主目录 |
🚀 快速上手：3 步完成多目标构建与分发
第 1 步：克隆仓库
git clone https://gitcode.com/gh_mirrors/agents/agent-skills cd agent-skills第 2 步：构建 dist 打包副本
node shared/scripts/skillpack-build.mjs --clean构建成功后，dist/下会按各助手的仓库布局生成 4 套默认输出：
dist/codex/.codex/skills/*→ OpenAI Codexdist/vscode/.github/skills/*→ VS Code / Copilotdist/claude/.claude/skills/*→ Claude Codedist/cursor/.cursor/skills/*→ Cursor
第 3 步：安装到你的 WordPress 项目
node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor执行后，你的 WordPress 项目里会自动出现.codex/skills/、.github/skills/、.claude/skills/、.cursor/skills/四个目录，团队成员提交后人人受益。
🎯 Antigravity：按需加入的第五个目标
Antigravity 是默认不参与构建的目标，需要显式通过--targets加入：
node shared/scripts/skillpack-build.mjs --clean --targets=codex,vscode,claude,cursor,antigravity node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor,antigravity这样会额外生成并安装到.agents/skills/。安装脚本会自动校验目标名，传入未知目标会立即报错并列出所有合法值，避免静默失败。
🌐 全局安装：让 WordPress 技能跨项目可用
如果不想逐个项目安装，可以用全局目标，技能会装到用户主目录，在你所有项目中自动生效：
- Claude Code：
node shared/scripts/skillpack-install.mjs --global→ 安装到~/.claude/skills/ - Cursor：
node shared/scripts/skillpack-install.mjs --targets=cursor-global→ 安装到~/.cursor/skills/ - Antigravity：先构建
--targets=antigravity，再执行node shared/scripts/skillpack-install.mjs --targets=antigravity-global→ 安装到~/.gemini/antigravity/skills/
💡 全局与项目级可以同时使用。当技能在两个作用域都存在时，项目级版本优先——方便你为特定项目定制技能。
🛠️ 实用参数详解
安装脚本支持几个很实用的选项（详见 docs/packaging.md）：
# 查看已构建的可用技能列表 node shared/scripts/skillpack-install.mjs --list # 干跑预览：只显示会安装什么，不做任何修改 node shared/scripts/skillpack-install.mjs --global --dry-run # 只安装指定技能（如只装 WP-CLI 运维技能） node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude,cursor --skills=wp-wpcli-and-ops两种安装模式：
replace（默认）：覆盖已安装的同名技能目录，保证版本一致merge：保留目标目录已有内容，适合你本地魔改过技能时
构建侧同样支持筛选：node shared/scripts/skillpack-build.mjs --skills=wp-playground,wp-block-development可以只打包指定技能，--out=可自定义输出目录。
📂 延伸阅读：仓库中值得关注的文件
- 打包分发说明：docs/packaging.md
- 技能编写规范：docs/authoring-guide.md
- 构建脚本源码：shared/scripts/skillpack-build.mjs
- 安装脚本源码：shared/scripts/skillpack-install.mjs
- 构建安装评测场景：eval/scenarios/skillpack-build-and-install.json
✅ 小结
skillpack 的设计思路非常清晰：skills/是唯一源码，构建产出多目标布局，安装脚本负责落位。无论你是想给整个团队的项目仓库统一注入 WordPress 专家知识（项目级安装），还是想让自己的 Claude Code / Cursor 在所有项目中都能"懂 WordPress"（全局安装），都只需两行命令即可完成。相比手动复制文件夹再改目录名，这种方式更可靠、可重复，也天然规避了软链接兼容性问题。
【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
