dsh-research-first

LLM 编码智能体存在三种不断叠加的失败模式：凭记忆直接写代码而不查阅 API 文档、反复试错却不搜索社区已知方案、以及在过时的版本或端点上操作。每一次跳过廉价查询，最终都会演变成一次昂贵的返工循环。dsh-research-first 正是针对这个缺口而设计。

它不硬阻断工作流，而是在 agent 尚未执行任何调查工具就触发修改类工具时，注入一条柔和且可追溯的提醒。若调查路径本身不可用（离线环境、文档缺失），插件会检测到失败并提示向用户确认，而非直接停滞。连续失败达到可配置阈值后，它会提醒先查看 GitHub Issues 再做下一次尝试。每条提醒都以插件来源消息写入会话日志，可回放可审计。需要更强约束时，可将 intensity 调为 warn 或 block。

适合希望以最低成本给 agent 养成先查证再动手习惯的团队。它与 dsh-doublecheck（严格纪律门）和 dsh-pain-point-check（失败否决）可组合使用，作为日常轻量级默认提醒，既不冻结流水线，也让 agent 少犯低级错误。