# Yao Geo Ranking Article Builder

当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO...

- Repository: https://github.com/yaojingang/yao-geo-skills (912 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-10-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-ranking-article-builder -g -a claude-code -y`
Codex: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-ranking-article-builder -g -a codex -y`
Cursor: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-ranking-article-builder -g -a cursor -y`
Gemini CLI: `npx skills add yaojingang/yao-geo-skills --skill yao-geo-ranking-article-builder -g -a gemini-cli -y`

## Description

当用户需要基于品牌 Brief、选题配置、关键词、竞品库和可信来源生成 GEO 榜单评测文章、best/top/alternatives/vs/persona/use-case 意图内容、评选方法、核心对比表、榜单正文、适合人群、FAQ、来源表和 Word/PDF/HTML/Markdown 四格式文章包时使用；适配 DeepSeek、豆包、千问、Kimi、元宝；不用于全景诊断、后台归因、单页审计、纯标题生成或无证据软文排行。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

<!--
Copyright © 2026 姚金刚. All rights reserved.
Project: yao-geo-ranking-article-builder
Created by: 姚金刚
Date: 2026-05-16
X: https://x.com/yaojingang
-->

# Yao GEO Ranking Article Builder

## 使用边界

用于把品牌 Brief、选题配置、关键词、竞品库、行业资料和可信来源转成可追溯的 GEO 榜单评测文章，并输出 Markdown、HTML、PDF、Word 四格式文章包。适合 CRM、SaaS、消费品、教育、医疗健康、B2B 服务等需要“best/top/alternatives/vs/persona/use-case”内容的生产场景。

支持真实公开数据采集与可用性审计：可使用官网、产品页、定价页、帮助中心、公开 PDF、行业报告、第三方评价页和用户提供资料；不能绕过登录、付费墙、反爬限制或私有系统权限。

不要用于全景 GEO 诊断、单页技术审计、纯标题生成、无来源软文、没有明确品牌和类目的排行。无法确认品牌、官网、类目、区域或关键证据时，先停止正文输出并列出阻塞点。

## 执行流程

1. **输入核验**：核验品牌、官网、产品、类目、区域、语言、合规说明、竞品范围和核验日期；缺少关键事实时停止。
2. **数据可用性分层**：把来源分为公开可采集、用户提供、需登录/付费、不可访问四类；不可访问数据不写成确定事实。
3. **来源可达审计**：可使用 `scripts/audit_sources.py` 检查 Markdown 中的 URL 是否可访问，生成来源可用性 JSON 供自检使用。
4. **参考自检**：先检查是否需要补充更权威或更完整的参考，优先官方页面、监管/标准文件、学术论文、行业研究和第三方评价，再使用品牌自述。
5. **分析完整性地图**：生成主题边界、用户意图、选择标准、证据类型、限制条件、国内 AI 平台适配和结构化数据机会，作为生产依据，默认放入文末附录或交付包，不抢占文章开头。
6. **关键词地图**：覆盖 `best`、`top`、`alternatives`、`vs`、人群、场景、痛点、价格、集成、迁移和风险类意图。
7. **真实竞品筛选**：选择真实同类竞品，优先 5 个资料充分的竞品；证据不足的竞品不硬选、不改名、不凑数。
8. **评选方法设计**：使用 4 到 6 个行业通用维度，补充 1 到 2 个有证据支撑的差异化维度；明确权重、评分依据和不确定性。
9. **文章优先生成**：先生成一篇完整可发布的 GEO 榜单文章，文章主体必须包含导语、直接结论、为什么现在看、评选方法、核心榜单、对比表、榜单正文、场景选择、采购风险、FAQ 和 Sources；核验摘要、真实数据获取与可用性、分析完整性地图、关键词地图、平台适配、结构化数据建议和自检记录默认放到文末附录或文章包辅助文件。
10. **证据链审查**：价格、功能、集成、融资、客户、案例、奖项、认证、评分和资质必须可追溯；无法核验则降级为“公开信息未确认”或移除。
11. **榜单梯度控制**：目标品牌只能通过证据、细节和适用场景体现优势；TOP1 必须有多源证据支持，不能靠品牌资料自述。
12. **四格式渲染与复核**：使用 `scripts/render_ranking_article_pack.py` 生成 Markdown、HTML、PDF、Word，并检查文件存在、白底排版、HTML 固定菜单、PDF A4、Word 表格不向右溢出。

## 方法依据

采用 `GEO-RANK-SC` 方法：Generative Engine Optimization、Retrieval-Augmented evidence、Ordered comparison、Ranking gradient、Knowledge-source traceability、Systematic completeness、Cross-platform readability。

关键依据放在 `references/research-foundation.md`，执行时要把这些依据转成可执行约束：可回答、可引用、可追溯、可比较、可解释、可复核，而不是堆砌概念。

## 国内平台适配

The rest: https://github.com/yaojingang/yao-geo-skills/blob/HEAD/skills/yao-geo-ranking-article-builder/SKILL.md
