| name | Web-SubAgent-Workflow |
| description | Sequential 6-step AI pipeline — Claude Code plans→Kimi searches→(complex? Gemini reasons)→Claude synthesizes→ChatGPT reviews→Claude fixes. Use for complex software engineering tasks needing web research + deep reasoning + quality review. MANDATORY EXECUTION - invoking this skill REQUIRES actually running `node skills/Web-SubAgent-Workflow/index.js` for Step 2 (--search) and Step 5 (--review) unconditionally (Step 3 --reason if complex), and listing each step's receipt.run_id from the returned JSON in the final report; narrating the pipeline or answering from model knowledge without receipts is a violation. |
Web-SubAgent-Workflow
核心原则: Claude Code 大脑 → Kimi 搜索 → (复杂? Gemini 推理) → Claude 合成 → ChatGPT 审查 → Claude 修复
Provider 层: AgentChat-WebExtended，零代码重复
安全策略: 永不关闭用户 Chrome
⚠️ 强制规则 — 调用即执行
本 skill 被调用时，必须依次执行 Step 1→6。Step 2 和 Step 5 无条件执行，Step 3 由复杂度决定。禁止跳过任何步骤，禁止只解释流程而不执行。
核心约束:
- ❌ 禁止：读了 SKILL.md 后描述流水线、解释角色分工、分析架构——却不跑
node index.js
- ❌ 禁止：以"任务太简单/纯本地/不需要搜索"为由跳过 Step 2 (
--search)
- ❌ 禁止：以"产出很简单/不需要审查"为由跳过 Step 5 (
--review)
- ❌ 禁止：用本地文件读取、代码分析、或 Claude 自身知识替代
node index.js 调用
- ✅ 必须：Step 2 和 Step 5 无条件执行。复杂度判定仅影响 Step 3（Gemini 推理）是否跳过
- ✅ 必须：每步产生可验证的
node index.js JSON 输出，结果返回后才可补充你的解读
执行回执（receipt）— 是否执行以此为准，不以叙述为准
每次 node index.js --search/--reason/--review 的输出 JSON 中都包含机器生成的 receipt 字段
（同时 stderr 打印一行 [receipt] AGENTCHAT_RUN {...}）：
"receipt": { "run_id": "ac-xxxxxxxxxxxx", "skill": "Web-SubAgent-Workflow", "mode": "search", "exit": 0, "provider_used": "kimi", ... }
- 最终报告必须逐步列出每次执行的
receipt.run_id（Step 2 一个；Step 3 如执行一个；Step 5 一个）。
- 缺少某一步的 run_id = 该步没有执行 = 违规，必须补跑。
- run_id 随机生成并落盘
skills/Web-SubAgent-Workflow/data/receipts.jsonl，用户可 grep <run_id> 核对，凭空编造无法通过核对。
- 失败执行（exit≠0）同样有 receipt：引用失败回执、说明降级/失败原因后，才允许以模型自身能力继续该步，并明确标注"web AI 未参与该步"。
反绕过原则: 如果某个步骤"看起来不需要 web AI"，正确的做法是仍然通过 node index.js 把本地发现发给 web AI 做验证/补充/交叉检查——而不是跳过该步骤。Step 2 的搜索 prompt 和 Step 5 的审查内容必须包含 Claude 已做的本地分析结果，让 web AI 做二次确认。
自检清单 (Claude Code 在最终输出前必须确认全部完成):
例外: --smoke、--doctor，或用户明确要求"只检查环境不发送"
架构
用户需求 → [1.Claude 规划] → [2.Kimi 搜索] →{复杂?}→ [3.Gemini 推理] → [4.Claude 合成] → [5.ChatGPT 审查] → [6.Claude 修复] → 最终产出
└── 简单: 跳过 ──┘
串行管道 + 条件分支。Claude Code 全程担任大脑，仅在 Step 2/3/5 通过 index.js 调 WebExtended。
角色与 Prompt 规范
| 步骤 | AI | 角色 | 必须内嵌的指令 |
|---|
| 2 | Kimi | 联网检索 | 请进行联网搜索，用要点列出关键事实和数据。不要运行代码。 |
| 3 | Gemini Pro | 深度推理 (条件) | 直接给出完整的分析。不需要搜索新资料，基于已有信息推理。 |
| 5 | ChatGPT | 交叉审查 | 请逐一审查以下内容，列出所有问题点并给出具体修改建议。不要重写整个方案。 |
复杂度判定 (Step 1)
仅决定 Step 3 (Gemini 推理) 是否执行。不影响 Step 2 和 Step 5 的强制执行。
不确定时倾向判定为"复杂"。
复杂 (触发 Step 3，满足 ≥2 项):
- 需综合多个信息源才能得出结论
- 涉及多步逻辑推理或数学推演
- 有非平凡架构/设计决策，或需多文件代码
- 问题域需要领域专长
- 用户要求"深度分析"或"全面方案"
简单 (跳过 Step 3，但 Step 2 和 Step 5 仍然必须执行):
- 单事实查询、≤50 行直观代码、格式转换等机械工作
操作流程
Step 1: 规划与分发
- 理解需求，快速浏览相关本地文件
- 判定复杂度（仅决定 Step 3 是否执行）
- 编写综合搜索 prompt — 必须包含:
- 用户原始需求
- Claude 已做的本地分析摘要（文件内容、项目结构等发现）
- 需要 web AI 补充/验证的领域背景或最新进展
- 即使问题看似纯本地，也必须构造搜索 prompt——至少让 Kimi 验证本地发现、补充领域最新动态、或交叉检查 Claude 的判断
- 向用户报告：复杂度 + 搜索查询 + 预期产出
Step 2: 联网检索 (无条件执行)
⚠️ 无论任务类型，此步骤不可跳过。 即使问题 100% 是本地文件理解，也必须执行搜索——价值在于补充领域背景、验证本地发现、发现 README 没有的最新进展。
node skills/Web-SubAgent-Workflow/index.js --search "综合搜索 prompt"
输出为 JSON。response 字段即 Kimi 完整搜索结果。Claude Code 完整阅读后提取关键事实。
Fallback: Kimi → Qwen
Step 3: 深度推理 (仅复杂任务)
将搜索摘要 + 原始需求组装为一个推理 prompt。摘要关键信息即可，不要贴原始全文。
node skills/Web-SubAgent-Workflow/index.js --reason "原始需求: ...搜索摘要: ...请从[角度]深度分析，直接给出完整推理。不需要搜索新资料。" --timeout=300000
Fallback: Gemini → ChatGPT → Claude
Step 4: 核心生成
汇总搜索事实 + 推理结论(如有) + 原始需求，生成最终交付物（代码/文档/报告）。自检：所有搜索事实已纳入？推理结论已被吸收？需求要点全覆盖？
Step 5: 交叉审查 (无条件执行)
⚠️ 无论任务类型，此步骤不可跳过。 将 Step 4 产出全文发给 ChatGPT。审查维度：正确性、安全性、性能、可维护性。
即使产出"很简单"，审查的价值在于：发现 Claude 可能忽略的错误、验证事实准确性、检查逻辑一致性。简单产出的审查可能很快（"无问题"也是有效结果），但必须执行。
node skills/Web-SubAgent-Workflow/index.js --review "原始需求: ...待审查产出: ...请从正确性、安全性、性能、可维护性逐一审查，列出问题并给修改建议。不要重写方案。"
Fallback: ChatGPT → Claude → Qwen
收到审查意见后逐条评估：合理→Step 6 修复 / 不适用→记录原因 / 需澄清→标注。
Step 6: 修复与输出
逐条应用审查意见，输出最终文件。向用户报告：步骤摘要、复杂度理由、审查处理情况、产出位置。
CLI 速查
node skills/Web-SubAgent-Workflow/index.js --search "query"
node skills/Web-SubAgent-Workflow/index.js --reason "prompt"
node skills/Web-SubAgent-Workflow/index.js --review "content"
node skills/Web-SubAgent-Workflow/index.js --smoke | --doctor
| Flag | 说明 |
|---|
--search/--reason/--review | 步骤模式（三选一） |
--provider=X | 覆盖默认 provider |
--timeout=N | 超时 ms（默认 180000） |
降级链
| 步骤 | 首选 | 降级 |
|---|
| Search | Kimi → Qwen | |
| Reason | Gemini → ChatGPT → Claude | |
| Review | ChatGPT → Claude → Qwen | |
