Observability Engineer 是一个用于实施可观测性改造的技能，目标是在批准的范围内交付能回答具体诊断问题的观测能力，并控制成本与暴露面。它要求把插桩和管道的改动限制在既定范围内，实际部署采集器属于另外的独立工作。
用途与边界：该技能负责发出诊断事件及其投递属性。错误处理的公共语义、持久化变更状态的业务结果属于其他负责方；尽力而为的运维日志不等于可审计的持久账本。事故调查会消费遥测数据，但不应修改生产者。审计账本类需求需要按批准的记录内容、访问、保留、完整性和失败行为要求另行实施，不能以日志默认值代替。审查和解释类请求为只读；准备工作不等于授权远程发布、部署或修改共享状态。
执行契约：技能要求把清单每一项标记为 PENDING（待办）、PROVEN（有观察到的结果证据）、CLEARED（有证据表明条件不存在）或 UNPROVEN（有缺口）。读取文件、委派任务、工具失败、零退出码和自报成功都不算证明。每完成一节后核对，返回前解决所有 PENDING，只统计 PROVEN 和 CLEARED，并对每个缺口套用结论与批准规则。要保持原有意图、范围、模式和已有授权；在需要外部批准前先完成已授权工作，只就重大未决选择提问；无人可答时报告具体问题并按技能缺口结论处理，不等待、不猜测。不得虚构审批关卡。深度随实质风险调整，同时保留强制检查、依赖和安全顺序。
证据与版本：接受等价用户或仓库证据，不要求另一个技能或命名产物。复用证据需绑定到相关版本、未提交改动、配置、环境和观察窗口，只作废受影响的主张。做技术决策前先确认适用性和实际版本，用官方文档或规范核实版本相关假设；片段不算证据，当前外部建议需读一手页面。无法取得的证据标为 UNVERIFIED，仅阻塞必要的依赖工作。优先使用原生机制，新增工具或抽象需有证据支撑。
工具路由：实际技术栈和负责方优先从说明文件、清单、锁文件、定向源码与配置读取及 Git 状态获取；外部语义以版本匹配的官方文档、规范和维护中的上游源码为准；授权改动优先用项目原生编辑器、配置与运行时工具，否则用最小范围补丁，无安全变更能力时标为 BLOCKED；可观察验证用现有检查与隔离的运行时或消费者演练，无法建立关键行为时标为 BLOCKED。
检查清单分三步。第一，定义诊断需求：识别操作者、失败问题、入口点、运行时版本、现有信号负责方和采集路径；把每个事件或信号映射到诊断问题和合适级别，去除逐层重复发出和无依据噪音；分类敏感度、保留与访问需求和投递保证，区分运维诊断与持久审计记录。第二，为负责方插桩：使用原生结构化日志和现有采集器，新后端、追踪或直接耦合采集器需有证据；包含稳定事件标识、时间、级别、服务与环境以及有用的请求、操作或发布关联，避免多个 ID 负责方竞争；脱敏密钥和敏感载荷，净化不可信字段，按实际传输约束限制记录与堆栈细节；在负责边界只发一次终结错误，保留有用上下文，不把预期控制流当异常；仅在结果确立后发出持久生命周期声明，区分已尝试、已提交、已失败和未知结果；高基数标识不放入指标维度或索引标签，按实际诊断与成本需要选择保留和采样；只为未回答的诊断问题添加指标或追踪，用受支持机制跨实际异步或进程边界传播上下文；按投递要求处理采集器中断和插桩失败，普通诊断失败不得静默改变产品结果。第三，验证效用：从生产者经可用采集边界演练成功、拒绝和失败路径；用合成金丝雀检查实际输出中的脱敏、级别、重复事件、关联和限额；在重要时演练采集不可用或缓冲区满，区分已验证的发出、远端摄取和审计持久性；把最终改动与受保护行为、规范负责方和观察到的检查核对，在授权改动内更新受影响的指引并报告剩余缺口。
结论类型：DELIVERED 表示请求的限定改动保留且具备全部所需行为证据；PARTIAL 表示保留了独立安全的已验证子集，未解决要求已列明；NO_CHANGE 表示证据显示请求结果已成立且无需编辑，不作为缺检查的兜底；PASS、CONCERNS、FAIL 分别用于只读评估中无实质问题、有受限的非阻塞问题、有证据支撑的必需修正；BLOCKED 表示关键意图书、授权、安全能力或证据不可得，需报告实际保留或恢复的状态。技能还要求返回前自查证据、需求覆盖、矛盾、范围、结论和清理，复用有效证据，不自动重扫仓库或重跑成功命令，并披露剩余缺口。
输出约定：用用户语言按 Result、Scope、Evidence、Verification、Completion 五个字段顺序报告，每个事实只说一次，使用受控平实语言，每句通常不超过 20 词，主动语态，每个概念一个术语，结论、ID 和状态不得使用同义词。小型结果每个字段一行即可，省略空表，不复制链接产物。Evidence 需区分事实、推断和未验证主张；Completion 需给出清单完成数 X/Y，以及未证明项的原因、结果影响和确切下一步，并列出残余风险与所需决策。技能特定的证据字段包括诊断问题、事件与级别负责方、关联标识、脱敏与成本决策、观察到的安全样本、投递保证和不可用的管道证据。
适用场景：为已有服务补充结构化日志、为排障问题设计关联标识、评估指标与追踪是否必要、检查敏感信息脱敏和日志成本控制、验证采集边界行为。限制：不执行事故调查，不替代错误处理或业务账本设计，不授权部署或发布，也不强制指定遥测平台。