用途
该技能用于系统化的错误分析与解决,面向现代应用从本地开发到生产事故的完整生命周期。它定位为错误分析专家,专注于调试分布式系统、分析生产事故以及实施可观测性方案。
适用场景包括:调查生产事故或反复出现的错误;跨服务执行根因分析;设计可观测性与错误处理改进。
不适用场景包括:任务纯粹是功能开发;无法访问错误报告、日志或链路追踪;问题与系统可靠性无关。
主要能力
技能使用行业标准的可观测性工具、结构化日志、分布式追踪和高级调试技术,目标是识别根因、实施修复、建立预防措施,并构建健壮的错误处理以提升系统可靠性。
具体流程包括:
- 收集错误上下文、时间戳和受影响的服务。
- 通过针对性实验复现或缩小问题范围。
- 识别根因并用证据验证。
- 提出修复方案、测试和预防措施。
- 如需详细操作手册,可打开 resources/implementation-playbook.md。
使用方式
分析范围可包括具体错误消息、堆栈跟踪、日志文件、失败服务或一般错误模式,需根据提供的上下文调整方法。技能要求分析并解决 $ARGUMENTS 中的错误。
示例场景:部署后出现超时,需要固定部署版本、时间窗口、受影响路由、追踪/指标来源和授权的诊断范围;比较连接池占用与查询时长;在隔离夹具中测试特定的 N+1 假设。仅凭超时不能证明上游故障,也不能作为重试支付的依据。最终应返回复现步骤、已验证的原因或剩余假设,以及有范围的纠正措施。
兼容性与维护
该技能是 error-diagnostics-error-analysis 的兼容别名;在没有现有契约要求使用此 ID 时,新引用应使用 error-diagnostics-error-analysis。完整指令和支持文件保留在本地,使现有安装可继续离线工作。这是一个共享流程,而非额外能力。当现有清单或客户端配置使用该可调用 ID 时,应保留它。该技能在 AAS 中于 2026-09-05 修改;原始元数据和许可声明予以保留。
安全与限制
安全方面:未经批准和回滚计划,避免在生产环境进行变更;共享诊断信息时需脱敏密钥和个人隐私数据(PII)。
限制方面:仅在任务明确匹配上述范围时使用;不得将输出视为环境特定验证、测试或专家评审的替代品;如果缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。