siluzan-seo-cli 0.1.1-beta.3

package/dist/skill/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: seo-content-generator
+description: >-
+  工业 B2B 海外 SEO **网页结构化 JSON** 生成（非通用写稿）：按各子目录 schemas/output.json 输出
+  引流页矩阵 / Blog SEO 包 / 外链 SEO 包（TDK、模块字段、密度自检等）。
+  仅当用户明确要 SEO landing page JSON、批量引流页 schema、官网 Blog 结构化上线包、
+  guest post JSON、TDK+output.json 交付时使用；先加载 siluzan-cso 做 RAG，再 Read 本子 Skill 路由。
+  **不是** siluzan-cso 替代：口播/公众号/短视频/平台运营文案/无 schema 的普通写稿 → 只用 siluzan-cso。
+---
+
+# SEO 网页 Schema 生成（总 Skill）
+
+本套件产出的是 **符合 `schemas/output.json` 的 JSON 网页物料**（引流页 `pages[]`、Blog/外链的 TDK + 正文字段 + 审计字段），供建站/CMS 灌入——**不是** CSO 三库口播/公众号等通用写稿流程。
+
+工业 B2B 事实来源仍走 **siluzan-cso RAG**；本 Skill 只负责 **SEO 结构化 schema 生成与校验**。
+
+## 一键安装
+
+如果 CLI 尚未安装，直接帮用户执行对应平台的安装脚本：
+
+- **macOS / Linux / WSL：**
+  ```bash
+  bash <(curl -fsSL https://unpkg.com/siluzan-seo-cli@latest/dist/skill/scripts/install.sh)
+  ```
+- **Windows PowerShell：**
+  ```powershell
+  irm https://unpkg.com/siluzan-seo-cli@latest/dist/skill/scripts/install.ps1 | iex
+  ```
+
+Windows 注意：部分 Agent 客户端通过 PowerShell / cmd 代执行命令时存在兼容性问题。若上述命令异常失败，请先安装 [Git for Windows](https://git-scm.com/download/win)，然后在 Git Bash 中执行 macOS / Linux / WSL 的 Bash 安装命令。
+
+脚本会自动完成 Node.js 检测/安装、`siluzan-seo-cli` 全局安装、`siluzan-seo init --global --force` 注册 Skill。**无需 login 或 API Key**。
+
+---
+
+## CLI 命令索引
+
+| 命令 | 作用 | 详细文档 |
+|------|------|----------|
+| `siluzan-seo init` | Skill 文件初始化（写入 AI 助手目录） | [references/setup.md](references/setup.md) |
+| `siluzan-seo update` | 升级 CLI 并刷新已安装 Skill 文件 | [references/setup.md](references/setup.md) |
+| `siluzan-seo export -f <文件> -t docx\|pdf` | Markdown / 纯文本 / SEO JSON → Word 或 PDF | [references/export.md](references/export.md) |
+
+---
+
+## 与 siluzan-cso 的分工
+
+| 用户意图 | 用哪个 |
+| -------- | ------ |
+| 口播稿、公众号、Blog 成稿（无 output.json）、改稿、人设、发布 | **siluzan-cso** |
+| 批量引流页 JSON、SEO landing schema、Blog/外链 **结构化上线包**（含 TDK、seo_audit 等 schema 字段） | **本 Skill（+ siluzan-cso RAG）** |
+| 只说「写 SEO 文章 / 写 Blog」但未要 JSON schema | **siluzan-cso**；若需 schema 再追问或转本 Skill |
+
+## 子 Skill 路由
+
+根据任务类型 **必须先 Read 对应子目录的 `SKILL.md`**，再按 prompts 与 **`schemas/output.json`** 执行：
+
+| 场景 | 子目录 | 子 Skill 名 |
+|------|--------|-------------|
+| 批量引流页，N 个关键词 → N 个页面 JSON | [seo-traffic-page/SKILL.md](seo-traffic-page/SKILL.md) | `seo-traffic-page` |
+| 单篇 Blog SEO 包（E-E-A-T / HCU / 上线字段） | [blog/SKILL.md](blog/SKILL.md) | `seo-blog-article` |
+| 单篇外链 SEO 包（guest post JSON + backlink_notes） | [backlink-article/SKILL.md](backlink-article/SKILL.md) | `seo-backlink-article` |
+
+**路由规则（按优先级）：**
+
+1. 用户提供 **关键词数组** 或明确「批量引流页 / landing JSON / traffic page schema」→ `seo-traffic-page`
+2. 用户明确「外链 JSON / guest post schema / backlink output.json」→ `backlink-article`
+3. 用户提供 **title + keyword** 且要 **Blog SEO 结构化包**（含 seo_audit、publishing_recommendation 等 schema 字段）→ `blog`
+4. 仅说「写 SEO 文章 / 博客」**未**要求 JSON schema → **不要**进本 Skill；用 **siluzan-cso**
+5. 类型不明且用户确实要 schema 交付 → AskQuestion：批量页 JSON / Blog 包 / 外链包
+
+## 共用约束（三子 Skill 均适用）
+
+- **事实来源**：KB（经 siluzan-cso RAG）为唯一事实来源；KB 无依据的数据、认证、客户名不得编造
+- **主关键词密度**：1%-3%（主词及核心拓展词次数 / 英文单词总数）
+- **总关键词密度**：3%-10%（主词+辅助词+长尾及合理变体之和 / 英文单词总数）
+- **TDK**：Title 45-55 英文字符（计空格）；Keywords 3-5 个；Description 145-155 英文字符（计空格）
+- **输出**：合法 JSON，**严格符合**各子目录 `schemas/output.json`；正文纯文本，禁止 Markdown/HTML（表格等走 schema 独立字段）
+- **语言**：正文英文；Blog/外链含中文字段见各子 schema
+
+详细对比见 [README.md](README.md)。
+
+## 执行流程
+
+```
+任务 Progress:
+- [ ] 0. 确认用户要的是 JSON schema 交付（非普通写稿）；否则 siluzan-cso
+- [ ] 1. 加载 siluzan-cso，按子 skill.yaml 做 RAG（若环境支持）
+- [ ] 2. 判定子 Skill（上表）
+- [ ] 3. Read 子目录 SKILL.md + schemas/output.json
+- [ ] 4. Read 子目录 prompts/system.md、prompts/user.md
+- [ ] 5. 收集必填入参（见子 SKILL.md）
+- [ ] 6. 生成 JSON 并校验 schemas/output.json
+- [ ] 7. 输出 keyword_density_check / SEO_Check 等自检字段
+- [ ] 8. 若用户要 Word/PDF 审阅稿 → Read [references/export.md](references/export.md) 并执行 `siluzan-seo export`
+```
+
+## WorkBuddy 与 Cursor
+
+- **WorkBuddy 运行时**：各子目录 `skill.yaml` 定义模型、inputs、RAG、prompt 路径
+- **Cursor Agent**：以本文件 + 子 `SKILL.md` 为操作说明；无 RAG 时向用户索取 KB 摘要或关键产品资料
+
+## 安装
+
+手动安装与 `init` 平台列表见 [references/setup.md](references/setup.md)。一键安装见上文 **一键安装** 小节。
+
+```bash
+npm install -g siluzan-seo-cli
+siluzan-seo init          # 写入 Cursor / Claude / DeerFlow 等 AI 助手 skill 目录
+siluzan-seo update        # 升级 CLI 并刷新已安装 skill 文件
+```
+
+- **DeerFlow**：`siluzan-seo init --ai deerflow` → `skills/public/siluzan-seo/`
+- **WorkBuddy**：也可将 `seo-traffic-page/`、`blog/`、`backlink-article/` 分别作为独立 Skill 安装

package/dist/skill/_meta.json

@@ -0,0 +1,18 @@
+{
+  "slug": "siluzan-seo",
+  "version": "0.1.1-beta.3",
+  "publishedAt": 1782270828481,
+  "homepage": "https://www.siluzan.com",
+  "source": "https://dev.azure.com/jack4it/Sammamish/_git/siluzan-skill",
+  "requiredBinaries": [
+    "node",
+    "npm"
+  ],
+  "optionalBinaries": [],
+  "requiredEnv": [],
+  "optionalEnv": [],
+  "configPaths": [],
+  "companionSkills": [
+    "siluzan-cso"
+  ]
+}

package/dist/skill/backlink-article/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: seo-backlink-article
+description: >-
+  生成单篇工业 B2B **外链 SEO 结构化 JSON**（schemas/output.json）：article_content、TDK、
+  backlink_notes 等——不是第三方平台运营文案或普通 guest post 成稿。
+  仅当用户要 guest post **JSON schema / output.json 交付** 时使用；无 schema 的外链写稿 → siluzan-cso。
+  须先 siluzan-cso RAG，再 Read 本子 SKILL 与 schemas/output.json。
+---
+
+# SEO 外链 JSON Schema（非普通写稿）
+
+产出 **schemas/output.json** 定义的外链 SEO 包（含 backlink_notes 等）——不是 CSO 平台发布文案。
+
+## 何时使用
+
+- 用户明确要 **guest post JSON / 外链 schema / output.json** 交付
+- 必填：`title`、`keyword`
+- **不要**用于：只说「写外链稿 / 投稿文」且未要 JSON schema（→ siluzan-cso）
+- 单篇输出；口吻接近第三方行业内容，非厂家宣传稿
+
+## 运行时配置
+
+| 文件 | 用途 |
+|------|------|
+| [skill.yaml](skill.yaml) | WorkBuddy：模型、inputs、4 路 RAG |
+| [prompts/system.md](prompts/system.md) | 结构、密度、外链语境规则 |
+| [prompts/user.md](prompts/user.md) | 用户侧模板 |
+| [schemas/output.json](schemas/output.json) | 输出 JSON Schema |
+
+## RAG（siluzan-cso）
+
+见 `skill.yaml`：`keyword_product_context`、`company_profile`、`product_detail`、`trust_assets`。
+
+## 输出结构
+
+```json
+{
+  "article_content": "英文正文，仅三级小标题，篇幅尽量长，纯文本",
+  "meta_title": "45-55 英文字符",
+  "seo_keywords": ["3-5 个"],
+  "seo_description": "145-155 英文字符",
+  "image_alt_suggestions": ["3-5 个"],
+  "keyword_density_check": {},
+  "chinese_summary": "150-300 字",
+  "backlink_notes": "平台类型、锚文本、硬广风险控制（中文）"
+}
+```
+
+## 内容要点
+
+- 开头点明对采购决策的价值；中段技术/标准/合规/供应链判断
+- 企业名仅作可信度补充；禁止 best/number one 等无依据绝对化表述
+- 结尾以采购建议或供应商评估收束，非产品目录页
+
+## 执行清单
+
+- [ ] 确认 title、keyword
+- [ ] Read `prompts/system.md` 全文
+- [ ] RAG 检索或 KB 摘要
+- [ ] 生成 `backlink_notes`（平台、锚文本、硬广风险）
+- [ ] 校验 `schemas/output.json` 与根 [SKILL.md](../SKILL.md) 共用规则

package/dist/skill/backlink-article/prompts/system.md

@@ -0,0 +1,40 @@
+# SEO Backlink Article Generator — System Prompt
+
+你是一位拥有多年经验的 SEO 技术顾问，基于企业知识库生成专业的外链文章。
+
+## 核心原则
+
+- 知识库是唯一事实来源，严禁虚构数据、案例或认证
+- 所有内容必须结合企业产品介绍，围绕核心关键词展开
+- 所有输出严格按照 output schema 输出合法 JSON，不加任何说明文字
+
+## 输出格式要求（严格执行）
+
+- article_content 必须输出纯文本，禁止使用任何 Markdown 语法（不得出现 #、**、- 等符号）
+- 禁止输出任何 HTML 标签
+- 三级小标题单独成行，置于对应段落之前，不加任何符号前缀
+- 段落之间用空行分隔
+
+---
+
+## 文章生成规范
+
+### 标题与结构
+- 文章正文必须包含输入的文章标题
+- 每个段落前用一个三级小标题概括该段内容（单独成行，无符号）
+- 只允许三级标题，禁止使用一级或二级标题
+- 正文中至少出现一次核心关键词
+
+### 内容要求
+- 内容结合企业产品介绍，充分利用知识库中的产品信息
+- 专业但通俗，使普通用户可以理解
+- 篇幅尽量长，充分展开每个要点
+- 内容需体现产品的实用价值，满足目标用户需求
+
+### 语言要求
+- article_content：英文输出
+- chinese_summary：中文，一段话总结全文核心内容，150-300字
+
+### SEO 要求
+- seo_keywords：5个关键词，含核心词、长尾词、语义相关词
+- seo_description：约60个英文单词，含核心关键词和行动引导

package/dist/skill/backlink-article/prompts/user.md

@@ -0,0 +1,20 @@
+请根据以下信息生成一篇 SEO 外链文章：
+
+**文章标题**：{{title}}
+**核心关键词**：{{keyword}}
+
+---
+
+## 企业知识库上下文（来自 siluzan-cso RAG）
+
+{{rag_context}}
+
+---
+
+要求：
+1. 正文结合知识库中的产品信息，围绕核心关键词 {{keyword}} 展开
+2. 正文包含文章标题"{{title}}"，每段前加三级小标题（纯文本，无符号前缀）
+3. 正文中至少出现一次关键词"{{keyword}}"
+4. 篇幅尽量长，内容专业且通俗易懂
+5. 英文正文 + 中文总结段落
+6. 严格按照 output schema 输出合法 JSON

package/dist/skill/backlink-article/schemas/output.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "SEO Backlink Article Generator Output",
+  "type": "object",
+  "required": ["article_content", "seo_keywords", "seo_description", "chinese_summary"],
+  "properties": {
+    "article_content": {
+      "type": "string",
+      "description": "英文正文，纯文本，三级小标题单独成行无符号前缀，段落间空行分隔，篇幅尽量长，至少包含一次核心关键词"
+    },
+    "seo_keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 5,
+      "maxItems": 5,
+      "description": "5个SEO关键词，含核心词、长尾词、语义相关词"
+    },
+    "seo_description": {
+      "type": "string",
+      "description": "SEO 描述，约60个英文单词，含核心关键词和行动引导"
+    },
+    "chinese_summary": {
+      "type": "string",
+      "description": "中文总结，一段话概括全文核心内容，150-300字"
+    }
+  }
+}

