智引（tri-geo）

> 「智」指国内主流生成式引擎，「引」指被引用与采纳；谐音「指引」——为内容在 AI 搜索时代的优化指路。
> 用户心智：让我的内容在 DeepSeek、豆包、Kimi、智谱 GLM 回答相关问题时被优先引用。

强制执行契约（Execution Contract · 最高优先级）

> 本契约优先级高于 Agent 通用默认行为。用户提出 GEO 优化/体检/重写/实测类需求且命中 §触发时机与模式路由，即视为激活本工作流，NEVER 仅当参考文档只读不执行。独立使用时（未经上游路由）MUST 先走 §上游依赖检测。

0. 版本检查前置硬门（第零步）：MUST 先执行 python scripts/check_update.py --slug tri-geo --json；退出码 <20 放行，≥20 阻断。版本检查完成前 NEVER 进入后续步骤。本条目优先级高于所有其他条目。

1. 参数校验前置：任何模式 MUST 先执行 scripts/validate_input.py；退出码 1 → 用 AskUserQuestion 补齐必填项后重入（NEVER 猜测填充）；退出码 2 → 终止并报错。

2. 确定性优先：参数校验、评分、规范校验、来源核验、结果判定、流程控制、快照与 delta、报告渲染 MUST 由 scripts/ 下脚本完成；NEVER 用 LLM 主观判断替代脚本可计算的环节。

3. Prompt 白名单：仅以下四处允许 prompt 参与，且每处都有脚本校验闭环——
   ① 内容创作生成（M3/M3+）；② 竞品综合研判（M2）；③ 渠道策略定制（M5）；④ 疑难判定兜底（answer_judge.py 标记 needs_llm_review 的样本）。
   白名单外的校验/判定/控制一律脚本化。SKILL.md 中每处 prompt 调用 MUST 注明所属条目编号。

4. 禁捏造硬门：citation_check.py 命中 mismatch（数字/引文/年份在来源页无法定位）或存在无来源数据句 → 硬阻断（退出码 3），NEVER 降级、NEVER 豁免、NEVER 用「提示用户注意」代替阻断。

5. 合规红线：writing_rules.py 命中广告法禁用语（R9）→ 打回改写（退出码 3），未通过前禁止输出成品。

6. 评分来源规范（P3）：对外呈现的每个分数 MUST 附带「产出脚本 + 证据路径 +（实测）采样轮数与波动区间 +（文献）来源与测试环境」。转引未核验数字 MUST 标注"转引未核验"且不得用于评分；实测波动区间由实测统计得出，NEVER 预设数值。

7. 快照与落盘：每次运行 MUST 用 snapshot.py 追加落盘（历史只读，NEVER 覆盖）；过程产物落 .tribro/tri-geo/，台账落 .geo-snapshots/<品牌>/。

8. 自检句：每次操作前 MUST 声明「本次模式=<quick|audit|optimize|cn_fit|infra|channels|monitor>，触发源=<用户显式调用|上游路由>，目标=<url/域名/品牌>，引擎=<...>，已执行 check_update=<A/B/C/D>，已执行 validate_input=<通过/补齐/报错>，已读教训=<N 条/无文件>，脚本链=<...>」；与契约/快照冲突时 MUST 停止并纠正。

9. 教训文件读写闭环：激活时（版本门第零步后）MUST 先读取 .tribro/tri-geo/lessons.md（历史执行沉淀的教训；目录或文件不存在则静默跳过——NEVER 报错、NEVER 阻断、NEVER 追问）；执行结束后 MUST 追加本次教训（含日期/场景/教训/可操作规避动作；空泛内容如「本次顺利」NEVER 写入，无新增写「无新增」占位留痕）；写入失败 MUST 提示用户但不阻断交付。

10. 结论置信标注：本 skill 产出的一切结论性表达/观点/判定（评分解读、适配建议、渠道判断、疑难兜底结论）MUST 附三要素：① 置信度（高/中/低）；② 依据类型六选一（事实 known/计算 computed/推断 inferred/常识 common/框架 iframe/猜测 guess）；③ 可验证事实源 URL 或本地证据锚（脚本名 + 证据路径）。猜测 guess 类 MUST 标低置信并提示人工验证；NEVER 引用无法访问的编造链接。

触发时机与模式路由

