[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-WordPress--agent-skills":3,"tool-WordPress--agent-skills":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",156033,2,"2026-04-14T23:32:00",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":72,"owner_website":76,"owner_url":77,"languages":78,"stars":83,"forks":84,"last_commit_at":85,"license":86,"difficulty_score":32,"env_os":87,"env_gpu":88,"env_ram":88,"env_deps":89,"category_tags":93,"github_topics":75,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":94,"updated_at":95,"faqs":96,"releases":124},7654,"WordPress\u002Fagent-skills","agent-skills","Expert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices","agent-skills 是一套专为 WordPress 开发设计的 AI 技能包，旨在教会各类 AI 编程助手（如 Claude、Copilot、Cursor 等）以专家级标准构建 WordPress 项目。它通过提供可移植的指令集、检查清单和脚本，让 AI 深入理解现代 WordPress 的开发模式。\n\n在实际开发中，AI 助手常因训练数据滞后而生成过时的代码（如未适配 Gutenberg 区块或区块主题），或忽略关键的安全规范与版本兼容性，导致“无效区块”等错误。agent-skills 有效解决了这些痛点，确保 AI 输出的代码符合最新的官方最佳实践，涵盖区块开发、插件架构、REST API、性能优化及静态分析等多个核心领域。\n\n这套工具非常适合 WordPress 开发者、主题与插件作者，以及希望提升 AI 辅助编码质量的技术团队使用。其独特亮点在于由官方文档提炼并经社区贡献者审核，且支持灵活部署：既可全局安装供所有项目调用，也能嵌入特定仓库，自动适配 VS Code、Cursor 等多种主流开发环境，让 AI 真正成为懂 WordPress 的得力搭档。","# Agent Skills for WordPress\n\n**Teach AI coding assistants how to build WordPress the right way.**\n\nAgent Skills are portable bundles of instructions, checklists, and scripts that help AI assistants (Claude, Copilot, Codex, Cursor, etc.) understand WordPress development patterns, avoid common mistakes, and follow best practices.\n\n> **AI Authorship Disclosure:** These skills were generated using GPT-5.2 Codex (High Reasoning) from official Gutenberg and WordPress documentation, then reviewed and edited by WordPress contributors. We tested skills with AI assistants and iterated based on results. This is v1, and skills will improve as the community uses them and contributes fixes. See [docs\u002Fai-authorship.md](docs\u002Fai-authorship.md) for details. ([WordPress AI Guidelines](https:\u002F\u002Fmake.wordpress.org\u002Fai\u002Fhandbook\u002Fai-guidelines\u002F))\n\n## Why Agent Skills?\n\nAI coding assistants are powerful, but they often:\n- Generate outdated WordPress patterns (pre-Gutenberg, pre-block themes)\n- Miss critical security considerations in plugin development\n- Skip proper block deprecations, causing \"Invalid block\" errors\n- Ignore existing tooling in your repo\n\nAgent Skills solve this by giving AI assistants **expert-level WordPress knowledge** in a format they can actually use.\n\n## Available Skills\n\n| Skill | What it teaches |\n|-------|-----------------|\n| **wordpress-router** | Classifies WordPress repos and routes to the right workflow |\n| **wp-project-triage** | Detects project type, tooling, and versions automatically |\n| **wp-block-development** | Gutenberg blocks: `block.json`, attributes, rendering, deprecations |\n| **wp-block-themes** | Block themes: `theme.json`, templates, patterns, style variations |\n| **wp-plugin-development** | Plugin architecture, hooks, settings API, security |\n| **wp-rest-api** | REST API routes\u002Fendpoints, schema, auth, and response shaping |\n| **wp-interactivity-api** | Frontend interactivity with `data-wp-*` directives and stores |\n| **wp-abilities-api** | Capability-based permissions and REST API authentication |\n| **wp-wpcli-and-ops** | WP-CLI commands, automation, multisite, search-replace |\n| **wp-performance** | Profiling, caching, database optimization, Server-Timing |\n| **wp-phpstan** | PHPStan static analysis for WordPress projects (config, baselines, WP-specific typing) |\n| **wp-playground** | WordPress Playground for instant local environments |\n| **wpds** | WordPress Design System |\n| **blueprint** | WordPress Playground Blueprints for declarative Playground environment setup |\n\n## Quick Start\n\n### Install globally for Claude Code\n\n```bash\n# Clone agent-skills\ngit clone https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills.git\ncd agent-skills\n\n# Build the distribution\nnode shared\u002Fscripts\u002Fskillpack-build.mjs --clean\n\n# Install all skills globally (available across all projects)\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global\n\n# Or install specific skills only\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global --skills=wp-playground,wp-block-development\n```\n\nThis installs skills to `~\u002F.claude\u002Fskills\u002F` where Claude Code will automatically discover them.\n\n### Install into your repo\n\n```bash\n# Clone agent-skills\ngit clone https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills.git\ncd agent-skills\n\n# Build the distribution\nnode shared\u002Fscripts\u002Fskillpack-build.mjs --clean\n\n# Install into your WordPress project\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --dest=..\u002Fyour-wp-project --targets=codex,vscode,claude,cursor\n```\n\nThis copies skills into:\n- `.codex\u002Fskills\u002F` for OpenAI Codex\n- `.github\u002Fskills\u002F` for VS Code \u002F GitHub Copilot\n- `.claude\u002Fskills\u002F` for Claude Code (project-level)\n- `.cursor\u002Fskills\u002F` for Cursor (project-level)\n\n### Install globally for Cursor\n\n```bash\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --targets=cursor-global\n```\n\nThis installs skills to `~\u002F.cursor\u002Fskills\u002F` where Cursor will discover them.\n\n### Available options\n\n```bash\n# List available skills\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --list\n\n# Dry run (preview without installing)\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global --dry-run\n\n# Install specific skills to a project (e.g. Claude + Cursor)\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --dest=..\u002Fmy-repo --targets=claude,cursor --skills=wp-wpcli-and-ops\n```\n\n### Manual installation\n\nCopy any skill folder from `skills\u002F` into your project's instructions directory for your AI assistant.\n\n## How It Works\n\nEach skill contains:\n\n```\nskills\u002Fwp-block-development\u002F\n├── SKILL.md              # Main instructions (when to use, procedure, verification)\n├── references\u002F           # Deep-dive docs on specific topics\n│   ├── block-json.md\n│   ├── deprecations.md\n│   └── ...\n└── scripts\u002F              # Deterministic helpers (detection, validation)\n    └── list_blocks.mjs\n```\n\nWhen you ask your AI assistant to work on WordPress code, it reads these skills and follows the documented procedures rather than guessing.\n\n## Compatibility\n\n- **WordPress 6.9+** (PHP 7.2.24+)\n- Works with any AI assistant that supports project-level instructions\n\n## Contributing\n\n**We welcome contributions!** This project is a great way to share your WordPress expertise—you don't need to be a coding wizard. Most skills are written in Markdown, focusing on clear procedures and best practices.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to get started.\n\nQuick commands:\n\n```bash\n# Scaffold a new skill\nnode shared\u002Fscripts\u002Fscaffold-skill.mjs \u003Cskill-name> \"\u003Cdescription>\"\n\n# Validate skills\nnode eval\u002Fharness\u002Frun.mjs\n```\n\n## Documentation\n\n- [Authoring Guide](docs\u002Fauthoring-guide.md) - How to create and improve skills\n- [Principles](docs\u002Fprinciples.md) - Design philosophy\n- [Packaging](docs\u002Fpackaging.md) - Build and distribution\n- [Compatibility Policy](docs\u002Fcompatibility-policy.md) - Version targeting\n\n## License\n\nGPL-2.0-or-later\n","# WordPress 代理技能\n\n**教会 AI 编码助手以正确的方式构建 WordPress。**\n\n代理技能是一组可移植的指令、检查清单和脚本，可帮助 AI 助手（Claude、Copilot、Codex、Cursor 等）理解 WordPress 开发模式、避免常见错误并遵循最佳实践。\n\n> **AI 著作声明：** 这些技能由官方 Gutenberg 和 WordPress 文档中的 GPT-5.2 Codex（高阶推理）生成，随后由 WordPress 贡献者审核和编辑。我们已使用 AI 助手对这些技能进行了测试，并根据结果不断迭代。目前为 v1 版本，随着社区的使用和贡献修复，技能将持续改进。详情请参阅 [docs\u002Fai-authorship.md](docs\u002Fai-authorship.md)。（[WordPress AI 指南](https:\u002F\u002Fmake.wordpress.org\u002Fai\u002Fhandbook\u002Fai-guidelines\u002F)）\n\n## 为什么需要代理技能？\n\nAI 编码助手功能强大，但它们常常：\n- 生成过时的 WordPress 模式（Gutenberg 之前、区块主题之前）\n- 在插件开发中忽略关键的安全考量\n- 跳过正确的区块弃用流程，导致“无效区块”错误\n- 忽视仓库中已有的工具链\n\n代理技能通过为 AI 助手提供它们能够实际使用的 **专家级 WordPress 知识** 来解决这些问题。\n\n## 可用技能\n\n| 技能 | 教授内容 |\n|-------|-----------------|\n| **wordpress-router** | 对 WordPress 项目进行分类，并引导至正确的开发流程 |\n| **wp-project-triage** | 自动检测项目类型、工具链和版本 |\n| **wp-block-development** | Gutenberg 区块：`block.json`、属性、渲染、弃用处理 |\n| **wp-block-themes** | 区块主题：`theme.json`、模板、模式、样式变体 |\n| **wp-plugin-development** | 插件架构、钩子、设置 API、安全性 |\n| **wp-rest-api** | REST API 路由\u002F端点、Schema、认证及响应格式化 |\n| **wp-interactivity-api** | 使用 `data-wp-*` 指令和状态管理实现前端交互 |\n| **wp-abilities-api** | 基于能力的权限控制与 REST API 认证 |\n| **wp-wpcli-and-ops** | WP-CLI 命令、自动化、多站点管理、搜索替换 |\n| **wp-performance** | 性能分析、缓存、数据库优化、Server-Timing |\n| **wp-phpstan** | PHPStan 静态分析用于 WordPress 项目（配置、基线、WordPress 特定类型系统） |\n| **wp-playground** | WordPress Playground，用于快速搭建本地环境 |\n| **wpds** | WordPress 设计系统 |\n| **blueprint** | WordPress Playground 蓝图，用于声明式 Playground 环境搭建 |\n\n## 快速开始\n\n### 为 Claude Code 全局安装\n\n```bash\n# 克隆 agent-skills\ngit clone https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills.git\ncd agent-skills\n\n# 构建分发包\nnode shared\u002Fscripts\u002Fskillpack-build.mjs --clean\n\n# 将所有技能全局安装（在所有项目中可用）\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global\n\n# 或仅安装特定技能\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global --skills=wp-playground,wp-block-development\n```\n\n这会将技能安装到 `~\u002F.claude\u002Fskills\u002F`，Claude Code 将自动发现它们。\n\n### 安装到您的项目中\n\n```bash\n# 克隆 agent-skills\ngit clone https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills.git\ncd agent-skills\n\n# 构建分发包\nnode shared\u002Fscripts\u002Fskillpack-build.mjs --clean\n\n# 安装到您的 WordPress 项目\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --dest=..\u002Fyour-wp-project --targets=codex,vscode,claude,cursor\n```\n\n这会将技能复制到：\n- `.codex\u002Fskills\u002F` 用于 OpenAI Codex\n- `.github\u002Fskills\u002F` 用于 VS Code \u002F GitHub Copilot\n- `.claude\u002Fskills\u002F` 用于 Claude Code（项目级别）\n- `.cursor\u002Fskills\u002F` 用于 Cursor（项目级别）\n\n### 为 Cursor 全局安装\n\n```bash\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --targets=cursor-global\n```\n\n这会将技能安装到 `~\u002F.cursor\u002Fskills\u002F`，Cursor 将自动发现它们。\n\n### 可用选项\n\n```bash\n# 列出可用技能\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --list\n\n# 干运行（预览而不安装）\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global --dry-run\n\n# 将特定技能安装到项目中（例如 Claude + Cursor）\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --dest=..\u002Fmy-repo --targets=claude,cursor --skills=wp-wpcli-and-ops\n```\n\n### 手动安装\n\n将 `skills\u002F` 目录下的任意技能文件夹复制到您项目的 AI 助手指令目录中即可。\n\n## 工作原理\n\n每个技能包含：\n\n```\nskills\u002Fwp-block-development\u002F\n├── SKILL.md              # 主要说明（何时使用、操作步骤、验证方法）\n├── references\u002F           # 关于特定主题的深入文档\n│   ├── block-json.md\n│   ├── deprecations.md\n│   └── ...\n└── scripts\u002F              # 确定性辅助工具（检测、验证）\n    └── list_blocks.mjs\n```\n\n当您让 AI 助手处理 WordPress 代码时，它会读取这些技能并按照文档中的步骤执行，而不是凭猜测行事。\n\n## 兼容性\n\n- **WordPress 6.9+**（PHP 7.2.24+）\n- 适用于任何支持项目级指令的 AI 助手\n\n## 贡献\n\n**我们欢迎您的贡献！** 该项目是分享您 WordPress 专业知识的好机会——您无需成为编码高手。大多数技能以 Markdown 格式编写，重点在于清晰的操作步骤和最佳实践。\n\n有关如何入门的详细信息，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n快捷命令：\n\n```bash\n# 搭建新技能框架\nnode shared\u002Fscripts\u002Fscaffold-skill.mjs \u003C技能名称> \"\u003C描述>\"\n\n# 验证技能\nnode eval\u002Fharness\u002Frun.mjs\n```\n\n## 文档\n\n- [创作指南](docs\u002Fauthoring-guide.md) - 如何创建和改进技能\n- [原则](docs\u002Fprinciples.md) - 设计哲学\n- [打包](docs\u002Fpackaging.md) - 构建与分发\n- [兼容性政策](docs\u002Fcompatibility-policy.md) - 版本定位策略\n\n## 许可证\n\nGPL-2.0 或后续版本","# agent-skills 快速上手指南\n\nagent-skills 是一套专为 WordPress 开发设计的 AI 助手技能包。它能教会 Claude、Copilot、Cursor 等 AI 工具遵循最新的 WordPress 最佳实践（如 Gutenberg 区块、现代主题架构），避免生成过时代码或忽略安全规范。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Linux、macOS 或 Windows (WSL)\n*   **Node.js**：已安装 Node.js 运行环境（用于执行构建和安装脚本）\n*   **Git**：已安装 Git 用于克隆仓库\n*   **目标 AI 工具**：已安装并配置好以下任一工具：\n    *   Claude Code\n    *   Cursor\n    *   VS Code (配合 GitHub Copilot)\n    *   OpenAI Codex\n\n> **注意**：本项目主要面向 WordPress 6.9+ 及 PHP 7.2.24+ 环境。\n\n## 安装步骤\n\n### 1. 克隆项目并构建\n\n首先从 GitHub 克隆仓库并构建分发包。\n\n```bash\n# 克隆 agent-skills 仓库\ngit clone https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills.git\ncd agent-skills\n\n# 构建分发包\nnode shared\u002Fscripts\u002Fskillpack-build.mjs --clean\n```\n\n### 2. 选择安装方式\n\n根据您的使用习惯，选择以下一种方式进行安装：\n\n#### 方案 A：全局安装（推荐）\n适用于希望所有项目都能自动调用这些技能的场景。\n\n**为 Claude Code 全局安装：**\n```bash\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global\n```\n*技能将被安装至 `~\u002F.claude\u002Fskills\u002F`*\n\n**为 Cursor 全局安装：**\n```bash\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --targets=cursor-global\n```\n*技能将被安装至 `~\u002F.cursor\u002Fskills\u002F`*\n\n**仅安装特定技能（例如只安装区块开发和 WP-CLI 相关）：**\n```bash\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --global --skills=wp-block-development,wp-wpcli-and-ops\n```\n\n#### 方案 B：项目级安装\n适用于仅在当前 WordPress 项目中启用技能，便于团队协作和版本控制。\n\n```bash\n# 将技能安装到指定的 WordPress 项目目录，并适配多种 AI 工具\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --dest=..\u002Fyour-wp-project --targets=codex,vscode,claude,cursor\n```\n*执行后，技能文件会自动复制到目标项目的 `.codex\u002Fskills\u002F`, `.github\u002Fskills\u002F`, `.claude\u002Fskills\u002F`, `.cursor\u002Fskills\u002F` 等对应目录中。*\n\n#### 方案 C：手动安装\n如果您偏好手动管理，可以直接将 `skills\u002F` 目录下的任意技能文件夹复制到您 AI 助手的指令目录中。\n\n## 基本使用\n\n安装完成后，无需额外配置，AI 助手会在上下文中自动识别并应用这些技能。\n\n### 使用示例\n\n假设您已全局安装了 `wp-block-development` 技能，现在需要在 Cursor 或 Claude Code 中创建一个新区块。\n\n**操作步骤：**\n1. 打开您的 WordPress 项目终端或 AI 聊天窗口。\n2. 直接输入自然语言指令，例如：\n\n> \"请帮我创建一个名为 'latest-posts' 的 Gutenberg 动态区块，包含显示文章标题和摘要的功能，并确保符合最新的 block.json 规范和去重处理逻辑。\"\n\n**预期效果：**\nAI 助手将读取已安装的 `wp-block-development` 技能包，自动执行以下操作：\n*   生成标准的 `block.json` 配置文件。\n*   编写符合现代 WordPress 规范的 PHP 渲染回调或 React 编辑组件。\n*   自动包含必要的区块弃用（deprecations）处理逻辑，防止未来升级导致区块失效。\n*   遵循安全性检查，避免常见的插件开发漏洞。\n\n### 查看可用技能\n\n如果您想查看当前所有可用的技能列表，可运行：\n\n```bash\nnode shared\u002Fscripts\u002Fskillpack-install.mjs --list\n```\n\n常用核心技能包括：\n*   `wp-block-development`: 区块开发规范\n*   `wp-block-themes`: 区块主题 (`theme.json`) 开发\n*   `wp-plugin-development`: 插件架构与安全\n*   `wp-rest-api`: REST API 路由与认证\n*   `wp-interactivity-api`: 前端交互指令","一位全栈开发者正利用 AI 助手为电商客户快速构建一个基于 Gutenberg 区块主题的新型 WordPress 网站。\n\n### 没有 agent-skills 时\n- AI 生成的代码仍沿用旧的 PHP 模板层级结构，完全忽略了现代 `theme.json` 全局样式配置，导致主题无法适配区块编辑器。\n- 在开发自定义区块时，AI 遗漏了关键的 `block.json` 元数据定义及版本废弃（deprecation）逻辑，用户更新后直接报错\"Invalid block\"。\n- 插件功能实现中缺乏对非ces转义和权限校验的处理，留下了严重的安全隐患，不符合 WordPress 官方开发规范。\n- 每次生成代码后，开发者必须花费大量时间手动审查并重构，因为 AI 频繁产出过时或不可用的“幻觉”代码。\n\n### 使用 agent-skills 后\n- AI 自动识别项目类型为区块主题，优先输出符合 `theme.json` 标准的配置代码，确保设计风格与编辑器无缝集成。\n- 借助 `wp-block-development` 技能包，AI 生成的自定义区块包含完整的属性定义、渲染回调及平滑的废弃迁移方案，杜绝运行时错误。\n- 在编写插件逻辑时，AI 严格遵循 `wp-plugin-development` 中的安全清单，自动添加数据转义函数和能力检查（Capability Checks）。\n- 开发者只需关注业务逻辑创新，agent-skills 让 AI 一次性产出高质量、可维护且符合社区最佳实践的代码，大幅减少返工。\n\nagent-skills 将通用的 AI 编码能力转化为精通 WordPress 生态的专家级助手，从根本上解决了模型知识滞后与规范缺失的痛点。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FWordPress_agent-skills_aac0d0d1.png","WordPress","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FWordPress_3fff9ae4.png","",null,"https:\u002F\u002Fwordpress.org\u002F","https:\u002F\u002Fgithub.com\u002FWordPress",[79],{"name":80,"color":81,"percentage":82},"JavaScript","#f1e05a",100,1225,171,"2026-04-14T17:37:51","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":90,"python":88,"dependencies":91},"该工具并非运行本地 AI 模型，而是一组用于指导现有 AI 编程助手（如 Claude Code, Cursor, GitHub Copilot 等）的指令包。因此无需 GPU 或大量内存。主要运行环境需求为安装 Node.js 以执行构建和安装脚本。兼容 WordPress 6.9+ 及 PHP 7.2.24+ 的开发环境。",[92],"Node.js",[13,52],"2026-03-27T02:49:30.150509","2026-04-15T11:20:07.317741",[97,102,106,110,114,119],{"id":98,"question_zh":99,"answer_zh":100,"source_url":101},34278,"如何向 Agent Skills 项目贡献代码或新技能？","该项目欢迎社区贡献。您可以查看仓库中的 CONTRIBUTING.md 文件，了解改进现有技能或创建新技能的具体指南。","https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills\u002Fissues\u002F2",{"id":103,"question_zh":104,"answer_zh":105,"source_url":101},34275,"Agent Skills 仓库迁移到了哪里？旧的克隆地址还能用吗？","该仓库已从 `Automattic\u002Fagent-skills` 正式迁移至 WordPress 组织下的 `WordPress\u002Fagent-skills`。如果您之前跟踪的是旧地址，请运行以下命令更新远程仓库地址：\n```bash\ngit remote set-url origin https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills.git\n```\n原 Automattic 仓库已归档并设有重定向通知。",{"id":107,"question_zh":108,"answer_zh":109,"source_url":101},34276,"迁移后项目的许可证发生了什么变化？","为了兼容 WordPress 生态系统，项目许可证已从 MIT 更改为 GPL-2.0-or-later。",{"id":111,"question_zh":112,"answer_zh":113,"source_url":101},34277,"Agent Skills 项目主要涵盖哪些 WordPress 开发领域？","该项目为 AI 编码助手提供专家级的 WordPress 知识，涵盖以下领域：Gutenberg 区块开发、区块主题与 theme.json、插件开发与安全、WordPress REST API、交互性 API (Interactivity API)、WordPress Playground 集成、性能优化与分析、WP-CLI 操作与自动化、PHPStan 静态分析以及 WordPress 设计系统 (WPDS)。",{"id":115,"question_zh":116,"answer_zh":117,"source_url":118},34274,"在哪里可以找到关于在 WordPress 中使用 AI 的官方指南和讨论渠道？","您可以查阅 WordPress 官方发布的 AI 指南手册：https:\u002F\u002Fmake.wordpress.org\u002Fai\u002Fhandbook\u002Fai-guidelines\u002F。如果您希望参与相关讨论，可以加入 Core AI Slack 频道。","https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills\u002Fissues\u002F1",{"id":120,"question_zh":121,"answer_zh":122,"source_url":123},34279,"项目是否计划披露每个技能中 AI 与人类作者的具体贡献比例？","社区成员强烈建议项目应遵循 WordPress AI 指南，明确披露每个技能中 AI 的使用情况（例如哪些是 GPT 生成、哪些经过人工审查编辑、验证测试方法等）。虽然目前这是一个被提出的 urgent 需求（Issue #6），但官方尚未在 Issue 评论中给出最终实施细节，建议关注后续更新或参考官方 AI 指南手册。","https:\u002F\u002Fgithub.com\u002FWordPress\u002Fagent-skills\u002Fissues\u002F6",[]]