Codex Skill package for keyword clustering：instructions、scripts、exports、clusters 与 page decisions。
为什么这应该做成 Codex Skill
Keyword clustering 不是一次性的 prompt。你每个月都会重新跑它，并带入新的 GSC exports、Bing queries、keyword tool data、competitor URLs 与 GEO prompts。这让它很适合做成 Codex Skill：一个包含 instructions、expected inputs、optional scripts 与一致 output format 的 reusable workflow。
目标不是产出一串 article titles。真正目标是一张 decision table：create、refresh、merge、support、monitor 或 ignore。
Codex Skills 是 reusable workflow packages，所以 keyword clustering 应该被打包，而不是每次贴一个超长 prompt。
Skill folder shape
一个实用的 project-local skill 可以长这样：
.codex/skills/keyword-cluster-planner/
SKILL.md
references/
clustering-rules.md
page-action-rules.md
scripts/
normalize_keywords.py
detect_cannibalization.py
如果你还不想维护 scripts，可以先只从 SKILL.md 开始。等 workflow 证明可重复后，再加入 scripts。
SKILL.md starter
---
name: keyword-cluster-planner
description: Turn SEO query exports, keyword data, competitor URLs, and GEO prompts into intent clusters and page actions.
---
# Keyword Cluster Planner
Inputs:
- GSC query export
- Bing query export
- keyword tool export
- existing URL inventory
- competitor URL notes
- GEO prompt map
Rules:
- Preserve source labels.
- Do not invent volume or difficulty.
- Cluster by reader job, not shared words.
- Assign one page action per cluster.
- Flag cannibalization before recommending new pages.
Output:
- normalized keyword table
- intent clusters
- page action table
- 90-day content calendar
- rejected cluster log
这份 starter 的重点，是让 Codex 知道它不能编造 volume 或 difficulty，也不能因为字词相同就硬分在一起。
Normalize the inputs
在 clustering 前，先要求 Codex clean data：
Use the keyword-cluster-planner skill.
Normalize these exports into seo/keyword-planning/normalized-keywords.csv.
Keep source labels, market, current URL, query, volume, difficulty, CPC, intent guess, and notes.
Remove duplicates only after preserving source frequency.
这一步会避免同一个 query 在不同 sources 里被错误合并，也让后续 decisions 能追溯来源。
Cluster by reader job
| 较弱的分组方式 | 较好的 Codex instruction |
|---|---|
| 只看相同字词 | 依 reader 想完成的 job 分组 |
| 只看高 volume | 同时评估 business fit 与 effort |
| 一个 keyword 等于一篇文章 | 把每个 cluster 对应到 existing 或 new page |
| GEO prompts 另外处理 | 把 prompt opportunities 附到 page decisions 上 |
对新手来说，最容易犯的错是「一个 keyword 一篇文章」。Codex 应该先看 reader job，再决定 existing page 是否能 refresh，或是否真的需要 new page。
Page action table
| Cluster | Existing URL | Search signal | GEO signal | Action | Reason |
|---|---|---|---|---|---|
| Set up SEO agent |
| GSC impressions | setup prompts | refresh | existing page can answer better |
| AI citation monitoring | none | medium demand | high GEO value | create | no page covers daily checks |
| Codex skill packaging |
| low volume | strong fit | support | link from operator guide |
Action 栏位很重要。不是每个 cluster 都值得 create。很多时候，refresh、merge 或 support 比新文章更有效。
90-day calendar output
Build a 90-day content calendar from the approved page-action table.
Rules:
- no duplicate pages for the same intent
- max 2 new pages per week
- mix refreshes and new posts
- include owner, evidence, and approval gate
- keep rejected clusters in a log
这个 calendar 应该反映 production capacity。若团队一周只能好好处理两篇，就不要让 Codex 排出二十篇。
Quality gate
接受 calendar 前，要求 Codex 做一次 review：
Review this keyword calendar for cannibalization, weak evidence, missing existing URLs, and overproduction.
Mark every risky item and recommend whether to keep, merge, monitor, or reject.
这一步会把 keyword clustering 从「看起来很满的内容表」变成可执行、可审核的 page decision system。
FAQ
Codex 应该自己收集 keyword metrics 吗？
请用 Codex normalize 与 interpret data。Metrics 应该来自 trusted exports 或 APIs。
这个 Skill 应该发布文章吗？
不应该。它应该产出 clusters、briefs 与 calendar decisions。Publishing 应放在另一个 approval gate 后面。
第一次应该包含多少 clusters？
从 12 到 30 个有用 clusters 开始。如果团队无法好好 publish 或 refresh，更多 clusters 不会带来帮助。
Codex SEO/GEO learning path
这篇文章是 Codex SEO/GEO operator series 的一部分。如果你要从零建立 workflow，建议照这个顺序读：
- 如何在 2026 年用 Codex 做自动化 GEO
- 如何用 Codex 做自动化 SEO
- 如何用 AGENTS.md 建立 Codex SEO Workspace
- 如何用 MCP 把 Codex 接上 SEO Data
- 2026 年最佳 Codex GEO Skill
- 如何建立 Codex Keyword Clustering Skill
- 如何用 Codex Subagents 做 SERP、内容与技术 SEO
- 如何用 Codex 修 Technical SEO 且不破坏 Production
- 如何用 Codex Automations 跑每日 SEO/GEO Monitoring
- Codex SEO/GEO Quality Gates：Diff、Evidence、Tests 与 Human Approval
下一步
- 上一篇： 2026 年最佳 Codex GEO Skill
- 下一篇： 如何用 Codex Subagents 做 SERP、内容与技术 SEO
- 相关： 如何用 MCP 把 Codex 接上 SEO Data
Sources and notes
请以 OpenAI 官方 Codex documentation 作为 current syntax 与 product behavior 的准确来源：
- Codex CLI: https://developers.openai.com/codex/cli
- AGENTS.md: https://developers.openai.com/codex/guides/agents-md
- Codex Skills: https://developers.openai.com/codex/skills
- Codex MCP: https://developers.openai.com/codex/mcp
- Codex subagents: https://developers.openai.com/codex/subagents
- Codex configuration: https://developers.openai.com/codex/config-reference
Author: Camille Rhodes, Auspia 300+ AI Content Workflows 架构师。Camille 撰写 AI-assisted content systems、automation 与 growth teams 的 editorial quality control。
