custom-post-type-architect

自定义文章类型架构师

版本： 1.0.0 更新日期： 2026-05-24 类别： 内容创作 状态： 稳定 要求： Respira for WordPress plugin 7.1+ + MCP server

---

描述

根据简要需求（“我需要一个包含案例研究的作品集”，或“我们有一档播客，希望每集都有独立页面”），端到端地设计并创建 WordPress 自定义文章类型、相关分类法和 ACF 字段组。使用全新的 v7.1 MCP 工具：respira_create_post_type、respira_create_taxonomy、respira_create_acf_field_group。

最终产出是一套完整配置好的内容架构，可直接使用：

1. CPT 本身（标签、支持的功能、公开与私有设置、has_archive、REST 暴露）
2. 相关分类法（例如案例研究的行业、播客剧集的季数）
3. 绑定到 CPT 的 ACF 字段组（编辑者可见的自定义字段）
4. 1–2 条示例条目，以便 Agent 验证渲染效果
5. 针对当前启用的构建器提供单页模板建议

---

适用场景

• 设置作品集、案例研究、团队成员、活动、播客剧集、食谱、房产、地点、产品（非 WooCommerce）、常见问题、客户评价、课程、课时或任何结构化内容类型
• 从将自定义字段存放在文章中迁移到规范的内容类型
• 审查过度使用默认“post”类型来存放非博客内容的网站

---

触发语句

• “创建自定义文章类型”
• “搭建作品集”
• “设置案例研究类型”
• “添加团队成员版块”
• “搭建 CPT”
• “创建播客文章类型”
• “搭建活动版块”
• “我们需要一种新的内容类型”

---

执行工作流

第 1 步 — 确认站点和构建器

调用 respira_get_active_site 和 respira_get_builder_info。构建器的选择会影响第 6 步（模板建议）。

第 2 步 — 了解需求

如果用户的请求中尚未说明清楚，询问以下三个简短问题：

1. 内容是什么？（案例研究、播客剧集、团队、活动……）
2. 如何组织？（分类、标签、自定义分类法——例如，按行业和服务类型组织案例研究）
3. 每条内容需要哪些字段？（例如案例研究：客户名称、主图、交付内容、成果、前后对比指标、相关案例研究）

如果用户无法清楚说明字段，基于内容类型提出一组默认字段。默认字段组：

• 案例研究： 客户名称、行业（分类法）、服务类型（分类法）、主图、简介、交付内容、成果、关键指标（3-5 项）、客户徽标、相关案例研究（关系）
• 团队成员： 姓名、职位、简介、头像、社交链接（LinkedIn / X / 个人网站）、部门（分类法）
• 活动： 标题、日期/时间、地点、地址、线上/线下、报名 URL、容量、主图
• 播客剧集： 标题、剧集编号、季数（分类法）、音频文件 URL、时长、节目说明、嘉宾姓名、嘉宾链接
• 房产（房地产）： 地址、价格、卧室数量、浴室数量、面积（平方米）、状态（分类法：待售 / 已售 / 待成交）、图库、社区（分类法）
• 食谱： 标题、准备时间、烹饪时间、份量、食材（重复字段）、步骤（重复字段）、类别（分类法）、菜系（分类法）、难度、饮食标签

第 3 步 — 设计 CPT 结构

输出建议的结构供用户审核：

## Proposed CPT: `case_study`

- **Singular label:** Case Study
- **Plural label:** Case Studies
- **Menu icon:** dashicons-portfolio
- **Public:** yes
- **Has archive:** yes (URL: /case-studies/)
- **Supports:** title, editor, thumbnail, excerpt, revisions
- **REST API:** exposed (so the builder + Respira can read/write)
- **Hierarchical:** no
- **Show in admin menu:** yes, position 25 (under Pages)

## Supporting taxonomies

1. `case_study_industry` — Industries (e.g. SaaS, e-commerce, healthcare)
2. `case_study_service` — Service types (e.g. branding, website, copywriting)