package/dist/skill/backlink-article/skill.yaml

@@ -0,0 +1,50 @@
+name: seo-backlink-article-generator
+version: 1.0.0
+description: 基于企业知识库生成 SEO 外链文章，英文正文 + 中文总结，仅使用三级标题
+author: WorkBuddy
+
+model:
+  provider: anthropic
+  name: claude-sonnet-4-5
+  temperature: 0.7
+  max_tokens: 4096
+
+inputs:
+  - name: title
+    type: string
+    required: true
+    description: 文章标题
+  - name: keyword
+    type: string
+    required: true
+    description: 核心关键词
+
+rag:
+  provider: siluzan-cso
+  queries:
+    - id: keyword_product_context
+      template: "{{keyword}} {{title}} product features"
+      top_k: 8
+      purpose: 召回与关键词和标题相关的产品描述和案例
+    - id: company_profile
+      template: "company profile brand overview services"
+      top_k: 5
+      purpose: 召回企业档案和品牌信息
+    - id: product_detail
+      template: "{{keyword}} product specifications advantages"
+      top_k: 5
+      purpose: 召回产品技术细节和核心优势
+    - id: trust_assets
+      template: "certification award trust partnership"
+      top_k: 3
+      purpose: 召回资质荣誉，增强文章可信度
+  merge: union
+  dedup: true
+
+prompts:
+  system: prompts/system.md
+  user: prompts/user.md
+
+output:
+  schema: schemas/output.json
+  format: json

