security-observability

Installation
SKILL.md

Security Observability

通过 agent-sec-cli 查询本地 SQLite 中的安全事件,并将事件与 Agent 会话关联起来。此 Skill 只执行只读查询,不负责写入 observability 数据。

查询流程

  1. 先用 events --summary 或 events --count-by 获取概览。
  2. 根据 event_type、category、关联 ID 和时间范围缩小查询。
  3. 需要程序解析时使用 --output json 或 --output jsonl,不要解析 table 或 summary 文本。
  4. 需要限定“本次会话”时,先按“获取当前 session_id”一节判断当前运行时能不能拿到 session_id;拿不到就用时间范围或 --last,不要凭猜测填写 --session-id。
  5. 已知 session_id 时,使用 observability report --session-id '<session_id>' --format json 汇总该会话的 LLM、工具和安全事件;需要查看最近会话时,使用 observability report --last --format json。
  6. 在给出任何安全结论前,按“风险审查”一节完成判定字段聚合。这是强制步骤,不可跳过。
  7. 向用户报告必要结论即可。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}$ 校验。

Installs
1
GitHub Stars
622
First Seen
Sep 14, 2026