shunk031-research-before-implementation

说明

阅读此 SKILL.md 后，请说：🔎 I read shunk031-research-before-implementation.

实施前先调研

当本地文件或稳定知识无法确定与任务相关的行为时，请使用此技能。对于自包含的编辑和常规措辞修改，除非用户要求调研，否则跳过调研流程。

1. 遵循适用环境指南中的明确调研路由，然后通过可用的网络调研能力查阅当前官方文档、规范、发行说明或推荐做法。阅读相关来源的内容，而不只是 URL 或搜索结果标题。若存在相关的非 GitHub 来源，请使用该来源。如果论文报告的行为正是需要测量的内容，请阅读论文。
2. 查阅官方来源后，在 GitHub 上检查有代表性的实现代码或配置。仅针对任务将使用的 API、默认值或入口点，阅读已安装的文档和源代码。
3. 将文档说明的行为与实现进行对比。在选择设计方案前，解决版本、平台、维护状态和激活方式方面的差异。
4. 根据这些证据实施并验证更改。根据风险和受影响调用方的数量，调整调研和验证的深度。
5. 报告影响决策的来源。如果同时查阅了官方非 GitHub 来源和直接的实现或配置文件，至少链接其中一个官方非 GitHub 来源和一个直接的实现或配置文件。

调研重试

如果调研能力因临时连接错误、HTTP 5xx 响应或流中断而在提供来源前退出，请在该阶段最多重试 3 次。提供方限制或工具遭拒（包括 403）属于稳定情况：不要重试、修改凭据或绕过限制。如果主机提供了其他获准的获取途径，请使用该途径；只有在适用环境指南明确配置时，才允许使用调研子进程。不要用记忆代替调研。只有在阅读来源内容并记录其直接 URL 后，才算一次有效尝试；不要因格式、长度或措辞原因重跑；如果答案说明文档未对此作出规定，也不要重跑。如果没有任何获准的调研途径成功，请停止并以 BLOCKED 报告确切问题及失败的途径。