1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | read-the-damn-docs-builderio-skills |
| 作者/维护者 | BuilderIO（Builder.io 官方组织账号） |
| 来源链接 | https://github.com/BuilderIO/skills/tree/main/skills/read-the-damn-docs |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 3,941（数据来自 GitHub API，为 BuilderIO/skills 整个合集仓库的星数，非本技能单独热度） |
| Forks | 197（数据来自 GitHub API） |
| 最新版本 | 无正式版本标签，采滚动发布（数据来自 GitHub API：仓库未使用 Release/Tag 机制） |
| 安装方式 | npx @agent-native/skills@latest add --skill read-the-damn-docs |
2. 功能介绍与亮点
Read The Damn Docs 是“编码前先核实官方文档”的纪律型技能：处理第三方 API、库、框架或云服务 SDK 时，强制先联网检索并阅读官方文档，而非依赖模型记忆中可能过时的知识。
核心亮点：
- 触发清单：要求“最新/官方做法”、升级依赖、报错疑似版本漂移、涉及鉴权/计费/合规等场景须查文档。
- 信息源优先级：本地文档 > 官方文档 > 包管理器版本元数据 > 源码，二手来源仅用于事后排查。
- 七步流程：定位 → 检索 → 精读 → 提炼事实 → 实现 → 验证 → 答复中注明依据文档，形成可追溯证据链。
- 十余条真实场景示例（Tailwind 升级、AI SDK 流式响应、Stripe Webhook 校验等），并豁免琐碎改动。
- 诚实兜底：文档不可获取时告知“未经核实”，不假装信息当前有效。
3. 适用场景
所属分类：元技能与 Agent 增强（约束 agent 自身编码前的证据获取行为，而非具体技术领域的产出物）。
面向频繁调用第三方 API/SDK/云服务的 Claude Code 和 Codex 用户，对初中级开发者尤有价值——他们更难判断 AI 写出的代码是否已过时。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持标准 SKILL.md 格式。
- Codex：✅ 原生支持，附带
agents/openai.yaml声明专属触发提示词。 - OpenClaw / Hermes Agent：❓ 未见专门适配材料，未验证。
5. 推荐理由
强制在实现第三方 API 前先联网核实官方最新文档，避免模型记忆过时致错误代码。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 BuilderIO 为知名前端可视化搭建与 AI 开发工具厂商，本技能为其官方出品；所属合集仓库整体 3,941 星不代表该子技能自身热度，且未查得该子技能自身的独立第三方讨论证据 |
| 可用性 | 9 | 一条 npx 命令即可安装；SKILL.md 文档详尽，含触发清单、信息源优先级、七步流程与十余条示例；无付费依赖；所属仓库持续维护，本技能文件本身创建于 2026 年 6 月中旬 |
| 安全性 | 9 | 纯提示词/配置类技能，不含任何可执行脚本；唯一的“外联”行为是检索公开的官方产品文档，目标透明；无需任何 API Key 或凭据；License 明确（MIT）；发布方为可审计的官方开源组织 |
安全检查清单逐项结果：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无——技能目录内仅含 SKILL.md、README.md 与一个 215 字节的 Codex 显示配置文件，不含任何可执行脚本 |
| ② 联网外发数据 | 有限——引导 agent 联网检索公开的官方产品文档，不涉及用户私有数据外发 |
| ③ API Key/凭据 | 不需要 |
| ④ 可疑指令（prompt injection 迹象） | 未发现，全部内容为文档核实工作流指导 |
| ⑤ 作者/组织信誉 | BuilderIO 官方组织账号，公开可查，无造假迹象 |
| ⑥ License | 明确（MIT） |
| ⑦ 最近维护时间 | 所属仓库最近一次推送为 2026 年 8 月初 |
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| Efficient Frontier（同仓库姊妹技能） | 多子 agent 委派编排方法论——把判断留给前沿模型，重复劳动外包给便宜子 agent | 关注的是“谁来执行”的成本效率分配，不涉及编码前的事实核实 |
| agent-watchdog（同仓库姊妹技能） | 审计另一个 agent 的会话产出，分清“做完了”和“做对了” | 作用于任务完成之后的结果审计，而本技能作用于任务开始之前的证据获取 |
| 各厂商官方技能自带的文档引用 | 许多厂商专属技能（如某云服务或某数据库的官方技能）会在正文中提示参照该厂商自身文档 | 通常只覆盖该技能自己服务的单一产品文档，不具备跨技术栈、跨供应商的通用触发规则；本技能是可复用于任意第三方依赖的通用纪律，而非绑定单一产品 |
三者同属 BuilderIO/skills 系列下的“agent 行为纪律”技能簇，分别覆盖委派、核实、审计三个阶段。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
9. 安装使用方式
npx @agent-native/skills@latest add --skill read-the-damn-docs安装后无需重启终端；满足触发条件（添加第三方依赖、询问“最新/官方做法”等）时自动调用，也可显式要求手动触发。
10. 注意事项
- 依赖联网搜索能力；完全离线时退化为提示“未经核实”，无法发挥核心价值。
- 不判断搜索结果可信度，仍需对“官方文档”链接保持基本判断。
- OpenClaw、Hermes 适配未经验证，建议先做小范围测试。