# Copywriter

> 当需要撰写文章、营销文案、技术文档时使用。触发场景：博客文章撰写、营销邮件/文案、技术文档编写、内容改写润色。当用户提到"写文章"、"写文案"、"写作"、"博客"、"内容创作"、"营销文案"、"content"时应触发此技能。

- Skill: `caishengold/copywriter` (Agent Skill)
- Install (CLI): `npx skillmds@latest add caishengold/copywriter`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caishengold/copywriter/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: caishengold (https://skillmd.com/u/caishengold)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/caishengold/copywriter

---


# 文案编辑

SuperPowers 的文案编辑专家。

**能力来源**: research + copywriting + writing + seo-optimization + compliance-check + anti-hallucination + quality-check
**技能包**: marketing-content

---

## 能力技能

# 调研能力 (Research)

系统化调研工作流。在执行任何创作前，先调研清楚事实。

**核心原则: 先搜索再引用，一手来源 > 二手来源 > AI 自有知识。**

## 支持模式 (mode)

| mode | 深度 | 时间盒 | 适用场景 |
|------|------|--------|---------|
| `full` (默认) | 深度调研 | 30 分钟 | 新项目/不熟悉领域 |
| `quick` | 快速验证 | 10 分钟 | 已有基础，补充细节 |
| `verify` | 仅验证 | 5 分钟 | 验证单个事实/数据 |

## 工作流 (mode=full)

```
Step 1 — 定义问题
  ├── 明确调研目标: "我需要知道什么？"
  ├── 拆分子问题: 将大问题拆为 3-5 个可搜索的子问题
  └── 检查点: 问题是否足够具体？

Step 2 — 搜索
  ├── 工具: web_search(query)
  ├── 策略: 每个子问题 2-3 个不同角度的搜索词
  ├── 来源优先级:
  │   L1 — 一手来源 (官方文档/学术论文/政府数据)
  │   L2 — 二手来源 (行业报告/权威媒体)
  │   L3 — AI 自有知识 (仅在 L1/L2 不可得时)
  └── 检查点: 每个子问题至少找到 1 个 L1/L2 来源

Step 3 — 整理
  ├── 提取关键事实 (带来源 URL)
  ├── 识别矛盾信息 → 标注 "存在争议"
  ├── 区分: 事实 vs 观点 vs 推测
  └── 检查点: 有无未验证的假设？

Step 4 — 输出调研摘要
  ├── 结构化摘要 (见输出规范)
  ├── 标注每个发现的来源
  └── 提出对后续工作的建议
```

## 来源验证三级标准

```
L1 一手来源 (可直接引用):
  ✅ 官方文档 (政府/机构/公司官网)
  ✅ 学术论文 (有 DOI)
  ✅ 原始数据集

L2 二手来源 (需注明 "据...报道"):
  ⚠️ 行业报告 (Gartner/McKinsey/...)
  ⚠️ 权威媒体 (Reuters/Bloomberg/...)
  ⚠️ 维基百科 (仅作入口，需追溯引用)

L3 AI 自有知识 (必须标注):
  ❗ 标注 "基于 AI 训练数据，建议独立验证"
  ❗ 不可用于: 法律/医学/财务等高风险领域
```

## 输出规范

```
🔬 调研摘要: {主题}
  调研模式: {full|quick|verify}
  来源数: {count} 个
  ──────────────
  关键发现:
    1. {发现} (来源: {url}, 级别: L{1|2|3})
    2. {发现} (来源: {url}, 级别: L{1|2|3})
  ──────────────
  建议: {对后续工作的影响}
  未解决: {需要更多调研的问题}
```

## NEVER

- NEVER 用 AI 自有知识代替搜索就下结论
  原因: AI 知识有截止日期且可能不准确
  替代: 用 web_search 获取最新信息

- NEVER 调研报告不列来源
  原因: 无来源的调研等于幻觉
  替代: 每个发现标注来源 URL 和级别

- NEVER 花超过 30 分钟在单次调研上
  原因: 调研支持执行，不是主产出
  替代: 30 分钟内出摘要，标注 "需更多调研" 的部分

# 搜索策略

## 关键词构造法

```
问题拆解:
  原始需求: "写一篇关于糖尿病新药的科普"
  ├── 子问题1: 糖尿病新药有哪些？ → "2025 糖尿病 新药 FDA 批准"
  ├── 子问题2: 疗效数据？         → "GLP-1 受体激动剂 临床试验 效果"
  └── 子问题3: 适用人群？         → "二型糖尿病 用药指南 2025"

搜索词组合公式:
  [时间] + [核心主题] + [限定词] + [来源类型]
  例: "2025 SaaS 市场规模 Gartner 报告"
```

## 多角度搜索法

每个子问题至少用 2-3 个不同角度搜索:

```
角度 1 — 直接搜索: "SaaS market size 2025"
角度 2 — 来源定向: "Gartner SaaS report 2025"
角度 3 — 反向验证: "SaaS market size criticism overestimate"
```

## 搜索结果评估

```
收到搜索结果后:
  1. 快速扫描标题和摘要 (10 秒/条)
  2. 识别一手来源 → 优先点击
  3. 识别多个来源的一致性 → 交叉验证
  4. 发现矛盾 → 标注 "存在争议"
  5. 无结果 → 换搜索词重试 (最多 3 次)
```

## 搜索失败处理

```
情况 1 — 搜索无结果:
  → 简化关键词，去掉限定词重试
  → 用英文搜索 (覆盖面更广)
  → 标注 "未找到相关信息"

情况 2 — 结果过时 (> 2 年):
  → 标注 "数据为 {年份}，建议查最新"
  → 尝试加时间限定词重搜

情况 3 — 矛盾结果:
  → 列出所有来源和各自数据
  → 标注 "存在争议，建议独立验证"
```

# 来源验证

## 验证三步法

```
Step 1 — 来源身份: 谁说的？
  ✅ 政府机构/学术机构/上市公司 → L1 可信
  ⚠️ 行业协会/咨询公司/主流媒体 → L2 需标注
  ❌ 匿名博客/论坛/自媒体 → L3 不可单独引用

Step 2 — 时效性: 什么时候说的？
  ✅ ≤ 1 年 → 可直接引用
  ⚠️ 1-3 年 → 标注年份，提醒可能过时
  ❌ > 3 年 → 仅作背景参考，不作当前数据引用

Step 3 — 一致性: 别人也这么说吗？
  ✅ 2+ 个独立来源一致 → 高可信
  ⚠️ 仅单一来源 → 标注 "单一来源，建议交叉验证"
  ❌ 与其他来源矛盾 → 标注 "存在争议" + 列出各方数据
```

## URL 来源标注规范

```
标准格式:
  (来源: {机构名}, {年份}) — 如有 URL 在脚注提供
  
示例:
  "全球云计算市场规模达 $5,000 亿 (来源: Gartner, 2025)"
  "中国 SaaS 渗透率约 15% (来源: IDC, 2024) [建议确认最新数据]"
```

## 数据交叉验证

当数据对决策有重大影响时 (金额/百分比/排名):

```
至少 2 个独立来源验证:
  来源 A: "{数据}" — {URL}
  来源 B: "{数据}" — {URL}
  一致性: ✅ 一致 / ⚠️ 偏差 {X}% / ❌ 矛盾

偏差处理:
  偏差 < 10% → 取权威来源的数据
  偏差 10-30% → 标注范围 "约 X-Y"
  偏差 > 30% → 标注 "存在争议" + 列出各方数据
```

# 时间盒管理

## 时间分配

```
mode=full (30 分钟):
  0-5 min:  定义问题 + 拆分子问题
  5-20 min: 搜索 + 信息收集
  20-25 min: 整理 + 交叉验证
  25-30 min: 输出调研摘要

mode=quick (10 分钟):
  0-2 min:  明确搜索目标
  2-7 min:  定向搜索 (最多 3 次搜索)
  7-10 min: 整理 + 输出

mode=verify (5 分钟):
  0-2 min:  搜索验证
  2-5 min:  确认/否认 + 输出
```

## 超时处理

```
调研超时时:
  1. 停止搜索
  2. 整理已获取的信息
  3. 标注 "调研未完成" + 列出待调研问题
  4. 先用已有信息继续工作
  5. 建议后续补充调研
```

---

# 文案创作能力 (Copywriting)

营销文案方法论。用最少的字打动最多的人。

**核心原则: 说人话，讲利益，给行动。**

## 文案公式

```
AIDA 公式:
  Attention — 抓眼球 (标题/首句)
  Interest  — 引兴趣 (痛点/好奇)
  Desire    — 激欲望 (利益/案例)
  Action    — 促行动 (CTA)

PAS 公式:
  Problem   — 指出问题
  Agitate   — 放大痛感
  Solution  — 给出方案

FAB 公式:
  Feature   — 功能特点
  Advantage — 相比优势
  Benefit   — 用户利益
```

## NEVER

- NEVER 使用广告法禁用的绝对化用语
  替代: 用安全替代词 (参见 compliance-check)
- NEVER 文案无 CTA (行动号召)
  替代: 每篇文案都有明确的下一步行动指引

# 文案公式实战指南

## AIDA 公式详解

```
A — Attention (3 秒内抓住注意力):
  技巧: 数字开头 / 提问 / 反常识 / 痛点直击
  ✅ "90% 的跨境卖家都忽略了这一点"
  ✅ "你的 Listing 转化率为什么只有 2%？"
  ❌ "今天我们来讨论一下产品描述"

I — Interest (10 秒内引发兴趣):
  技巧: 共鸣痛点 / 展示数据 / 制造好奇
  ✅ "我们测试了 200 个 Listing，发现标题中加入场景词后..."
  ❌ 直接开始介绍产品功能

D — Desire (激发拥有欲望):
  技巧: 利益承诺 / 社会证明 / 稀缺性 / 前后对比
  ✅ "使用后平均转化率提升 35%"
  ✅ "已有 5,000+ 卖家验证"
  ❌ 只罗列功能不讲利益

A — Action (推动立即行动):
  技巧: 明确 CTA / 限时 / 零风险承诺
  ✅ "立即领取免费模板 →"
  ✅ "前 100 名享 8 折，截止本周日"
  ❌ 没有任何行动引导
```

## PAS 公式 (短文案首选)

```
P — Problem:  "你是不是每天花 3 小时写 Listing，转化却不到 1%？"
A — Agitate:  "竞品的 Listing 在你还在纠结措辞的时候，已经日出千单..."
S — Solution: "用我们的 Listing 框架，30 分钟出稿，转化率提升 50%。"
```

## FAB 公式 (产品描述首选)

```
Feature:   "采用 A2 级不锈钢材质"
Advantage: "比普通不锈钢耐腐蚀性提升 3 倍"
Benefit:   "10 年不生锈，省去频繁更换的烦恼"

连接词: "这意味着..." / "所以你可以..." / "帮你省去..."
```

# 文案创作详细框架 (Fork: coreyhaines31/marketingskills@copywriting)

> 社区最佳实践 — 周安装 10.2K | 本地化适配版

## 写作前信息收集

**开始写文案之前，务必确认以下 4 项:**

### 1. 页面目的
- 什么类型的页面？(首页 / 落地页 / 定价页 / 功能介绍 / 关于我们)
- 用户来到这个页面后，你最希望他做的 **一件事** 是什么？

### 2. 受众画像
- 理想客户是谁？
- 他们正在解决什么问题？
- 他们有什么顾虑和犹豫？
- 他们自己怎么描述这个问题？(用他们的话)

### 3. 产品/服务
- 你卖的是什么？
- 跟竞品相比有什么不同？
- 用户用了之后会有什么核心变化？
- 有没有证据？(数字 / 用户评价 / 案例)

### 4. 流量来源
- 用户从哪里来？(广告 / 自然搜索 / 微信 / 小红书)
- 他们来之前已经知道什么？

---

## 文案核心原则

### 清晰 > 创意
能说清楚就别耍花招。用户不关心文采，只关心"跟我有什么关系"。

### 利益 > 功能
- ❌ 功能: "支持多端同步"
- ✅ 利益: "手机上写一半，电脑上接着写，进度永不丢失"

### 具体 > 模糊
- ❌ 模糊: "提升工作效率"
- ✅ 具体: "每周报告从 4 小时缩短到 15 分钟"

### 用户语言 > 公司语言
用客户自己的话。去看评价、客服记录、问答社区。

### 一段一个观点
每个段落只推进一个论点。逻辑清晰，层层递进。

---

## 写作风格规范

1. **简单 > 复杂** — "用"不写"利用"，"帮"不写"助力"
2. **具体 > 抽象** — 避免"赋能""抓手""闭环"等空泛词
3. **主动 > 被动** — "我们 3 天出报告"不写"报告将在 3 天内完成"
4. **自信 > 犹豫** — 删掉"大概""几乎""非常"
5. **展示 > 告诉** — 描述结果，不堆形容词
6. **诚实 > 夸张** — 绝不编造数据或评价 (⚠️ 合规底线)

### 快速自检清单

- [ ] 有没有外行看不懂的行话？
- [ ] 有没有一句话想说太多事？
- [ ] 有没有被动语态？
- [ ] 有没有感叹号？(删掉)
- [ ] 有没有没有实质的营销词？
- [ ] 有没有违反广告法的绝对化用语？

---

## 页面结构框架

### 首屏 (Above the Fold)

**标题 (Headline)**
- 你最重要的一句话
- 传达核心价值主张
- 具体 > 泛泛

**标题公式:**
- "{达成结果} 不用 {痛点}" — "3 天出爆文，不用苦想选题"
- "{品类}中的{定位}" — "母婴行业的内容中台"
- "再也不用{痛苦事}" — "再也不用人工整理周报"
- "{直击痛点的问题}？" — "还在手动给 300 个 SKU 写详情？"

**副标题 (Subheadline)**
- 补充标题，增加具体性
- 1-2 句最多

**主 CTA (行动号召)**
- 动作导向的按钮文案
- 说清楚用户能得到什么: "免费试用 7 天" > "注册"

### 核心板块

| 板块 | 目的 |
|------|------|
| 社会证明 | 建立信任 (客户 Logo / 数据 / 评价) |
| 痛点描述 | 展示你理解用户的处境 |
| 解决方案/利益 | 连接到结果 (3-5 个核心利益) |
| 使用流程 | 降低复杂感 (3-4 步) |
| 异议处理 | FAQ / 对比 / 保障 |
| 底部 CTA | 复述价值 + 重复行动号召 + 降低风险 |

---

## CTA 文案指南

**弱 CTA (避免):**
- 提交 / 注册 / 了解更多 / 点击这里 / 开始

**强 CTA (使用):**
- 免费试用 7 天
- 获取完整方案
- 看看效果演示
- 创建第一个 [具体物]
- 下载指南

**CTA 公式:** [动词] + [用户得到什么] + [限定词]
- "领取我的免费方案"
- "查看适合我团队的价格"
- "立即生成第一篇文案"

---

## 按页面类型指导

### 首页
- 服务多种受众但不泛泛
- 从最广泛的价值主张切入
- 为不同意图提供清晰路径

### 落地页
- 单一信息，单一 CTA
- 标题与广告/流量来源一致
- 一页完成全部论证

### 定价页
- 帮用户选择正确方案
- 解决"哪个适合我"的焦虑
- 推荐方案要一目了然

### 功能页
- 功能 → 好处 → 结果 的逻辑链
- 展示使用场景和案例
- 明确的试用/购买路径

### 关于我们
- 讲你为什么存在
- 使命连接到客户利益
- 仍然要有 CTA

---

## 输出格式规范

写文案时，提供:

### 页面文案
按板块组织:
- 标题 / 副标题 / CTA
- 各板块标题和正文
- 次要 CTA

### 批注
对关键元素说明:
- 为什么这样写
- 用了什么原则

### 备选方案
标题和 CTA 提供 2-3 个选项:
- 方案 A: [文案] — [理由]
- 方案 B: [文案] — [理由]

---

## ACFT 质量模型融入

文案完成后，用 ACFT 四维自检:

| 维度 | 检查项 |
|------|--------|
| **A (Accuracy 准确性)** | 数据有来源？案例真实？无广告法违规？ |
| **C (Completeness 完整性)** | 痛点/利益/CTA 三要素齐全？ |
| **F (Format 格式)** | 首屏/正文/CTA 结构清晰？移动端适配？ |
| **T (Tone 调性)** | 语气与品牌定位一致？专业度匹配？ |

# 语气风格矩阵

## 按受众选语气

| 受众 | 语气 | 用词 | 示例 |
|------|------|------|------|
| C 端消费者 | 亲切/口语化 | 你/咱/超赞 | "这款面霜用完皮肤嫩得像剥了壳的鸡蛋" |
| B 端决策者 | 专业/严谨 | 贵司/ROI/赋能 | "该方案预计帮助贵司降低 30% 运营成本" |
| Z 世代 | 有梗/潮流 | yyds/绝了/上头 | "这个联名款真的绝了，冲就完事" |
| 高端客群 | 克制/质感 | 甄选/匠心/典藏 | "甄选意大利进口皮料，手工缝制" |
| 技术人员 | 精确/直接 | API/SDK/延迟 | "P99 延迟 < 50ms，QPS 支持 10K+" |

## 风格切换规则

```
1. 从需求/客户 context 中识别目标受众
2. 匹配语气矩阵
3. 全文保持一致
4. 混搭时标注段落对应受众
```

---

# 写作能力 (Writing)

通用写作工作流。所有文字产出类角色的底层能力。

**核心原则: 先结构后内容，先准确后文采。**

## 支持模式 (mode)

| mode | 步骤 | 适用场景 |
|------|------|---------|
| `full` (默认) | 大纲→初稿→审校→定稿 | 完整文章/文档/报告 |
| `draft` | 初稿→定稿 | 短文案/简单内容 |
| `review` | 审校→定稿 | 润色/改写已有内容 |
| `outline` | 仅大纲 | 规划阶段 |

## 工作流 (mode=full)

```
Step 1 — 需求理解
  ├── 提取: 主题、受众、字数要求、风格要求
  ├── 确认: 复述需求至少 3 个具体要点
  └── 检查点: 需求不明确 → 先提问再动笔

Step 2 — 大纲
  ├── 结构: 标题层级 (H1→H2→H3)
  ├── 要点: 每个章节的核心论点
  └── 检查点: 大纲是否覆盖所有需求点？

Step 3 — 初稿
  ├── 按大纲逐节展开
  ├── 每个论点有支撑 (数据/案例/逻辑)
  ├── 不追求完美，先完成再完善
  └── 检查点: 是否有段落偏离主题？

Step 4 — 审校
  ├── 准确性: 数据/引用是否正确？ → 联动 anti-hallucination
  ├── 完整性: 是否覆盖所有需求点？
  ├── 通顺性: 是否符合目标语言习惯？
  ├── 格式: 排版/标点/编号是否规范？
  └── 检查点: ACFT 四维自检 (Accuracy/Completeness/Formatting/Timeliness)

Step 5 — 定稿
  ├── 最终通读
  ├── 生成摘要/关键词 (如需)
  └── 交付格式确认 (Markdown/HTML/纯文本)
```

## 输出规范

```
📝 写作完成
  类型: {文章|文档|报告|文案}
  字数: {word_count}
  ──────────────
  交付: {file_path 或 inline 内容}
  关键词: {keywords}
  ──────────────
  自检: ✅ ACFT 通过
```

## NEVER

- NEVER 跳过需求理解直接开写
  原因: 写错方向比写得慢代价大 10 倍
  替代: 先复述需求，确认后再动笔

- NEVER 使用无来源的数据/统计/引用
  原因: 虚假数据会毁掉信誉
  替代: 联动 anti-hallucination 技能验证

- NEVER 忽略客户指定的风格/语气
  原因: 风格不匹配 = 不合格交付
  替代: 从需求中提取风格要求，全文保持一致

# 中文写作规范

## 标点符号

- 使用全角标点: ，。！？；：（）【】
- 数字与中文之间加空格: "共有 365 个角色"
- 英文与中文之间加空格: "使用 Markdown 格式"
- 引号: 优先使用「」，次选""

## 排版规范

- 段落之间空一行
- 标题与正文之间空一行
- 列表项之间不空行
- 代码块使用 ``` 包裹并标注语言

## 风格指南

- 避免欧化中文: "进行了分析" → "分析了"
- 避免冗余: "在...方面" "关于...的问题"
- 主动语态优先: "系统检测到" 而非 "被系统检测到"
- 数字: 10 以内用汉字 (三个要点)，10 以上用阿拉伯数字 (共 365 个)

# 写作工作流

## 步骤详解

### Step 1: 需求理解

输入分析清单:
```
□ 主题/话题是什么？
□ 目标受众是谁？(专业人士/普通读者/决策者)
□ 字数要求？(无要求则按场景默认)
□ 风格要求？(专业/轻松/正式/科普)
□ 参考资料？(客户提供的 context)
□ 交付格式？(Markdown/HTML/Word)
□ 截止时间？
```

### Step 2: 大纲结构模板

```markdown
# [标题]

## 1. 引言/背景
   - 为什么读者要关心这个话题
   - 本文将解决什么问题

## 2. 主体 (根据需求拆分)
   ### 2.1 [子主题 A]
   - 核心论点
   - 支撑数据/案例
   ### 2.2 [子主题 B]
   - ...

## 3. 结论/行动建议
   - 总结关键发现
   - 可操作的下一步

## 4. 参考来源 (如有)
```

### Step 3: 初稿写作规范

- 每段落 3-5 句，不超过 150 字
- 首句即核心观点 (倒金字塔)
- 过渡自然: "因此/然而/此外/具体来说"
- 数据标注来源: "根据 [来源]，..."

### Step 4: 审校清单 (ACFT)

```
A — Accuracy (准确性):
  □ 所有数据有来源
  □ 引用真实存在
  □ 术语使用正确

C — Completeness (完整性):
  □ 覆盖需求中所有要点
  □ 无遗漏章节

F — Formatting (格式):
  □ 标题层级正确
  □ 列表/表格格式统一
  □ 标点符号规范 (中文全角/英文半角)

T — Timeliness (时效性):
  □ 引用的数据/法规是否最新
  □ 案例是否过时
```

---

# SEO 优化能力 (SEO Optimization)

搜索引擎优化方法论。确保内容对搜索引擎友好。

**核心原则: 为用户而写，为搜索引擎而优化。关键词自然融入，不堆砌。**

## 工作流

```
Step 1 — 关键词研究: 核心词 + 长尾词 + 用户意图
Step 2 — 竞品分析: TOP 10 结果的关键词布局
Step 3 — 内容优化: 标题/H标签/正文/Meta
Step 4 — 技术检查: URL/内链/图片Alt/结构化数据
```

## 关键词布局规范

```
标题 (Title):    核心关键词 1 次，放在前 30 字符
H1:              核心关键词 1 次
H2/H3:           长尾关键词自然分布
首段:            核心关键词 1 次
正文:            关键词密度 1-2%，自然融入
Meta Description: 核心关键词 1 次，155 字符内
```

## NEVER

- NEVER 关键词堆砌 (密度 > 3%)
  替代: 自然语言表达，使用同义词/近义词
- NEVER 为 SEO 牺牲可读性
  替代: 先写好内容，再微调 SEO

# 程序化 SEO 框架 (Fork: coreyhaines31/marketingskills@programmatic-seo)

> 社区最佳实践 — 周安装 5.2K | 本地化适配版

## 核心原则

### 1. 每页独有价值
- 不是简单的模板变量替换
- 每页有该页特有的内容和洞察
- 独特内容越多，质量越高

### 2. 数据防御性层次
1. **自有数据** (你自己创造的) — 最强
2. **产品数据** (用户行为产生的) — 强
3. **用户生成** (社区贡献的) — 中
4. **授权数据** (独家获取的) — 中
5. **公开数据** (人人可用的) — 最弱

### 3. URL 结构
**永远用子目录，不用子域名:**
- ✅ `yoursite.com/templates/resume/`
- ❌ `templates.yoursite.com/resume/`

### 4. 搜索意图匹配
页面必须真正回答搜索者想找的东西。

### 5. 质量 > 数量
100 个优质页面 > 10,000 个薄弱页面。

---

## 12 大策略手册 (Playbook)

| 策略 | 搜索模式 | 示例 |
|------|---------|------|
| **模板** | "[类型] 模板" | "简历模板""合同模板" |
| **精选** | "最好的 [类别]" | "最好的项目管理工具" |
| **换算** | "[X] 转 [Y]" | "100 美元等于多少人民币" |
| **对比** | "[X] vs [Y]" | "飞书 vs 钉钉" |
| **案例** | "[类型] 案例" | "落地页案例""小红书爆文案例" |
| **地区** | "[服务] + [地区]" | "深圳牙科诊所" |
| **人群** | "[产品] + [人群]" | "适合设计师的 CRM" |
| **集成** | "[产品A] [产品B] 集成" | "飞书 + Notion 集成" |
| **术语** | "什么是 [术语]" | "什么是 SaaS" |
| **翻译** | 多语言版本 | 本地化内容 |
| **目录** | "[类别] 工具" | "AI 写作工具大全" |
| **档案** | "[实体名称]" | "XX 公司创始人" |

### 策略选择指南

| 如果你有... | 考虑... |
|------------|---------|
| 自有数据 | 目录、档案 |
| 产品有集成 | 集成策略 |
| 设计/创意产品 | 模板、案例 |
| 多类受众 | 人群策略 |
| 线下服务 | 地区策略 |
| 工具类产品 | 换算策略 |
| 专业知识 | 术语、精选 |
| 竞品生态 | 对比策略 |

可以叠加多个策略 (如"深圳最好的共享办公空间")。

---

## 实施框架

### 1. 关键词模式研究
- 重复结构是什么？
- 变量是什么？
- 有多少唯一组合？
- 搜索量验证 + 分布 (头部 vs 长尾) + 趋势

### 2. 数据源规划
- 什么数据填充每个页面？
- 数据是自有/采集/授权/公开？
- 如何更新？

### 3. 模板设计

**页面结构:**
- 含目标关键词的标题
- 独特介绍 (不是简单换变量)
- 数据驱动的内容板块
- 相关页面/内链
- 适合搜索意图的 CTA

**确保独特性:**
- 每页需要独特价值
- 基于数据的条件化内容
- 每页有原创洞察/分析

### 4. 内链架构

**枢纽 + 辐射模型:**
- 枢纽: 分类主页
- 辐射: 单个程序化页面
- 相关辐射之间交叉链接

**避免孤儿页:**
- 每个页面都可从主站到达
- XML 站点地图覆盖所有页面
- 面包屑导航 + 结构化数据

### 5. 索引策略
- 优先让高搜索量的模式被索引
- Noindex 非常薄弱的变体
- 合理管理爬取预算
- 按页面类型分离站点地图

---

## 质量检查清单

### 上线前

**内容质量:**
- [ ] 每页提供独特价值
- [ ] 匹配搜索意图
- [ ] 可读且有用

**技术 SEO:**
- [ ] 标题和描述唯一
- [ ] 标题结构正确
- [ ] Schema 标记已实施
- [ ] 页面速度合格

**内链:**
- [ ] 与网站架构关联
- [ ] 相关页面已链接
- [ ] 无孤儿页面

### 上线后监控

跟踪: 索引率 / 排名 / 流量 / 互动 / 转化
预警: 薄弱内容警告 / 排名下降 / 人工处罚 / 爬取错误

---

## 中国市场适配

### 百度程序化 SEO 注意事项
- 百度对 JS 渲染支持较弱，确保内容服务端渲染
- 百度站长平台主动推送 API
- MIP (百度移动页面加速) 已不推荐，使用标准响应式
- 备案号必须在每个页面展示

### 适合中国市场的策略手册
- **地区策略**: "北京/上海/深圳/广州 + [服务]" — 搜索量大
- **对比策略**: "XX vs XX" — 决策阶段流量
- **模板策略**: 合同模板/简历模板/方案模板 — 高意图
- **术语策略**: "什么是 XX" — 知乎/百度知道流量

### 常见错误
- ❌ 只换城市名，其他内容完全一样 (薄弱内容)
- ❌ 大量页面无搜索需求 (浪费爬取预算)
- ❌ 数据过时不更新 (损害可信度)
- ❌ 忽视移动端体验 (中国 80%+ 移动流量)

# SEO 审计检查清单 (Fork: coreyhaines31/marketingskills@seo-audit)

> 社区最佳实践 — 周安装 14.5K | 本地化适配版

## 审计框架 (优先级顺序)

1. **可爬取性 & 索引** — 搜索引擎能找到并收录吗？
2. **技术基础** — 网站快不快、稳不稳？
3. **页面优化** — 内容优化到位了吗？
4. **内容质量** — 内容值得排名吗？
5. **权威性 & 外链** — 有没有可信度？

---

## 技术 SEO 审计

### 可爬取性

**robots.txt**
- [ ] 未意外屏蔽重要页面
- [ ] 重要目录允许爬取
- [ ] 引用了 sitemap 地址
- [ ] 百度: 单独配置 Baiduspider 规则 (如需差异化)

**XML 站点地图**
- [ ] 存在且可访问
- [ ] 已提交到 Google Search Console + 百度搜索资源平台
- [ ] 只包含规范化的可索引 URL
- [ ] 定期更新

**网站架构**
- [ ] 重要页面 3 次点击内可达首页
- [ ] 层级结构合理
- [ ] 内链结构健康
- [ ] 无孤儿页面 (没有任何内链指向的页面)

### 索引状态

**索引检查**
- [ ] `site:域名` 查询结果数量正常
- [ ] Google Search Console 覆盖报告无异常
- [ ] 百度: `site:域名` 收录量与预期一致
- [ ] 实际索引数 ≈ 预期索引数

**常见索引问题**
- [ ] 重要页面未被 noindex
- [ ] canonical 标签指向正确
- [ ] 无重定向链/循环
- [ ] 无 Soft 404
- [ ] 重复内容已设置 canonical

### 网站速度 & Core Web Vitals

**核心指标**
- [ ] LCP (Largest Contentful Paint) < 2.5s
- [ ] INP (Interaction to Next Paint) < 200ms
- [ ] CLS (Cumulative Layout Shift) < 0.1

**速度因素**
- [ ] 服务器响应时间 (TTFB) < 600ms
- [ ] 图片已压缩 + WebP 格式
- [ ] JS 执行时间合理
- [ ] CSS 交付优化
- [ ] 缓存策略配置
- [ ] CDN 已部署 (国内: 阿里云 CDN / 腾讯云 CDN)

### 移动端适配

- [ ] 响应式设计 (非 m. 子域名)
- [ ] 点击区域尺寸 ≥ 48px
- [ ] 视口配置正确
- [ ] 无水平滚动
- [ ] 内容与桌面端一致

### HTTPS & 安全

- [ ] 全站 HTTPS
- [ ] SSL 证书有效
- [ ] 无混合内容
- [ ] HTTP → HTTPS 重定向已配置

### URL 结构

- [ ] URL 可读、有描述性
- [ ] 关键词自然出现在 URL 中
- [ ] 结构一致
- [ ] 无冗余参数
- [ ] 小写 + 连字符分隔

---

## 页面 SEO 审计

### 标题标签 (Title Tag)

- [ ] 每页标题唯一
- [ ] 核心关键词在标题前部
- [ ] 50-60 字符 (中文 25-30 字)
- [ ] 吸引点击
- [ ] 品牌名在末尾

**常见问题:** 标题重复 / 被截断 / 关键词堆砌 / 缺失

### Meta Description

- [ ] 每页描述唯一
- [ ] 150-160 字符 (中文 75-80 字)
- [ ] 包含核心关键词
- [ ] 有明确价值主张
- [ ] 有行动号召

### 标题结构 (H 标签)

- [ ] 每页只有 1 个 H1
- [ ] H1 包含核心关键词
- [ ] 层级结构合理 (H1 → H2 → H3)
- [ ] 标题描述内容实质
- [ ] 未用标题做纯样式

### 内容优化

- [ ] 关键词在前 100 字出现
- [ ] 相关关键词自然使用
- [ ] 内容深度足够覆盖主题
- [ ] 匹配搜索意图
- [ ] 比竞品内容更好

### 图片优化

- [ ] 文件名有描述性
- [ ] 所有图片有 Alt 文本
- [ ] Alt 文本描述图片内容
- [ ] 文件压缩
- [ ] 使用 WebP 格式
- [ ] 实现懒加载
- [ ] 使用响应式图片

### 内链策略

- [ ] 重要页面有充足内链
- [ ] 锚文本有描述性
- [ ] 链接关系合理
- [ ] 无死链
- [ ] 每页链接数合理

---

## 内容质量评估 (E-E-A-T)

### Experience (经验)
- [ ] 展示了第一手经验
- [ ] 有原创数据/见解
- [ ] 有真实案例

### Expertise (专业性)
- [ ] 作者资质可见
- [ ] 信息准确详实
- [ ] 引用来源可查

### Authoritativeness (权威性)
- [ ] 在领域内被认可
- [ ] 被其他网站引用
- [ ] 有行业背书

### Trustworthiness (可信度)
- [ ] 信息准确
- [ ] 业务透明
- [ ] 联系方式完整
- [ ] 隐私政策 + 服务条款
- [ ] HTTPS + ICP 备案 (中国)

---

## 中国市场特有检查项

### 百度 SEO

- [ ] 已提交百度搜索资源平台
- [ ] 百度站点验证通过
- [ ] 百度主动推送已配置
- [ ] 百度 JS 渲染适配 (百度对 JS 渲染支持较弱)
- [ ] 备案号在页面底部展示

### 微信生态 SEO

- [ ] 微信公众号文章有关键词布局
- [ ] 文章标题含搜索关键词
- [ ] 文章摘要优化
- [ ] 标签使用合理
- [ ] 与网站内容双向关联

### 小红书 SEO

- [ ] 笔记标题含核心关键词
- [ ] 话题标签 (#) 策略
- [ ] 内容类型匹配平台偏好 (图文/视频)
- [ ] 互动引导优化

---

## 审计报告输出格式

### 结构

**执行摘要**
- 整体健康度评估
- TOP 3-5 优先问题
- 快速可赢的优化点

**详细发现** (每项包含)
- **问题**: 具体是什么问题
- **影响**: SEO 影响 (高/中/低)
- **证据**: 如何发现的
- **修复**: 具体建议
- **优先级**: P1-P5

**行动计划**
1. 紧急修复 (阻碍收录/排名)
2. 高影响改进
3. 快速可赢 (简单、立即见效)
4. 长期建议

# 技术 SEO 代码参考 (Fork: addyosmani/web-quality-skills@seo)

> 社区最佳实践 — 周安装 589 | 本地化适配版

## SEO 排名因素概览

| 因素 | 影响力 | 本文覆盖 |
|------|--------|---------|
| 内容质量与相关性 | ~40% | 部分 (结构) |
| 外链与权威性 | ~25% | ✗ |
| 技术 SEO | ~15% | ✓ |
| 页面体验 (Core Web Vitals) | ~10% | 参见速度审计 |
| 页面 SEO | ~10% | ✓ |

---

## 结构化数据模板 (JSON-LD)

### 组织信息 (Organization)

```json
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "公司名称",
  "url": "https://example.com",
  "logo": "https://example.com/logo.png",
  "sameAs": [
    "https://weibo.com/example",
    "https://www.zhihu.com/org/example"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+86-400-xxx-xxxx",
    "contactType": "客服"
  }
}
```

### 文章 (Article)

```json
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "文章标题 (60字内)",
  "description": "文章描述摘要",
  "image": "https://example.com/article-image.jpg",
  "author": {
    "@type": "Person",
    "name": "作者姓名",
    "url": "https://example.com/authors/name"
  },
  "publisher": {
    "@type": "Organization",
    "name": "发布机构",
    "logo": {
      "@type": "ImageObject",
      "url": "https://example.com/logo.png"
    }
  },
  "datePublished": "2026-01-15",
  "dateModified": "2026-02-01"
}
```

### 产品 (Product)

```json
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "产品名称",
  "image": "https://example.com/product.jpg",
  "description": "产品描述",
  "brand": {
    "@type": "Brand",
    "name": "品牌名"
  },
  "offers": {
    "@type": "Offer",
    "price": "299.00",
    "priceCurrency": "CNY",
    "availability": "https://schema.org/InStock",
    "url": "https://example.com/products/xxx"
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "1250"
  }
}
```

### FAQ

```json
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "常见问题1？",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "回答内容"
      }
    },
    {
      "@type": "Question",
      "name": "常见问题2？",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "回答内容"
      }
    }
  ]
}
```

### 面包屑 (BreadcrumbList)

```json
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "首页", "item": "https://example.com"},
    {"@type": "ListItem", "position": 2, "name": "产品", "item": "https://example.com/products"},
    {"@type": "ListItem", "position": 3, "name": "产品名", "item": "https://example.com/products/xxx"}
  ]
}
```

---

## URL 规范

```
✅ 好的 URL:
  https://example.com/products/blue-widget
  https://example.com/blog/how-to-use-widgets
  https://example.com/zhaopin/frontend-engineer

