wp-plugin-development

wp-plugin-development 技能概览

wp-plugin-development 是一个面向 WordPress 的技能，专门用于构建、重构和加固插件，比通用提示词更少靠猜。它最适合处理插件架构、hooks、激活/停用/卸载行为、后台设置、数据存储、cron 任务以及对安全性敏感的代码路径。

这个技能适合做什么

当你的任务不只是“写点 PHP”，而是“让这个插件在 WordPress 里正确工作”时，就该用 wp-plugin-development 技能。它能帮助你处理那些最容易卡住进度的决策：bootstrap 文件该放哪里、hooks 应该怎么注册、设置如何安全保存，以及生命周期事件里要做什么。

最适合的用户和项目

这个技能适用于独立插件的后端开发、WordPress 大型仓库中的插件模块，以及现有代码库里的维护任务。尤其适合你需要一份尊重 WordPress 约定、而不是在其上硬造自定义框架的 wp-plugin-development 指南时使用。

它有什么不同

它的核心价值在于工作流纪律：在你改代码之前，先把你引导到插件入口点、生命周期规则、安全护栏和配套参考文件上。相比一次性的提示词，wp-plugin-development 更实用，因为它是按“先安装、再检查、后实现”的正确顺序设计的。

如何使用 wp-plugin-development 技能

安装并确认插件目标

请在你正在编辑的仓库上下文中使用 wp-plugin-development 安装命令：

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

安装完成后，先确认你到底在处理哪个插件。在完整站点仓库里，编辑任何内容之前，先确认 wp-content/plugins/ 或 mu-plugins/ 下正确的插件。这是最常见的失败点之一。

提供技能需要的起始信息

当你提供这些信息时，这个技能效果最好：仓库根目录、插件路径或主文件（如果已知）、WordPress/PHP 版本，以及站点是单站点还是多站点。如果你的目标依赖 WP-CLI 或发布打包，也要一开始说明。这些细节会影响 API 选择、兼容性，以及建议的修复是否安全可用。

用清晰的任务描述来提问

高质量输入要具体，不要空泛。比如：

• “重构插件 bootstrap，让仅后台使用的 hooks 延迟加载。”
• “新增一个设置页，包含 sanitization、capabilities 和默认保存值。”
• “修复激活流程，确保只有在注册后才 flush rewrite rules。”
• “审计这个插件的 nonce、escaping 和 SQL 安全问题。”

这类提示能帮助 wp-plugin-development 技能走对路径，而不是猜测你到底要的是结构、生命周期、设置还是安全工作。

先阅读这些文件

先看 SKILL.md，然后检查 references/structure.md、references/lifecycle.md、references/settings-api.md、references/security.md、references/data-and-cron.md 和 references/debugging.md。如果仓库里包含 scripts/detect_plugins.mjs，就运行它来快速定位 plugin headers。这个顺序能让你以最快路径从安装走到有用输出。

wp-plugin-development 技能常见问题

wp-plugin-development 只适合新插件吗？

不是。它同样适用于已有插件的重构、修复 bug 和清理代码。实际上，很多 wp-plugin-development 的使用场景，都是在纠正现有代码中的 hook 时机、生命周期行为或安全错误。

什么时候不该用这个技能？

如果你并没有在修改 WordPress 插件代码，就不要用它。它不适合通用 PHP 库、只做主题的工作，或者不涉及插件行为的 UI 文案修改。如果你的任务不属于 WordPress 插件后端开发，这套建议就会过于具体。

它比普通提示词更好吗？

当任务需要 WordPress 特定决策时，答案是肯定的。普通提示词也许能生成可运行的 PHP，但 wp-plugin-development 技能会在 bootstrap 结构、activation hooks、Settings API 用法以及 sanitization/escaping 上加上护栏，让结果更容易直接部署。

它适合初学者吗？

适合，只要你能说明插件目标，以及你想改哪个文件。初学者通常最能受益于这个技能的文件阅读路径，以及它在改代码前强调“先检查什么”。

如何改进 wp-plugin-development 技能

给技能真实约束，不要只给功能点

想最快提升结果，最有效的方法是把最关键的约束写清楚：兼容版本、多站点行为、插件是否已上线，或者你需要的是最小补丁还是清理式重构。这样可以避免 wp-plugin-development 技能建议那些理论上正确、但对你的发布并不合适的改动。

展示插件当前的结构

如果你想得到更好的代码改动，请把主插件文件、相关类名，以及当前的 hook 流程一起提供出来。例如：“bootstrap 在 my-plugin.php，后台代码无条件加载，设置存放在一个 option array 里。” 这样技能就有足够上下文，提出符合现有仓库结构的方案，而不是凭空设计一套新的。

直接要求你真正能用的输出

好的请求会明确告诉技能你想要什么结果：补丁计划、逐文件修改策略、安全审查，还是发布检查清单。如果你需要一份面向特定结果的 wp-plugin-development 指南，就要说清楚你想要的是“安全的最小改动”还是“更清晰的架构，并考虑 breaking changes”。

从症状迭代到修复

如果第一次回答太宽泛，就把问题收窄到具体故障模式：activation hook not firing、settings not saving、cron runs twice，或者 nonce check passes but authorization is missing。最有价值的改进循环是：症状 → 对应参考文件 → 代码修改 → 复查。这样能让技能始终聚焦在真正阻碍采用的那一部分插件上。