尧图网页设计 
成为贡献者WordPress Agent Skills 社区协作与技能改进全流程【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skillsWordPress Agent Skills是一个为 AI 编程助手提供专家级 WordPress 知识的开源项目——它把区块开发、主题、插件开发和安全最佳实践整理成结构化技能包让 AI 助手不再写出过时的代码或漏掉关键安全细节。贡献这个项目不需要你是编码高手技能大多用 Markdown 写成本质上是一份份清晰的步骤清单和决策树。只要你深入理解 WordPress 的某个领域就能做出有价值的贡献。本文将带你走完从提交第一个 PR 到发布全新技能的完整协作流程。为什么这个项目适合新手贡献 与传统开源项目不同Agent Skills 的核心是知识的结构化沉淀而非代码量项目特点对新贡献者意味着什么技能以 Markdown 为主会写文档就能贡献无需深厚代码功底代码是步骤清单和决策树你熟悉的 WordPress 经验可以直接转化内置脚手架和验证脚本有确定性护栏降低入门门槛每个技能都有评测场景贡献有明确的验收标准项目的设计原则强调小而可组合优于大而全、SKILL.md保持简短、深度内容下沉到references/、可靠性要求高时优先用确定性脚本。理解了这些你就理解了整个项目的协作语言。四种参与社区协作的方式根据 CONTRIBUTING.md贡献主要有四条路径难度由低到高1. 改进现有技能最容易上手WordPress 迭代很快任何技能都可能过时。你可以修正过时信息— 发现某个 API 或行为变了直接开 PR补充边缘情况— 踩到过没被记录的坑加进 Failure modes 部分澄清模糊步骤— 如果一个步骤让你困惑它也会让 AI 困惑扩展参考资料— 在references/下为某个主题补充深度文档2. 创建全新技能当你要贡献一个全新的技能时先做三件事检查 skills/ 目录避免与现有技能重叠通读技能编写指南了解结构要求较大范围的技能建议先开 Issue 讨论3. 添加评测场景低门槛好选择每个技能都需要 eval/scenarios/ 下的 JSON 测试场景描述三要素一个真实任务提示、AI 应该怎么做、如何验证它做对了。这相当于在回答当用户问 X 时应该发生什么——是上手社区协作的绝佳起点。4. 报告问题发现技能给出了错误建议开 Issue 时说明三件事是哪个技能、哪里出了问题、正确的行为应该是什么。新建技能全流程从脚手架到发布 第一步用脚手架生成技能骨架仓库提供了脚手架脚本一条命令即可创建符合规范的起点node shared/scripts/scaffold-skill.mjs my-new-skill 技能的简短描述它会同时生成两个文件skills/my-new-skill/SKILL.md— 主指令文件含必填的 YAML 头部eval/scenarios/my-new-skill.json— 配套的评测场景模板 技能名要求小写字母/数字加连字符不能以连字符开头或结尾长度不超过 64 字符。第二步按规范填写 SKILL.md以 wordpress-router 技能 为例每个SKILL.md都遵循同样的骨架skills/skill-name/ ├── SKILL.md # 主指令简短、步骤化 ├── references/ # 特定主题的深度文档 │ └── *.md └── scripts/ # 确定性辅助脚本可选 └── *.mjs每个SKILL.md必须包含 7 个部分YAML frontmatter—name、description、compatibility三个字段When to use— 什么条件触发该技能Inputs required— AI 需要先收集什么信息Procedure— 逐步执行的清单Verification— 如何确认操作成功Failure modes / debugging— 常见问题与修复方法Escalation— 何时应该请求人工介入编写指南的黄金法则还有两条值得注意SKILL.md保持简短把深度推给references/AI 需要猜的事情版本检测、项目布局识别优先写成确定性脚本。第三步明确兼容性目标按照兼容性政策技能统一面向WordPress7.0PHP7.4.0编写时应优先使用稳定 API、避免过时的经典主题或 Gutenberg 之前的旧 API并在需求变化时更新 frontmatter 中的compatibility字段。第四步运行结构验证提交前必须运行验证脚本node shared/scripts/validate-skills.mjs它会检查技能元数据和项目 triage 报告的规范性。另外请注意手动演练相关评测场景并把结果写进 PR——仓库目前还没有自动化的评测执行器你的实测结果是重要的补充证据。第五步提交 Pull Request标准提交流程共 7 步Fork 仓库创建分支如git checkout -b improve-block-dev-skill进行修改运行node shared/scripts/validate-skills.mjs结构验证用清晰的提交信息 commit发起 Pull Request请求维护者审阅重大改动建议先开 Issue 讨论方案再动手实现。贡献守则速查清单 ✅原则具体要求保持实用聚焦开发者真正要做的操作给具体例子而非抽象理论保持时效面向 WordPress 7.0 和 PHP 7.4.0避免遗留模式保持可测新技能至少配一个评测场景提交前跑验证脚本保持精简优先小而专注的技能一个技能只把一件事做好技能如何被分发 你贡献的技能最终会通过 skillpack 打包脚本 分发到各个 AI 助手中——skills/目录是唯一事实来源构建后可安装为全局作用域跨所有项目生效或项目作用域提交到版本库与团队共享。了解这条链路能帮你判断技能应该写成多通用。此外上游同步机制会在 WordPress 核心或 Gutenberg 发布新版时自动更新版本索引你贡献的技能也会因此持续保持最新。常见问题快速解答我完全不懂 JavaScript能贡献吗可以。绝大多数技能内容是 Markdown 文档只有在添加确定性检测脚本时才涉及少量代码脚手架和验证脚本会替你处理大部分工程细节。我的技能主题和现有技能有重叠怎么办先浏览 skills/ 目录并对照各技能的description字段。若只是部分重叠考虑扩展现有技能的references/若确实是空白领域再开 Issue 提议新技能。评测场景 JSON 该写什么参考 场景说明每个场景文件包含name名称、skills关联技能、query真实任务提示、expected_behavior期望行为步骤和success_criteria成功标准五个字段。你的 WordPress 经验可以帮助成千上万的开发者获得更可靠的 AI 辅助。无论是修正一个过时的 API 说明还是从零打造一个全新技能社区都欢迎你的加入——打开 CONTRIBUTING.md迈出第一步吧【免费下载链接】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），仅供参考 成为贡献者：WordPress Agent Skills 社区协作与技能改进全流程
成为贡献者WordPress Agent Skills 社区协作与技能改进全流程【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skillsWordPress Agent Skills是一个为 AI 编程助手提供专家级 WordPress 知识的开源项目——它把区块开发、主题、插件开发和安全最佳实践整理成结构化技能包让 AI 助手不再写出过时的代码或漏掉关键安全细节。贡献这个项目不需要你是编码高手技能大多用 Markdown 写成本质上是一份份清晰的步骤清单和决策树。只要你深入理解 WordPress 的某个领域就能做出有价值的贡献。本文将带你走完从提交第一个 PR 到发布全新技能的完整协作流程。为什么这个项目适合新手贡献 与传统开源项目不同Agent Skills 的核心是知识的结构化沉淀而非代码量项目特点对新贡献者意味着什么技能以 Markdown 为主会写文档就能贡献无需深厚代码功底代码是步骤清单和决策树你熟悉的 WordPress 经验可以直接转化内置脚手架和验证脚本有确定性护栏降低入门门槛每个技能都有评测场景贡献有明确的验收标准项目的设计原则强调小而可组合优于大而全、SKILL.md保持简短、深度内容下沉到references/、可靠性要求高时优先用确定性脚本。理解了这些你就理解了整个项目的协作语言。四种参与社区协作的方式根据 CONTRIBUTING.md贡献主要有四条路径难度由低到高1. 改进现有技能最容易上手WordPress 迭代很快任何技能都可能过时。你可以修正过时信息— 发现某个 API 或行为变了直接开 PR补充边缘情况— 踩到过没被记录的坑加进 Failure modes 部分澄清模糊步骤— 如果一个步骤让你困惑它也会让 AI 困惑扩展参考资料— 在references/下为某个主题补充深度文档2. 创建全新技能当你要贡献一个全新的技能时先做三件事检查 skills/ 目录避免与现有技能重叠通读技能编写指南了解结构要求较大范围的技能建议先开 Issue 讨论3. 添加评测场景低门槛好选择每个技能都需要 eval/scenarios/ 下的 JSON 测试场景描述三要素一个真实任务提示、AI 应该怎么做、如何验证它做对了。这相当于在回答当用户问 X 时应该发生什么——是上手社区协作的绝佳起点。4. 报告问题发现技能给出了错误建议开 Issue 时说明三件事是哪个技能、哪里出了问题、正确的行为应该是什么。新建技能全流程从脚手架到发布 第一步用脚手架生成技能骨架仓库提供了脚手架脚本一条命令即可创建符合规范的起点node shared/scripts/scaffold-skill.mjs my-new-skill 技能的简短描述它会同时生成两个文件skills/my-new-skill/SKILL.md— 主指令文件含必填的 YAML 头部eval/scenarios/my-new-skill.json— 配套的评测场景模板 技能名要求小写字母/数字加连字符不能以连字符开头或结尾长度不超过 64 字符。第二步按规范填写 SKILL.md以 wordpress-router 技能 为例每个SKILL.md都遵循同样的骨架skills/skill-name/ ├── SKILL.md # 主指令简短、步骤化 ├── references/ # 特定主题的深度文档 │ └── *.md └── scripts/ # 确定性辅助脚本可选 └── *.mjs每个SKILL.md必须包含 7 个部分YAML frontmatter—name、description、compatibility三个字段When to use— 什么条件触发该技能Inputs required— AI 需要先收集什么信息Procedure— 逐步执行的清单Verification— 如何确认操作成功Failure modes / debugging— 常见问题与修复方法Escalation— 何时应该请求人工介入编写指南的黄金法则还有两条值得注意SKILL.md保持简短把深度推给references/AI 需要猜的事情版本检测、项目布局识别优先写成确定性脚本。第三步明确兼容性目标按照兼容性政策技能统一面向WordPress7.0PHP7.4.0编写时应优先使用稳定 API、避免过时的经典主题或 Gutenberg 之前的旧 API并在需求变化时更新 frontmatter 中的compatibility字段。第四步运行结构验证提交前必须运行验证脚本node shared/scripts/validate-skills.mjs它会检查技能元数据和项目 triage 报告的规范性。另外请注意手动演练相关评测场景并把结果写进 PR——仓库目前还没有自动化的评测执行器你的实测结果是重要的补充证据。第五步提交 Pull Request标准提交流程共 7 步Fork 仓库创建分支如git checkout -b improve-block-dev-skill进行修改运行node shared/scripts/validate-skills.mjs结构验证用清晰的提交信息 commit发起 Pull Request请求维护者审阅重大改动建议先开 Issue 讨论方案再动手实现。贡献守则速查清单 ✅原则具体要求保持实用聚焦开发者真正要做的操作给具体例子而非抽象理论保持时效面向 WordPress 7.0 和 PHP 7.4.0避免遗留模式保持可测新技能至少配一个评测场景提交前跑验证脚本保持精简优先小而专注的技能一个技能只把一件事做好技能如何被分发 你贡献的技能最终会通过 skillpack 打包脚本 分发到各个 AI 助手中——skills/目录是唯一事实来源构建后可安装为全局作用域跨所有项目生效或项目作用域提交到版本库与团队共享。了解这条链路能帮你判断技能应该写成多通用。此外上游同步机制会在 WordPress 核心或 Gutenberg 发布新版时自动更新版本索引你贡献的技能也会因此持续保持最新。常见问题快速解答我完全不懂 JavaScript能贡献吗可以。绝大多数技能内容是 Markdown 文档只有在添加确定性检测脚本时才涉及少量代码脚手架和验证脚本会替你处理大部分工程细节。我的技能主题和现有技能有重叠怎么办先浏览 skills/ 目录并对照各技能的description字段。若只是部分重叠考虑扩展现有技能的references/若确实是空白领域再开 Issue 提议新技能。评测场景 JSON 该写什么参考 场景说明每个场景文件包含name名称、skills关联技能、query真实任务提示、expected_behavior期望行为步骤和success_criteria成功标准五个字段。你的 WordPress 经验可以帮助成千上万的开发者获得更可靠的 AI 辅助。无论是修正一个过时的 API 说明还是从零打造一个全新技能社区都欢迎你的加入——打开 CONTRIBUTING.md迈出第一步吧【免费下载链接】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），仅供参考