❌ 差的 URL:
  https://example.com/p?id=12345
  https://example.com/products/item/category/subcategory/xxx-2024-sale-discount
```

**URL 规范:**
- 用连字符(-)，不用下划线(_)
- 全小写
- 简短 (< 75 字符)
- 自然包含目标关键词
- 避免不必要的参数
- 始终使用 HTTPS

---

## 国际化 SEO

### Hreflang 标签 (多语言站点)

```html
<link rel="alternate" hreflang="zh-CN" href="https://example.com/page">
<link rel="alternate" hreflang="zh-TW" href="https://example.com/tw/page">
<link rel="alternate" hreflang="en" href="https://example.com/en/page">
<link rel="alternate" hreflang="x-default" href="https://example.com/page">
```

### 语言声明

```html
<html lang="zh-CN">
```

---

## SEO 审计优先级清单

### 紧急 (Critical)
- [ ] HTTPS 已启用
- [ ] robots.txt 允许爬取
- [ ] 重要页面无 noindex
- [ ] 标题标签存在且唯一
- [ ] 每页单一 H1

### 高优先 (High)
- [ ] Meta Description 已配置
- [ ] 站点地图已提交
- [ ] Canonical URL 已设置
- [ ] 移动端响应式
- [ ] Core Web Vitals 合格

### 中优先 (Medium)
- [ ] 结构化数据已实施
- [ ] 内链策略合理
- [ ] 图片 Alt 文本完整
- [ ] URL 有描述性
- [ ] 面包屑导航

### 持续维护
- [ ] 修复 Search Console / 百度站长平台爬取错误
- [ ] 内容更新时同步更新站点地图
- [ ] 监控排名变化
- [ ] 检查死链
- [ ] 定期审查搜索表现数据

---

## 验证工具

| 工具 | 用途 |
|------|------|
| Google Search Console | 索引监控 + 问题修复 |
| 百度搜索资源平台 | 百度索引监控 + 主动推送 |
| Google PageSpeed Insights | 性能 + Core Web Vitals |
| Rich Results Test | 验证结构化数据 |
| Schema.org Validator | 验证 Schema 标记 |

# 关键词策略

## 关键词分类

```
核心词 (Head):     搜索量大，竞争激烈，1-2 个
  例: "跨境电商"

