wp-readme-optimizer

WordPress 插件 readme.txt 优化器

此技能会对 WordPress.org 插件的 readme.txt 文件进行结构化审核，为每个部分评分，然后生成完整的改写版本。目标是提升插件在 WordPress.org 插件目录中的曝光度，提高访客转化为安装的比例，并让插件页面更值得信赖。

改写方案位于 AGENTS.md——生成改写后的 readme 时请阅读该文件。

工作流

1. 阅读 readme.txt——如果附有文件，请阅读该文件。如果用户粘贴了内容，请使用该内容。如果两者都没有，请让用户提供 readme.txt 内容。
2. 推断目标关键词——评分前，确定此插件应针对哪些关键词争取排名。这是整个审核的基础。
3. 执行审核——为每个部分评分，并撰写具体、可操作的发现。
4. 生成改写版本——交付一份可直接替换的 readme.txt，并纳入所有审核发现。遵循 AGENTS.md 中的方案。

---

阶段 0：关键词推断

评分前，请输出：主要关键词（最可能带来安装的 2-3 个词语组成的短语）、次要关键词（3-4 个辅助词语）、推断依据（插件名称／标签／描述）、置信度（高／中／低）。

请通过以下问题进行推断：“如果 WordPress 网站所有者需要这个插件，他们会在搜索栏中输入什么？”查看插件名称、标签和第一段描述。如果置信度为低，请添加 ``，并根据最佳判断继续。

阶段 1 的所有评分均以推断出的关键词为基准。

---

阶段 1：审核

评分

为以下 8 个部分分别打分，每项满分 10 分（总分／80）。在审核开头显示汇总表。分数范围：65-80 表现出色（仅需润色）、45-64 整体扎实但存在不足、25-44 存在明显问题、0-24 仅达到最低要求。

每个部分撰写 2-5 条具体发现。每条发现应指出问题、说明其重要性，并提出修复建议。切勿泛泛而谈——始终引用实际内容。

各部分评估要点

插件名称和标签

• 名称是否描述了插件的功能，而不仅仅是品牌名称？
• 是否包含用户会搜索的主要关键词？
• 是否使用了最多 5 个标签？标签是否合适——搜索量高且与插件功能相关？
• 陌生用户能否仅凭名称立即了解插件的功能？

简短描述（<=150 个字符）

• 是否先说明用户面临的问题或能获得的好处，而不是先写插件名称？
• 是否少于 150 个字符（硬性限制——截断会降低点击率）？
• 是否自然地包含主要关键词？
• 是否具体明确（避免“强大”“简单”“最佳”等含糊说法）？
• 是否在 150 个字符之前完整结束，而不是截断在半句话中？

长描述

• 第一段是否以好处为重点、有吸引力，而不是以功能为主？
• 前 150 个词中是否使用了主要关键词？
• 是否使用 H2/H3 标题拆分文本（采用 == Heading == 语法）？
• 功能是否以用户收益的形式呈现，而不是单纯罗列？
• 是否包含社会证明，例如活跃安装量、评分或知名用户？
• 是否有明确的行动号召（例如指向 Pro 版、文档或演示的链接）？
• 是否包含常见问题内容或视频嵌入，以丰富页面内容？
• 是否自然融入次要关键词／长尾关键词？

安装

• 步骤是否编号且完整？
• 是否同时涵盖手动安装（FTP）和自动安装（仪表盘）方法？
• 是否提到了启用后的操作步骤？

常见问题

• 问题是否是实际用户会提出的问题（如有可能，请查看支持论坛中的主题）？
• 答案是否自然地包含关键词？
• 是否至少有一个问题能回应常见的异议或顾虑？
• 问题的措辞是否贴近用户的表达，而不是开发者的写法？

截图

• 是否有 == Screenshots == 部分？
• 每张截图是否都有说明文字（搜索引擎会索引说明文字）？
• 说明文字是否描述了用户看到的内容，并包含相关关键词？
• 截图数量是否足以展示关键 UI 流程？

更新日志

• 更新日志是否为最新？
• 是否采用 = X.X.X = 格式，并在其下方列出项目符号？
• 最新条目是否传达了面向用户的价值，而不只是写“bug 修复”？
• 更新频率是否合理可见（体现项目仍在积极维护）？

稳定标签与插件标头

• Stable tag: 是否与 /tags/ SVN 目录中的最新标签一致？
• Requires at least: 是否足够保守，不会排除用户？
• Tested up to: 是否为最新（与当前 WP 主要版本相差不超过 1-2 个）？
• 是否声明了 Requires PHP:？
• 是否声明了 License:（GPL-2.0-or-later）？

---

第 2 阶段：重写

审核完成后，编写完整的重写版 readme.txt。请阅读 AGENTS.md，了解完整的重写规则、各部分的写作指导和格式参考。

AGENTS.md 的章节：重写规则、插件名称与标签、简短描述、详细描述、安装、常见问题、截图、更新日志、稳定标签与标头、格式参考。

---

第 2.5 阶段：元数据与可读性检查

编写重写版 readme.txt 后，在提交前进行两轮检查：

1. 元数据检查——metadata-check 技能。 检查插件名称、简短描述和每个常见问题答案。检查内容包括信息前置、具体性、冗余内容、截断适配度、每个字段是否只表达一个要点。
2. 文案检查——readability-check 技能。 仅检查详细描述。跳过标头区块、更新日志和安装步骤。

WordPress.org 的受众遍布全球——许多用户以英语为第二语言。请直接应用改进。优先处理：(1) 简短描述；(2) 详细描述的第一段；(3) 常见问题答案。

---

输出格式

先输出包含评分表和各部分问题的 ## Audit，然后输出 ---，再输出包含完整文件（置于代码块中）的 ## Rewritten readme.txt。

---

核心原则

• 目录由 Elastic Search 驱动。 标题、标签、简短描述、各级标题和常见问题的问题中的关键词都会影响搜索排名；自然表达胜过关键词堆砌。
• 简短描述影响最大。 它是搜索结果摘要。文案薄弱会降低点击率，用户甚至不会阅读详细描述。
• 更新时效性是信任信号。 “上次更新”日期过久会导致安装量下降。
• 支持评分是排名因素。 如果描述可能引发不必要的负面评价，请指出。
• 截图说明会被索引。 它们是 SEO 内容，不只是用户体验内容。
• 围绕用户意图写作，而非罗列功能。 先讲用户能实现什么，而不是插件是什么。