package/dist/skill/blog/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: seo-blog-article
+description: >-
+  生成单篇工业 B2B **Blog SEO 结构化 JSON**（schemas/output.json）：article_en、TDK、comparison_tables、
+  seo_audit、publishing_recommendation 等上线字段——不是普通 Blog 成稿。
+  仅当用户要官网 Blog **schema 包 / output.json 交付** 时使用；无 schema 的写 Blog → siluzan-cso。
+  须先 siluzan-cso RAG，再 Read 本子 SKILL 与 schemas/output.json。
+---
+
+# SEO Blog 结构化 JSON（非普通写稿）
+
+产出 **schemas/output.json** 定义的 Blog SEO 包（含 seo_audit、内链、对比表字段等），供 CMS/上线——不是 CSO 三库口播/公众号流程。
+
+## 何时使用
+
+- 用户明确要 **Blog SEO JSON / output.json / 上线 schema 包**（含 seo_audit、publishing_recommendation 等）
+- 必填：`title`、`keyword`
+- **不要**用于：只说「写一篇 Blog」且未要 JSON schema（→ siluzan-cso）
+- 可选：`target_market`、`brand_name`、`product_page_urls`、`existing_page_context`、`buyer_problem`、`target_long_tail_keywords`、`case_study_context`（见 `skill.yaml`）
+
+## 运行时配置
+
+| 文件 | 用途 |
+|------|------|
+| [skill.yaml](skill.yaml) | WorkBuddy：模型、inputs、4 路 RAG |
+| [prompts/system.md](prompts/system.md) | E-E-A-T、HCU、结构、密度规则 |
+| [prompts/user.md](prompts/user.md) | 用户侧模板 |
+| [schemas/output.json](schemas/output.json) | 完整输出字段定义 |
+
+## RAG（siluzan-cso）
+
+见 `skill.yaml`：`keyword_product_context`、`company_profile`、`product_detail`、`trust_assets`。
+
+## 输出结构（摘要）
+
+| 字段 | 说明 |
+|------|------|
+| `article_en` | 英文正文，仅二级小标题，5-7 段，1000-1500 词，末尾 3 个 Q&A，纯文本 |
+| `h1` / `meta_title` / `seo_description` / `seo_keywords` | 上线 TDK |
+| `comparison_tables` | 材料/牌号/标准等结构化对比（勿写入正文 Markdown） |
+| `internal_links` / `image_alt_suggestions` / `featured_snippet_opportunities` | 运营增强 |
+| `seo_audit` / `publishing_recommendation` / `publishing_checklist` | 中文审计与发布建议 |
+| `keyword_density_check` | 密度与布局自检 |
+| `chinese_summary` / `article_zh` | 中文总结与全文翻译 |
+
+## 内容要点
+
+- 行业指南口吻，非宣传册；禁止复用 About/Why Choose Us 叙事
+- 至少一个 Case Study / Application 小节；无真实数据则匿名场景
+- CTA 温和（spec review、material guidance 等），禁止强销售口吻
+- `duplicate_content_risk` 须在 `seo_audit` 中评估
+
+## 执行清单
+
+- [ ] 收集 title、keyword 及可选上下文
+- [ ] Read `prompts/system.md` 全文
+- [ ] RAG 检索或 KB 摘要
+- [ ] 生成并分离表格/内链到 schema 字段
+- [ ] 校验 `schemas/output.json` 与根 Skill 共用 TDK/密度规则

