geo-ai-search-optimization

Install and run a production-ready Codex skill for Generative Engine Optimization (GEO)-first, SEO-supported website optimization.

GEO 是什么

这里的 GEO 指的是 Generative Engine Optimization。 这个工具的目标不是传统 SEO 审计器，而是帮助 PM、SEO、内容和工程团队判断：网站在哪些地方会影响生成式搜索引擎理解、提取、引用和展示内容。

Install

npm install -g geo-ai-search-optimization

Or run it without a permanent install:

npx geo-ai-search-optimization

What it does

• installs the bundled GEO skills into your Codex skills directory
• ships a local resource folder with SKILL.md, references, and a scanner script
• provides a CLI for installing, locating, and scanning projects for GEO signals
• now exposes the bundled skill package directly, so agents can discover which GEO sub-skill to use next

Skills 命令

如果你想先看这个 npm 包里到底打包了哪些 skills，现在可以直接用：

geo-ai-search-optimization skills
geo-ai-search-optimization skills --json

它会列出：

• 核心 GEO skill
• usage / onboarding skill
• agent 执行闭环相关 skills
• 分享 / 导出 / 最终交付相关 skills

Agent Orchestrator 命令

如果你希望 agent 不要看长链路，而是直接拿到“现在唯一该跑哪条命令”，可以直接用 agent-orchestrator：

geo-ai-search-optimization agent-orchestrator "继续这个 GEO 任务"
geo-ai-search-optimization agent-orchestrator https://example.com
geo-ai-search-optimization agent-orchestrator ./your-site
geo-ai-search-optimization agent-orchestrator ./reports/agent-playbook-pack.json --format json --out ./reports/agent-orchestrator.json

它会输出：

• 当前阶段
• 为什么现在该做这一步
• 现在只该跑哪条命令
• 预期产物
• 什么时候先停下
• 做完之后下一条是什么
• 可直接复制给 agent 的 orchestrator prompt

Agent Resume 命令

如果 GEO 工作已经做过一轮或多轮，你不想让下一个 agent 从头重新判断，而是想让它从最近一个可靠恢复点继续，可以直接用 agent-resume：

geo-ai-search-optimization agent-resume "继续这个 GEO 任务"
geo-ai-search-optimization agent-resume https://example.com
geo-ai-search-optimization agent-resume ./your-site
geo-ai-search-optimization agent-resume ./reports/agent-playbook-pack.json --format json --out ./reports/agent-resume.json

它会输出：

• 恢复模式
• 从哪里恢复
• 现在只恢复哪一条命令
• 恢复前要先确认什么
• 恢复时不要重置什么
• 恢复后下一条是什么
• 可直接复制给 agent 的 resume prompt

Agent Continue 命令

如果你希望 agent 不只知道从哪里恢复，还要知道这一轮做完之后该更新哪些状态工件，可以直接用 agent-continue：

geo-ai-search-optimization agent-continue ./your-site
geo-ai-search-optimization agent-continue ./reports/agent-playbook-pack.json
geo-ai-search-optimization agent-continue ./reports/agent-resume.json --format json --out ./reports/agent-continue.json

它会输出：

• 这一轮怎么继续
• 现在先执行哪条命令
• 这轮的 do-now checklist
• 执行后先验证什么
• 完成后更新哪些工件
• 可以进入收尾时跑什么
• 可直接复制给 agent 的 continue prompt

Agent State Pack 命令

如果你希望下一个 agent 直接拿到一份统一的当前状态工件，而不是自己拼 agent-resume / agent-continue / agent-status-board / agent-checkpoint，可以直接用 agent-state-pack：

geo-ai-search-optimization agent-state-pack ./your-site
geo-ai-search-optimization agent-state-pack ./reports/agent-playbook-pack.json
geo-ai-search-optimization agent-state-pack ./reports/agent-continue.json --format json --out ./reports/agent-state-pack.json

它会输出：

• 当前阶段和状态等级
• 现在先执行哪条命令
• 当前包与下一包
• 执行前先确认什么
• 执行后先验证什么
• 这一轮完成后要同步哪些工件
• 可直接复制给 agent 的 state prompt

Auto Flow 命令

如果你希望 agent 不用自己判断现在该用哪个 skill、该跑哪个命令，可以直接用 auto-flow：

geo-ai-search-optimization auto-flow "我想把这份 GEO 结果交给下一个 agent 继续修"
geo-ai-search-optimization auto-flow https://example.com
geo-ai-search-optimization auto-flow ./your-site
geo-ai-search-optimization auto-flow ./reports/apply-plan.json --json

它会自动输出：

• 当前输入属于哪一类
• 现在更像诊断、执行、复盘还是交付阶段
• 最适合的下一个 skill
• 建议命令顺序
• 可直接复制给 agent 的 prompt

Agent Session 命令

如果你希望不只是“选 skill”，而是直接产出一份给 agent 跟着执行的会话包，可以用 agent-session：

geo-ai-search-optimization agent-session "我想把这份 GEO 结果交给下一个 agent 继续修"
geo-ai-search-optimization agent-session https://example.com
geo-ai-search-optimization agent-session ./your-site
geo-ai-search-optimization agent-session ./reports/apply-plan.json --json