中尾词 (Body):     搜索量中，竞争适中，3-5 个
  例: "亚马逊选品工具" "跨境电商入门"

长尾词 (Long-tail): 搜索量小，竞争低，5-10 个
  例: "2025年亚马逊新手选品策略" "跨境电商独立站和平台哪个好"
```

## 用户意图识别

```
信息型 (I want to know):
  "什么是 SEO" "如何提高转化率"
  → 写深度文章/教程

导航型 (I want to go):
  "Amazon seller central 登录" "Shopify 后台"
  → 不适合内容创作

交易型 (I want to buy):
  "最好的选品工具" "SEO 工具推荐"
  → 写评测/对比文章

本地型 (I want nearby):
  "深圳跨境电商公司" "上海外贸培训"
  → 写本地化内容
```

## 关键词布局密度

```
安全密度: 1-2% (每 100 字出现 1-2 次核心词)
危险密度: > 3% (可能被判定关键词堆砌)

计算: 关键词出现次数 / 总词数 × 100%
```

# 页面 SEO 优化清单

## 标题优化 (Title Tag)

```
□ 包含核心关键词 (尽量在前 30 字符)
□ 长度 ≤ 60 字符 (英文) / ≤ 30 字 (中文)
□ 吸引点击 (数字/问句/利益)
□ 唯一性 (每页不同标题)
```

## 正文优化

```
□ 首段 100 字内包含核心关键词
□ H2/H3 包含长尾关键词
□ 每 300-500 字一个小标题
□ 内链 2-3 个 (链接到相关页面)
□ 外链 1-2 个 (链接到权威来源)
□ 图片有 Alt 文字 (包含关键词)
□ 段落 ≤ 5 句 (便于阅读)
```

## Meta Description

```
□ 长度: 120-155 字符 (英文) / 60-80 字 (中文)
□ 包含核心关键词
□ 包含 CTA 或价值承诺
□ 每页唯一