package/dist/skill/blog/prompts/system.md

@@ -0,0 +1,57 @@
+# SEO Blog Article Generator — System Prompt
+
+你是一位拥有多年经验的 SEO 技术顾问，基于企业知识库（KB）生成专业的博客文章，严格遵循 E-E-A-T 框架。
+
+## 核心原则
+
+- 知识库是唯一事实来源，内容必须结合产品介绍
+- 如果产品有具体数据参数，内容必须完全贴合 KB 中的描述；KB 中没有的数据，文章中不得出现
+- 口吻不夸大，切合实际，语言专业且通俗易懂，使普通用户可以理解
+- 语法正确，无拼写错误
+- 严格按照 output schema 输出合法 JSON，不加任何说明文字
+
+## E-E-A-T 框架（每篇必须体现）
+
+- **Experience（经验）**：包含作者或企业的实际经验，引用 KB 中真实案例场景
+- **Expertise（专业）**：展示专业知识和深入分析，使用行业术语，结合产品技术细节
+- **Authoritativeness（权威）**：引用 KB 中的资质、认证、奖项或合作伙伴作为背书
+- **Trustworthiness（可信）**：确保内容准确、透明、有实用价值，不夸大，数据有依据
+
+---
+
+## 写作规范
+
+**结构要求**
+
+- 正文包含文章标题
+- 只使用二级标题，每个段落前加一个二级小标题概括该段内容
+- 禁止使用一级、三级及其他级别标题
+- 段落数：4-6 段
+- 正文末尾附 3 个普通用户会问的问题及回答
+
+**字数与关键词**
+
+- 篇幅：800-1200 个英文单词
+- 正文中至少出现一次核心关键词
+- 关键词密度：2%-5%
+
+**格式要求（严格执行）**
+
+- article 均输出 Markdown 文本
+- 二级小标题单独成行，段落间空行分隔
+
+**内容要求**
+
+- 内容需专业，介绍通俗，使普通用户可以理解
+- 明确目标客户需求，强调产品如何为客户提供实用价值
+- 不夸大，不使用"best""number one"等无依据的绝对化表述
+
+---
+
+## 输出字段说明
+
+- **article_en**：英文正文，含文章标题、二级小标题、4-6 段正文、3 个 Q&A
+- **seo_keywords**：5 个关键词，含核心词、长尾词、语义相关词
+- **seo_description**：约 60 个英文单词，含核心关键词和行动引导
+- **chinese_summary**：中文，一段话总结全文核心内容
+- **article_zh**：将 article_en 完整翻译成中文，保持结构一致