它会输出：

• 当前阶段与会话状态
• 会话目标
• 自动选择的 skill
• 一步步该跑什么命令
• 每一步的目的与预期产物
• 可直接复制给 agent 的 session prompt

Agent Runbook 命令

如果你希望 agent 拿到的不只是会话步骤，而是一份更稳定的执行手册和检查清单，可以直接用 agent-runbook：

geo-ai-search-optimization agent-runbook "我想把这份 GEO 结果交给下一个 agent 继续修"
geo-ai-search-optimization agent-runbook https://example.com
geo-ai-search-optimization agent-runbook ./your-site
geo-ai-search-optimization agent-runbook ./reports/apply-plan.json --json

它会输出：

• 开始前检查
• 工作规则
• 需要停下来的情况
• 命令执行清单
• 重点执行包
• 验证清单
• 回报清单
• 可直接复制给 agent 的 runbook prompt

Agent Executor 命令

如果你希望 agent 不只是拿到 runbook，而是直接得到“这一轮先执行哪 1 个任务”的入口，可以直接用 agent-executor：

geo-ai-search-optimization agent-executor ./your-site
geo-ai-search-optimization agent-executor ./reports/apply-plan.json
geo-ai-search-optimization agent-executor ./reports/apply-plan.json --task fix-02 --json

它会输出：

• 当前先做哪一包
• 为什么先做这一包
• do-now checklist
• stop checklist
• success checklist
• 验证命令
• 给用户的回报模板
• 可直接复制给 agent 的 executor prompt

Agent Batch Executor 命令

如果你希望 agent 不只做 1 包，而是把前 2 到 3 包排成一个连续执行序列，同时仍然保持“一次只推进一包”，可以直接用 agent-batch-executor：

geo-ai-search-optimization agent-batch-executor ./your-site
geo-ai-search-optimization agent-batch-executor ./reports/apply-plan.json
geo-ai-search-optimization agent-batch-executor ./reports/apply-plan.json --task fix-02 --count 3 --format json --out ./reports/agent-batch-executor.json

agent-batch-executor 会输出：

• 当前批次先推进哪几包
• 为什么按这个顺序推进
• 每一包的 do-now checklist
• 每一包的 stop checklist
• 每一包的 success checklist
• 批次总验证命令
• 批次收尾命令
• 可直接复制给 agent 的 batch prompt

Agent Progress Tracker 命令

如果你希望 agent 不是只拿到执行队列，而是能够明确回答“现在做到第几包、当前卡在哪、下一包是什么”，可以直接用 agent-progress-tracker：

geo-ai-search-optimization agent-progress-tracker ./your-site
geo-ai-search-optimization agent-progress-tracker ./reports/apply-plan.json --completed fix-01,fix-02 --current fix-03
geo-ai-search-optimization agent-progress-tracker ./reports/agent-batch-executor.json --blocked "缺少仓库权限,缺少模板文件" --format json --out ./reports/agent-progress-tracker.json

agent-progress-tracker 会输出：

• 当前状态是未开始、进行中、阻塞还是已完成
• 已完成到哪几包
• 当前正在推进哪一包
• 下一包是什么
• 当前阻塞项
• 建议下一步命令
• 可直接复制给 agent 的 progress prompt

Agent Status Board 命令

如果你希望把当前执行状态直接整理成更像团队协作看板的分栏视图，而不是只看一份文字进度摘要，可以直接用 agent-status-board：

geo-ai-search-optimization agent-status-board ./your-site
geo-ai-search-optimization agent-status-board ./reports/apply-plan.json --completed fix-01 --current fix-02
geo-ai-search-optimization agent-status-board ./reports/agent-progress-tracker.json --blocked "缺少仓库权限,缺少模板文件" --format json --out ./reports/agent-status-board.json

agent-status-board 会输出：

• 已完成栏
• 进行中栏
• 阻塞栏
• 下一步栏
• 排队中栏
• 收尾栏
• 建议下一步命令
• 可直接复制给 agent 的 status board prompt

Agent Checkpoint 命令

如果你希望在每一轮执行结束时，产出一个明确的阶段决策，而不只是状态展示，可以直接用 agent-checkpoint：

geo-ai-search-optimization agent-checkpoint ./your-site
geo-ai-search-optimization agent-checkpoint ./reports/agent-status-board.json --completed fix-01 --current fix-02
geo-ai-search-optimization agent-checkpoint ./reports/agent-progress-tracker.json --blocked "缺少仓库权限" --format json --out ./reports/agent-checkpoint.json

agent-checkpoint 会输出：

• 当前检查点类型
• 当前决策是继续、解除阻塞还是进入收尾
• gate checks
• 决策清单
• 建议下一步命令
• 备选命令
• 交接说明
• 可直接复制给 agent 的 checkpoint prompt

Agent Decision Log 命令

如果你希望把每一轮 checkpoint 累积成“为什么之前这样决定”的历史，而不是只保留单轮状态，可以直接用 agent-decision-log：

