security-observability
Installation
SKILL.md
Security Observability
通过 agent-sec-cli 查询本地 SQLite 中的安全事件,并将事件与 Agent 会话关联起来。此 Skill 只执行只读查询,不负责写入 observability 数据。
查询流程
- 先用
events --summary或events --count-by获取概览。 - 根据
event_type、category、关联 ID 和时间范围缩小查询。 - 需要程序解析时使用
--output json或--output jsonl,不要解析 table 或 summary 文本。 - 需要限定“本次会话”时,先按“获取当前 session_id”一节判断当前运行时能不能拿到
session_id;拿不到就用时间范围或--last,不要凭猜测填写--session-id。 - 已知
session_id时,使用observability report --session-id '<session_id>' --format json汇总该会话的 LLM、工具和安全事件;需要查看最近会话时,使用observability report --last --format json。 - 在给出任何安全结论前,按“风险审查”一节完成判定字段聚合。这是强制步骤,不可跳过。
- 向用户报告必要结论即可。
details可能包含命令、扫描证据或后端诊断信息,不要无必要地完整回显。
参数取值约束
本文命令中的 <session_id>、<run_id>、<trace_id>、<event_id> 是 Agent 运行时或 CLI 持久化的 correlation ID,不一定是 UUID;OpenClaw、Codex、Qwen Code 等运行时可能使用 session-001、thread_xxx 这类非 UUID 标识。替换占位符前必须先校验取值形态,仅当它非空、长度不超过 256 字符,并且完全匹配 ^[A-Za-z0-9][A-Za-z0-9._:@+=,/-]{0,255}$ 时才能拼入命令。
例外:如果取值来自 cosh-ng runtime_context.provider_session_id,它应当是 UUID,必须继续按 ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ 校验。