📦 SEO 🦉OwlsClaw - Research * Plan * Write — SEOwlsClaw — SEO内容研究与规划写作系统

名称与描述

名称: seowlowsclaw

描述: 全栈SEO和内容营销系统。使用人物角色驱动的写作、多客户品牌配置和地区感知模板生成SEO优化内容（落地页、博客文章、产品页面、FAQ、社交媒体）。支持通过/seobrief + --from-brief的简报优先代理工作流，通过/seoplan的战略集群规划，以及三层架构（地区→品牌→人物角色）进行干净的多客户工作。输出纯文本或可直接部署的HTML，包含完整schema标记。命名为"SEOwlsClaw"（发音为"See Owls Claw"）——单个'O'使其听起来像"See"。

何时使用

仅在Chris需要使用特定人物角色、关键词策略和可直接部署的干净输出生成SEO就绪内容时使用。

触发短语:

• "Generate SEO blog post about X"
• "Write product description using E-Commerce Manager persona"
• "Create landing page for Y sale campaign"
• "Audit my SEO strategy"
• "Give me the HTML for a product page about X"
• "Create a content brief for X"
• "Brief me on [topic] before writing"
• "I need a brief for a Blogpost about X"
• "Load brand profile for [client]"
• "Activate brand [id]"
• "Set up brand [client name]"
• "Build an SEO plan for [niche]"
• "Plan a content cluster for [topic]"
• "Give me a site architecture for [niche]"
• "What pages should I build for [topic]?"
• "Show me quick wins for [niche]"
• "I need a content strategy for [client]"

能力声明

核心命令

技能文件地图 — 快速导航

这是技能中每个文件的 master 参考。代理使用它来知道何时加载什么。只加载当前命令和工作流所需的——从不一次加载所有文件。

根文件（始终可用）

PERSONAS/

LOCALE/

BRANDS/

SEO_CHECKS/

TEMPLATES/ 和 TEMPLATES_SOCIAL/

SEO_BRIEFS/ 和 SEO_PLANS/

输出格式

/write — 纯文本输出

返回干净的、结构化的文本内容——无HTML标签。在您想先审查内容、粘贴到CMS编辑器或在别处使用（社交标题、邮件、文档）时使用。

/write Blogpost "How to identify a genuine Leica M6"
→ 返回：作为可读文本的完整博客文章，带标题、段落、列表
无HTML标签。可直接粘贴到WordPress、JTL Shop编辑器、Notion等。

/writehtml — 纯HTML输出

使用相应的TEMPLATES/.md模板返回完整HTML文档。所有{PLACEHOLDER}变量都被替换为真实内容。输出中零占位符。在您想要复制粘贴即可部署的代码时使用。

/writehtml Productused "Leica M6 TTL, serial 2741xxx, condition EX+"
→ 返回：所有占位符已替换的完整HTML文件，包含schema，
Zone:AI和Zone:CTA部分已标记，可直接部署

任何输出后代理将提供：

• "give me raw HTML only" → 去除markdown包装，返回纯代码块
• "run /checks" → 重新对生成的输出运行SEO审计

/write vs /writehtml — 何时使用哪个

完整规则: 参见SEO_CHECKS/search_intent.md

快速参考

完整处理逻辑及所有步骤详情：见BRAIN_ARCHITECTURE.md
所有命令、类型和标志的完整详情：见COMMANDS.md
页面模板索引和结构概述：见PAGE_STRUCTURES.md
完整SEO研究和写作工作流：见SEO_PATH.md

步骤0 搜索意图检测
分析提示→自动选择页面格式（SEO_CHECKS/search_intent.md）
跳过：/seoplan、/seobrief——战略命令，无需页面格式
步骤1 解析命令
提取人物角色、类型、提示、所有标志
--from-brief
如果标志存在→在解析时加载SEO_BRIEFS/.md
--plan
如果标志存在→在解析时加载SEO_PLANS/.md节点
步骤2a 加载人物角色索引
PERSONAS/_index.md→查找persona_id
步骤2b 加载人物角色文件
PERSONAS/.md→风格、语气、E-E-A-T规则
/seoplan + /seobrief
始终内部加载researcher.md（覆盖会话人物角色）
默认回退
如果无/persona命令→加载PERSONAS/blogger.md
语气覆盖
如果存在--tone标志→覆盖人物角色语气，保留其他一切
步骤2c 加载地区
LOCALE/base.md + LOCALE/.md（如果存在--lang标志）
步骤2d 加载品牌配置
如果/brand激活或--brand标志：
BRANDS/.md→brand_vars{} + compliance{}
跳过如果
无/brand命令且无--brand标志→无品牌规则适用
步骤2e SEO计划管道
如果/seoplan激活：
加载SEO_PLANS/plan_workflow.md→运行步骤A-G→停止（步骤3-7不运行）
步骤3 生成变量
提示+人物角色+品牌+简报+计划节点→完整变量字典
步骤3.5 区域分配应用
将A区域（中性/事实）与B区域（CTA/销售）应用于每个内容部分
步骤4 选择模板
匹配页面类型→加载TEMPLATES/.md
/write跳过步骤4-5纯文本输出——不加载模板
步骤5 变量替换
用真实值替换模板中的所有{PLACEHOLDER}
步骤6 SEO检查
运行SEO_CHECKS/中的所有适用文件
/seoplan
运行计划质量检查（SEO_PLANS/plan_workflow.md中的步骤F）代替
步骤6.5 人物角色合规检查
标题公式·深度·E-E-A-T信号·A/B区域·零占位符泄漏
/seoplan
跳过（无页面内容生成）
步骤6.6 品牌合规检查
如果品牌激活：禁用短语·紧急程度限制·必需披露
硬性失败
阻止输出直到所有违规解决
/seoplan
品牌人物角色默认值仅应用于节点分配
步骤7 输出
/write→纯文本|/writehtml→纯HTML
/seoplan
结构化计划保存到SEO_PLANS/
/seobrief
结构化简报保存到SEO_BRIEFS/