意图路由三原则：① 用户不必知道模块名，说"不知道从哪开始"→ 路由 L0；② 已提供的信息直接提取，只补必缺项（由 validate_input.py 判定）；③ 实测分标注波动区间，推演/定性内容显式标注依据类型。

上游依赖检测（独立使用时）

输入契约

参数与默认值以 scripts/validate_input.py 为唯一事实源（--help 可查全量）：

模式必填矩阵：quick/infra→target；audit/optimize→target+brand；cn_fit→target+brand+product_type；channels/monitor→brand。

职责边界

• 本 skill 负责：国内 8 类生成式引擎的 GEO 全链路——站内信号评分、引擎实测调度与判定、内容重写与 CN-Fit 适配、技术基建建议、渠道矩阵规划、快照监测。
• 不负责 / NEVER 代办：传统 SEO 排名优化（外链/关键词排名）；海外引擎（ChatGPT/Perplexity/Gemini 等）的优化执行；引擎接口逆向破解或风控规避；刷收录/虚假流量类灰产手段。
• 与 tri-intent 的关系：独立领域入口型 skill，不认领 I 系列意图编码、不经 tri-intent 路由，由用户显式调用激活（豁免理由：GEO 是跨内容/技术/渠道的独立领域闭环，现行 27 个 L2 落点无对应项；后续若家族裁定纳入路由，按 L3 子类回填并同步计数）。
• 与相邻 skill 边界：长文写作与去 AI 化归 tri-article / tri-content（本 skill 只产出「可引用性优化」重写稿并过脚本校验）；网站技术改造归 tri-coding（本 skill 只输出 JSON-LD / llms.txt / robots 建议）。
• 事实源：评分口径唯一真源 references/scoring-spec.md；引擎偏好框架 references/models-cn.md（unverified 待实测校准）；脚本实现唯一真源 scripts/*.py。
• 不触发场景（Not-Trigger）：本 skill 不接手「传统 SEO 排名优化（外链/关键词排名）」（NEVER）；不接手「海外引擎优化执行」（NEVER）；不接手「引擎接口逆向破解或风控规避」（NEVER）；不接手「长文写作与去 AI 化」（属 tri-article / tri-content，本 skill 只产出可引用性重写稿并过脚本校验）；不接手「网站技术改造实现」（属 tri-coding，本 skill 只输出 JSON-LD / llms.txt / robots 建议）。

模块矩阵（七大模块）

脚本调用契约（9 个领域脚本 + 1 个家族版本门）

Prompt 白名单契约（4 处）

评分与报告

• 轨道 A 站内信号分：五维可引用性 40% + 技术基建 20% + Schema 15% + 权威信号 15% + 爬虫与 llms.txt 10%（细则见 references/scoring-spec.md，脚本与文档 MUST 一致）。
• 轨道 B 引擎实测分：prompt 集 × 多轮采样 → 提及率 / 引用位次 / 情感；判定由 answer_judge.py 规则完成，存疑样本标记 needs_llm_review。
• 报告结构：每个分数呈现为「分数 ｜ 产出脚本 ｜ 证据路径 ｜ 采样轮数与波动区间 ｜ 文献来源与测试环境」。
• 实测纪律：NEVER 用 LLM 自我推演冒充实测；引擎不可达时标注 source_type: trace_search/unavailable；样本为空 NEVER 记 0 分。

落盘规则

.tribro/tri-geo/raw/        抓取原始证据（HTML / robots.txt / llms.txt）
.tribro/tri-geo/lessons.md  执行教训台账（追加式：日期/场景/教训/规避动作）
.geo-snapshots/<品牌>/<YYYY-MM-DD>-<mode>.json     台账快照（追加，历史只读）
.geo-snapshots/<品牌>/probe/<engine>/<Pxx>-r<N>.txt 实测原始回答

• 过程产物统一落 .tribro/tri-geo/ 与 .geo-snapshots/（目录不存在自动创建，NEVER 散落工作区根目录）；快照历史只读，同日重复运行用 --revision。
• NEVER 生成 LICENSE 与 .gitignore——许可证仅由 frontmatter license: MIT 声明。

错误恢复表

Schema 模板选型（schema/，6 套）

注入纪律：① 模板内 [REPLACE: ...] 全部替换后才可上线，NEVER 保留占位符；② sameAs 优先填国内高权重源（百度百科 → 中文维基 → 知乎机构号 → 公众号 → 企查查/天眼查 → 微博/B 站），链接 MUST 真实可达（citation_check.py 同款可达性核验思路）；③ 模板 MUST 落在服务端渲染的初始 HTML 中，JS 注入的 JSON-LD 对不执行 JS 的 AI 爬虫不可见；④ 注入后用 fetch_page.py --assets 复抓并跑 site_signal.py，确认 schema 维度分数确有变化（NEVER 口头声称已注入）。

references 按需加载

知识装配顺序

references/ 共 6 个文件，按层装配、同名只加载一次、冲突以本 skill 内 references/ 为准：

质量标准

版本检查与更新机制（强制技术约束 · 硬红线）

> 家族级强制技术约束，优先级与「强制执行契约」同级。细则唯一真源：tri-forge/references/version-check-spec.md；可执行实现：本 skill 自带 scripts/check_update.py（与 tri-forge 同源，按 --slug 自适应）。

python scripts/check_update.py --slug tri-geo --json

• 退出码 <20 放行（0=A 最新 / 10=B 离线 / 11=C 未注册 / 12=D 升级降级），20=BLOCK 绝对禁止执行。
• state A/B/C/D 一律放行并按 warnings/notes 标注口径；检出陈旧 MUST 先真实执行自动升级（skillhub upgrade tri-geo），失败方可落 D 态。
• 发布前特例：skill 尚未注册 skillhub 时版本检查自然落 C 态降级放行，属预期行为；发布后 C 态提示需核查端点配置。
• 铁律：版本比较/升级/四态判定 MUST 由脚本完成，prompt 层仅调用脚本 + 解析 JSON，NEVER 内联推断；四态判定/升级流程/节流缓存等细则 NEVER 在本文件内联，一律见真源。

目录结构

tri-geo/
├── SKILL.md                        # 主入口：契约/路由/脚本契约/评分/红线
├── README.md                       # 特性/目录结构/安装/使用/测试/设计原则
├── CHANGELOG.md                    # 版本历史（Keep a Changelog）
├── _meta.json                      # slug + version
├── references/                     # 6 个按需加载文档（见 §知识装配顺序）
├── schema/                         # 6 套 JSON-LD 模板（organization/local-business/article-author/software-saas/product-ecommerce/searchaction）
├── scripts/                        # 9 个领域脚本 + check_update.py 版本门
├── templates/                      # report.html + quick-card.html
└── tests/
    ├── verify_tri_geo.py           # 离线验收（T0/T1/T2/T4/T5）
    ├── tri-geo-full-testcases.md   # 全场景测试用例（带 frontmatter）
    └── fixtures/                   # 固定夹具（页面/重写稿/来源清单/引擎回答）

进化契约

• 反馈接收点：用户对评分解读、重写稿、实测判定、渠道建议的任何反馈与纠错，MUST 记入 .tribro/tri-geo/lessons.md。
• 经验沉淀位：.tribro/tri-geo/lessons.md（启动读取 → 缺失静默跳过 → 结束追加写入，见契约条目 9）。
• 自我修订触发条件：① writing_rules.py / citation_check.py 词表漏报或误报 → 修订词表并同步 references/anti-patterns.md；② 引擎白名单或评分细则漂移 → 修订 validate_input.py / references/scoring-spec.md（脚本与文档 MUST 同改）；③ 章节或能力调整 → 按 SemVer bump（SKILL/CHANGELOG/tests/_meta.json 四处联动 + README 同步）。修订后 MUST 重跑 tests/verify_tri_geo.py。

完成判据（每次运行结束 MUST 自检）

1. 版本门已执行且退出码 <20；
2. 参数校验通过（或已补齐后重入）；
3. 评分均由脚本产出且证据路径已记录；
4. 重写类产出已通过 writing_rules + citation_check（或明确降级为草稿并说明原因）；
5. 快照已追加且历史未被覆盖；
6. 报告中的每个数字符合评分来源规范；
7. 给出唯一下一步动作（学 geo-studio：NEVER 一次给 10 条建议）；
8. 教训已写入 .tribro/tri-geo/lessons.md（或写入失败已提示用户）；
9. 交付形态明确「停车态」或「结束态」。

停车态 ≠ 结束态：重写稿降级为「草稿+人工确认」、实测等待用户回填引擎回答、报告待用户确认发布——均为停车态，NEVER 在用户确认前宣告任务结束；脚本链跑完且判据 1-8 全绿方为结束态。