geo-ai-search-optimization agent-decision-log ./your-site
geo-ai-search-optimization agent-decision-log ./reports/agent-checkpoint.json --note "本轮先解除模板缺失问题"
geo-ai-search-optimization agent-decision-log ./your-site --append-from ./reports/agent-decision-log.json --blocked "缺少模板文件" --format json --out ./reports/agent-decision-log.json

agent-decision-log 会输出：

• 当前累计决策次数
• 最新检查点类型与决策
• 当前重点与开放阻塞
• 决策时间线
• 最新建议下一步命令
• 可直接复制给 agent 的 decision log prompt

Agent Retrospective 命令

如果你希望不只是看多轮决策历史，而是直接总结“为什么这几轮顺利 / 为什么总卡住”，可以直接用 agent-retrospective：

geo-ai-search-optimization agent-retrospective ./your-site
geo-ai-search-optimization agent-retrospective ./reports/agent-decision-log.json
geo-ai-search-optimization agent-retrospective ./reports/agent-decision-log.json --format json --out ./reports/agent-retrospective.json

agent-retrospective 会输出：

• 当前复盘状态
• 重复阻塞与重复任务包
• 关键学习
• 下一轮建议
• 决策分布
• 多轮时间线
• 可直接复制给 agent 的 retrospective prompt

Agent Playbook Pack 命令

如果你希望把多轮复盘、决策历史和交接信息压成一个“下一位 agent 一拿到就能继续做”的单入口工件，可以直接用 agent-playbook-pack：

geo-ai-search-optimization agent-playbook-pack ./your-site
geo-ai-search-optimization agent-playbook-pack ./reports/agent-decision-log.json
geo-ai-search-optimization agent-playbook-pack ./reports/agent-retrospective.json --format json --out ./reports/agent-playbook-pack.json

agent-playbook-pack 会输出：

• 当前状态
• 恢复摘要
• 启动命令
• 当前包与下一包
• 先读什么
• 现在先做什么 / 现在不要做什么
• 后续命令
• 可直接复制给 agent 的 playbook prompt

Quick Start

如果你要从 0 到 1 启动一个 GEO 项目，建议照这个顺序做。

Step 1: 安装 CLI

npm install -g geo-ai-search-optimization
geo-ai-search-optimization version

Step 2: 检查环境

geo-ai-search-optimization doctor
geo-ai-search-optimization where

Step 3: 初始化基础文件

geo-ai-search-optimization init-llms ./your-site --site-name "Your Site" --site-url "https://example.com"
geo-ai-search-optimization init-schema organization ./your-site --site-url "https://example.com"
geo-ai-search-optimization init-schema faq-page ./your-site

Step 4: 快速扫描

geo-ai-search-optimization scan ./your-site
geo-ai-search-optimization scan ./your-site --json --out ./reports/geo-scan.json

Step 5: 正式审计

geo-ai-search-optimization audit ./your-site
geo-ai-search-optimization report ./your-site --mode audit --format html --out ./reports/geo-audit.html

Step 6: 按顺序修复

优先级建议：

1. robots.txt、sitemap、canonical
2. llms.txt、schema、作者信息、更新时间
3. FAQ、comparison、methodology、evidence 页面
4. 重跑 scan 和 audit 验证是否改善

CLI 内置 Quick Start

如果你想直接在终端里看这套步骤：

geo-ai-search-optimization quick-start
geo-ai-search-optimization quick-start --json
geo-ai-search-optimization quick-start --out ./reports/quick-start.md

URL Onboarding Flow

如果用户第一次进来，手上只有一个网站网址，现在可以直接用网址开局：

geo-ai-search-optimization onboard-url https://example.com
geo-ai-search-optimization onboard-url https://example.com --json --out ./reports/onboarding.json

这个 flow 会自动做这些事：

• 抓取首页 HTML
• 检查 robots.txt
• 检查 llms.txt
• 检查 sitemap.xml
• 抽取首页的 title、meta description、canonical
• 生成一个首页级别的 GEO 初步评分和下一步动作
• 输出更适合 PM 阅读的问题区域、阻塞项与下一步动作
• 输出一份 7 天行动计划

Report 命令

如果你想把分析结果直接整理成更适合阅读或交付的报告，现在可以直接使用 report：

geo-ai-search-optimization report ./your-site
geo-ai-search-optimization report ./your-site --mode audit --format html --out ./reports/geo-audit.html
geo-ai-search-optimization report https://example.com --mode onboarding --format markdown
geo-ai-search-optimization report ./your-site --mode scan --format json --out ./reports/geo-scan.json

report 支持：

• 自动识别输入是本地项目路径还是网站网址
• 输出 markdown、html、json
• 统一整理 audit、scan、onboard-url 的结果
• 中文化分析内容，更适合直接阅读、分享或存档

Agent Handoff 命令

如果你希望生成的工件可以直接交给另一个 agent 接手，而不是只给人阅读，现在可以直接用 agent-handoff：

geo-ai-search-optimization agent-handoff ./your-site
geo-ai-search-optimization agent-handoff ./your-site --format json --out ./reports/agent-handoff.json
geo-ai-search-optimization agent-handoff https://example.com