package/dist/skill/blog/prompts/user.md

@@ -0,0 +1,21 @@
+请根据以下信息生成一篇 SEO 博客文章：
+
+**文章标题**：{{title}}
+**核心关键词**：{{keyword}}
+
+---
+
+## 企业知识库上下文（来自 siluzan-cso RAG）
+
+{{rag_context}}
+
+---
+
+要求：
+1. 内容结合知识库中的产品介绍，KB 中没有的数据参数不得出现在文章中
+2. 正文包含文章标题"{{title}}"，只使用二级小标题，段落数 4-6 段
+3. 正文中至少出现一次关键词"{{keyword}}"，关键词密度 2%-5%
+4. 篇幅 800-1200 个英文单词，语言专业通俗，不夸大
+5. 正文末尾附 3 个普通用户常问的问题及回答
+6. 输出英文正文 + 中文总结 + 完整中文翻译
+7. 严格按照 output schema 输出合法 JSON

package/dist/skill/blog/schemas/output.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "SEO Blog Article Generator Output",
+  "type": "object",
+  "required": ["article_en", "seo_keywords", "seo_description", "chinese_summary", "article_zh"],
+  "properties": {
+    "article_en": {
+      "type": "string",
+      "description": "英文正文，纯文本，包含：文章标题、4-6段正文（每段前有二级小标题单独成行）、3个Q&A，800-1200单词，关键词密度2%-5%，禁止Markdown和HTML"
+    },
+    "seo_keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "minItems": 5,
+      "maxItems": 5,
+      "description": "5个SEO关键词，含核心词、长尾词、语义相关词"
+    },
+    "seo_description": {
+      "type": "string",
+      "description": "SEO描述，约60个英文单词，含核心关键词和行动引导"
+    },
+    "chinese_summary": {
+      "type": "string",
+      "description": "中文总结，一段话概括全文核心内容"
+    },
+    "article_zh": {
+      "type": "string",
+      "description": "article_en 的完整中文翻译，保持结构一致，纯文本"
+    }
+  }
+}

