Communitygithub.com

kylebrodeur/wordpress-agent-kit

面向AI编码助手的WordPress AGENTS.md + Agent技能入门套件。

wordpress-agent-kit 是什么?

这是一个专为AI编码助手(如Claude Code、Cursor、Codex等)设计的WordPress设计系统技能包。它通过提供一个结构化的AGENTS.md和技能文件,指导AI代理在WordPress相关项目中正确、高效地使用WordPress设计系统(WPDS)。该技能的关键功能是强制AI代理使用WPDS MCP服务器来获取权威文档,而不是依赖网络搜索,从而确保组件、设计令牌和模式的准确性。它支持在Gutenberg、WooCommerce、WordPress.com、Jetpack等任何WordPress UI上下文中工作,并假定技术栈为TypeScript、React和CSS。此外,该技能还定义了严格的规则,如只关注UI相关方面、使用最合适的WPDS组件,以及在可能的情况下利用本地lint脚本进行验证,最终输出带有清晰解释和边界说明的代码方案。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add kylebrodeur/wordpress-agent-kit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

WordPress 设计系统(WPDS)

前提条件

本技能最好与 WPDS MCP 服务器 配合使用。该 MCP 提供对 WordPress 设计系统文档和资源的访问,例如组件和 DS 令牌列表。

以下术语应视为同义词:

  • “WordPress” 和 “WP”;
  • “Design System” 和 “DS”;
  • “WordPress Design System” 和 “WPDS”。

使用时机

当用户提到以下内容时,请使用本技能:

  • 在 WordPress 相关上下文中构建和/或审查任何 UI(例如 Gutenberg、WooCommerce、WordPress.com、Jetpack 等);
  • WordPress 设计系统、WPDS、设计系统;
  • UI 组件、设计令牌、颜色原色、间距比例、排版变量和预设;
  • 特定组件包,例如 @wordpress/components 或 @wordpress/ui;

规则

使用 WPDS MCP 服务器访问 WPDS 相关文档

  • 使用 WPDS MCP 服务器检索权威、规范的文档:
    • 参考站点(wpds://pages)
    • 可用组件列表(wpds://components)和特定组件信息(wpds://components/:name)
    • 可用令牌列表(wpds://design-tokens)
  • 不要在网络上搜索关于 WordPress 设计系统的规范文档。如果用户提出此类要求,请拒绝并请求确认,同时提醒用户 MCP 服务器是提供信息的最佳场所。

必需文档

在处理任何 WPDS 相关任务之前,请确保阅读参考站点上的相关文档。在评估任何给定任务的最佳行动方案时,此文档应具有绝对优先权。

边界

  • 跳过回答中与 UI 无关的部分(例如,从存储中获取数据或本地化文本字符串)。
  • 专注于构建尽可能符合 WPDS 最佳实践的 UI,并使用最合适的 WPDS 组件/令牌/模式。

技术栈

  • 除非另有说明(或从请求的本地上下文中收集到特定信息),否则假定技术栈为:TypeScript、React、CSS。

验证

  • 如果任务运行的本地上下文提供了 lint 脚本,在可能的情况下使用它们来验证提议的代码输出。

输出

  • 在回答的最后,作为回顾,提供清晰简洁的解决方案说明,并为每个决策添加上下文解释。
  • 明确指出边界,即因不相关而明确排除在任务之外的内容(例如非 UI 相关内容)。
  • 提供可工作的代码片段。

相关技能