agent-handoff 会输出：

• 当前适合的接手模式：implementation-ready / advice-only / artifact-guided
• 可直接复制给 agent 的总提示词
• 每条任务对应的 handoff prompt
• 建议执行步骤
• 验收标准
• 还需要补充哪些上下文

这更适合：

• 让 agent 直接接手下一步修复
• 让 agent 先基于当前工件给出结构化建议
• 让 PM 把 GEO 问题变成交接包，而不是临时口头说明

Apply Plan 命令

如果你希望 agent 不只是“接手”，而是直接进入执行闭环，现在可以用 apply-plan：

geo-ai-search-optimization apply-plan ./your-site
geo-ai-search-optimization apply-plan ./your-site --task fix-01 --format json --out ./reports/apply-plan.json
geo-ai-search-optimization apply-plan https://example.com

apply-plan 会输出：

• 本轮应该先执行哪些任务
• 每个任务先检查什么
• 建议怎么改
• 该跑哪些验证命令
• 完成后怎么向用户回报

这适合：

• 让 agent 直接开始修复
• 让 agent 在每个任务完成后有一致的回报格式
• 把 GEO workflow 从“分析”推进到“执行 + 验证 + 回报”

Completion Report 命令

如果你希望 agent 在完成一轮修复或建议后，自动产出复盘、剩余风险和下一轮任务，现在可以用 completion-report：

geo-ai-search-optimization completion-report ./your-site
geo-ai-search-optimization completion-report ./reports/apply-plan.json --format json --out ./reports/completion-report.json
geo-ai-search-optimization completion-report https://example.com

completion-report 会输出：

• 本轮已完成什么
• 当前还剩哪些风险
• 下一轮建议先做哪些任务
• 建议复测命令
• 可直接复用的完成回报模板

Handoff Bundle 命令

如果你希望把 agent-handoff、apply-plan、completion-report 一次打成一个完整交接包，现在可以用 handoff-bundle：

geo-ai-search-optimization handoff-bundle ./your-site
geo-ai-search-optimization handoff-bundle ./your-site --task fix-01 --format json --out ./reports/handoff-bundle.json
geo-ai-search-optimization handoff-bundle https://example.com

handoff-bundle 会输出：

• 单一 bundle summary
• handoff 摘要
• apply plan 摘要
• completion report 摘要
• 下一步该先做哪一个任务

Share Pack 命令

如果你希望把同一份 GEO 结果直接分享给 PM、工程、管理层和下一位 agent，现在可以用 share-pack：

geo-ai-search-optimization share-pack ./your-site
geo-ai-search-optimization share-pack ./your-site --task fix-01 --format json --out ./reports/share-pack.json
geo-ai-search-optimization share-pack https://example.com

share-pack 会输出：

• 给 PM 的摘要
• 给工程 / 执行团队的任务视图
• 给管理层的高层摘要
• 给下一位 agent 的交接入口
• 建议分享顺序

Export Pack 命令

如果你希望直接导出一整包可外发文件，而不是自己一个个生成，现在可以用 export-pack：

geo-ai-search-optimization export-pack ./your-site --out-dir ./exports/your-site-pack
geo-ai-search-optimization export-pack ./your-site --task fix-01 --format json --out-dir ./exports/your-site-json
geo-ai-search-optimization export-pack https://example.com --out-dir ./exports/example-pack

export-pack 会生成：

• pm-brief
• owner-board
• exec-summary
• agent-handoff-bundle
• share-pack

HTML Pack 命令

如果你希望直接生成可浏览的静态 HTML 页面，而不是 Markdown 文件，现在可以用 html-pack：

geo-ai-search-optimization html-pack ./your-site --out-dir ./exports/your-site-html
geo-ai-search-optimization html-pack https://example.com --out-dir ./exports/example-html

html-pack 会生成：

• index.html
• pm.html
• engineering.html
• exec.html
• agent.html
• share.html

Publish Pack 命令

如果你希望直接生成一份“最终可交付包”，同时给人和 agent 使用，现在可以用 publish-pack：

geo-ai-search-optimization publish-pack ./your-site --out-dir ./exports/your-site-publish-pack
geo-ai-search-optimization publish-pack https://example.com --out-dir ./exports/example-publish-pack

publish-pack 会一次生成：

• site/: 可浏览的静态 HTML 页面
• documents/: 给 PM、工程、管理层直接转发的 Markdown 文档
• data/: 给 agent 或自动化流程使用的 JSON 工件
• START-HERE.md: 给人的起始说明
• AGENT-START.md: 给 agent 的执行入口
• manifest.json: 机器可读总索引

Fix Plan 命令

如果你已经跑过 audit、report 或 onboard-url，下一步就可以直接把结果转成 PM 待办清单：

geo-ai-search-optimization fix-plan ./your-site
geo-ai-search-optimization fix-plan ./your-site --format json --out ./reports/fix-plan.json
geo-ai-search-optimization fix-plan ./reports/geo-audit.json
geo-ai-search-optimization fix-plan https://example.com

