技能介绍

解决的实际问题

WordPress 站点长期维护后，acf 字段组往往在主题、子主题和自定义代码之间不断叠加。没有统一索引时，开发者很难回答三个问题：哪些字段已经不再被任何文章类型引用；哪些字段键被重复声明，可能覆盖后端写入；哪些字段类型在当前主题模板中并不匹配，比如预期文本却挂载了媒体字段。手动翻找函数和配置既慢又容易遗漏，尤其在多人协作项目里，字段命名和用途常常没有完整文档。

核心能力与关键步骤

这个技能面向 Advanced Custom Fields 的站点审计场景，适合在迁移、重构、性能排查或交接文档前快速生成一份结构化清单。

拉取字段定义：通过 ACF REST API 访问 /wp-json/acf/v3/，读取全部字段组及其字段配置。
映射文章类型：将每个字段键与对应的文章类型关联，保留字段名称、键名和类型信息。
执行一致性检查：识别孤立字段、重复键以及字段类型不匹配等常见配置风险。
输出审计结果：生成结构化报告，便于开发者按文章类型复查字段用途，也可以作为重构或清理依据。

适用边界与注意点

它适合作为字段配置体检工具，而不是运行时依赖检查器。运行前需要确认站点已开放 ACF REST API，并且当前环境具备足够的读取权限。如果站点使用了权限插件、自定义 REST 路由或较新的 WP 版本限制，接口返回可能不完整；例如 rest_authorization_required_code 这类设置会影响未登录请求的结果。

此外，本次资料没有自动提取到上游项目自带的安装或使用说明。运行前应先查看 GitHub 仓库中的 SKILL.md，确认调用范围与预期输出，再决定是否接入敏感工作流。

来源：GitHub @1991513ccie-png