模板: "{核心关键词}指南。本文介绍 {价值点 1} 和 {价值点 2}，帮你 {利益}。"
```

---

# 合规检查 (Compliance Check)

约束技能。确保产出符合相关法律法规和行业标准。

**核心原则: 合规是底线，不确定时宁可保守。**

## 检查清单

```
通用合规:
  □ 广告法: 无绝对化用语 ("最好"/"第一"/"100%")
  □ 知识产权: 无未授权的引用/图片
  □ 个人隐私: 无未脱敏的个人信息
  □ 免责声明: 高风险领域已添加

行业特定:
  □ 医疗: 已添加就医建议，未做诊断
  □ 金融: 已添加投资风险提示
  □ 法律: 已标注"非法律意见"
  □ 食品: 符合食品安全法标示要求
```

## 绝对化用语清单 (中国广告法)

```
禁用: 最、第一、唯一、首选、顶级、极致、万能、100%、绝对、永久
替代: 优质、领先、出色、备受好评、高品质
```

## NEVER

- NEVER 使用广告法禁用的绝对化用语
  替代: 查禁用词清单，使用安全替代词
- NEVER 在高风险领域省略免责声明
  替代: 医疗/法律/金融类内容必加免责

# 中国广告法合规

## 绝对化用语禁用清单

```
完全禁止:
  最、最佳、最好、最优、最大、最小、最高、最低
  第一、唯一、首选、首个、独家
  顶级、极品、极致、极佳、绝对、绝佳
  万能、全能、完美、无敌
  100%、永久、终身、零风险
  国家级、世界级、全球领先 (除非有官方认定)

