メニュー
yakuten (hrtyaku.com) 网站运营/SEO 作战入口。当用户要求：分析 GA/GSC 数据、看流量/排名/搜索词、 出 SEO 报告、推荐 SEO 文章选题、优化 CTR/meta/AEO、内容更新计划、"网站运营" 等任务时触发。 分析由 Claude 本人完成（不调 Gemini；scripts/seo/ai-analyze.mjs 仅为 CI 无人值守备用）。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | seo-ops |
| description | yakuten (hrtyaku.com) 网站运营/SEO 作战入口。当用户要求：分析 GA/GSC 数据、看流量/排名/搜索词、 出 SEO 报告、推荐 SEO 文章选题、优化 CTR/meta/AEO、内容更新计划、"网站运营" 等任务时触发。 分析由 Claude 本人完成（不调 Gemini；scripts/seo/ai-analyze.mjs 仅为 CI 无人值守备用）。 |
分工原则：数据用脚本拉（机械、可复现），分析和建议由 Claude 直接做（不转包给 Gemini）。
npm run seo:ai（Gemini 脚本）只用于 CI 无人值守场景，日常交互一律 Claude 亲自分析。
| 数据源 | 怎么读 | 凭证 |
|---|---|---|
| GA4 | MCP 工具 mcp__analytics-mcp__run_report 等，property_id=541902985 | 服务账号 ga-mcp@hrt-yakuten-123456.iam.gserviceaccount.com（已是属性查看者） |
| GSC | npm run seo:gsc → docs/data/gsc-latest.csv（列: query,impressions,clicks,ctr,position,top_page） | 本地 .gsc-credentials.json（gitignored）= gsc-reader@yakuten-seo-20260419.iam.gserviceaccount.com |
| Trends | npm run seo:trends → docs/data/trends-latest.json（geo=CN，词表 trends-keywords.json） | 无需 |
| 策略底稿 | docs/seo-keyword-gap.md（人工 P0/P1/P2 + AUTO-SNAPSHOT 区块） | — |
| 页面清单 | public/llms.txt | — |
GA4 API 陷阱：metrics/dimensions 传字符串数组（["screenPageViews","sessions"]），传 {name:...} 对象会 InputValidationError。
GA4 埋点 Measurement ID G-1E6C28RJFJ 写死在 src/components/overrides/Head.astro，生产自动激活。
GA4 常用配方（date_ranges 用 [{"start_date":"28daysAgo","end_date":"today"}]）：
| 要什么 | dimensions | metrics | 备注 |
|---|---|---|---|
| 热门页面 | ["pagePath"] | ["screenPageViews","activeUsers","averageSessionDuration"] | order_bys desc screenPageViews，limit 30 |
| 国家分布 | ["country"] | ["activeUsers","sessions"] | 验证多语种投放是否到达目标市场 |
| 流量渠道 | ["sessionDefaultChannelGroup"] | ["sessions","activeUsers"] | Organic Search 占比 = SEO 大盘健康度 |
| 语言版本对比 | ["pagePath"] + dimension_filter BEGINS_WITH /es/ 等 | ["screenPageViews","bounceRate"] | 逐 locale 看 |
| 日趋势 | ["date"] | ["activeUsers","screenPageViews"] | 看改动前后拐点 |
| 实时在线 | run_realtime_report + ["unifiedScreenName"] | ["activeUsers"] | 偶尔抽查 |
两侧数据的分工：GSC = 进站前（搜索词/排位/CTR），GA4 = 进站后（停留/跳出/路径）。 高曝光词的落地页要两侧对照——排位好+CTR 好但跳出高 = 内容不符预期，光改 meta 没用。
ls -la docs/data/gsc-latest.csv（看 mtime 是否今天）→ 过期才跑
npm run seo:gsc && npm run seo:trends && npm run seo:refresh
⚠ 绝不随手跑 npm run seo:ai --dry-run——它会把当日 ai-seo-report-*.md 覆盖成占位符（2026-07-10 实际踩坑）。gsc-latest.csv + seo-keyword-gap.md 的 AUTO-SNAPSHOT（已算好 top40 + striking distance）；
再按上表补 GA4 流量侧（至少：热门页面 + 国家 + 渠道），做两侧对照。docs/data/ai-seo-report-YYYY-MM-DD.md + 覆盖 ai-seo-report-latest.md（均 gitignored，含真实搜索词不入库）。首行注释注明 Generated by Claude (seo-ops) + 数据来源与日期范围。药娘用药指南(zh, CTR 19%)、プロギノンデポー 個人輸入(ja, 20%)。多语种纪律：站有 17 个 locale，query 天然分布在各语言。每条行动必须落到具体 locale 的具体页面
（/es/... 而非笼统的"孕酮页"）；改 meta 只改命中语言的页，勿顺手全语种铺开（i18n 同步另有流程）。
meta 改写标准：description 110–160 字符（与 blog eval 同标准）；title 含目标 query 主词 + 一个点击钩子 （数字/年份/直答），不夸大疗效、不用绝对语。
产出格式：一句话诊断 → Top 5 行动表（词/曝光/排位/CTR/落地页/动作）→ 模式归纳 → 区分「机械改写」vs「需要新写内容」→ 若上轮报告存在，附「上轮行动回顾」（同 query 排位/CTR 对比）。
<CitationRef> + DOI + 证据等级；无引用 = 不上线。/cto-blog-pipeline（有可循证性硬门槛）。seo-keyword-gap.md P0/P1/P2 优先级 + Trends 热度。/cto-blog-pipeline（勿在本 skill 内直接写全文）。选题定稿、正文交给 /cto-blog-pipeline 后，配图这样做。gpt-image-2 现在能可靠渲染文字、多语言、信息图式复杂版面——旧的「图表一律拒绝 LLM 生图」规则（cto-image §26.5）对它已放宽，可放心用于：博客/文档 OG 图、编辑类信息图、概念示意图、图标套装、文字卡片。
gpt-image-2 提示词结构（OpenAI 官方 cookbook）：
背景/场景 → 主体 → 关键细节 → 约束，复杂需求用换行分块而非长段落。Spell the brand: U-T-R-O-G-E-S-T-A-N。quality: high；一般产品图 medium。Render text verbatim. No extra characters. No duplicate text. No invented logos.clean flat visual system, consistent icon style, clear arrows, readable labels, generous white space。keep typography style, placement, spacing, hierarchy; translate verbatim, no reflow。医疗红线（配图同样不可妥协）：
PKCurveChart、DoseTable、血检范围图），不用 gpt-image-2 —— AI 画错剂量/半衰期/坐标轴数值是安全事故，不是画质问题。gpt-image-2 只做「示意/编辑/品牌」类图，不做「承载数据」类图。alt（无障碍 + SEO）；产品示意图 alt 标明是「示意图」。no extra/duplicate text 是降低概率，不是保证）。public/images/，OG 图postbuild 由 generate-og-images.mjs 处理。实际生图仍走 /cto-image 的委派流程（Codex gpt-image-2 asset-in-loop）；本 skill 只负责产出符合上述规范的 prompt + 医疗红线把关。
npm run build 通过 + grep dist 确认改动落地（CJK ** 陷阱见 memory）。.github/workflows/seo-refresh.yml 每月 1 号自动拉数据开 PR（需 GitHub Secret GSC_CREDENTIALS_B64；未配则只跑 Trends）。§37 Constitution 协议自动加载器（对齐 GitHub Spec Kit）。当用户请求涉及 spec/plan/ feature/architecture/decision/release 或开始新任务时自动触发。读取项目 docs/ai-cto/CONSTITUTION.md 并把项目特定的不可妥协约束注入响应。
§35 Eval-Driven Development 强制规则（铁律 #12）。当 Claude 编辑 .claude/commands/、 .claude/agents/、.claude/skills/、.agents/skills/、CLAUDE.md、playbook/handbook.md、 .claude/output-styles/ 等 prompt/agent 配置类文件时自动加载。 强制：无 eval 不进 main。配套 eval-gate.sh 注入 PostToolUse 提醒。
§32.1 Forbidden 路径强制规则。当 Claude 编辑 auth/payment/billing/secrets/keys/migration/ crypto/infra/terraform/ansible/.github/workflows 路径下文件时自动加载。要求 spec-driven、 双签、PR 标签 requires-double-review。配套 .claude/hooks/forbidden-guard.sh 硬阻止 (exit 2)；本 skill 提供 Claude 应如何响应被阻止时的处理流程。
ai-playbook handbook (3986 行) 智能查询入口。当用户/任务提到 §NN.M 章节号、 "手册"、"playbook"、"铁律 #N"、"反模式"、"竞品" 等关键词时自动触发。 读 INDEX.md 决定该读哪段 handbook，避免每次塞 3986 行全文进上下文。
v3.9 Bugbot-style learned rules 自动加载器（Cursor 启发，44k learned rules 验证）。 当 Claude 触及 .claude/rules/learned/ 目录或被 /cto-evolve apply 写入新 learned rule 时自动加载。把项目历次自审 / cross-review / commit 沉淀的具体教训注入上下文， 避免重复犯同类错。
§20.3 Test-Lock 规则（铁律 #14）。当 Claude 编辑测试文件 (tests/、__tests__/、 *.test.{ts,tsx,js,jsx,py}、*.spec.*、*_test.{py,go}) 时自动加载。强制： AI 只能改实现不能改断言；改测试需符合合法场景之一并显式标注 commit message。 配套 .claude/hooks/test-lock-guard.sh 注入 PreToolUse 提醒。