SuperAPI AI 工具集

oodle-o11y-context

部署与运维

查看项目

更新于 10-16 02:39

技能介绍

用途:该技能只定义一件事——O11y Change Context 清单,即作者代理写入 PR 描述中的结构化块,作为可观测性闭环的连接组织:左侧评审技能 oodle-o11y-review 会补充它,右侧分诊技能 oodle-triage 在告警触发时读取它。它本身不包含埋点方法,而是另两个技能引用的共享契约。

主要能力:清单块包含字段 type(变更性质,如 bugfix、perf、feature、critical-path、refactor、infra)、touches(变更的部署/服务单元)、telemetry(新增 +、变更 ~、移除 - 的信号及简短用途)、guarded-by(覆盖被改代码的现有告警/SLO)、watch(部署后需关注的风险假设)、gaps(有意未添加的遥测)。字段由作者与评审分别填写,评审可从后端解析 guarded-by 并追加 gaps,必要时将 type 升级为 critical-path。

使用方式:在 PR 描述中放入以 ## O11y Change Context 为标题的围栏块,保持标题与字段键原样,供下游代理按此形状定位解析。telemetry 行以 +、~、- 开头,后接信号与用途。仅在变更涉及埋点或服务代码,或类型为 perf、critical-path、bugfix 时写入;纯文档、配置外观等琐碎变更应跳过。v1 中清单仅存于 PR 描述,分诊时通过 GitHub 或 Linear MCP 读回,无 GitHub MCP 时用 gh CLI(gh pr list、gh pr view)。

限制:## O11y Change Context 标题与字段键是解析契约,不得重命名或调整顺序;新增可选字段安全,重命名现有字段属破坏性变更。持久化 git commit trailer 与仓库内清单文件被有意推迟。字段无内容时可省略,但不得改名。资料未提供收费、价格或平台支持等更多信息。