fix-plan 会输出：

• priority
• owner
• problem
• action
• expected outcome
• why it matters

Owner Board 命令

如果你想直接把任务按角色分栏，变成更像团队协作看板的视图：

geo-ai-search-optimization owner-board ./your-site
geo-ai-search-optimization owner-board ./your-site --format json --out ./reports/owner-board.json
geo-ai-search-optimization owner-board https://example.com

owner-board 会自动按这些栏位分配任务：

• PM
• 工程
• SEO
• 内容

Meeting Pack 命令

如果你要直接拿一份周会同步包，现在可以用 meeting-pack：

geo-ai-search-optimization meeting-pack ./your-site
geo-ai-search-optimization meeting-pack ./your-site --format json --out ./reports/meeting-pack.json
geo-ai-search-optimization meeting-pack https://example.com

meeting-pack 会整合：

• pm-brief
• owner-board
• roadmap
• 本次会议需要确认的决策

Exec Summary 命令

如果你要一份给老板、高层或管理层看的高层摘要，现在可以用 exec-summary：

geo-ai-search-optimization exec-summary ./your-site
geo-ai-search-optimization exec-summary ./your-site --format json --out ./reports/exec-summary.json
geo-ai-search-optimization exec-summary https://example.com

exec-summary 会输出：

• 当前状态
• Headline
• Why Now
• Business Impact
• 本周关键动作
• 未来 2-4 周重点
• 需要确认的管理决策

PM Brief 命令

如果你要把结果带去开会、排优先级或分工，可以直接生成 PM 视角摘要：

geo-ai-search-optimization pm-brief ./your-site
geo-ai-search-optimization pm-brief ./your-site --format json --out ./reports/pm-brief.json
geo-ai-search-optimization pm-brief https://example.com

pm-brief 会输出：

• PM 一句话总结
• 当前最关键的风险
• 本周先做什么
• 下周再做什么
• 谁该负责
• 是否适合进入下一轮内容扩张

Roadmap 命令

如果你已经有 fix-plan 或 pm-brief，下一步可以直接生成 2 周 / 4 周路线图：

geo-ai-search-optimization roadmap ./your-site
geo-ai-search-optimization roadmap ./your-site --format json --out ./reports/roadmap.json
geo-ai-search-optimization roadmap https://example.com

roadmap 会输出：

• 第 1 周要做什么
• 第 2 周要做什么
• 第 3-4 周如何扩展
• 每个阶段的目标
• 每个阶段的完成标准

Interactive Onboarding

如果你想要更像产品的新手流程，而不是只跑一次分析，现在可以直接进入交互式 onboarding：

geo-ai-search-optimization onboard

CLI 会一步步问你：

• 网站网址
• 你的主要目标是 traffic、conversions 还是 brand-visibility
• 你现在已经有哪些资产：blog、docs、faq、schema、llms.txt

你也可以部分预填：

geo-ai-search-optimization onboard --url https://example.com
geo-ai-search-optimization onboard --url https://example.com --goal conversions
geo-ai-search-optimization onboard --url https://example.com --json --out ./reports/interactive-onboarding.json

Commands

geo-ai-search-optimization
geo-ai-search-optimization install
geo-ai-search-optimization install --target ./tmp/custom-skills --json
geo-ai-search-optimization agent-orchestrator ./your-site
geo-ai-search-optimization agent-resume ./your-site
geo-ai-search-optimization agent-continue ./your-site
geo-ai-search-optimization agent-state-pack ./your-site
geo-ai-search-optimization auto-flow "audit this site and tell me the next skill"
geo-ai-search-optimization agent-session ./your-site
geo-ai-search-optimization agent-runbook ./your-site
geo-ai-search-optimization agent-executor ./your-site
geo-ai-search-optimization agent-batch-executor ./your-site
geo-ai-search-optimization agent-progress-tracker ./your-site
geo-ai-search-optimization agent-status-board ./your-site
geo-ai-search-optimization agent-checkpoint ./your-site
geo-ai-search-optimization agent-decision-log ./your-site
geo-ai-search-optimization agent-retrospective ./your-site
geo-ai-search-optimization agent-playbook-pack ./your-site
geo-ai-search-optimization skills
geo-ai-search-optimization where
geo-ai-search-optimization doctor
geo-ai-search-optimization quick-start
geo-ai-search-optimization quick-start --out ./reports/quick-start.md
geo-ai-search-optimization onboard
geo-ai-search-optimization onboard --url https://example.com --goal traffic
geo-ai-search-optimization onboard-url https://example.com
geo-ai-search-optimization init-llms ./site --site-name "Acme Docs" --site-url "https://example.com"
geo-ai-search-optimization init-schema organization ./site --site-url "https://example.com"
geo-ai-search-optimization init-schema faq-page ./site --json
geo-ai-search-optimization audit ./my-site
geo-ai-search-optimization agent-handoff ./my-site
geo-ai-search-optimization apply-plan ./my-site
geo-ai-search-optimization completion-report ./my-site
geo-ai-search-optimization handoff-bundle ./my-site
geo-ai-search-optimization share-pack ./my-site
geo-ai-search-optimization export-pack ./my-site --out-dir ./exports/my-site-pack
geo-ai-search-optimization html-pack ./my-site --out-dir ./exports/my-site-html
geo-ai-search-optimization publish-pack ./my-site --out-dir ./exports/my-site-publish-pack
geo-ai-search-optimization exec-summary ./my-site
geo-ai-search-optimization fix-plan ./my-site
geo-ai-search-optimization owner-board ./my-site
geo-ai-search-optimization meeting-pack ./my-site
geo-ai-search-optimization pm-brief ./my-site
geo-ai-search-optimization roadmap ./my-site
geo-ai-search-optimization report ./my-site --format html --out ./reports/geo-audit.html
geo-ai-search-optimization report https://example.com --mode onboarding
geo-ai-search-optimization audit ./my-site --json --out ./reports/geo-audit.json
geo-ai-search-optimization scan ./my-site --max-file-size 500000 --max-examples 3
geo-ai-search-optimization scan ./my-site --json --out ./reports/geo-scan.json
geo-ai-search-optimization version
geo-ai-search-optimization help