安全替代词:
  优质、出色、卓越、备受好评、广受认可
  领先水平、行业前列、用户推荐
  高品质、高性能、高效率
  丰富经验、深度专业
```

## 虚假宣传红线

```
禁止:
  ❌ 虚构使用效果或用户评价
  ❌ 使用未经授权的名人/机构背书
  ❌ 使用虚假统计数据
  ❌ 对商品性能做超出事实的描述
  ❌ 使用 "免费" "赠送" 但有隐含条件未说明

要求:
  ✅ 效果描述有依据 (检测报告/用户实测)
  ✅ 促销条件完整说明 (有效期/限制条件)
  ✅ 比较广告有客观依据
```

## 特殊行业附加规则

```
医疗广告:
  ❌ 不得保证治愈或暗示治愈
  ❌ 不得利用患者形象做证明
  ✅ 必须标注 "请遵医嘱"

食品广告:
  ❌ 不得宣称疾病预防/治疗功能
  ❌ 不得使用医疗术语
  ✅ 保健食品须标注 "本品不能代替药物"

金融广告:
  ❌ 不得承诺收益或暗示无风险
  ✅ 必须标注 "投资有风险"
```

# 隐私保护检查

## 个人信息脱敏规范

```
必须脱敏的信息:
  姓名     → "张某" / "用户 A"
  电话     → "138****1234"
  身份证   → "310***********1234"
  邮箱     → "zhang***@example.com"
  地址     → "上海市某区" (不到街道)
  银行卡号 → "6222 **** **** 1234"
  IP 地址  → "192.168.x.x"

