其他
在实现、集成、升级、调试或回答涉及第三方 API、库、框架…
当用户要求 latest/current/official/supported/best practice/recommended/today/now/look it up,或任务涉及新增/升级/配置/导入包/SDK/框架/插件/CLI/模型/云资源/供应商集成、快速变化或版本敏感的 API、鉴权/OAuth 权限/secrets/webhooks/计费/支付/PII/加密/数据保留/迁移/重试/速率限制/配额/缓存/部署/合规、错误提示弃用或版本不匹配、仓库有本地文档/ADR/schema/OpenAPI/route 注册表/设计系统文档、难以逆转的公共格式/数据库 schema/持久 ID/事件名/客户可见行为/外部自动化契约,或你正准备用 usually/probably/I think/from memory 写外部 API 代码时,先阅读当前官方或本地权威文档。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
在实现、集成、升级、调试或回答涉及第三方通用
解决思路
- 不要猜权威文档在哪里;当问题涉及 API、版本、供应商行为、配置、限制、生命周期钩子或安全敏感流程时,先网页搜索当前官方文档、打开相关页面并在写代码前阅读,用文档实际内容支撑答案。
- 按权威性选择来源:项目特定行为优先用本地 repo 文档、specs、ADRs、schemas、generated types、package READMEs 和 tests。
- 第三方行为用官方产品文档、API references、migration guides、changelogs、release notes 和 SDK source/types;没有确切 URL 时用网页搜索找到这些文档。
- 版本用包注册表元数据:添加依赖前运行 `npm view <pkg> version`、`pnpm view <pkg> version` 或生态等价命令,然后阅读该大版本的文档。
- 官方文档不完整时,阅读 source code 或 type definitions;把它们当作证据,而不是传闻。
- 有官方文档时,避免把 Stack Overflow、旧博客、随机片段和记忆作为主要来源;只有在已知权威契约后,才用社区来源调试症状。
- 识别确切对象:包名、已安装版本、目标版本、provider endpoint、CLI 命令、配置文件、本地 helper、schema 或产品功能。
- 除非相关文档已在本地或用户提供了 URL,否则搜索网页上的当前官方文档;使用定向搜索,如 `<product> <feature> official docs`、`<package> migration guide`、`<provider> API reference`。
- 打开并阅读离该对象最近的文档:内部代码优先本地文档,然后官方上游文档;对于新包,在写 imports、config 或 install 命令前先确认最新版本。
- 提取任务所需少量事实:选项名、imports、生命周期规则、默认行为、破坏性变更、限制、权限,以及当前主版本的示例。
- 用这些事实实现或回答;如果文档与现有代码冲突,检查本地代码路径并指出差异。
- 用最小有用检查验证:typecheck、tests、build、CLI dry run、API schema validation 或本地复现。
- 在最终答案中,当被参考的证据影响建议或实现时,列出查阅的文档或本地文件。
- 不要为每个微小编辑都浏览网页;当答案已在 repo 中(现有 helper 用法、附近 tests、typed interfaces、generated clients、ADRs、package READMEs)时,可只做简短本地阅读。
- 如果任务依赖外部工具、包、provider 或当前产品行为,通常应以网页搜索为第一步。
- 对于琐碎语言语法、拼写修复、格式化或无外部契约的自包含代码,正常继续。
- 如果网络访问、认证或缺失本地文件阻止阅读文档,在依赖记忆前明确说明;缩小不确定性,若可用则检查 source 或 types,避免把结果说成已确认的最新。
适用边界 · 注意事项
- 不要对每个微小编辑强制上网查文档;答案已在 repo 中时本地简短阅读即可。
- 对于琐碎语言语法、拼写修复、格式化或无外部契约的自包含代码,不要强制查文档。
- 有官方文档时,不要把 Stack Overflow、旧博客、随机片段或模型记忆当作主要来源。