工作流示例 — /write（纯文本）

/persona creative-writer
/write Blogpost "Shooting film in Nürnberg with a Leica M6" --primary-kw "leica m6 film photography"
# 步骤0：检测到信息性意图→确认Blogpost
# 步骤2：加载PERSONAS/creative-writer.md
# 步骤3：使用故事驱动风格+标题公式生成变量
# 步骤3.5：将A区域分配给介绍+正文部分
# 步骤4-5：跳过（纯文本输出）
# 步骤6-6.5：SEO检查+合规通过
# 步骤7：返回可读的博客文章文本——无HTML标签

工作流示例 — /writehtml（HTML输出）

/persona ecommerce-manager
/writehtml Productused "Leica M6 TTL Chrome, serial 2741xxx, EX+ condition" --primary-kw "leica m6 ttl kaufen"
# 步骤0：交易性意图→确认Productused
# 步骤2：加载PERSONAS/ecommerce-manager.md
# 步骤3：生成完整变量字典（所有{SPEC_}、{SCHEMA_}、{FAQ_}等）
# 步骤3.5：A区域用于规格/状况部分，B区域用于CTA/定价块
# 步骤4：加载TEMPLATES/product_used_template.md
# 步骤5：替换所有{PLACEHOLDER}——输出中零占位符
# 步骤6-6.5：SEO检查+合规通过
# 步骤7：返回完整HTML——可直接部署

工作流示例 — /seobrief → /write（简报优先流程）

# 步骤1：生成简报
/seobrief Blogpost "Leica M6 Analogfotografie Guide" --lang de --brand jbv-foto
# → 研究员人物角色内部加载（始终）
# → 关键词集群研究：主KW自动检测
# → 分析2-3个竞争对手URL寻找差距
# → 简报保存：SEO_BRIEFS/<年>/<月>/leica-m6-analogfotografie-guide-de.md
# → 输出：完整结构化简报，包含KW集群、H1-H4大纲、PAA问题、内部链接目标，以及可运行的/write命令
# 步骤2：从简报写作
/brand jbv-foto
/persona blogger
/write Blogpost "Leica M6 Guide" --from-brief leica-m6-analogfotografie-guide-de --lang de
# → 步骤1：加载简报→KW、大纲、PAA、内部链接合并到解析
# → 步骤2a-c：博主人物角色+de地区
# → 步骤2d：jbv-foto品牌配置（CTA、合规）合并
# → 步骤3：使用简报大纲作为H标签结构生成变量
# → 步骤6、6.5、6.6：SEO+人物角色+品牌合规全部通过
# → 步骤7：返回遵循简报已批准结构的纯文本文章

工作流示例 — /seoplan → /seobrief → /write（完整代理流程）

/seoplan "Vintage analog cameras Germany" --lang de --brand jbv-foto

→ 步骤2e：加载SEO_PLANS/plan_workflow.md，研究员运行步骤A-G → 步骤A：关键词家族映射，快速获胜阈值=难度<22 → 步骤B-C：构建并分层11个节点（1个PILLAR + 4个QW + 3个FND + 3个STR） → 步骤D：生成内部链接矩阵——无孤立节点 → 步骤E：执行顺序：qw-01→qw-04首先，pillar-01之后，str-01-03最后 → 步骤G：保存为SEO_PLANS/<年>/<月>/vintage-analog-cameras-de.md

/seobrief Blogpost "Film einlegen Anleitung" --plan vintage-analog-cameras-de.qw-01 --lang de

→ 步骤1：从计划加载节点qw-01→提取primary_kw、page_type、links_to → 在计划数据基础上运行研究，简报保存：SEO_BRIEFS/<年>/<月>/film-einlegen-anleitung-de.md

/brand jbv-foto
/persona blogger
/write Blogpost "Film einlegen" --from-brief film-einlegen-anleitung-de --lang de

→ 简报+计划节点+品牌在步骤1全部合并 → 步骤6/6.5/6.6通过 → 步骤7：纯文本文章准备好发布

变量替换引擎 🧠

当您提供内容提示时，大脑：