New in 1.2.6

• 新增 skills 命令，直接列出整套 GEO 技能包
• 安装后会额外写入 .skill-bundle.json，方便 agent 自动发现技能
• 为缺失的 skill 补齐 agents/openai.yaml
• 主 skill 新增 skill-bundle-map 参考，usage skill 也同步纳入 publish-pack 和 skills

New in 1.2.7

• 新增 auto-flow 命令，自动选择下一步该用哪个 GEO skill
• 支持任务描述、网站网址、本地项目目录和 JSON 工件作为输入
• 输出推荐 skill、命令顺序与可直接复制给 agent 的 prompt
• 新增 geo-ai-search-optimization-auto-flow skill，作为 agent 的自动路由入口

New in 1.2.8

• 新增 agent-session 命令，生成给 agent 跟着执行的会话包
• 在 auto-flow 之上补上步骤级说明、预期产物和 session prompt
• 新增 geo-ai-search-optimization-agent-session skill
• 更适合把 GEO 任务直接交给下一个 agent 连续推进

New in 1.2.9

• 新增 agent-runbook 命令
• 把 agent-session 继续推进成给 agent 使用的执行手册和检查清单
• 输出开始前检查、工作规则、停止条件、验证清单、回报清单
• 新增 geo-ai-search-optimization-agent-runbook skill

New in 1.2.10

• 新增 agent-executor 命令
• 把 runbook 再收敛成“这一轮先做哪 1 包”的单任务入口
• 输出 do-now checklist、stop checklist、success checklist、验证命令和回报模板
• 新增 geo-ai-search-optimization-agent-executor skill

New in 1.3.0

• 正式进入 1.3 主线，把 agent-first 的执行闭环收敛成更明确的继续入口
• 新增 agent-continue
• 把 agent-resume 再推进成“继续这一轮并回写状态工件”的微闭环入口
• 输出 continue_now、validate_after、update_artifacts、closeout_when_ready、report_back
• auto-flow、agent-session 已能把 playbook-pack / agent-resume / agent-continue 统一接成继续链
• 新增 geo-ai-search-optimization-agent-continue skill

New in 1.3.1

• 新增 agent-state-pack
• 把 agent-resume + agent-continue + agent-status-board + agent-checkpoint 压成一个统一状态工件
• 输出当前阶段、当前包、现在先执行哪条命令、执行后验证项、同步状态命令和收尾路径
• auto-flow 已能识别 geo-agent-state-pack 并继续往下路由
• 新增 geo-ai-search-optimization-agent-state-pack skill

New in 1.2.20

• 新增 agent-continue
• 把 agent-resume 再推进成“继续这一轮并回写状态工件”的微闭环入口
• 输出 continue_now、validate_after、update_artifacts、closeout_when_ready、report_back
• auto-flow、agent-session 已能把 playbook-pack / agent-resume / agent-continue 统一接成继续链
• 新增 geo-ai-search-optimization-agent-continue skill

New in 1.2.19

• 新增 agent-resume
• 把 agent-orchestrator + agent-playbook-pack 收敛成“从最近一个可靠恢复点继续”的恢复入口
• 输出 resume_mode、resume_from、resume_command、verify_before_resume、do_not_reset、after_resume
• auto-flow、agent-session、skills 已经把 agent-resume 视为正式恢复链路
• 新增 geo-ai-search-optimization-agent-resume skill

New in 1.2.18

• 新增 agent-orchestrator
• 把 auto-flow + agent-session 收敛成一个“现在只该做哪条命令”的总入口
• 输出固定 contract：current_stage、why_now、next_command、expected_artifact、stop_if、after_that
• 更适合 PM 把任务直接交给 agent，或 agent 接着前一个工件继续做
• 新增 geo-ai-search-optimization-agent-orchestrator skill

New in 1.2.17

