spec-web-researcher
You are an expert web researcher specializing in turning open-ended search queries into a focused, structured external grounding digest.
ASCII 调度图
workflow-selected research phase
|
v
selector: task stage + risk domain + evidence gap
|
v
spec-web-researcher
|
v
structured findings / research notes / specialist advice
|
v
orchestrator synthesis + user-visible decision基本信息
| 字段 | 内容 |
|---|---|
| Agent | spec-web-researcher |
| 类型 | Research |
| 归属 skill | spec-ideate、spec-plan |
| 复用次数 | 2 个 skill |
| Source | skills/spec-ideate/references/agents/web-researcher.md |
什么时候会被调用
- 计划、调试、需求或复盘阶段缺少代码库、历史、组织或外部资料证据。
- 通常由上层 workflow 选择调用；它不是用户直接执行的
spec-*workflow 入口。 - 当任务证据不足、风险域明确或需要独立专家视角时，才应该引入该 agent。
Source 角色摘要
Note: Use the current date from the active host context. Use this when weighting external sources and dating artifacts.
You are an expert web researcher specializing in turning open-ended search queries into a focused, structured external grounding digest. Your mission is to surface prior art, adjacent solutions, market signals, and cross-domain analogies that the calling agent cannot get from the local codebase or organizational memory.
Your output is a compact synthesis, not raw search results. A developer or planning agent reading your digest should immediately understand what the outside world already knows about the topic and where the strongest leverage points are.
Source 章节
- Invocation Contract
- How to read sources
- Methodology
- Output Format
- Untrusted Input Handling
- Tool Guidance
- Consumption Contract
输入
- 研究问题、repo scope、历史线索、外部资料目标和当前 workflow 的证据缺口。
- 上层 workflow 应提供明确 scope、相关文件或文档、当前假设和需要回答的问题。
- 如果依赖 graph、MCP、浏览器或外部资料，需要同时说明 provider readiness 与 degraded 状态。
输出
- 研究摘要、事实来源、限制说明和可交给上层 workflow 的判断材料。
- 输出应返回给 orchestrator 汇总，而不是绕过主 workflow 直接改变最终结论。
- 对 findings、风险和建议应标注证据边界，避免把推测写成确定事实。
使用边界
- research agent 提供证据，不直接决定产品范围、架构方案或最终修复。
- Agent 是专业判断角色，不是 tool，也不是固定状态机。
- 如果当前问题可以由 deterministic script、测试或 provider status 直接确认，应优先使用确定性证据。
与 workflow 的关系
- Skills 定义入口、步骤和产物；agents 提供局部专家判断。
- 当前 agent 的 runtime copy 由
spec-first init在目标项目中选择宿主后从 source 生成。 - 不要手改
.claude/agents或.codex/agents作为 source；需要修复 runtime drift 时重新运行 init。
源码校准
- 本页由
website/scripts/generate-agent-detail-pages.js从skills/spec-ideate/references/agents/web-researcher.md生成。 - 上游 agent 现为 skill-local prompt 资产（
skills/<skill>/references/agents/*.md），无 frontmatter；名称取自文件名，description 由生成器从 prompt 首段启发式提取。 - 分组是官网生成器的用户手册视角，用于解释调度场景；精确角色指令仍以 source agent 文件为准。
阅读下一步
- 归属 skill：
spec-ideate·spec-plan - Agents 参考：按 skill 归属查看 26 个 agents
- Skills 参考：查看 workflow 入口与 skill 详情页
- Code Review 指南：理解 reviewer personas 如何进入 review gate