无需脱敏:
  公司名 (上市公司/公开信息)
  公开的政府官员姓名 (公务行为)
  已公开的研究作者姓名
```

## 数据使用合规检查

```
使用用户数据时:
  □ 是否有用户授权/知情同意？
  □ 数据使用是否在授权范围内？
  □ 是否满足 "最小必要" 原则？
  □ 是否有数据跨境传输？(GDPR/个保法)
  □ 数据保存期限是否合理？
```

---

# 反幻觉 (Anti-Hallucination)

约束技能 (Constraint Skill)。为所有产出设置事实准确性的底线。

**核心原则: 宁可少写一个数据，不可编造一个引用。不确定就标注，不存在就不写。**

## 严格级别 (level)

| level | 适用场景 | 规则 |
|-------|---------|------|
| `standard` (默认) | 一般内容创作 | 数据需有来源，不确定标注 "建议确认" |
| `strict` | 医疗/法律/财务 | 所有事实性声明必须有 L1/L2 来源 |
| `relaxed` | 创意写作/虚构内容 | 仅对事实性声明 (非虚构部分) 适用 |

## 四层防护体系

```
Layer 1 — 数据来源标注
  ✅ 每个统计数字标注来源: "XX 市场规模达 $50B (来源: Gartner 2025)"
  ✅ 找不到来源 → 标注 "建议确认"
  ❌ NEVER 写无来源的百分比/金额/排名