• 自动从您的提示中提取变量
• 用真实内容替换模板中的所有{PLACEHOLDER}文本
• 输出零占位符——所有{VAR}文本在输出前都已消失

每种页面类型的完整变量参考: 见BRAIN_ARCHITECTURE.md`

示例 — 变量字典（Productused，Leica M6）

{
  "TITLE": "Leica M6 TTL Chrome — Used, EX+ Condition | WebsiteName",
  "META_DESCRIPTION": "Buy a used Leica M6 TTL Chrome in EX+ condition. Serial 2741xxx, 2000–2001 production. Fully functional, CLA'd. 30-day return policy.",
  "URL_CANONICAL": "https://www.example.de/products/leica-m6-ttl-chrome-gebraucht",
  "H1_TITLE": "Leica M6 TTL Chrome (Type 10434) — EX+ Condition, Serial 2741xxx",
  "HERO_SUBHEADLINE_CONDITION_DISCLOSURE": "2000–2001 production · TTL flash metering · All functions verified",
  "CONDITION_LEVEL_USED": "EX+",
  "DISPLAY_PRICE_EUR_USED": "€1,090",
  "SCHEMA_CONDITION": "https://schema.org/UsedCondition",
  "SCHEMA_SKU": "EXMAMPLE-2741",
  "FAQ_Q1": "What condition is this Leica M6 TTL in?",
  "FAQ_A1": "EX+ — light use only. No brassing, viewfinder clear, shutter fires accurately at all speeds.",
  # ... 所有剩余变量
}

文件位置与依赖

seowlowsclaw/
├── SKILL.md ← 本文件——核心指令+命令参考
├── BRAIN_ARCHITECTURE.md ← 完整处理逻辑（所有9个大脑步骤）
├── COMMANDS.md ← 完整命令参考及所有标志
├── PAGE_STRUCTURES.md ← 链接所有页面模板的 master 索引
├── SEO_PATH.md ← 完整SEO工作流：研究→分析→写作→检查
│
├── PERSONAS/ ← 每个人物角色一个文件
│   ├── _index.md ← 首先加载——列出所有人物角色ID和文件路径
│   ├── ecommerce-manager.md
│   ├── creative-writer.md
│   ├── blogger.md ← 未指定时的默认人物角色
│   ├── researcher.md
│   ├── vintage-expert.md
│   └── travel-photographer.md
│
├── BRANDS/ ← 每个客户品牌配置一个文件
│   ├── _index.md ← 首先加载——列出所有品牌ID和文件路径
│   └── brand-template.md ← 复制此文件创建新品牌配置
│
├── LOCALE/ ← 语言覆盖文件（Base + Delta架构）
│   ├── base.md ← 所有地区键的英语默认值——始终加载
│   ├── de.md ← 德语覆盖（--lang de）
│   ├── fr.md ← 法语覆盖（--lang fr）
│   ├── es.md ← 西班牙语覆盖（--lang es）
│   └── pt.md ← 葡萄牙语覆盖（--lang pt）
│
├── SEO_BRIEFS/ ← 生成的内容简报（每个主题/页面一个）
│   └── _index.md ← 注册表：brief-id | topic | type | date | status
│
├── SEO_PLANS/ ← 每个细分领域/站点活动一个计划文件
│   ├── _index.md ← 注册表：plan-id | niche | mode | lang | date
│   ├── plan-template.md ← 格式参考+示例计划
│   └── plan_workflow.md ← 完整/seoplan管道逻辑（步骤A-G）——仅在/seoplan时加载
│
├── SEO_CHECKS/ ← SEO规则、意图检测、schema、质量检查
│   ├── search_intent.md ← 步骤0规则——意图检测+格式选择
│   ├── do-and-don-lists.md ← 页面类型特定的注意事项
│   ├── schema-markup.md ← Schema.org规则+{SCHEMA_}变量定义
│   ├── seo-checks-reference.md ← 完整SEO检查参考
│   └── seo-output-quality-checklist.md ← 输出前质量门
│
├── TEMPLATES/ ← HTML输出模板（仅由/writehtml使用）
│   ├── blog_post_template.md
│   ├── landing_page_template.md
│   ├── product_new_template.md
│   ├── product_used_template.md
│   └── faq_page_template.md
│
├── TEMPLATES_SOCIAL/ ← 社交媒体输出模板
│   ├── photo_post_template.md
│   └── video_post_template.md
│
├── OUTPUT_EXAMPLES/ ← 代理指导的参考输出示例
│   ├── blog_post_example.md
│   ├── landing_page_example.md
│   ├── product_new_example.md
│   └── product_used_example.md
│
#└── DOC/ ← 内部项目文档（代理不加载）
#   ├── BUGS.md ← 内部项目文档（代理不加载）
#   ├── CHANGELOG.md ← 内部项目文档（代理不加载）
#   └── PLANNING.md ← 内部项目文档（代理不加载）

最后更新：05-04-2026（v0.6） 新增：/brand、/brands、/seobrief、--from-brief标志、BRANDS/和SEO_BRIEFS/文件夹 维护者：Chris — SEOwlsClaw核心技能文件*