用途：nerd-diagnose 用于在行为出错、异常或不一致时建立原因，并给出“已确认、可能、未知”的结论，本身不进行修复。资料说明不得与 Superpowers、Ponytail、Caveman 组合使用（除非请求明确要求），技能钩子、提及与间接指令不构成授权。
主要能力：一是诊断类型映射，将观察到的症状匹配到唯一最接近的一行，并在调查前加载其参考，例如确定错误输出、间歇性或抖动、崩溃或异常、挂起或超时、性能回归、状态或数据损坏、集成或 API 失败、构建/编译/类型失败、环境或配置不匹配、视觉或 UI 不匹配；独立症状分别诊断，一次只保持一个活动映射，映射只用于选择证据，不确立原因。二是技术栈映射，从仓库文件、运行时证据和失败边界检测栈，仅加载该边界所需参考，先一个栈，只有证据跨越真实集成边界时才加载第二个，覆盖 Kotlin、Java、Python、Ruby、TypeScript、JavaScript、Docker、Kubernetes、Terraform、Redis、MySQL、PostgreSQL、Go、Rust。三是框架映射，从依赖清单、生成产物、配置和运行时证据检测，与活动诊断类型及最小相关栈集配对，仅在跨集成边界时加载第二个框架，覆盖 Spring Boot、jOOQ、FastAPI、Ruby on Rails、Sidekiq、React、gRPC；框架指南是补充而非替代语言、运行时、数据库或基础设施指南。
使用方式：内部遵循其纪律：Focus 将已解析的 Focus Record 作为诊断边界，建议原因视为假设而非证据；Observe 捕获输入及预期与实际行为，尽量复现，否则保留证据缺口；Map 为活动症状选择一个诊断类型与最小相关栈和框架集，选择下一个非纠正、范围安全的诊断检查，可创建一次性本地缓存或构建输出，但不得修改源码、持久数据、基础设施或生产；Analyze 对比观察信号与活动假设，将原因分类为 Confirmed、Probable 或 Unknown；Diagnose 收集区分性证据并保持一个活动假设，Confirmed 需要直接因果证据，Probable 记录缺失的确认，Unknown 说明未解决的缺口。仅在系统性调试专长能实质性改善调查时使用 nerd-surgery，且必须保留 Diagnose 端点、不能修复。当前失败使用诊断模板，回顾性事件使用 RCA 模板，只加载匹配模板；用户明确格式优先，小型直接诊断无需模板。仅当用户请求、提供路径或既有仓库工作流要求时持久化产物。
限制：停在原因与证据处，不修复、不编辑、不执行纠正动作；不修改源码或持久产物、数据、基础设施。诊断命令在观察失败所需时可创建一次性本地缓存或构建输出。修复前需通过 Smart 确认 Execute 端点。