1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | doubt-driven-development（addyosmani/agent-skills 合集仓库子技能） |
| 作者/维护者 | Addy Osmani（Google Chrome DevRel 工程师），核心提交者 federicobartoli |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/doubt-driven-development |
| 许可证 | MIT（GitHub API 获取） |
| 仓库 Stars/Forks | 80,973 / 8,737（GitHub API 获取；合集仓库整体数字，不代表本子技能自身热度） |
| 最新版本 | 0.6.5（2026-07-26，GitHub Releases） |
| 安装方式 | npx skills add addyosmani/agent-skills --skill doubt-driven-development，或 Claude Code 插件市场 /plugin install |
2. 功能介绍与亮点
doubt-driven-development 提供一套“在决策落地前先质疑”的工作流：对每个非平凡决策（涉及分支逻辑、跨模块边界、不可逆操作等）生成一个无历史上下文的新鲜复核者，用对抗性提问（只找问题、不做背书）挑战刚形成的结论，再由原 Agent 把复核意见分类为“合同误读/真实可改/可接受权衡/噪音”后决定是否收敛。核心亮点：
- 明确区分于事后的
/review（终审）——这是决策形成过程中的实时纠偏，纠错成本更低； - 支持“跨模型复核”（可选调用 Codex CLI / Gemini CLI 作二次意见），且内置只读沙箱、经用户明确授权才调用外部 CLI 等安全护栏；
- 正文内建“5 条常见借口对照表”与“红旗清单”，帮助使用者识别自己在偷懒跳过质疑步骤。
3. 适用场景
固定分类：工程效率与代码质量。适用于生产环境变更、安全敏感逻辑、不可逆操作（部署、数据迁移、公开 API 变更）等高风险决策场景；受益人群是希望在代码合并前而非合并后揪出隐藏假设与边界情况的 Claude Code 用户，尤其是独立开发者或小团队里没有专职代码评审人力的场景。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。SKILL.md 明确将自己定位为“主会话编排者”专用技能，第 3 步“生成新鲜上下文复核者”依赖 Claude Code 的子代理（
agents/）机制，且文中专门讨论了在 Claude Code 子代理上下文内嵌套调用本技能时的降级方案。 - Codex：⚠️ 需适配。仓库 README 与第三方安装器
vercel-labs/skills均将 Codex 列入可安装目标，但本技能核心的“生成隔离新鲜复核者”步骤是否有 Codex 侧等效实现，SKILL.md 未提及，未经验证。 - OpenClaw / Hermes Agent：⚠️ 需适配。同样可经
vercel-labs/skills安装器（其官方文档列出 OpenClaw、Hermes Agent 为受支持目标），但核心复核机制的可用性同上未经验证。
5. 推荐理由
它把“资深工程师会在关键决策上找同事挑刺”这一朴素但常被跳过的习惯，封装成一套结构化、可执行、有明确停止条件（最多 3 轮）的流程，专门针对 Agent 编程里“长会话积累的隐性假设被当成事实”这一具体失效模式，且对可选的跨模型能力配了扎实的安全护栏。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 该子目录本身提交记录来自内部维护者，暂无可查证身份的外部企业贡献者；独立第三方评测网站 productize.life 在其“Addy Osmani 技能合集”评测文章中明确点名本技能为全仓库“四个特别值得关注”的技能之一 |
| 可用性 | 9 | 纯 Markdown 指令文件，npx skills add 一条命令即可安装，核心流程零配置；仓库近期（0.6.5，2026-07-26）仍在活跃维护 |
| 安全性 | 9 | 无脚本、无自动联网、无需凭据；唯一涉及外部程序调用（跨模型复核）为可选项，且明文要求每次调用前必须获得用户显式授权、非交互场景自动跳过、并使用只读沙箱与 stdin 传参防止 shell 注入 |
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| code-review-and-quality（同仓库同作者） | 五维（正确性/可读性/架构/安全/性能）代码评审技能 | 面向已完成的代码变更做事后终审；本技能面向决策形成过程中的实时质疑，SKILL.md 原文明确写明二者互补关系 |
| second-opinion（trailofbits/skills） | 调用 Codex/Gemini 为代码变更提供独立复核意见 | 需配置 .mcp.json，专注代码 diff 层面；本技能覆盖范围更广（架构决策、断言、不熟悉代码的理解），跨模型仅为可选附加项而非核心机制 |
| differential-review（trailofbits/skills） | 把安全视角审查固化为风险分级方法论 | 专攻安全类 diff 审查；本技能是通用决策质疑框架，不限定安全场景 |
8. 用户评价
第三方评测网站 productize.life 在其“Addy Osmani Skills”系列评测文章中，将本技能列为该仓库全部技能中“四个特别值得关注”之一，原文形容其价值在于“长会话积累假设之后，生成一个从零开始、偏向证伪而非认可的新鲜复核者”。除此之外，暂未发现其他独立具名用户评价。
9. 其他补充
本技能与仓库内 source-driven-development（验证框架事实）、test-driven-development（失败测试即证伪尝试）、debugging-and-error-recovery（复核发现真实缺陷后的处理）三个技能有明确协作关系，SKILL.md 正文专节说明了彼此边界。
10. 安装使用方式
- 通用（推荐）：
npx skills add addyosmani/agent-skills --skill doubt-driven-development - Claude Code 插件市场：
/plugin marketplace add addyosmani/agent-skills后/plugin install agent-skills@addy-agent-skills（如遇 SSH 权限报错，改用 HTTPS 形式的仓库地址） - 本地开发：
git clone后claude --plugin-dir /path/to/agent-skills - 安装后无需重启，Agent 会依据 SKILL.md 中的
description自动判断何时触发；也可在做出非平凡决策前主动提示 Agent 使用本技能
11. 注意事项
- 不应加入某个 persona 的
skills:frontmatter——SKILL.md 明确警告这会导致嵌套子代理调用，是仓库文档中列出的编排反模式； - 跨模型复核（调用 Codex CLI / Gemini CLI）功能依赖用户本机已安装并配置好对应 CLI 工具，且每次调用都需要用户显式授权，非交互式场景（如 CI、定时任务）会自动跳过该功能；
- 该技能只对“非平凡决策”生效，文档本身提醒不要滥用到机械性操作（改名、格式化、单行改动）上，否则会拖慢交付节奏。