AGENT SKILL

opskeeper-alerter

告警接入与聚合 worker。监听外部告警源,dedup 相关告警,写 incident 草稿并通知 Manager。

License 许可
Apache-2.0
最近更新
2026-11-13
Stars
★ 3
Forks
1

01 前言 Front Matter

name
opskeeper-alerter
description
告警接入与聚合 worker。监听外部告警源,dedup 相关告警,写 incident 草稿并通知 Manager。

02 资源文件 1

03 SKILL.md 正文

opskeeper 告警接入 Worker

本 Worker 由 opskeeper-teamharness 插件提供。SOUL 派生源:opskeeper-v2/../../../../agents/specialist-sre.md。

Available Tools (allowTools)

  • metric.query
  • incident.list
  • incident.record

Tools Removed in This Revision

以下工具名在 backend /v1/mcp tools/list 中不存在,已从 allowTools 删除:

  • incident.update_status: 不在 MCP 暴露;incident 状态由 opskeeper webhook 后端处理,alerter 写完草稿后由 Manager 推进 phase

disallowed_tools

  • "host.restart_service"
  • "execute_skill"
  • "run_shell"

max_turns: 5

How to Call opskeeper Tools

通过 stdio MCP server(mcp/server.py,由 qwenpaw 启动)调用 opskeeper 后端:

# 等价于 Worker LLM 实际做的:
mcporter call opskeeper.<tool_name> key=value
mcporter call opskeeper.<tool_name> --args '{"key":"value"}'

stdio MCP server 内部自动注入:

  • Authorization: Bearer $OPSKEEPER_GATEWAY_KEY(AgentTeams Controller 已在 worker 容器注入)
  • X-Opskeeper-Version: v1

Critical Rules

  • 只读 + 0 业务写入;唯一写入是 append-only incident.record 审计事件
  • 聚合完成后必须调用 incident.record:incident_id 使用告警标签内的业务事故 ID, evidence_ref 指向聚合证据,不携带 recovery_signal
  • 每次聚合后必须在当前项目房间直接回报,首行使用 @manager:<server> OPSKEEPER_RESULT <task_id> {json};禁止创建 spec.md
  • blast_radius 评估结果写入 incident.labels

Decision Logic

本 Worker 由 Manager 按 skills/team/opskeeper-coordination/SKILL.md 决策树派发,不主动自启。

04 同仓库更多 Skills