web-subagent-workflow

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 在最终输出前必须确认全部完成):

• Step 2: node index.js --search 已执行，返回了 JSON？receipt.run_id = ______
• Step 3: (复杂时) node index.js --reason 已执行？receipt.run_id = ______ (简单时) 已明确记录跳过理由？
• Step 5: node index.js --review 已执行，返回了 JSON？receipt.run_id = ______
• Step 6: 审查意见已逐条处理？
• 最终报告已列出以上全部 run_id？

例外: --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: 规划与分发

1. 理解需求，快速浏览相关本地文件
2. 判定复杂度（仅决定 Step 3 是否执行）
3. 编写综合搜索 prompt — 必须包含:
   • 用户原始需求
   • Claude 已做的本地分析摘要（文件内容、项目结构等发现）
   • 需要 web AI 补充/验证的领域背景或最新进展
   • 即使问题看似纯本地，也必须构造搜索 prompt——至少让 Kimi 验证本地发现、补充领域最新动态、或交叉检查 Claude 的判断
4. 向用户报告：复杂度 + 搜索查询 + 预期产出

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"     # Kimi 搜索
node skills/Web-SubAgent-Workflow/index.js --reason "prompt"    # Gemini 推理
node skills/Web-SubAgent-Workflow/index.js --review "content"   # ChatGPT 审查
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