用途：在改动凭据、权限、代码或计算资源之前，先对 Palantir Foundry 的失败面进行分诊，避免把外观相似的失败归为同一原因。
主要能力：将失败归类为认证、授权、限流/并发、资源标识、依赖、transform 逻辑或平台可用性；保留最小完整证据集（请求 ID、构建 ID、分支、提交、主体类型、scope 名称、受影响 RID 或 API 名称）；按顺序评估令牌有效性、scope、应用限制、项目角色与强制标记；对 429/503 采用有界指数退避并降低并发；对构建失败检查详细报告、对比预览与全量输入，并在沙箱分支测试最小失败 transform。
使用方式：先捕获确切状态码或 Foundry 错误名、请求标识、时间戳、端点或构建、受影响主体；确认调用使用临时用户令牌、授权码令牌还是客户端凭据服务用户；阅读 references/official-docs.md，以 API 参考和平台内构建报告为当前契约；尽量用只读请求或沙箱分支复现。工具使用上，用 Glob 定位仓库与配置，用 Grep 查找标识符与错误，用 Read 查看最小必要文件，Write 仅用于新建获批草稿，Edit 仅用于有已知回滚的有界改动。
适用场景：Ontology 读取从 200 变为 403、transform 检查反复失败、限流加剧等排查。
限制：权限授予、应用限制变更、标记访问、令牌替换与生产重建需各自负责人批准，诊断本身不授权这些变更；不得打印或持久化令牌；预览通过不代表生产构建成功；未解决的厂商行为变化应视为停止条件。输出为分诊记录，含分类、证据、排除原因、确认原因、最小修复、审批负责人、验证请求与回滚。