★ FEATURED ARTICLE WordPress Agent Skills 上架指南GPL 合规、命名规则与 18 条插件目录规范【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skillsWordPress 插件上架 WordPress.org 之前最容易踩坑的就是 GPL 合规与命名规则。本指南带你逐条过一遍 WordPress.org 插件目录的 18 条规范并介绍如何用agent-skills仓库中的wp-plugin-directory-guidelines技能让 AI 助手帮你自动完成上架前审查。什么是 WordPress Agent SkillsAgent Skills 是一套喂给 AI 编程助手的专家知识包把 WordPress 官方文档中的开发规范、检查清单整理成结构化 Markdown让 AI 在写代码、审代码时直接遵循最佳实践而不是凭记忆瞎猜。其中与插件上架直接相关的技能位于skills/wp-plugin-directory-guidelines/SKILL.md — 18 条目录规范的权威参考references/gpl-compliance.md — GPL 许可兼容性完整对照表references/naming-rules.md — 命名与商标规则、Slug 黑名单references/guideline-review-checklist.md — 逐条规范的审查清单安装方式只需一条命令全局生效npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelinesGPL 合规上架第一关WordPress 本身采用GPLv2 or later许可这意味着通过 WordPress.org 分发的一切插件必须100% GPL 兼容——不只是 PHP 代码图片、字体、CSS、JS 资源全都算在内。有效的 License 头主插件文件头部必须包含有效的许可声明例如License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html哪些许可被接受、哪些直接拒绝类别例子结论GPL 家族GPL-2.0-or-later、GPL-3.0、LGPL✅ 推荐宽松许可MIT、BSD、ISC、Zlib✅ 可打包有条件兼容Apache-2.0仅兼容 GPLv3、MPL-2.0⚠️ 需核对上下文专有许可Proprietary、All Rights Reserved❌ 直接拒绝含限制条款CC-BY-NC、SSPL、BSL、Commons Clause、EPL❌ 直接拒绝四大常见 GPL 违规拆分许可免费部分 GPL、高级功能专有——违规混淆代码ionCube、Zend Guard 加密的 PHP——违规压缩 JS 若提供源码可接受缺失许可信息主文件没有License:头或包内没有 LICENSE 文件限制性条款仅限个人使用不得转售必须保留回链——统统违规。 一个反直觉的知识点GPL 插件可以卖钱。GPL 只要求接收者获得使用、修改、再分发的自由不禁止收费。命名规则别让商标毁了你的插件名命名错误是第二高发的拒审原因。核心规则一句话商标/项目名只能出现在连接词for、with、using、and之后。命名正误对照表插件名判定原因Shipping❌太泛化6 万个插件里没法区分Shipping Tracker for UPS✅描述清晰 有上下文WooCommerce Pricing Rates❌以商标开头暗示官方关联Pricing Rates for WooCommerce✅商标放在 for 之后PricingPress❌用-Press拼造商标词Best SEO Plugin for WordPress❌最高级 禁用词My Free Slider❌free 冗余目录里的插件都是免费的禁用词与 Slug 黑名单禁用词任何位置都不允许Facebook/Insta 等 Meta 品牌、WordPress/WP在目录里冗余、Trustpilot、Binance Pay不鼓励词plugin作首词、best、#1、Gutenberg等Slug 规则全小写、仅连字符、≤ 50 字符woocommerce-、jetpack-、yoast-等商标词不能开头woocommerce只能以for-woocommerce这类形式出现。完整的商标 Slug 静态黑名单见 naming-rules.md。18 条规范速览哪些是硬门槛完整的逐条审查清单在 guideline-review-checklist.md其中最常导致拒审的 6 条是#规范一句话要点1GPL 兼容许可全部资产 GPL 兼容 有效 License 头4人类可读代码禁止 PHP 混淆压缩 JS 必须能找到源码5禁止试用软件所有本地功能必须无需 Key/付费即可端到端使用7数据收集需同意未 opt-in 前禁止任何外部上报8禁止远程加载可执行代码JS/CSS 必须随包分发不能从第三方 CDN 拉17尊重商标与版权名称/Slug 遵守上述命名规则其中第 5 条无试用软件最容易误伤 freemium 模式非阻断、可关闭的升级提示是允许的但30 天后功能失效未付费就弹锁屏人为压低免费配额逼你升级——直接 FAIL。第 7、8 条则划出了 SaaS 集成的边界真正调用外部服务如 AI API、Mailchimp没问题但**外部服务器只是用来验证 License Key、实际处理全在本地**属于伪装会被拒。用 AI 助手做一次上架前审查安装技能后直接对 AI 说在我提交 WordPress.org 之前帮我审查这个插件的许可合规性。AI 会按照 SKILL.md 中的标准流程执行核对 License 头 → 走 18 条检查清单重点盯 1、4、5、7、8、17 条→ 用许可对照表核查每个第三方库 → 输出带文件路径和违规证据的审查报告。仓库里还有两个可复现的评估场景展示了完整的审查逻辑plugin-directory-license-review.json — 审查License: Proprietary主文件 MIT 库 CC-BY-NC 字体应如何判定plugin-directory-name-trademark.json — 校验WooCommerce Pricing Rates这类名称与 Slug 为何失败、如何改名上架前自查清单提交前花 10 分钟过一遍主文件有有效License:License URI:头所有打包库/字体/图片许可 GPL 兼容无混淆代码、无拆分许可名称不是占位符≥ 5 个字母数字字符且与 readme 一致名称无禁用词商标只出现在 for/with/using/and 之后Slug 小写、连字符、≤ 50 字符、无商标开头所有免费功能无需 Key 即可完整使用无任何未 opt-in 的外部数据上报readme.txt的Stable tag与插件头Version一致总结记住三件事就能避开 90% 的拒审全资产 GPL 兼容、商标放连接词之后、免费功能不锁门。把这些规则装进你的 AI 助手wp-plugin-directory-guidelines技能再对照 SKILL.md 的流程自查一遍你的插件就能平滑通过 WordPress.org 目录审查。【免费下载链接】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），仅供参考
阅读完成 · 觉得有帮助？