package/dist/skill/blog/skill.yaml

@@ -0,0 +1,50 @@
+name: seo-blog-article-generator
+version: 1.0.0
+description: 基于企业知识库生成 SEO 博客文章，E-E-A-T 框架，英文正文 + 中文总结 + 完整中文翻译
+author: WorkBuddy
+
+model:
+  provider: anthropic
+  name: claude-sonnet-4-5
+  temperature: 0.7
+  max_tokens: 4096
+
+inputs:
+  - name: title
+    type: string
+    required: true
+    description: 文章标题
+  - name: keyword
+    type: string
+    required: true
+    description: 核心关键词
+
+rag:
+  provider: siluzan-cso
+  queries:
+    - id: keyword_product_context
+      template: "{{keyword}} {{title}}"
+      top_k: 8
+      purpose: 召回与关键词和标题相关的产品描述和案例
+    - id: company_profile
+      template: "company profile brand overview services"
+      top_k: 5
+      purpose: 召回企业档案和品牌信息
+    - id: product_detail
+      template: "{{keyword}} product specifications features advantages"
+      top_k: 5
+      purpose: 召回产品技术细节和核心优势
+    - id: trust_assets
+      template: "certification award trust partnership media"
+      top_k: 4
+      purpose: 召回资质荣誉，增强 E-E-A-T 信号
+  merge: union
+  dedup: true
+
+prompts:
+  system: prompts/system.md
+  user: prompts/user.md
+
+output:
+  schema: schemas/output.json
+  format: json

package/dist/skill/references/export.md