• 新增 agent-playbook-pack
• 把 agent-retrospective + agent-decision-log + handoff-bundle 压成一个单入口执行包
• 让下一位 agent 可以直接从 current packet、start command 和 do-now checklist 继续
• completion-report 现在也能直接吃 retrospective / handoff bundle / playbook pack 这类工件
• 新增 geo-ai-search-optimization-agent-playbook-pack skill

New in 1.2.16

• 新增 agent-retrospective 命令
• 把多轮 decision log 压成复盘视图，识别重复阻塞、重复任务包和反复出现的决策模式
• 支持从 agent-decision-log、agent-checkpoint、目录、网址等输入继续生成 retrospective
• 新增 geo-ai-search-optimization-agent-retrospective skill

New in 1.2.15

• 新增 agent-decision-log 命令
• 把多轮 checkpoint 沉淀成可继承的决策历史，而不是只有单轮阶段判断
• 支持从 agent-checkpoint、agent-status-board、agent-progress-tracker、目录、网址等输入继续生成或追加决策记录
• 新增 geo-ai-search-optimization-agent-decision-log skill

New in 1.2.14

• 新增 agent-checkpoint 命令
• 把每一轮执行状态压成 continue / unblock / closeout 的阶段决策工件
• 支持从 agent-progress-tracker、agent-status-board、apply-plan 等工件继续生成检查点
• 新增 geo-ai-search-optimization-agent-checkpoint skill

New in 1.2.13

• 新增 agent-status-board 命令
• 把当前执行状态整理成更像看板的分栏视图
• 支持从 apply-plan、agent-progress-tracker、agent-batch-executor 等工件继续生成状态看板
• 新增 geo-ai-search-optimization-agent-status-board skill

New in 1.2.12

• 新增 agent-progress-tracker 命令
• 可以从 apply-plan、agent-executor、agent-batch-executor 等工件推导当前执行进度
• 输出已完成任务、当前包、下一包、阻塞项和建议下一步命令
• 新增 geo-ai-search-optimization-agent-progress-tracker skill

New in 1.2.11

• 新增 agent-batch-executor 命令
• 让 agent 可以连续推进前几包任务，但仍然保持一次只执行一包
• 输出批次顺序、每包检查清单、批次总验证命令和收尾命令
• 新增 geo-ai-search-optimization-agent-batch-executor skill

New in 1.2.5

• 新增 publish-pack
• 一次生成最终可交付目录，而不是手动拼 HTML、Markdown、JSON
• 增加 START-HERE.md、AGENT-START.md、manifest.json
• 新增 geo-ai-search-optimization-publish-pack skill，帮助 agent 直接接手最终交付包

New in 1.2.4

• 新增 html-pack
• 直接生成可浏览的静态 HTML 页面目录
• 更适合直接分享链接或打包给不同角色查看
• 新增 geo-ai-search-optimization-html-pack skill，帮助消费 HTML 包

New in 1.2.3

• 新增 export-pack
• 直接生成一组可外发文件，而不是只在终端显示
• 一次导出 PM、工程、管理层、Agent 四类视图
• 新增 geo-ai-search-optimization-export-pack skill，帮助消费导出结果

New in 1.2.2

• 新增 share-pack
• 让同一份 GEO 结果按 PM、工程、管理层、Agent 四种视图分享
• 更适合直接转发，而不是人工重新整理内容
• 新增 geo-ai-search-optimization-share-pack skill，帮助消费分享包

New in 1.2.1

• 新增 handoff-bundle
• 把 agent-handoff + apply-plan + completion-report 打成一个完整交接包
• 更适合 agent 或团队直接接力，而不用自己拼多个工件
• 新增 geo-ai-search-optimization-handoff-bundle skill，帮助消费 bundle

New in 1.2.0

• 新增 completion-report
• 让 agent 在完成一轮 GEO 修复或建议后自动产出 closeout report
• 会输出本轮完成项、剩余风险、下一轮任务、复测命令和完成回报模板
• 新增 geo-ai-search-optimization-completion-report skill，帮助 agent 稳定产出复盘

New in 1.1.9

• 新增 apply-plan
• 让 agent-handoff 继续进入执行闭环，而不是停在交接阶段
• 会输出任务执行包、验证指令、Done 定义、完成回报模板
• 新增 geo-ai-search-optimization-repair-loop skill，帮助 agent 继续做修复、验证和回报

New in 1.1.8

• 新增 agent-handoff
• 让分析结果可以直接交给 agent 接手，而不只是给人阅读
• 会输出执行模式、总提示词、任务级 handoff prompt、验收标准与上下文需求
• 新增 geo-ai-search-optimization-agent-handoff skill，帮助 agent 消费这些工件并继续修复

New in 1.1.7

• 新增 exec-summary
• 会把现状、为什么现在要做、未来 2-4 周重点压缩成高层摘要
• 更适合老板、高层或管理层快速理解当前 GEO 投入的必要性

New in 1.1.6

• 新增 meeting-pack
• 会把 pm-brief + owner-board + roadmap 整合成一份周会同步包
• 更适合 PM 在周会中快速过现状、任务分工和接下来 2-4 周路线图

New in 1.1.5

