AgentChat-OneWeb

AI Fallback Chain — Multi-Provider CDP Bridge

最后更新: 2026-08-09 核心功能: 按优先级链自动降级，确保始终有一个可用的大模型 变更日志: 见 CHANGELOG.md

⚠️ 强制规则 — 调用即执行（首要动作契约）

本 skill 被调用（如 /AgentChat-OneWeb <问题>）时，必须执行 node 命令把用户问题发送到 web AI。禁止只解释用法而不执行，禁止用模型自身知识替代 web AI 的回答。

1. 首要动作契约

读完本 SKILL.md 之后的下一个工具调用必须是：

node ~/.claude/skills/AgentChat-OneWeb/index.js "<用户prompt>"

中间不允许插入文件浏览、架构分析、"我将会…"式的规划叙述（至多一行说明即将执行的命令）。web AI 返回结果后，才可补充你自己的分析。

2. 执行回执（receipt）— 是否执行以此为准，不以叙述为准

每次真实执行（含失败）都会在 stderr 输出一行机器生成的回执：

[receipt] AGENTCHAT_RUN {"run_id":"ac-xxxxxxxxxxxx","skill":"AgentChat-OneWeb","exit":0,"provider_used":"Gemini",...}

• 最终回答末尾必须原样引用这行 receipt（至少包含 run_id、provider_used、exit）。
• 没有 receipt = 没有执行 = 违规，必须回去执行。
• run_id 为随机生成并同步落盘到 ~/.claude/skills/AgentChat-OneWeb/data/receipts.jsonl，用户可用 grep <run_id> 核对——凭空编造无法通过核对。
• 执行失败（exit≠0）同样有 receipt：必须引用失败回执并说明原因（限流/未登录/超时…），在此之后才允许用模型自身能力回答，且必须明确标注"web AI 未参与本次回答"。

3. 违规模式（全部禁止）

• ❌ 读完 SKILL.md 后描述 fallback 链、罗列 CLI 参数、讲解架构——却不跑 node index.js
• ❌ 以"问题太简单/我已经知道答案"为由跳过执行，直接用模型知识回答
• ❌ 回答中没有 [receipt] AGENTCHAT_RUN 行却声称"已通过 web AI 处理"

4. 例外

仅限：--smoke、--doctor，或用户明确要求"只检查环境不发送"。这两种模式不产生 receipt，属预期行为。

5. 本地上下文

网页 AI 无法访问本地文件系统。涉及本地文件/代码/图片时，Claude Code 须先将内容读入 prompt 再发送，禁止只传文件路径。

📐 输出排版规范 — 最终回答强制格式

约束对象是 Claude Code 撰写的最终落地文本；worker 原始输出、代码块、diff、表格与 receipt 行不受约束。

1. 结论先行：开头第一段为 ≤50 字的核心结论（TL;DR），直接回答用户根本诉求，无客套话、无方法论铺垫。
2. 标题层级：主模块用 ##，子观点用 ###，禁止一级标题 #。维度按逻辑聚类为 3–5 块（如：背景/现状/分析/结论），禁止按检索顺序写流水账。
3. 视觉焦点：数据、时间、专有名词、核心论点用 **加粗** 标出；加粗仅用于焦点引导，每个自然段不超过 2 处。
4. 列表纪律：只允许单层无序列表 *，禁止任何多级嵌套列表（保证终端/聊天框阅读体验）。
5. 文本密度：叙述性自然段 ≤3 句，新逻辑分支必须换行分段；禁止"总而言之""基于以上搜索结果""作为一个人工智能"等无实质信息的过渡句。
6. 信息隔离：引用 web AI 原文片段或外部链接时必须放入 > 引用块并标注来源 provider，与自己的分析严格区分。
7. 豁免条款（优先级高于第 1–6 条）：
   • [receipt] AGENTCHAT_RUN {...} 行（或各步 run_id 清单）必须原样保留在回答末尾的代码块中，禁止改写、加粗、省略——受强制规则 §2 约束。
   • 降级/失败披露（如"N 个角色降级""web AI 未参与本次回答"）属流程透明性要求，不算冗余过渡句，不得删除。
   • 代码块、diff、表格不受段落长度与列表层级限制。