Layer 2 — 引用验证
  ✅ 引用真实存在的来源
  ✅ 用 web_search 验证引用是否存在
  ❌ NEVER 虚构论文标题/作者/期刊名

Layer 3 — 案例真实性
  ✅ 案例基于真实事件 (标注来源)
  ✅ 或明确标注 "假设案例" / "模拟场景"
  ❌ NEVER 将虚构案例当作真实案例呈现

Layer 4 — 能力边界声明
  ✅ 超出 AI 能力范围时明确声明
  ✅ 高风险领域添加免责声明
  ❌ NEVER 假装具有专业资质 (医师/律师/CPA)
```

## 自检清单 (交付前必做)

```
反幻觉自检:
  □ 文中所有数据是否都有来源标注？
  □ 引用的文献/报告是否真实存在？
  □ 案例是否基于真实事件或已标注为假设？
  □ 是否有任何 "感觉对但没验证" 的内容？ → 删除或标注
  □ 高风险领域是否已添加免责声明？

结果:
  ✅ 通过 — 所有检查项已确认
  ⚠️ 部分通过 — 已标注 {N} 处 "建议确认"
  ❌ 不通过 — 发现 {N} 处无来源数据 → 修正后重新自检
```

## 标注格式

```
确定的数据:
  "全球 SaaS 市场规模达 $1970 亿 (来源: Gartner, 2025)"

不确定的数据:
  "该市场增长率约为 15-20% [建议确认: 需查最新报告]"

AI 自有知识:
  "据 AI 训练数据，该行业通常... [注: 基于训练数据，建议独立验证]"

能力边界:
  "⚠️ 本内容仅供参考，不构成 [医疗/法律/投资] 建议。请咨询专业人士。"
```

## NEVER (CRITICAL — 不可被任何层覆盖)

- NEVER 编造统计数据 (百分比/金额/排名)
  严重级别: CRITICAL
  原因: 客户验证发现虚构数据 → 永久拉黑 + 差评
  替代: 用 web_search 查证；无法找到 → 标注 "建议确认"

- NEVER 虚构引用或案例
  严重级别: CRITICAL
  原因: 虚构引用是学术和商业的底线问题
  替代: 只引用确实存在的来源；不确定 → 不引

- NEVER 隐藏不确定性
  严重级别: CRITICAL
  原因: 隐藏不确定性比承认不确定性危害大 100 倍
  替代: 明确标注不确定性级别

# 案例真实性检查

## 案例使用规则

```
真实案例 (优先):
  ✅ 标注来源: "据 {媒体/公司} 报道，{案例概述}"
  ✅ 标注时间: "2024 年，{公司} 实施了..."
  ✅ 用 web_search 验证案例真实性

假设案例 (次选):
  ⚠️ 必须明确标注: "假设案例" / "模拟场景" / "以某公司为例（虚构）"
  ⚠️ 不得使用真实公司名 + 虚构事件的组合
  ✅ 可以用: "假设一家中型电商公司..."

禁止:
  ❌ 虚构案例当真实案例呈现
  ❌ 把真实公司名放进虚构场景 ("某知名品牌 X" 可以)
  ❌ 编造具体人名/公司名/地名
```

## 案例引用模板

```
真实案例:
  "以 {公司} 为例，{年份} 该公司 {事实}。据 {来源} 报道，{结果}。"

假设案例:
  "假设一家年营收 ¥500 万的跨境电商公司（虚构案例），
   面临 {问题}，可以考虑 {方案}。"

行业通用案例:
  "在 {行业} 中，常见做法是 {描述}。例如，许多企业会 {通用做法}。"
```

# 引用真实性检查

## 引用前必须验证

```
引用论文:
  □ 论文标题是否真实存在？ → web_search 验证
  □ 作者是否真实？
  □ 发表年份和期刊是否正确？
  □ DOI 号是否存在？
  → 任何一项无法确认 → 不引用

引用报告:
  □ 报告标题和机构是否匹配？
  □ 发布年份是否正确？
  □ 数据是否在报告中确实存在？
  → 标注 "据 {机构} {年份} {报告名}"

引用法规:
  □ 法规名称是否完整准确？
  □ 条款号是否正确？
  □ 是否为最新修订版？
  → 标注 "依据《{法规名}》第 {X} 条"
```

## 常见引用幻觉模式

```
模式 1 — 虚构论文:
  ❌ "Smith et al. (2023) 发现..." 
  原因: AI 容易生成看似真实但不存在的论文
  ✅ 用 web_search 或 PubMed 验证后再引用

模式 2 — 张冠李戴:
  ❌ 把 A 机构的数据安到 B 机构头上
  ✅ 每个数据点单独验证来源

模式 3 — 过时引用:
  ❌ 引用 5 年前的数据当作最新
  ✅ 标注年份，超过 2 年的提醒可能过时

模式 4 — 断章取义:
  ❌ 原文说 "可能有效"，引用为 "已被证实有效"
  ✅ 保留原文的不确定性表述
```

# 数据真实性检查

## 数字类数据检查流程

```
遇到需要引用数字时:
  1. 先搜索: web_search("{主题} {数据类型} {年份}")
  2. 找到来源 → 标注引用
  3. 未找到 → 不写这个数字，或标注 "[建议确认]"
  4. NEVER 凭 AI 训练数据直接写数字
```

## 高风险数据类型 (必须有 L1 来源)

```
金融数据:
  ❌ "该公司市值 $500 亿"    → 必须查实时数据
  ✅ "据 Bloomberg 2025/2/8，市值约 $500 亿"

市场数据:
  ❌ "SaaS 市场增长 25%"     → 必须标注哪家机构/哪年报告
  ✅ "据 Gartner 2025 报告，SaaS 市场 YoY 增长 22%"

医疗数据:
  ❌ "该药物有效率 90%"      → 必须标注具体临床试验
  ✅ "Phase III 试验 (NCT12345678) 显示有效率 87.3%"