## ACF field group: `Case Study Fields`

- Hero image (image, required)
- Client name (text, required)
- Brief (textarea)
- Deliverables (repeater — title + description)
- Outcomes (repeater — metric name + before + after)
- Client logo (image)
- Related case studies (relationship → case_study)

等待确认。用户可能希望添加或移除字段。

第 4 步 — 创建 CPT 和分类法

确认后，运行创建调用：

1. respira_create_post_type — 使用建议的结构创建 CPT
2. respira_create_taxonomy — 对每个相关分类法各调用一次，并绑定到 CPT
3. respira_create_acf_field_group — 创建 ACF 字段组，通过位置规则绑定到 CPT

每次调用都应返回结果，例如：“✓ 已创建 CPT case_study” / “✓ 已创建分类法 case_study_industry” / “✓ 已创建包含 8 个字段并绑定到 case_study 的 ACF 字段组。”

步骤 5 — 生成示例条目

创建 1–2 个示例条目，让用户可以立即在管理后台查看 CPT，并确认编辑器能正确渲染。使用 respira_create_custom_post 创建内容真实可信但通用的条目（不要使用真实客户名称；使用「BrandQ」或「agency-A」之类的通用角色）。

示例条目应填充每个 ACF 字段，让用户看到完整的结构。

步骤 6 — 建议适用于特定构建器的单页模板

根据当前启用的构建器，建议在哪里创建单页模板：

• Bricks：「在 Templates → Add New → Type: Single → Conditions: Post Type = case_study 创建单页模板。建议的元素：……」
• Elementor：「在 Templates → Theme Builder → Single → Add Conditions → Posts: case_study 创建单页模板。建议的组件：……」
• Divi：「在 Divi → Theme Builder → Add Template → Posts: case_study 创建 Theme Builder 模板。建议的模块：……」
• Gutenberg / FSE theme：「在主题中创建 single-case_study.html 模板，或通过 Appearance → Editor → Templates → Add → Single Item: Case Study 创建。」
• Oxygen / Breakdance：「创建一个针对 case_study 的 Single 模板。」

如果用户想立即搭建模板，主动提出为其创建：这是单独的技能流程（针对所选构建器的单页模板界面使用 respira_build_page）。

步骤 7 — 验证

输出一份摘要，包含：

• CPT 别名 + 管理后台 URL（/wp-admin/edit.php?post_type=case_study）
• 前端归档页 URL（/case-studies/）
• 2 个示例条目 URL
• 说明单页模板是已搭建，还是留给用户自行创建

---

硬性规则

• 创建前务必征求确认。步骤 3 中的 CPT 结构预览为必需项。客户将在这个 CPT 中持续写入内容多年，务必一开始就设置正确。
• 使用 snake_case 别名（case_study、case_study_industry），绝不使用空格或连字符。WordPress CPT 别名的硬性长度上限为 20 个字符。
• 务必启用 show_in_rest，以便构建器和 Respira 能读取和写入 CPT。如果 show_in_rest 为 false，该文章类型将无法被 REST API 识别，并会导致大多数现代构建器无法正常工作。
• CPT 绝不能命名为 post、page、attachment、revision、nav_menu_item、custom_css、customize_changeset、oembed_cache、user_request、wp_block、wp_template、wp_template_part、wp_global_styles、wp_navigation——这些名称均为保留名称。
• ACF 字段组的位置规则必须绑定到 CPT（post_type == case_study），不能绑定到分类目录或模板。位置规则错误会导致字段在管理后台中不可见。
• 示例条目使用通用角色。绝不能使用记忆中或任何其他来源中的真实客户名称。

---

遥测

记录：站点 URL 哈希、已创建的 CPT 别名、分类法数量、ACF 字段数量、启用的构建器、已创建的示例条目、成功/失败情况。不发送 CPT 名称、字段值或内容。

端点：POST https://www.respira.press/api/skills/track-usage