# 技术研究通过调度并行子代理从 X/Twitter（通过 Grok）、GitHub 存储库（通过 DeepWiki）和网络（通过 WebSearch）收集情报来协调多源技术研究。将所有调查结果综合成一份可操作的报告。 **架构：** 主代理使用两种模式之一来编排研究：轻量级（任务子代理）或重量级（代理队友） - 根据研究复杂性进行选择。 ## 语言 **匹配用户的语言**：以用户使用的相同语言进行响应。如果用户用中文书写，则整个研究报告应为中文。如果是英文，请用英文报告。 ## 研究模式选择在派遣任何代理之前，请确定适当的模式：信号| → 模式 ---|--- 单一主题，多个数据源（Grok + DeepWiki + WebSearch）| **轻量** → 任务子代理需要交叉比较的多个独立主题/竞争对手 | **重** → 特工队友研究可能会产生需要动态重新界定范围的后续问题| **重** → 特工队友代理数量 ≥ 4 | **重** → 特工队友 ### 轻型模式（单主题研究的默认模式）调度最多 3 个任务子代理（带有 `subagent_type: "general- Purpose"` 的 `Task`）。每个独立处理一个数据源。主代理全部返回后综合结果。 ### 重型模式（用于多主题/竞争性研究）使用“TeamCreate”创建研究团队→为每个研究任务生成“TaskCreate”→生成代理队友（通过带有“team_name”和“name”参数的“Task”）→通过“SendMessage”进行协调。队友可以： * 进行沟通以避免重复（“我发现项目 A 使用与 B 相同的方法 - 专注于它们的差异化”） * 跨任务分享发现（“我找到的博客文章比较了所有 3 个框架，向您发送链接”） * 根据其他人的发现动态调整范围 ## 何时使用 * 评估技术、库或框架的采用 * 比较替代方案（例如“Zustand vs Jotai vs Redux”） * 调查 GitHub 存储库的架构和社区接受情况 * 衡量开发人员对新 API、工具或公告的情绪 * 跨语言研究（中日开发者社区） ## 研究来源来源 |它提供什么 |最适合 ---|---|--- **Grok** (X/Twitter) |真实的开发者意见、@handles、帖子 URL |情感、专家发现、利基推荐 **DeepWiki** (GitHub) | AI 支持的存储库分析、架构、API 文档 |了解代码库，比较存储库内部结构。 **仅使用`ask_question`** - 切勿使用`read_wiki_struction`或`read_wiki_contents`（它们返回大量转储，很容易超出上下文限制） **网络搜索** |官方文档、博客文章、基准测试、教程 |事实、性能数据、官方公告 ## 源降级并非所有来源每次都可用。遵循以下降级策略：来源 |如果不可用 |回退 ---|---|--- 格洛克|无浏览器后台或未登录 |跳过。报告中的注释：“Grok 源已跳过 - [原因]。” 深度维基 |没有已知的“所有者/存储库”，或 API 错误 |跳过。报告中的注释：“DeepWiki 已跳过 - [原因]。” 网络搜索 |工具不可用（罕见）|跳过。报告中注明。 **最低限度可行的研究：** 至少一个来源必须返回结果。如果所有源都失败，请报告失败并建议用户检查其环境设置。 ## Grok 浏览器后端 Grok 需要具有登录状态的浏览器自动化。支持多个后端，按优先级顺序检测：优先|后端| MCP 服务器名称 |优点 |缺点 ---|---|---|---|--- 1 | **克劳德在铬** |克劳德镀铬 |零设置，使用用户的Chrome登录状态 |占据用户可见的 Chrome 窗口 2 | **剧作家-Grok** | `剧作家格罗克` |专用配置文件，登录持续存在，不会阻止默认剧作家 |需要一次性设置 3 | **剧作家**（默认）| `剧作家` |已为大多数用户配置 |无登录持久化，可能无法登录 **重要**：请勿修改用户的默认“playwright”MCP 以添加“--user-data-dir”。这将强制所有浏览器操作通过单个配置文件，从而破坏并行代理的使用。相反，请使用单独的“playwright-grok”实例。 ### Grok 飞行前在分派 Grok 子代理之前，请检测最佳可用的浏览器后端。有两条路： **路径 A — claude-in-chrome（运行时检测，无需脚本）：** 如果当前会话中提供了 `mcp__claude-in-chrome__*` 工具，那么您已经拥有了最好的后端。 chrome扩展是在运行时注入的，**永远不会出现在`~/.claude.json`**中，因此shell脚本无法检测到它。完全跳过预检脚本 - 设置“backend=chrome”并继续调度。 **路径 B — Playwright 后备（基于脚本的检测）：** 如果 claude-in-chrome 不可用，请运行预检脚本来检测剧作家后端： bash ${SKILL_PATH}/scripts/grok_setup.sh 检查该脚本输出预检 JSON：`{"ready": true, "backend": "playwright-grok", "login_status": "logged_in", "hint": "..."}`。关键字段：“ready”（布尔值）、“backend”（“playwright-grok”/“playwright”/“none”）、“login_status”（“logged_in”/“logged_out”/“unknown”）、“hint”（人类可读的摘要）。 **实时验证说明：** 预检检查 `~/.claude.json` 中的 MCP 服务器是否存在（存在性检查），但无法从 shell 实时测试浏览器 MCP 连接 - MCP 服务器由 Claude Code 运行时管理，并且只能在代理执行期间访问。该技能通过乐观调度进行补偿：假设后端正常工作，然后根据实际的浏览器交互结果更新登录状态缓存（请参阅下面的登录状态缓存）。退出代码 |意义|行动 ---|---|--- ‘0’ 准备好了 |后端可用 |将“backend”值传递给 Grok 子代理。如果 `login_status` 是 `logged_out`，则跳过 Grok 并在报告中注明。否则调度子代理（乐观）。 `1` 需要设置 |有剧作家，无剧作家-grok | **安装优先门：**立即运行`grok_setup.sh setup`（在任何研究之前）。安装程序在修改“~/.claude.json”之前对其进行备份（备份路径位于输出 JSON 中）。如果设置成功，则通知用户需要重新启动 Claude Code 才能激活 playwright-grok，然后使用“backend=playwright”作为此会话的降级后备继续研究。不要开始研究并中途发现设置需要。 `2` NOT_AVAILABLE |根本没有浏览器 MCP |完全跳过 Grok 源代码。报告中注明。 **配置安全：** setup 命令始终在写入之前创建 `~/.claude.json` 的带时间戳的备份。如果新配置导致问题，请使用设置输出中的回滚命令进行恢复（例如“cp ~/.claude.json.backup. ~/.claude.json”）。 ### 登录状态缓存登录状态缓存在“~/.claude/tech-research/.grok-status.json”中。缓存语义：“logged_in”持续存在，直到子代理观察到注销； `logged_out` 在 2 小时后自动过期（或使用 `grok_setup.sh reset` 清除）； `未知`/缺失 = 乐观，尝试 Grok。 **子代理职责：** 与 Grok 交互后，更新登录状态： * 成功： `bash ${SKILL_PATH}/scripts/grok_setup.sh statuslogging_in ` *“登录”页面：`bash ${SKILL_PATH}/scripts/grok_setup.sh statuslogging_out` **缓存损坏恢复：** 如果状态文件损坏（无效 JSON、权限错误），请将其删除（`rm ~/.claude/tech-research/.grok-status.json`）并以乐观模式继续。有关完整的决策树，请参阅 [references/troubleshooting.md]()。 ## 工作流程进展： * 第 1 步：预检 — 运行 `grok_setup.sh check`，在研究之前完成所有设置 * 第 2 步：分析 — 将问题分解为每个源的子查询 * 第 3 步：调度 — 并行启动子代理（轻型或重型模式） * 第 4 步：综合 — 将调查结果合并到统一报告中 ### 1\.预检门（必须先运行） **在执行其他操作之前**运行预检。这决定了哪些源可用以及是否需要一次性设置。 1. 检查“mcp__claude-in-chrome__*”工具在您的会话中是否可用。 * **是** → `backend=chrome`，跳过脚本，直接进行步骤2。 * **否** → 运行 `bash ${SKILL_PATH}/scripts/grok_setup.sh check` 并根据退出代码执行操作：退出代码 0 (READY) → 记下后端和 login_status，继续执行步骤 2。退出代码 1 (NEEDS_SETUP) → 立即运行 `grok_setup.sh setup`。如果设置成功，则告诉用户： “playwright-grok 已配置。重新启动 Claude 代码来激活它。在本次会议中，Grok 将使用默认剧作家后端作为后备。” 然后使用 backend=playwright 继续步骤 2。退出代码 2 (NOT_AVAILABLE) → Grok 不可用。不使用 Grok 继续执行步骤 2。 **关键原则：** 设置在研究开始之前完成。永远不要在研究中发现设置需要。 ### 2\.分析研究问题将用户的问题分解为每个源的子查询： * **Grok 查询**：开发者意见、社区情绪、专家建议 * **DeepWiki 查询** ：存储库架构、API 设计、代码质量（需要 `owner/repo`） * **WebSearch 查询**：官方文档、基准测试、比较、最新公告并非每个研究任务都需要全部 3 个来源。根据问题选择来源：研究类型|格洛克|深度维基 |网络搜索 ---|---|---|--- “我们应该使用 X 库吗？” |是的 |是（如果 OSS）|是的 “开发者对 X 有什么看法？” |是的 |没有 |也许 “repo X 内部是如何工作的？” |没有 |是的 |也许 “比较 X 与 Y 性能”|也许|是（两个存储库）|是的 “X 框架有什么新变化？” |是的 |没有 |是的 ### 3\.派遣研究人员根据上面选择的研究模式选择调度方式。 #### 轻型模式：任务子代理使用“Task”同时启动子代理。有关完整的提示模板，请参阅 [references/subagent_templates.md]()。 **Grok 子代理：** 任务（subagent_type：“通用”，描述：“向 Grok 询问 [主题]”，提示：） **DeepWiki 子代理：** 任务（subagent_type：“通用”，描述：“DeepWiki 研究 [repo]”，提示：） **WebSearch 子代理：** 任务（subagent_type：“通用”，描述：“网络研究[主题]”，提示：） #### 重型模式：特工队友 1. TeamCreate(team_name: "研究-[主题]") 2. TaskCreate(主题：“研究[项目A]”，描述：“...”，activeForm：“研究[项目A]”) 3. TaskCreate(主题：“研究[项目B]”，描述：“...”，activeForm：“研究[项目B]”) 4. 任务(subagent_type: "通用", team_name: "research-[topic]", 名称: "researcher-a", 提示: "...") 5. 任务(subagent_type: "通用", team_name: "research-[topic]", 名称: "researcher-b", 提示: "...") 6. 通过 SendMessage 进行协调 — 分享发现、调整范围、避免重复 7、所有队友汇报后进行综合 8. 完成后关闭队友和 TeamDelete 每个团队成员都应该使用所有相关的数据源（Grok、DeepWiki、WebSearch）来完成其分配的主题，而不是按数据源进行拆分。 ### 4\.综合并报告所有子代理返回后，将结果合并到包含以下部分的统一报告中： * **TL;DR** — 2-3 句话执行摘要，带有明确的建议 * **社区情绪**（来自 X/Twitter）——带有 @username 属性和帖子 URL 的关键意见 * **存储库分析**（来自 DeepWiki）——架构、代码质量、API 设计、维护状态 * **Web Intelligence** — 官方文档、基准测试、博客见解、公告 * **比较矩阵**（如果比较替代方案）- 基于标准的表 * **建议** — 基于所有来源的清晰、可操作的建议 * **限制** - 无法验证的内容，包括跳过的来源及其原因 ## Grok 查询策略请参阅 [references/grok_query_overview.md]() 策略选择表和[references/query_strategies.md]() 获取完整的提示模板。 ## 故障排除和自我恢复有关完整的决策树和常见场景，请参阅 [references/troubleshooting.md]()。 ## 提示 * 对于CJK社区，直接用目标语言查询Grok * DeepWiki 在单个查询中最多接受 10 个存储库进行比较 * 网络搜索最适合最近的信息（包括查询中的当前年份） * 在引用之前始终验证 Grok 帖子 URL — 准确度约为 80% * 并行运行子代理以最大限度地减少总研究时间

技术研究

包含技能