揭秘 AI 创作：WordPress Agent Skills 如何用 GPT-5.2 Codex 生成并经人工审核-育师

揭秘 AI 创作：WordPress Agent Skills 如何用 GPT-5.2 Codex 生成并经人工审核

【免费下载链接】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 是一套专为 AI 编程助手打造的 WordPress 专家技能包：它由 GPT-5.2 Codex 基于官方文档智能生成，再经 WordPress 核心贡献者逐条人工审核，帮助 AI 助手写出"懂行"的 WordPress 代码。这篇文章将完整揭秘这套技能从 AI 生成到人工审核、再到实测验证的全流程。

🤔 WordPress Agent Skills 是什么？

一句话概括：它把 WordPress 开发专家的隐性知识，打包成 AI 助手能直接读懂的"操作手册"。

AI 编程助手虽然强大，但写 WordPress 时经常"翻车"：

🕰️ 生成过时的编码模式（Gutenberg 时代之前的老写法）
⚠️ 忽略插件开发中的关键安全细节
💥 缺少区块弃用处理，导致"Invalid block"报错
🔍 无视项目里已有的工具链和配置

Agent Skills 用可移植的指令、清单和脚本集合解决这些问题——AI 助手读取技能文件后，会按文档化的流程操作，而不是靠猜测。项目内置了 18 个技能，覆盖区块开发、区块主题、插件开发、REST API、性能优化、PHPStan 静态分析等主流场景。

📝 揭秘全流程：AI 生成的 5 个关键步骤

项目的 docs/ai-authorship.md 遵循 WordPress AI 指南公开了完整的创作披露，整个过程分为五步：

步骤	做了什么	关键细节
1️⃣ 素材收集	从 Gutenberg 主干文档和 WordPress 官方开发者文档收集最新资料	确保知识源头权威、时效
2️⃣ AI 生成	GPT-5.2 Codex（高推理模式）将大篇幅文档"蒸馏"成语义密集的指令文件	从文档到可执行指令的压缩
3️⃣ 人工审核	WordPress 贡献者逐条审核每个技能的准确性、最佳实践一致性与完整性	人类把关，兜底质量
4️⃣ AI 辅助测试	用 Claude、Copilot、Codex 等助手执行真实的 WordPress 开发任务（题目源自 WP Bench 基准）	实测验证，而非纸上谈兵
5️⃣ 迭代打磨	根据测试结果在 v1 发布前持续修正	测试驱动的改进闭环

💡核心思路：AI 负责把海量官方文档浓缩成紧凑的技能文件，人类负责判断"写得对不对"。两者分工，各发挥所长。

🧪 人工审核之后：测试如何保证可靠性？

生成 + 审核只是前半程，项目还用可复现的评估场景为每个技能"上保险"。

每个技能的测试场景都存放在 eval/scenarios/ 目录下，是一个个 JSON 文件，统一包含四要素：

name：场景名称（如"Add a settings page with Settings API"）
skills：该场景会调用的技能组合
query：模拟用户提出的真实任务
expected_behavior + success_criteria：预期的分步操作和成功标准

以 plugin-add-settings-page.json 为例，场景要求 AI 完成"新增插件设置页"任务，并明确校验：是否使用 Settings API、是否有 nonce 验证、是否做了权限检查、输出是否正确转义——6 项成功标准逐一核对。目前共有30+ 个场景覆盖插件、区块、主题、性能等方向。

值得注意的是项目的坦诚态度：在 docs/ai-authorship.md 中，团队明确说明技能"尚未经过正式评测系统运行，因为这样的系统尚不存在"，并承诺技能会随社区使用和纠错持续改进——这种透明度本身就是 AI 开源项目的最佳实践。

🧭 创作规范：AI 辅助写作 + 确定性护栏

技能的编写流程遵循 docs/authoring-guide.md 中的"起草 → 加固 → 发布"工作流，几条黄金法则值得借鉴：

📏保持SKILL.md简短：深度内容下沉到references/目录
🎯能用脚本就不用"猜"：仓库检测、版本检查、lint/test 命令发现，都封装成 scripts/ 下的确定性脚本
📦没有评估场景，就没有新技能：每个新技能必须至少附带一个 eval/scenarios/ 测试场景
🔗文件引用保持一跳：避免深层引用链，保证 AI 高效阅读

创作哲学详见 docs/principles.md：优先小而可组合的技能，而非一个"超级大技能"。

🚀 如何上手体验？一条命令安装

想让自己的 AI 助手也拥有这些 WordPress 专家技能？最快方式是单条命令安装指定技能：

npx skills add WordPress/agent-skills --skill wp-plugin-development

支持全局作用域（所有项目可用）和项目作用域（随仓库提交、团队共享），也可用 skillpack-install.mjs 脚本安装到 Codex、VS Code Copilot、Claude Code、Cursor 等工具。完整安装选项与贡献指南见 CONTRIBUTING.md 和 README.md。