geo-ai-search-optimization 2.2.0 → 2.3.0

package/README.md

@@ -1,11 +1,11 @@
 # geo-ai-search-optimization
 
-Install and run a production-ready Codex skill for Generative Engine Optimization (GEO)-first, SEO-supported website optimization.
+The most comprehensive open-source CLI toolkit for **Generative Engine Optimization (GEO)**. Optimize your website for AI-powered search engines — ChatGPT, Perplexity, Gemini, Google AI Overviews, and Bing Copilot.
 
-## GEO 是什么
+**Zero dependencies. 43 commands. 12-dimension scoring. TypeScript support.**
 
-这里的 `GEO` 指的是 `Generative Engine Optimization`。
-这个工具的目标不是传统 SEO 审计器，而是帮助 PM、SEO、内容和工程团队判断：网站在哪些地方会影响生成式搜索引擎理解、提取、引用和展示内容。
+[![npm version](https://img.shields.io/npm/v/geo-ai-search-optimization)](https://www.npmjs.com/package/geo-ai-search-optimization)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
 ## Install
 
@@ -13,1288 +13,249 @@ Install and run a production-ready Codex skill for Generative Engine Optimizatio
 npm install -g geo-ai-search-optimization
 ```
 
-Or run it without a permanent install:
+Or run without installing:
 
 ```bash
-npx geo-ai-search-optimization
+npx geo-ai-search-optimization diagnose https://example.com
 ```
 
-## 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，现在可以直接用：
-
-```bash
-geo-ai-search-optimization skills
-geo-ai-search-optimization skills --json
-```
-
-它会列出：
-
-- 核心 GEO skill
-- usage / onboarding skill
-- agent 执行闭环相关 skills
-- 分享 / 导出 / 最终交付相关 skills
-
-## Agent Orchestrator 命令
-
-如果你希望 agent 不要看长链路，而是直接拿到“现在唯一该跑哪条命令”，可以直接用 `agent-orchestrator`：
-
-```bash
-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
-
-## Page Audit 命令
-
-如果你不想一次看整站，而是想先判断“这个单页为什么不容易被生成式搜索理解与引用”，可以直接用 `page-audit`：
-
-```bash
-geo-ai-search-optimization page-audit https://example.com/blog/geo-guide
-geo-ai-search-optimization page-audit ./content/posts/geo-guide.mdx
-geo-ai-search-optimization page-audit ./content/posts/geo-guide.mdx --json --out ./reports/page-audit.json
-```
-
-它会输出：
-
-- 单页 GEO 分数
-- 页面级问题区域
-- 推荐新增模块
-- rewrite brief
-- 可直接交给 agent 的 page-level prompt
-
-## Rewrite Pack 命令
-
-如果你已经知道某个页面有问题，想直接拿到更接近“改写方案”的产物，可以用 `rewrite-pack`：
-
-```bash
-geo-ai-search-optimization rewrite-pack https://example.com/blog/geo-guide
-geo-ai-search-optimization rewrite-pack ./content/posts/geo-guide.mdx
-geo-ai-search-optimization rewrite-pack ./content/posts/geo-guide.mdx --json --out ./reports/rewrite-pack.json
-```
-
-它会输出：
-
-- metadata drafts
-- 建议章节结构
-- FAQ questions
-- schema recommendations
-- execution checklist
-- 可直接交给 agent 的 rewrite prompt
-
-## Repo Patch Plan 命令
-
-如果你希望从“页面建议”继续推进到“仓库里先改哪些文件和模板”，可以直接用 `repo-patch-plan`：
-
-```bash
-geo-ai-search-optimization repo-patch-plan ./your-site
-geo-ai-search-optimization repo-patch-plan ./your-site --json --out ./reports/repo-patch-plan.json
-```
-
-它会输出：
-
-- 候选文件区域
-- patch packets
-- likely files
-- execution notes
-- 可直接交给 agent 的 repo-level prompt
-
-## Agent Resume 命令
-
-如果 GEO 工作已经做过一轮或多轮，你不想让下一个 agent 从头重新判断，而是想让它从最近一个可靠恢复点继续，可以直接用 `agent-resume`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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`：
-
-```bash
-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
-
-```bash
-npm install -g geo-ai-search-optimization
-geo-ai-search-optimization version
-```
-
-### Step 2: 检查环境
-
-```bash
-geo-ai-search-optimization doctor
-geo-ai-search-optimization where
-```
-
-### Step 3: 初始化基础文件
-
-```bash
-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: 快速扫描
-
-```bash
-geo-ai-search-optimization scan ./your-site
-geo-ai-search-optimization scan ./your-site --json --out ./reports/geo-scan.json
-```
-
-### Step 5: 正式审计
-
-```bash
-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
-
-如果你想直接在终端里看这套步骤：
-
-```bash
-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
-
-如果用户第一次进来，手上只有一个网站网址，现在可以直接用网址开局：
-
-```bash
-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`：
-
 ```bash
-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
-```
+# Smart diagnosis — auto-detects URL, directory, or file
+geo-ai-search-optimization diagnose https://example.com
 
-`report` 支持：
+# Full 12-dimension page audit
+geo-ai-search-optimization full-page-audit https://example.com/blog/post
 
-- 自动识别输入是本地项目路径还是网站网址
-- 输出 `markdown`、`html`、`json`
-- 统一整理 `audit`、`scan`、`onboard-url` 的结果
-- 中文化分析内容，更适合直接阅读、分享或存档
+# Generate ready-to-use fix code
+geo-ai-search-optimization auto-fix https://example.com/blog/post
 
-## Agent Handoff 命令
+# Compare two pages
+geo-ai-search-optimization compare https://yoursite.com https://competitor.com
 
-如果你希望生成的工件可以直接交给另一个 agent 接手，而不是只给人阅读，现在可以直接用 `agent-handoff`：
+# Project-level audit
+geo-ai-search-optimization full-audit ./your-project
 
-```bash
-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
+# CI/CD gate
+geo-ai-search-optimization ci ./your-project --min-score 60 --fail-on-regression
 ```
 
-`agent-handoff` 会输出：
+## What It Does
 
-- 当前适合的接手模式：`implementation-ready` / `advice-only` / `artifact-guided`
-- 可直接复制给 agent 的总提示词
-- 每条任务对应的 handoff prompt
-- 建议执行步骤
-- 验收标准
-- 还需要补充哪些上下文
+GEO is **Generative Engine Optimization** — the practice of making your content understandable, extractable, and citable by AI search engines.
 
-这更适合：
+This tool analyzes your pages across **12 dimensions** and tells you exactly what to fix:
 
-- 让 agent 直接接手下一步修复
-- 让 agent 先基于当前工件给出结构化建议
-- 让 PM 把 GEO 问题变成交接包，而不是临时口头说明
+| Dimension | What It Checks |
+|-----------|---------------|
+| **Base Audit** | Title, meta description, canonical, JSON-LD, author signals, Q&A headings |
+| **Citability** | Claim density, entity density, quotable sentences, content structure |
+| **E-E-A-T** | Experience, Expertise, Authoritativeness, Trustworthiness signals |
+| **Readability** | Flesch-Kincaid grade, sentence length, passive voice, reading time |
+| **Heading Structure** | H1-H6 hierarchy, semantic coverage, question headings |
+| **Internal Links** | Link count, anchor text quality, path depth |
+| **Social Meta** | Open Graph (10 tags), Twitter Card (7 tags) |
+| **Platform Readiness** | ChatGPT, Perplexity, Gemini, Google AI Overviews, Bing Copilot |
+| **Schema Validation** | JSON-LD correctness, required fields, AI discoverability enhancements |
+| **Content Freshness** | Date extraction (9 patterns), content age, staleness detection |
+| **Security** | HTTPS, security headers, viewport, robots meta, mixed content |
+| **Topic Coverage** | TF-IDF keywords, bigrams, topic clusters |
 
-## Apply Plan 命令
+## Commands
 
-如果你希望 agent 不只是“接手”，而是直接进入执行闭环，现在可以用 `apply-plan`：
+### Smart Entry Points
 
 ```bash
-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
+diagnose <url|dir|file>              # Auto-detect input, run right analysis
+compare <page-A> <page-B>           # 12-dimension side-by-side comparison
+auto-fix <url|file>                  # Generate fix code (meta, JSON-LD, robots.txt, llms.txt)
 ```
 
-`apply-plan` 会输出：
-
-- 本轮应该先执行哪些任务
-- 每个任务先检查什么
-- 建议怎么改
-- 该跑哪些验证命令
-- 完成后怎么向用户回报
-
-这适合：
-
-- 让 agent 直接开始修复
-- 让 agent 在每个任务完成后有一致的回报格式
-- 把 GEO workflow 从“分析”推进到“执行 + 验证 + 回报”
-
-## Completion Report 命令
-
-如果你希望 agent 在完成一轮修复或建议后，自动产出复盘、剩余风险和下一轮任务，现在可以用 `completion-report`：
+### Page-Level Analysis
 
 ```bash
-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
+page-audit <url|file>               # Basic GEO page audit
+full-page-audit <url|file>          # Full 12-dimension audit (with --save for snapshots)
+batch-page-audit <urls...>          # Batch basic audits
+batch-full-page-audit <urls...>     # Batch 12-dimension audits
 ```
 
-`completion-report` 会输出：
-
-- 本轮已完成什么
-- 当前还剩哪些风险
-- 下一轮建议先做哪些任务
-- 建议复测命令
-- 可直接复用的完成回报模板
-
-## Handoff Bundle 命令
-
-如果你希望把 `agent-handoff`、`apply-plan`、`completion-report` 一次打成一个完整交接包，现在可以用 `handoff-bundle`：
+### Project-Level Analysis
 
 ```bash
-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
+scan <dir>                           # Signal scanning
+audit <dir>                          # Project audit with scoring
+full-audit <dir>                     # Project + infra + optional page sampling
 ```
 
-`handoff-bundle` 会输出：
-
-- 单一 bundle summary
-- handoff 摘要
-- apply plan 摘要
-- completion report 摘要
-- 下一步该先做哪一个任务
-
-## Share Pack 命令
-
-如果你希望把同一份 GEO 结果直接分享给 PM、工程、管理层和下一位 agent，现在可以用 `share-pack`：
+### Specialized Analysis (14 commands)
 
 ```bash
-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
+crawlers <url|file>                  # AI crawler access (GPTBot, ClaudeBot, etc.)
+citability <url|file>                # Static citability scoring
+eeat <url|file>                      # E-E-A-T signal analysis
+readability <url|file>               # Flesch-Kincaid, reading ease
+heading-structure <url|file>         # H1-H6 hierarchy analysis
+internal-links <url|file>            # Link analysis
+social-meta <url|file>               # OG + Twitter tags
+platform-ready <url|file>            # Multi-platform readiness
+validate-schema <url|file>           # JSON-LD validation
+validate-llms <url|file>             # llms.txt validation
+sitemap <url|file>                   # XML sitemap analysis
+security <url|file>                  # Security headers + checks
+freshness <url|file>                 # Content age analysis
+topics <url|file>                    # Keyword + topic extraction
 ```
 
-`share-pack` 会输出：
-
-- 给 PM 的摘要
-- 给工程 / 执行团队的任务视图
-- 给管理层的高层摘要
-- 给下一位 agent 的交接入口
-- 建议分享顺序
-
-## Export Pack 命令
-
-如果你希望直接导出一整包可外发文件，而不是自己一个个生成，现在可以用 `export-pack`：
+### Competitive Analysis
 
 ```bash
-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
+benchmark <url> --competitors <urls> # Signal matrix comparison
+content-gap <url> --competitors <urls> # Gap analysis
 ```
 
-`export-pack` 会生成：
-
-- `pm-brief`
-- `owner-board`
-- `exec-summary`
-- `agent-handoff-bundle`
-- `share-pack`
-
-## HTML Pack 命令
-
-如果你希望直接生成可浏览的静态 HTML 页面，而不是 Markdown 文件，现在可以用 `html-pack`：
+### Tracking & CI
 
 ```bash
-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
+full-page-audit <url> --save         # Save page snapshot
+page-trend <url>                     # View page score history
+trend                                # View project score trend
+snapshot                             # Manage audit snapshots
+ci <dir> --min-score 60              # CI/CD gate
+watch <dir>                          # Auto-audit on file changes
+init-hook                            # Git pre-commit hook
 ```
 
-`html-pack` 会生成：
-
-- `index.html`
-- `pm.html`
-- `engineering.html`
-- `exec.html`
-- `agent.html`
-- `share.html`
-
-## Publish Pack 命令
-
-如果你希望直接生成一份“最终可交付包”，同时给人和 agent 使用，现在可以用 `publish-pack`：
+### Citation Tracking
 
 ```bash
-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
+citation-check <url> --queries <q1,q2>  # Check if cited in AI search
+citation-monitor <url> --queries-file <file>  # Monitor citation rate
 ```
 
-`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 待办清单：
+### Code Generation & Init
 
 ```bash
-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
+auto-fix <url|file>                  # Generate meta tags, JSON-LD, robots.txt, llms.txt
+init-llms [dir]                      # Generate llms.txt template
+init-schema <type> [dir]             # Generate JSON-LD template
+init-config [dir]                    # Generate .georc.json
+init-hook [dir]                      # Generate pre-commit hook
 ```
 
-`fix-plan` 会输出：
-
-- priority
-- owner
-- problem
-- action
-- expected outcome
-- why it matters
-
-## Owner Board 命令
-
-如果你想直接把任务按角色分栏，变成更像团队协作看板的视图：
+### Reports & Export
 
 ```bash
-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
+report <input>                       # Unified report (markdown/html/json)
+pdf-report <audit.json>              # PDF-ready HTML report
+html-pack <input> --out-dir <dir>    # Static HTML pages
+export-pack <input> --out-dir <dir>  # Multi-format export
+publish-pack <input> --out-dir <dir> # Full deliverable package
 ```
 
-`owner-board` 会自动按这些栏位分配任务：
-
-- PM
-- 工程
-- SEO
-- 内容
-
-## Meeting Pack 命令
-
-如果你要直接拿一份周会同步包，现在可以用 `meeting-pack`：
+## Programmatic API
 
-```bash
-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` 会整合：
+```javascript
+import {
+  diagnose,
+  fullPageAudit,
+  comparePages,
+  generateAutoFix,
+  analyzeCrawlers,
+  analyzeCitability,
+  analyzeEeat,
+  analyzeReadability
+} from 'geo-ai-search-optimization';
 
-- pm-brief
-- owner-board
-- roadmap
-- 本次会议需要确认的决策
+// Smart diagnosis
+const result = await diagnose('https://example.com');
+console.log(result.score, result.quickWins);
 
-## Exec Summary 命令
+// Full 12-dimension audit
+const audit = await fullPageAudit('https://example.com/blog/post');
+console.log(audit.compositeScore, audit.dimensions);
 
-如果你要一份给老板、高层或管理层看的高层摘要，现在可以用 `exec-summary`：
+// Compare two pages
+const comparison = await comparePages(
+  'https://yoursite.com',
+  'https://competitor.com'
+);
+console.log(comparison.overallWinner, comparison.dimensionWins);
 
-```bash
-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
+// Generate fix code
+const fixes = await generateAutoFix('https://example.com');
+console.log(fixes.jsonLdSchemas, fixes.metaTags);
 ```
 
-`exec-summary` 会输出：
-
-- 当前状态
-- Headline
-- Why Now
-- Business Impact
-- 本周关键动作
-- 未来 2-4 周重点
-- 需要确认的管理决策
-
-## PM Brief 命令
+Full TypeScript declarations included (`index.d.ts`) — 230+ exports with IDE autocomplete.
 
-如果你要把结果带去开会、排优先级或分工，可以直接生成 PM 视角摘要：
+## GitHub Action
 
-```bash
-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
+```yaml
+- uses: redredchen01/geo-ai-search-optimization@v2.2.0
+  with:
+    project-path: ./your-project
+    min-score: 60
+    fail-on-regression: true
+    save-snapshot: true
 ```
 
-`pm-brief` 会输出：
-
-- PM 一句话总结
-- 当前最关键的风险
-- 本周先做什么
-- 下周再做什么
-- 谁该负责
-- 是否适合进入下一轮内容扩张
-
-## Roadmap 命令
+## Configuration
 
-如果你已经有 `fix-plan` 或 `pm-brief`，下一步可以直接生成 2 周 / 4 周路线图：
+Create `.georc.json` in your project root:
 
 ```bash
-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
+geo-ai-search-optimization init-config --site-name "My Site" --site-url "https://example.com"
 ```
 
-`roadmap` 会输出：
-
-- 第 1 周要做什么
-- 第 2 周要做什么
-- 第 3-4 周如何扩展
-- 每个阶段的目标
-- 每个阶段的完成标准
-
-## Interactive Onboarding
-
-如果你想要更像产品的新手流程，而不是只跑一次分析，现在可以直接进入交互式 onboarding：
-
-```bash
-geo-ai-search-optimization onboard
+```json
+{
+  "site": { "name": "My Site", "url": "https://example.com" },
+  "audit": { "minScore": 40, "maxFileSize": 1000000 },
+  "ci": { "minScore": 60, "failOnRegression": false },
+  "crawlers": { "strategy": "open" },
+  "plugins": []
+}
 ```
 
-CLI 会一步步问你：
+## Plugin System
 
-- 网站网址
-- 你的主要目标是 `traffic`、`conversions` 还是 `brand-visibility`
-- 你现在已经有哪些资产：`blog`、`docs`、`faq`、`schema`、`llms.txt`
+Extend with custom signals, checks, and commands:
 
-你也可以部分预填：
-
-```bash
-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
+```javascript
+// my-plugin.js
+export function register(api) {
+  api.addSignal('custom-signal', {
+    pattern: /my-custom-pattern/i,
+    label: 'Custom Signal',
+    weight: 5
+  });
+}
 ```
 
-## Commands
-
-```bash
-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.3.2
-
-- 进行了 CLI 架构迭代，把 flow/routing 相关命令从主 `cli.js` 拆到独立模块
-- 新增 `src/cli-flow-commands.js`，让 `auto-flow / agent-orchestrator / agent-resume / agent-continue / agent-state-pack / agent-session` 形成一个明确的 adapter 边界
-- 新增 `src/cli-shared.js`，集中处理 flag 解析、输入校验和输出写回，降低后续继续加命令时的耦合
-- 主 `cli.js` 现在更像薄路由层，后续扩充 command family 会更稳
-
-## New in 1.3.3
-
-- 继续做 CLI 架构迭代，把 agent execution family 也从主 `cli.js` 拆出
-- 新增 `src/cli-agent-execution-commands.js`，接管 `agent-runbook / agent-executor / agent-batch-executor / agent-progress-tracker / agent-status-board / agent-checkpoint / agent-decision-log / agent-retrospective / agent-playbook-pack`
-- 主 `cli.js` 进一步收敛成更薄的 command router
-- 现在 flow family 和 execution family 都有独立 adapter 模块，后续继续拆 planning / delivery 会更顺
-
-## New in 1.3.4
-
-- 继续做 CLI 架构迭代，把 planning / reporting / delivery family 也从主 `cli.js` 拆出
-- 新增 `src/cli-planning-delivery-commands.js`，接管 `agent-handoff / apply-plan / completion-report / handoff-bundle / share-pack / export-pack / html-pack / publish-pack / exec-summary / fix-plan / owner-board / meeting-pack / pm-brief / roadmap / report`
-- 主 `cli.js` 现在更接近纯路由层
-- CLI 已经形成 `flow / execution / planning-delivery / shared` 四层 command adapter 结构
-
-## New in 1.3.5
-
-- 继续做 CLI 架构迭代，把 onboarding / audit / scan / doctor / init family 也从主 `cli.js` 拆出
-- 新增 `src/cli-site-ops-commands.js`，接管 `doctor / quick-start / onboard / onboard-url / init-llms / init-schema / audit / scan`
-- 主 `cli.js` 现在只保留 install / skills / where / version / help 与 command routing
-- CLI 已经形成 `flow / execution / planning-delivery / site-ops / shared` 五层 command adapter 结构
-
-## New in 1.3.6
-
-- 继续做 CLI 架构迭代，把 shell family 也从主 `cli.js` 拆出
-- 新增 `src/cli-shell-commands.js`，接管 `install / skills / where`
-- 主 `cli.js` 现在只保留 `version / help / command routing`
-- CLI 已经形成 `shell / flow / execution / planning-delivery / site-ops / shared` 六层 command adapter 结构
-
-## New in 1.3.7
-
-- 开始把重复的 artifact 编排从 adapter 中抽成共享组合器
-- `src/cli-shared.js` 新增 `createArtifactCommandHandler` 和 `createPackCommandHandler`
-- `src/cli-agent-execution-commands.js` 与 `src/cli-planning-delivery-commands.js` 现在改用声明式组合，减少重复的 `create / render / write` handler 模板代码
-- CLI 架构从“按命令族拆文件”进一步推进到“adapter + shared composition”模式
-
-## New in 1.3.8
-
-- 继续把共享组合器推广到 `flow` 与 `site-ops` 两层
-- `src/cli-shared.js` 新增 `createStructuredOutputCommandHandler`
-- `src/cli-flow-commands.js` 现在统一通过组合器编排 `auto-flow / agent-orchestrator / agent-resume / agent-continue / agent-state-pack / agent-session`
-- `src/cli-site-ops-commands.js` 现在统一通过组合器编排 `doctor / quick-start / onboard / onboard-url / audit / scan`
-- CLI 架构进一步收敛到“命令族 adapter + shared composition primitives”的模式
-
-## New in 1.3.9
-
-- 继续把“直接执行型命令”也纳入共享组合模式
-- `src/cli-shared.js` 新增 `createActionCommandHandler`
-- `src/cli-shell-commands.js` 里的 `install` 已改成声明式 action 组合
-- `src/cli-site-ops-commands.js` 里的 `init-llms / init-schema` 已改成声明式 action 组合
-- CLI 现在同时覆盖 artifact、structured-output、action 三类共享 composition primitives
-
-## New in 1.3.10
-
-- 开始把重复的命令参数组装抽成共享 option builders
-- `src/cli-shared.js` 新增 `buildIntentFormatOptions / buildTaskFormatOptions / buildProgressFormatOptions` 等 builder
-- `src/cli-agent-execution-commands.js`、`src/cli-flow-commands.js`、`src/cli-planning-delivery-commands.js` 现在统一复用这些 builder
-- CLI 架构进一步接近“adapter registry + shared option builders + shared composition primitives”的模式
-
-## New in 1.3.11
-
-- 继续收敛原本仍较特殊的命令编排
-- `src/cli-shared.js` 新增 `buildTaskOutputDirOptions / buildTaskFormatOutputDirOptions / createContentCommandHandler`
-- `src/cli-planning-delivery-commands.js` 中的 `report` 已改成统一 content handler
-- `export-pack / html-pack / publish-pack` 也开始复用共享 output-dir / task builder
-- CLI 更接近统一的 command registry，而不是混合少数特例 handler
-
-## New in 1.3.12
-
-- 开始把命令说明与 handler 收敛成同源 registry metadata
-- `src/cli-shared.js` 新增 `buildCommandRegistry`
-- `src/cli-shell-commands.js` 与 `src/cli-flow-commands.js` 现在由同一份声明同时生成 help lines 和 handlers
-- CLI 开始从“多个 handler 文件”进一步推进到“显式 command registry”模式
-
-## New in 1.3.13
-
-- 把 registry metadata 推广到 `agent-execution` 命令族
-- `src/cli-agent-execution-commands.js` 现在由同一份 registry 同时生成 help lines 和 handlers
-- `agent-runbook / agent-executor / agent-batch-executor / agent-progress-tracker / agent-status-board / agent-checkpoint / agent-decision-log / agent-retrospective / agent-playbook-pack` 已统一进入 registry
-- CLI 距离“所有命令族都使用显式 registry metadata”又更近一步
-
-## New in 1.3.14
-
-- 把 registry metadata 推广到 `planning-delivery` 命令族
-- `src/cli-planning-delivery-commands.js` 现在由同一份 registry 同时生成 help lines 和 handlers
-- `agent-handoff / apply-plan / completion-report / handoff-bundle / share-pack / export-pack / html-pack / publish-pack / exec-summary / fix-plan / owner-board / meeting-pack / pm-brief / roadmap / report` 已统一进入 registry
-- CLI 更接近所有命令族都使用显式 registry metadata 的结构
-
-## New in 1.4.0
-
-- 新增 `page-audit`
-- 支持对单个 URL 或本地单页文件做 GEO 页面级审计
-- 输出页面分数、问题区域、推荐新增模块、rewrite brief 与 agent prompt
-- 产品能力从“站点级诊断”扩展到“页面级修复入口”
-
-## New in 1.4.1
-
-- 新增 `rewrite-pack`
-- 基于 `page-audit` 继续产出 metadata drafts、章节结构、FAQ questions、schema recommendations 与 execution checklist
-- 让产品从“页面级诊断”继续推进到“页面级改写方案”
-
-## New in 1.4.2
-
-- 新增 `repo-patch-plan`
-- 把 GEO 问题继续收敛到仓库级 likely files、模板入口、metadata / schema / navigation 区域
-- 让 agent 更容易从“页面建议”切到“仓库改动计划”
-
-## 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:
+Load via config: `"plugins": ["./my-plugin.js"]`
 
-- `CODEX_HOME`
-- `CODEX_SKILLS_DIR`
-- `GEO_SKILL_INSTALL_DIR`
-- `GEO_SKILL_SKIP_POSTINSTALL`
+## Why GEO?
 
-## Resource contents
+- **35%+ of search queries** are now handled by AI assistants (2026)
+- **SaaS GEO tools cost $100-$3000/month** — this is free and open-source
+- **No other npm package** provides comprehensive GEO analysis with zero dependencies
+- **CI/CD native** — fail your build if GEO score drops
+- **Agent-friendly** — 25 bundled Codex skills for AI coding assistants
 
-The installed package now includes a bundled GEO skill pack, including:
+## Numbers
 
-- `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`
+| Metric | Value |
+|--------|-------|
+| CLI Commands | 43 site ops + agent workflow commands |
+| API Exports | 230+ |
+| Analysis Dimensions | 12 |
+| Test Cases | 139 |
+| External Dependencies | 0 |
+| TypeScript Support | Full declarations |
+| GitHub Action | Included |
+| Plugin System | Extensible |
 
 ## License