• 新增 owner-board，会把任务自动按 PM / 工程 / SEO / 内容 分栏
• 安装流程现在支持一起安装多个 skill
• 新增 geo-ai-search-optimization-usage skill，agent 装好后可直接用来教用户如何使用这套工具
• 更适合把这套工具交给 agent 做 onboarding 和后续使用引导

New in 1.1.4

• 新增 roadmap 命令
• 可直接把 fix-plan 转成第 1 周 / 第 2 周 / 第 3-4 周执行路线图
• 每个阶段都带目标、完成标准和任务列表
• 更适合 PM 做排期、周会同步和跨团队推进

New in 1.1.3

• 明确统一 GEO = Generative Engine Optimization
• 新增 pm-brief，更适合 PM 开会、排期和分工
• fix-plan 增强为带 impact、effort、owner 的任务输出
• 整体输出更偏向 PM 决策与推进，而不是只停留在技术检查

New in 1.1.2

• 新增 fix-plan 命令
• 可以直接从项目目录、网站网址或已有 JSON 报告生成待办清单
• 输出 priority、owner、problem、action、expected outcome、why it matters
• 更适合 PM 直接拆成 backlog 或同步给工程、SEO、内容团队

New in 1.1.1

• 不再强调 saas / blog / docs 这类站点类型
• audit 改成按问题区域输出，更适合 PM 判断网站哪里有问题
• 报告里新增 PM 推进清单，方便直接拆成 backlog
• onboard-url 和交互式 onboard 改成问题导向
• quick-start 改成通用网站优化工作流

New in 1.1.0

• 新增 report 命令，统一生成 audit、scan、onboard-url 报告
• 支持 markdown、html、json 三种输出格式
• audit、onboard-url、scan 的分析输出改成更适合中文用户阅读的版本
• 更适合首次分析后直接导出、分享和归档

New in 1.0.9

• onboard 现在支持仅提供 --url 的非交互脚本模式
• 交互式 onboarding 的输出更适合自动化串接与落盘

New in 1.0.8

• 新增 onboard 交互式 onboarding 命令
• 输入网址后继续追问主要目标、已有资产
• 根据回答输出更个性化的 checklist 与下一步优先事项

New in 1.0.7

• onboard-url 现在支持输入网址直接开始
• onboarding 报告增加更完整的 summary
• 新增 7-day action plan，方便首次用户直接执行

New in 1.0.6

• 新增 onboard-url 命令
• 初次用户只输入网站网址，就能拿到首页级 GEO 分析
• 内建 onboarding flow：抓首页、抓 robots.txt / llms.txt / sitemap.xml、输出下一步动作

New in 1.0.5

• 新增 quick-start 命令
• 新增从 0 到 1 的详细 Quick Start 操作说明
• 增加可直接执行的启动步骤与命令示例

New in 1.0.4

• init-schema command for generating JSON-LD starter files
• supported schema templates:
  • organization
  • article
  • faq-page
  • product
  • breadcrumb-list

New in 1.0.3

• audit command with a GEO score, blockers, high-impact fixes, SEO support fixes, and experiments
• report export for audit output via --out

New in 1.0.2

• init-llms command for generating an llms.txt starter template
• keeps the 1.0.1 CLI upgrades: doctor, custom install --target, and richer scan output controls

New in 1.0.1

• doctor command for installation and environment checks
• install --target <dir> for custom skill destinations
• scan --out <file> to save reports
• scan --max-file-size and scan --max-examples for tighter project scans

Install location

By default the skill is installed to:

• macOS / Linux: ~/.codex/skills/geo-ai-search-optimization
• Windows: %USERPROFILE%\\.codex\\skills\\geo-ai-search-optimization

Override with:

• CODEX_HOME
• CODEX_SKILLS_DIR
• GEO_SKILL_INSTALL_DIR
• GEO_SKILL_SKIP_POSTINSTALL

Resource contents

The installed package now includes a bundled GEO skill pack, including:

• geo-ai-search-optimization
• geo-ai-search-optimization-auto-flow
• geo-ai-search-optimization-agent-orchestrator
• geo-ai-search-optimization-agent-resume
• geo-ai-search-optimization-agent-continue
• geo-ai-search-optimization-agent-state-pack
• geo-ai-search-optimization-agent-session
• geo-ai-search-optimization-agent-runbook
• geo-ai-search-optimization-agent-executor
• geo-ai-search-optimization-agent-batch-executor
• geo-ai-search-optimization-agent-progress-tracker
• geo-ai-search-optimization-agent-status-board
• geo-ai-search-optimization-agent-checkpoint
• geo-ai-search-optimization-agent-decision-log
• geo-ai-search-optimization-agent-retrospective
• geo-ai-search-optimization-agent-playbook-pack
• geo-ai-search-optimization-usage
• geo-ai-search-optimization-agent-handoff
• geo-ai-search-optimization-repair-loop
• geo-ai-search-optimization-completion-report
• geo-ai-search-optimization-handoff-bundle
• geo-ai-search-optimization-share-pack
• geo-ai-search-optimization-export-pack
• geo-ai-search-optimization-html-pack
• geo-ai-search-optimization-publish-pack

License

MIT