Agent Observability
使用本 skill 帮用户安装、部署、验证和排障 Agent Observability 运行态插件。
重要边界：本 skill 提供安装/部署/诊断工作流，并在 assets/plugin-runtime/ 内附带一份精简运行态插件本体。真正运行时仍按 Hook 插件形式部署到目标项目的 plugins/agent-observability，包括 src/、hooks/、.codex-plugin/、config.env 和 .aobs 输出。
先读哪份参考
- 做安装或部署时，先读 references/runtime-plugin.md。
- 用户要一段可交给 AI 代理执行的安装提示词时，读 references/install-deploy-prompt.md。
- 排查没有数据、hook 失败、远程导出失败时，读 references/diagnostics.md。
核心流程
- 定位运行态插件目录。优先识别包含
package.json、src/index.ts、hooks/、.codex-plugin/plugin.json的现有目录；若目标项目没有运行态插件，从本 skill 的assets/plugin-runtime/复制到目标项目plugins/agent-observability/。 - 确认目标 Agent：Codex、CodeBuddy，或两者。用户未说明时，按当前环境判断；无法判断再问一个简短问题。
- 安装依赖并准备配置。
config.env只放运行时配置和密钥，缺失时从config.env.example复制。 - 接入 hook：Codex 走
.codex-plugin/plugin.json/hooks/codex-hooks.json；CodeBuddy 合并hooks/codebuddy-hooks.json到目标项目.codebuddy/settings.json。 - Codex 接入后必须验证 Codex 自身门禁：
features.hooks已启用，且/hooks或hooks/list中所有 AOBS hook 为trusted。不要复用旧trusted_hash；hook 命令变化后 hash 会变。 - 跑验证：
npm test、入口 smoke test、触发一次 Agent 对话后检查.aobs/exports。 - 汇报插件目录、接入对象、执行命令结果、输出文件是否生成，以及失败时的最小修复建议。
必守规则
- 不把密钥、token、DSN 写进代码或回复中。
- 不把
SKILL.md当作运行时代码；运行态只复制/部署assets/plugin-runtime/或已有插件目录。 - 不手改
.aobs事实输出；只读它们做验证和诊断。 - Hook 必须 fail-open：采集失败不能阻断用户正常 Agent 会话。
- 优先做最小接入和可验证闭环，再考虑 Langfuse、CLS、OTLP 等远程导出。