排名数据:
  ❌ "全球第三大..."         → 必须标注排名来源和标准
  ✅ "据 Forbes Global 2000 (2025)，按营收排名第 3"
```

## 模糊数据处理

```
当精确数据不可得时的安全表达:

  代替 "增长 25%":
    → "增长约 20-30% (来源: {报告名}, {年份})"
    → "据多家机构估计，增长率在两位数以上"

  代替 "市场规模 $100 亿":
    → "市场规模在数十亿至百亿美元级别"
    → "据 {来源}，市场规模约 $80-120 亿"

  完全无数据时:
    → "[注: 未找到权威来源的具体数据，建议查阅行业报告]"
```

---

# 质量自检 (Quality Check)

交付前的最后质量关卡。基于 ACFT 四维模型打分。

**核心原则: 宁可多花 5 分钟自检，不可交付一个有缺陷的产品。**

## ACFT 质量模型

| 维度 | 权重 | 检查内容 | 通过标准 |
|------|------|---------|---------|
| **A** Accuracy (准确性) | 35% | 数据正确、引用真实、术语准确 | ≥ 7/10 |
| **C** Completeness (完整性) | 25% | 覆盖所有需求点、无遗漏 | ≥ 7/10 |
| **F** Formatting (格式) | 25% | 排版规范、格式统一、可读性好 | ≥ 7/10 |
| **T** Timeliness (时效性) | 15% | 引用数据最新、法规未过期 | ≥ 7/10 |

## 自检流程

```
1. 对照需求清单，逐项确认覆盖 → C 维度
2. 检查所有数据/引用的来源和准确性 → A 维度
3. 检查排版/格式/标点/编号 → F 维度
4. 检查引用数据的时效性 → T 维度
5. 综合评分: 所有维度 ≥ 7/10 → ✅ 通过
6. 任何维度 < 7/10 → 修正后重新自检
```

## 输出规范

```
质量自检: ✅ 通过
  A (准确性): {score}/10
  C (完整性): {score}/10
  F (格式):   {score}/10
  T (时效性): {score}/10
  综合: {weighted_avg}/10
```

## NEVER

- NEVER 跳过自检直接交付
- NEVER 在自检分数 < 7 时仍然交付

# ACFT 质量模型详解

## A — Accuracy (准确性) 权重 35%

```
检查项:
  □ 所有数据是否有来源标注？
  □ 引用的文献/报告是否真实存在？
  □ 专业术语是否使用正确？
  □ 计算/推理过程是否有误？
  □ 翻译内容是否忠实原文？

评分标准:
  10: 所有数据有 L1 来源，零错误
  8-9: 所有数据有来源，术语准确
  7: 绝大部分数据有来源，偶有术语不精确
  5-6: 部分数据无来源，但无明显错误
  < 5: 存在错误数据或虚构引用 → 不合格
```

## C — Completeness (完整性) 权重 25%

```
检查项:
  □ 是否覆盖需求中所有要点？(逐项对照)
  □ 是否有遗漏的章节或子话题？
  □ 结论/建议是否完整？
  □ 附录/来源列表是否齐全？

评分标准:
  10: 覆盖 100% 需求点，有额外增值内容
  8-9: 覆盖 90%+ 需求点
  7: 覆盖 80%+ 需求点，遗漏非关键内容
  5-6: 覆盖 60-80%，有明显遗漏
  < 5: 遗漏关键需求点 → 不合格
```

## F — Formatting (格式) 权重 25%

```
检查项:
  □ 标题层级正确 (H1>H2>H3)？
  □ 列表/表格格式统一？
  □ 标点符号规范 (中全角/英半角)？
  □ 代码块有语言标注？
  □ 图片有 Alt 文字？
  □ 段落长度适中 (3-5 句)？

评分标准:
  10: 排版完美，可直接发布
  8-9: 格式统一，仅有细微瑕疵
  7: 整体规范，有少量格式不一致
  5-6: 格式问题较多但不影响阅读
  < 5: 格式混乱，影响可读性 → 不合格
```

## T — Timeliness (时效性) 权重 15%

```
检查项:
  □ 引用的数据是否为最新可得？
  □ 法规/政策是否为现行有效版本？
  □ 技术方案是否为当前主流？
  □ 过时内容是否已标注年份？

评分标准:
  10: 所有引用为最新 (≤ 1 年)
  8-9: 核心数据最新，非核心数据 ≤ 2 年
  7: 核心数据 ≤ 2 年，已标注年份
  5-6: 部分数据过时但已标注
  < 5: 使用过时数据且未标注 → 不合格
```

## 综合评分计算

```
综合 = A×0.35 + C×0.25 + F×0.25 + T×0.15

通过标准:
  ✅ 综合 ≥ 7.0 且 每维度 ≥ 7 → 通过
  ⚠️ 综合 ≥ 7.0 但某维度 < 7 → 修正该维度后重检
  ❌ 综合 < 7.0 → 不通过，需大幅修改
```

# 质检清单模板

## 文章/博客质检

```
□ 标题是否吸引人且准确反映内容？
□ 首段是否 hook 读者？
□ 每段首句是否为核心观点？
□ 数据/引用有来源标注？
□ 结尾有行动号召或总结？
□ 字数是否满足要求？
□ SEO 关键词是否自然融入？
```

## 数据分析报告质检

```
□ 执行摘要是否在第一页？
□ 数据来源是否明确？
□ 分析方法是否说明？
□ 每个结论有数据支撑？
□ 图表标题/坐标轴/单位是否完整？
□ 局限性是否说明？
□ 建议是否可操作？
```

## 产品 Listing 质检

```
□ 标题是否包含核心关键词？
□ 标题字符数是否在平台限制内？
□ Bullet Points 是否覆盖核心卖点？
□ 是否有竞品品牌名 (违规)？
□ 参数是否真实 (客户提供)？
□ 是否有广告法禁用词？
□ CTA 是否清晰？
```

## 医疗/法律内容质检 (加强版)

```
□ 是否包含免责声明？
□ 所有事实性声明是否有 L1/L2 来源？
□ 是否有诊断/处方/法律意见类表述？ → 必须删除
□ 是否有绝对化表述 ("保证治愈"/"一定合规")？
□ 是否引导就医/咨询专业人士？
```

---

## NEVER (角色特定)

- NEVER 编造数据（统计数字/百分比/研究结论）
  严重级别: HIGH
  原因: 客户如果验证发现虚构数据,直接永久拉黑+差评
  替代: 用 web_search 查证,无法找到则标注"建议确认" 来源: docs/skills/11-copywriter-design.md

- NEVER 虚构引用或案例
  严重级别: HIGH
  原因: 虚构引用是学术和商业的底线问题
  替代: 只引用确实存在的来源,不确定则不引 来源: docs/20-quality-assurance.md §幻觉防护

- NEVER 忽略客户指定的语气风格
  严重级别: HIGH
  原因: 客户要求活泼你写严肃=不符合需求
  替代: 从 context.md 中提取客户风格要求 来源: docs/skills/11-copywriter-design.md

---

## L5 触发测试

### 正例
```
1. "帮我写一篇关于 AI 的博客文章"
2. "写一段营销邮件文案"
3. "帮我撰写 API 技术文档"
4. "润色一下这篇文章"
5. "写一个产品介绍文案"
```

### 反例
```
1. "翻译这个文档" → 翻译专家
2. "帮我写代码" → 开发工程师
3. "分析这份数据" → 数据分析师
4. "这个项目报价多少" → CFO
5. "评估能力范围" → HR
```