web-research

Web 研究

规则

• 遵守用户约束，包括禁止写入或仅聊天的请求。了解可用的检索能力；不要臆测工具名称。
• 优先使用一手来源，并阅读对答案至关重要的内容。搜索摘要和自动生成的摘要仅用于发现线索，不足以作为证据。
• 对于依赖项相关的说法，确认已安装或目标版本，以及运行时和集成边界。若版本匹配的源与当前在线文档冲突，优先采用前者。
• 对于签名、哈希、序列化、规范化、身份验证或线路协议，必须有独立的官方实现、测试向量或互操作性验证；仅靠自洽的往返测试不足以证明。
• 引用 URL，区分观察结果与推断，并说明不确定性。绝不存储机密、凭据、私人会话或敏感源内容。

资源

开始相应工作前阅读：

工作	资源
大量研究笔记或决策综合	ADR 约定：共享文档路径与决策权威
复杂、多条件、多角度或时效性强的发现工作	Web 搜索
多个来源、代码库、PDF 或截断内容	内容检索
视频/音频或视觉片段	媒体

登录、填写表单或进行动态交互时使用浏览器自动化；处理本地文档时使用本地解析器或截图。

工作流

1. 界定问题。 简单直接的查询无需产出文档。对于大量、相互冲突、可续做、对实现至关重要或高风险的研究，请阅读 ADR 约定，并复用当前工作文档，或创建 adrs/work/<research-slug>.md。记录问题、范围、约束、已知背景和搜索角度。若禁止写入，则在回复中保留证据。
2. 了解背景。 适用时检查清单文件、锁定文件、配置或确切源代码。找出会影响答案的行为、兼容性、故障和集成问题。
3. 发现资料。 优先检查用户提供的来源；否则从两到四个不同角度着手，例如官方文档、源代码/发布历史和佐证实现。检索经筛选且对答案至关重要的来源。
4. 检查资料。 阅读实际文档、源代码、测试或媒体。若内容被截断，通过获取完整内容或使用其他检索途径解决。对于大量研究，在同一份工作文档中保留有用发现、引用、版本/日期范围、重大冲突、已排除的证据、未决问题和下一步行动。
5. 得出结论。 评估来源的权威性、直接性、版本匹配度和故障行为。针对重大缺口进行有针对性的跟进；在证据充分、剩余缺口无关紧要或不太可能找到更多有用证据时停止。
6. 综合整理。 在最终回复、交接或内容压缩前，重新阅读现有工作笔记。说明发现、影响、来源冲突和局限。将与决策相关的证据链接到对应的 ADR；仅起草真正重大的选择，绝不把研究视为验收。可复用的技术知识应归入 wiki。

只有当后续结果会对结论造成重大影响，或用户提出要求时，才需要跟进。