@@ -0,0 +1,110 @@
+# 导出 Word / PDF（`siluzan-seo export`）
+
+将 **Markdown**、**纯文本** 或 **SEO JSON 上线包** 转为 Word（`.docx`）或 PDF（`.pdf`），供客户审阅、归档或线下传阅。JSON 导出会保留 Blog 包中的元数据、正文、对比表与中文附录等结构。
+
+## 何时使用
+
+| 用户意图 | 是否用 export |
+|----------|----------------|
+| 已有 `output.json` / Blog 包 JSON，要 Word 或 PDF | ✅ |
+| 已有 `.md` 说明稿或纯文本 `.txt` | ✅ |
+| 仍在生成或修改 JSON schema | ❌ 先生成并校验 JSON，再 export |
+| 要直接灌入 CMS / 建站 | ❌ 用 JSON 原文，不经过 export |
+
+Agent：**在用户明确要求 Word/PDF/文档版** 或交付审阅稿时再执行；不要默认每篇 SEO 文章都导出。
+
+---
+
+## 命令语法
+
+```bash
+siluzan-seo export -f <输入文件> -t <格式> [-o <输出路径>]
+```
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `-f, --file` | 是 | 输入文件：`.json` / `.md` / `.markdown` / `.txt` |
+| `-t, --format` | 是 | `docx` / `word` / `doc` → Word；`pdf` → PDF |
+| `-o, --output` | 否 | 输出路径；省略时与输入同目录、同名换扩展名 |
+
+### 示例
+
+```bash
+# Blog SEO JSON → Word
+siluzan-seo export -f ./blog-output.json -t docx
+
+# 同上 → PDF，指定输出名
+siluzan-seo export -f ./blog-output.json -t pdf -o ./deliverables/article.pdf
+
+# Markdown 冒烟稿 → Word
+siluzan-seo export -f ./draft.md -t docx
+```
+
+---
+
+## 输入格式
+
+### 1. SEO JSON（Blog / 外链）
+
+**Blog**（含 `article_en`）：导出 H1、SEO Metadata、英文正文、对比表（若有）、SEO 审计块（若有）、中文总结、完整中文翻译。
+
+**外链**（含 `article_content`、无 `article_en`）：元数据 + 正文 + 中文总结。
+
+正文为 **纯文本**（与 `schemas/output.json` 一致），非 Markdown。小节标题由「短行 + 空行」启发式识别；FAQ 的 `Q:` / `A:`（及中文 `问：` / `答：`）**各占独立段落**。
+
+### 2. Markdown（`.md`）
+
+支持 `#` / `##` 标题、空行分段、`Q:` / `A:`、`问：` / `答：`。适合说明稿或已从别处转好的 MD。
+
+### 3. 纯文本（`.txt`）
+
+与 JSON 内 `article_en` 相同规则（小节标题、FAQ 分段）。
+
+---
+
+## 输出特性
+
+### Word（docx）
+
+- `title` → **Heading 1**（保留 Word 大纲与目录锚点）
+- 正文小节 → **Heading 2**
+- 章节分隔（如 English Article、中文总结）→ 带底边框的区块标题
+- Q/A 独立段落；段间距在样式层定义，避免标题与正文之间多余空行
+
+### PDF
+
+- 嵌入系统中文字体（Windows 优先黑体/雅黑；无字体时缓存下载 Noto Sans SC 至 `~/.siluzan/fonts/`）
+- 书签大纲：`title` / `section` / `heading2`
+- 命名锚点（`destination`）便于 PDF 阅读器内跳转
+
+可选环境变量：
+
+| 变量 | 说明 |
+|------|------|
+| `SILUZAN_PDF_FONT` | 指定 PDF 正文字体文件路径（`.ttf` / `.otf`） |
+| `SILUZAN_PDF_FONT_BOLD` | 粗体字体路径（默认同 regular） |
+
+---
+
+## 分页说明（JSON 导出）
+
+仅在 **JSON 完整包** 中插入分页：
+
+| 位置 | 条件 |
+|------|------|
+| 对比表前 | 存在 `comparison_tables` |
+| SEO 审计前 | 存在 `seo_audit` 等审计相关字段 |
+| 中文附录前 | 存在 `chinese_summary` 或 `article_zh`（总结与翻译在同一附录内，中间不再硬分页） |
+
+短测试 JSON 通常 1～2 页；含对比表与审计的完整 Blog 包页数更多，属预期行为。
+
+---
+
+## Agent 操作要点
+
+1. 确认 CLI 已安装：`siluzan-seo --version`（未安装见 [setup.md](setup.md) 一键安装）
+2. 确认输入 JSON 已通过 `schemas/output.json` 校验
+3. 执行 `siluzan-seo export -f ... -t docx|pdf`
+4. 将生成的文件路径回报用户；大文件可用 `present_files` 等等效工具展示
+
+**不要**用 export 替代 JSON 交付；export 是 JSON 的 **可读副本**，不是建站数据源。