用途
Manifest 技能用于为 AI 智能体安装并配置 Manifest 可观测性插件，帮助用户将智能体接入 Manifest 平台进行监控与遥测。当用户需要为智能体设置可观测性或遥测、将智能体连接到 Manifest 进行监控、配置 Manifest API 密钥或自定义端点、排查 Manifest 插件连接问题，或验证 Manifest 插件是否正在运行时，可使用本技能。
本技能不适用于以下情况：需要通用可观测性设计（应改用 observability-engineer）、需要构建自定义仪表盘或告警规则、或用户并未使用 Manifest 平台。
主要能力
- 安装 Manifest 可观测性插件
- 配置 Manifest API 密钥
- 配置自定义端点（默认端点为 https://app.manifest.build/api/v1/otlp）
- 启动网关并验证插件运行状态
- 提供常见错误的排查方法
使用方式
配置流程需按顺序执行，不可跳过步骤。
第 1 步 — 停止网关
先停止网关，以避免配置期间出现热重载问题。
claude gateway stop
第 2 步 — 安装插件
claude plugins install manifest
如果失败，请检查 CLI 是否已安装并可在 PATH 中使用。
第 3 步 — 获取 API 密钥
向用户说明：要连接智能体，需要一个 Manifest API 密钥。获取方式如下：
- 前往 https://app.manifest.build 创建账户（或登录）
- 登录后点击 "Connect Agent" 创建新智能体
- 复制以 mnfst_ 开头的 API 密钥
- 将其粘贴到此处
等待用户提供以 mnfst_ 开头的密钥。如果密钥格式不匹配，告知用户格式看起来不正确，并请其重试。
第 4 步 — 配置插件
claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY"
将 USER_API_KEY 替换为用户提供的实际密钥。
询问用户是否有自定义端点。如果没有，将自动使用默认端点（https://app.manifest.build/api/v1/otlp）。如果有：
claude config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT"
第 5 步 — 启动网关
claude gateway install
第 6 步 — 验证
等待 3 秒让网关完全启动，然后检查日志：
grep "manifest" ~/.claude/logs/gateway.log | tail -5
查找：
[manifest] Observability pipeline active
如果出现该信息，告知用户配置完成。如果没有出现，请检查错误信息并进行排查。
安全注意事项
- 配置完成后，切勿以明文记录或回显 API 密钥
- 在写入配置前验证密钥格式（mnfst_ 前缀）
排查
| 错误 | 修复方法 |
|---|---|
| Missing apiKey | 重新执行第 4 步 |
| Invalid apiKey format | 密钥必须以 mnfst_ 开头 |
| Connection refused | 端点不可达。检查 URL 或询问用户是否自托管 |
| Duplicate OTel registration | 禁用冲突的内置插件：claude plugins disable diagnostics-otel |
示例
示例 1：基础配置
Use @manifest to set up observability for my agent.
示例 2：自定义端点
Use @manifest to connect my agent to my self-hosted Manifest instance at https://manifest.internal.company.com/api/v1/otlp
最佳实践
- 在进行配置更改前，始终先停止网关
- 默认端点适用于大多数用户——仅在自托管时才更改
- API 密钥始终以 mnfst_ 开头——任何其他格式均无效
- 调试任何插件问题时，首先检查网关日志
限制
- 仅在任务明确符合上述范围时使用本技能
- 不要将输出视为环境特定验证、测试或专家审查的替代品
- 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清