搜索优化任务落地与验收清单

要解决的问题

大多数 SEO 审计工具止步于报告：告诉你标题太长、缺少 schema、canonical 指向错误，然后由你手动打开 CMS，逐页复制粘贴。这个流程的问题在于——修改分散、缺乏版本记录、批量操作容易出错，更关键的是，没有机制验证改动是否真的生效。一旦线上页面出了问题，回滚往往要凭记忆。

这个技能解决的正是"从建议到上线"这一环。它连接 WordPress 或 Webflow 的 CMS MCP 服务，把审计发现直接变成可执行的页面级修改，并在每一步留下可审计的痕迹。

核心能力与工作方式

执行能力覆盖 SEO 落地的常见操作：

• 更新 title、meta description、robots 指令
• 部署或校验 JSON-LD 结构化数据（Article、Product、FAQ、HowTo、LocalBusiness、BreadcrumbList 等）
• 设置或修改 canonical URL
• 创建 301/302 重定向
• 通过 Google Search Console 提交索引请求（支持 normal 或 urgent 优先级）

执行门槛是强制的，不可跳过：

1. 在触碰任何线上页面之前，先输出完整的 Execution Summary，展示每个 meta、schema、canonical、重定向的 before/after diff，以及影响范围和合规信息
2. 用户必须输入明确的 yes 或等效批准；任何模糊、暗示、部分或缺失的输入都会取消执行
3. 失败时不会自动重试，需要人工审查后再决定是否重跑
4. 审批本身会被记录：执行前调用 approval-manager.py --action create-approval，平台确认成功后调用 --action mark-executed

处理流程分七步：

• 加载品牌上下文：读取 ~/.claude-marketing/brands/{slug}/profile.json、合规规则和行业背景
• 验证变更：抓取当前页面 meta、schema、canonical、重定向快照，对照 SEO 最佳实践（标题 50–60 字符、描述 150–160 字符、schema 符合 Google 富媒体结果要求等）
• 生成变更规范：把 SEO 修改映射到 CMS API 字段——WordPress 下区分 Yoast（_yoast_wpseo_title、_yoast_wpseo_metadesc）、RankMath 或 AIOSEO；Webflow 走原生 SEO 设置对象
• 创建审批门槛：以 diff 形式展示所有变更，标注风险等级（单页中等风险；超过 5 页的批量更新、重定向创建、canonical 变更为高风险），提示标题超长、schema 缺字段等警告
• 执行变更：通过 CMS MCP 写入字段、注入 JSON-LD、创建重定向规则、提交索引
• 部署后验证：回读页面数据确认改动生效；重定向测试 HTTP 状态码和目标；索引请求确认提交受理
• 记录与回滚：所有变更通过 seo-executor.py 记录时间戳、URL、变更类型、前后状态、CMS 平台、审批引用和回滚快照

适用边界与注意点

• 依赖 CMS MCP 连接：WordPress 或 Webflow 的 MCP server 必须已配置，且 SEO 插件（Yoast / RankMath / AIOSEO）信息需准确指定，否则字段映射会失败
• 不做自动重试：执行失败后需要人工介入，技能不会自行重跑，避免在状态不明时反复尝试
• 批量操作风险高：超过 5 页的更新、重定向创建、canonical 变更被标记为高风险，需要更谨慎的审批
• 品牌上下文是可选但推荐的：如果不存在品牌配置，会提示先运行 /digital-marketing-pro:brand-setup，或使用默认值继续
• 不替代策略制定：这个工具负责执行，不负责告诉你该改什么；它需要配合 SEO 审计或策略环节才能发挥作用