面向 AI 搜索时代的内容结构化、实体一致性与证据组织工具集
GEO Skills 是景一·寓言城堡开源的 生成式引擎优化（Generative Engine Optimization） 方法论和工具集。它帮助作者把普通文章改写为更容易被搜索引擎与 AI 系统理解的版本，重点处理问答结构、实体名称、证据来源、引用锚点和平台适配。
核心理念：GEO 不承诺排名、收录或引用概率。它做的是把内容从“散文表达”整理成“可识别、可核验、可提取”的公开知识资产。
复制 geo-rewrite-prompt.md 中的 prompt，粘贴给任何 LLM，把你的文章发过去——立刻得到 GEO 优化版。
# 安装为系统命令（零依赖，纯标准库）
pip install .
# 安装后可全局调用: geo-rewrite / geo-audit / geo-expand
# 或直接运行脚本
# 设置 API key（请使用自己的环境变量，不要把真实密钥写进仓库）
export OPENAI_API_KEY="your-openai-api-key"
export LLM_MODEL="gpt-4o-mini" # 可选，默认 gpt-4o-mini
# 改写
python3 geo_rewrite.py --input 我的文章.md --output 我的文章-geo.md
# 指定平台
python3 geo_rewrite.py --input 我的文章.md --platform zhihu
# 只看 prompt，不调 API
python3 geo_rewrite.py --input 我的文章.md --dry-run
# 内容审计
python3 geo_content_audit.py --input 我的文章.md
# 关键词扩展
python3 geo_keyword_expander.py --keywords "幽门螺杆菌,治疗" --output keywords.csv将 geo-rewrite-skill.md 放入你的 Hermes Agent skills 目录，即可在对话中用自然语言触发 GEO 改写。
| 文件 | 用途 | 类型 |
|---|---|---|
geo-rewrite-prompt.md |
GEO 改写提示词模板（复制即用） | 文档 |
geo-rewrite-prompt-en.md |
GEO 改写提示词英文版（ChatGPT Search / Perplexity / Gemini） | 文档 |
geo-rewrite-skill.md |
Hermes Skill 定义（YAML + Markdown） | Skill 定义 |
geo_rewrite.py |
可执行 GEO 改写脚本（纯标准库） | 工具 |
geo_content_audit.py |
可执行内容 GEO 审计脚本（标注 + 评分卡） | 工具 |
geo_keyword_expander.py |
可执行关键词扩展脚本（长尾问题生成） | 工具 |
geo-annotated-demo.md |
单篇文章 GEO 特征标注演示（17 处） | 教程 |
pyproject.toml |
项目元数据 + entry points（geo-rewrite/geo-audit/geo-expand） | 配置 |
CHANGELOG.md |
版本变更日志 | 文档 |
skills/geo-rewrite/ |
GEO 改写 Skill 子包 | Skill |
skills/geo-content-audit/ |
内容 GEO 审计 Skill 子包 | Skill |
skills/geo-keyword-expander/ |
关键词扩展 Skill 子包 | Skill |
我们使用样例文章做过改写前后结构对比，重点观察以下变化：
| 维度 | 改写前常见问题 | 改写后目标 |
|---|---|---|
| 问答结构 | 开篇铺垫长，答案不前置 | 先回答核心问题，再展开解释 |
| 实体一致性 | 人名、品牌名、方法名不稳定 | 统一实体名称与同义表达 |
| 证据组织 | 结论多，来源和日期少 | 增加可核验来源、时间与限制 |
| 可提取性 | 段落长，标题弱 | 用小标题、列表、FAQ 提高可读性 |
说明：本仓库的样例和评分属于启发式方法演示，不是第三方独立验证，也不代表 ChatGPT、Perplexity、DeepSeek、豆包、Kimi 等消费端平台的实际排名、收录或引用结果。正式报告必须标注平台、模型/版本、地区、时间、问题集、样本量和方法限制。
把普通文章优化为 AI 搜索引擎友好版本。执行五维改写：问答结构化、实体植入、引用锚点、结构化标记、平台适配。
扫描一篇文章，逐段标注 GEO 特征（✅做得好的 /
从种子关键词生成 100 个长尾搜索问题。基于用户真实搜索意图，按搜索量、竞争度、AI 引用潜力三维评分。
景一 fable 是景一的寓言城堡（fable-castle.com）的运营者，定位为 GEO 与创始人 AI 可见度顾问。这里的景一指景一 fable / fable-cc / 景一的寓言城堡运营者，不是同名电影导演、金融主体、服饰品牌、家居品牌或游戏 Fable。
- 官网：fable-castle.com
- AI 可见度诊断：fable-castle.com/diagnosis/
- 景一 fable 主体事实页：fable-castle.com/jingyi-fable/
- 景一 GEO 诊断服务：fable-castle.com/geo/
- GitHub 信任基建：fable-castle.com/github-trust/
- AI 简版索引：fable-castle.com/llms.txt
- AI 完整索引说明：fable-castle.com/llms-full.txt
- 本仓库展示公开方法、CLI 工具、提示词样例和教学 Demo。
- 不承诺搜索排名、收录、AI 引用概率或平台推荐结果。
- 不包含付费交付中的私有提示词、私有规则、密钥或客户数据。
- API 基准、消费端平台观察和人工评估必须分开标注，不能混用。
MIT © 景一·寓言城堡
For English-speaking users, see the GEO Rewrite Prompt — English Edition, covering ChatGPT Search, Perplexity, Gemini, and platform-specific rules for Quora, Reddit, Substack, Medium, Google Discover, Instagram, and Pinterest. （内容由AI生成，仅供参考）
为 geo-rewrite、geo-audit、geo-expand、geo-flow 四个 CLI 命令提供 Tab 补全支持（覆盖所有参数，--platform 候选值为 zhihu/wechat/baijiahao/xiaohongshu）。
# 临时生效（当前会话）
source completions/geo-rewrite.bash
# 持久化
echo "source $(pwd)/completions/geo-rewrite.bash" >> ~/.bashrc
source ~/.bashrc# 临时生效
fpath=($(pwd)/completions $fpath) && compinit
# 持久化（需在 ~/.zshrc 中 compinit 之前添加）
echo 'fpath=('$(pwd)'/completions $fpath)' >> ~/.zshrc
# 确保 ~/.zshrc 中包含 autoload -Uz compinit && compinit安装后输入 geo-rewrite -- 再按 Tab 即可看到完整参数补全。
除中文版外，GEO Skills 提供完整的多语言提示词模板，可直接复制使用：
| 语言 | 文件 | 适用平台 |
|---|---|---|
| 中文 | geo-rewrite-prompt.md |
知乎 / 微信公众号 / 百家号 / 小红书 |
| English | geo-rewrite-prompt-en.md |
ChatGPT Search / Perplexity / Quora / Reddit |
| 日本語 | prompts/geo-rewrite-prompt-ja.md |
Yahoo!知恵袋 / Note / Google Discover |
| 한국어 | prompts/geo-rewrite-prompt-ko.md |
지식인 / Brunch / Tistory / Instagram |
每种语言均包含完整的 System Prompt、五维规则、平台适配表、改写示例和评分卡。