skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
tdir-1258344699.cos.ap-guangzhou.myqcloud.com99 installs

tdir-insights

快速了解威胁洞察的默认入口:查询威胁洞察候选对象(含 topic=endpoint_agent_threat 的终端智能体威胁洞察)及其已有研判结论、报告、告警、规则、实体、溯源与工单,并在用户明确确认后写回人工研判结论;用户查看或了解洞察事件时默认使用(仅拉取平台已有洞察、终端与 AI 研判结论信息),不负责默认拉取证据包深挖搜证,不把洞察天然定性为真实事件,也不代替用户确认写入。

How do I install this agent skill?

npx skills add https://tdir-1258344699.cos.ap-guangzhou.myqcloud.com --skill tdir-insights
view source ↗

Is this agent skill safe to install?

No partner audit is available yet. Read the source before installing.

What does this agent skill do?

TDIR 威胁洞察

执行时遵守 ../tdir-shared/SKILL.md 的认证、输出、写操作和安全契约。本 Skill 是快速了解洞察的默认入口;按需深入调查与挑战性复核见 ../tdir-insight-review/SKILL.md,业务写回及工单跟进流程见 ../tdir-insight-response/SKILL.md。

三层渐进式入口:快速了解(默认) → 初步调查(免取包) → 深入调查(拉取证据包)

  • 1. 快速了解(默认入口,仅读 MySQL 已有数据):运营人员给出洞察 ID 或工单 ID,询问“看看这个洞察/工单”、“告诉我终端发生了什么”、“发生了什么事件”、“给出事件描述和研判结论”(未提出调查/狩猎要求)时,默认只拉取平台 MySQL 已有信息:
    1. 若从工单进入,先用 tdir tickets get <ticket_id> 获取 insight_uuids[];
    2. 执行 tdir insights get <uuid>(获取洞察摘要、ai_summary、当前 AI/人工研判结论 .verdict 与关联工单)与 tdir insights report <uuid> --kind l1(直接从 MySQL 读取 L1 研判报告;若当前洞察为聚类关联成员且自身无独立报告,工具会自动返回定性来源洞察 source_insight_uuid 的源头报告,并附带 is_source_report=true、report_scope_note 与 SOURCE_INSIGHT_REPORT 警告),按需加 tdir endpoints get <machine_id> --source <source> --platform <platform> 获取终端基本信息与失陷状态;
    3. 按标准结构组织输出并立即止步:
      • TL;DR(一句话判断):置顶 1–2 句话概括“哪个终端在什么时间由什么进程触发了什么关键动作 → 当前定性结论(如真实事件/误报)与失陷状态 → 核心定性依据(若为聚类传播或源头报告,明确点出)”;
      • 事件与终端概况表:用“字段 / 内容”小表列出终端 machine_id(来源/平台/租户类型/当前失陷状态)、洞察 insight_uuid(工单号、聚类角色与定性来源 source_insight_uuid)、告警时间窗、命中规则(alert_names)与战术;
      • 事件经过与行为主链(文本树 / Mermaid):串联关键进程调用链、动作与结果;若 insights report 返回 is_source_report=true,必须在正文中明确说明“该详细报告来自定性来源洞察 <source_insight_uuid>,反映的是源头事件当时的研判分析,非当前终端本次事件的独立报告”,并将本洞察自身的 ai_summary 与源头报告背景区分展示;
      • 研判结论与下一步建议:展示生效结论(verdict / is_compromised)、AI/人工结论及核心依据,最后给出 1–2 个按需进入“初步调查(免取包在线核查)”或“深入调查(拉取证据包)”的可选方向;此阶段不下载冻结证据包,不调用 tdir hunt 查遥测,不查外部情报。
  • 2. 初步调查(常规调查默认,不拉取证据包):当运营人员要求“调查/分析/核查一下这个洞察”、“查一下某个文件/进程/外联/告警/同机关联”或针对快速了解后的疑点追问,但未明确要求下载证据包或全量深挖时,默认不拉取冻结证据包,直接基于已有在线查询与狩猎工具(tdir insights signals/rules/entities/provenance/risk-paths/trajectory <uuid>、tdir hunt investigate file-usage|process-code-origin|network-history|startup-link|related-insights、tdir hunt sql、tdir intel lookup)快速核查,并按“TL;DR(一句话判断) → 调查概要 → 攻击图谱 → 关键对象与在线核查发现表 → 初步结论与剩余缺口”组织输出。
  • 3. 深入调查(拉取证据包到本地深入分析):只有当运营人员明确要求深入调查、拉取证据包分析、全面挑战性复核 L1 结论或输出完整深度调查报告(或初步调查发现必须核对 L1 冻结原始记录)时,才进入 ../tdir-insight-review/SKILL.md 的深入调查层:在 IOA 且已有 L1 结论时执行 tdir insights evidence download <uuid> [--report-id <id>] --output-dir <dir> 整包下载 AI 研判证据(若当前成员无独立证据包,CLI 会自动解析并下载 source_insight_uuid 的源头证据包并标记 is_source_evidence=true),逐项审查 case.json、evidence.json、records.jsonl 并结合 tdir hunt investigate 补足缺口,生成完整人工定性(L2)报告。平台报告与补查证据不等同于 L1(AI/Agent 研判)当时的完整输入;平台写回与工单跟进交给 ../tdir-insight-response/SKILL.md。
  • 独立只读工具可并行,遵守公共依赖与逐项结果检查契约。只要客户摘要或处置建议时由 response 起草;单点追问复用已有证据,不重复整套调查或默认写回。

Insight 是 Signal 经单机关联聚图形成的威胁洞察候选对象,随后才进入语义聚类、定性以及符合条件的高优/深度调查与报告路径;物理聚图、语义聚类和定性是不同阶段。Insight 不天然是真实事件:有效 verdict=incident(宽表 review_result)才表达真实事件定性;“已失陷真实事件”还必须同时满足 is_compromised=compromised。

  • 失陷统计与归属口径:有效失陷包含人工确认失陷(human_verdict=incident)与未经人工排除的 L1 定性失陷(human_verdict 为空,含 L1 独立定性 llm_finished 与相似聚类传播 llm_auto_reviewed),经人工排除的记录不计入;终端台账 machine.compromise_status=1(tdir endpoints get 的 compromise.status)由 L1 定性失陷驱动标记,人工复核结果不联动修改终端表状态。汇报时需标明该失陷属于“人工确认失陷”或“L1 定性失陷(独立定性 / 聚类传播)”。

topic 是单值专题字段:endpoint_agent_threat 表示终端智能体威胁洞察;NULL 表示未归入专题。查询该类洞察时必须使用 tdir insights list --topic endpoint_agent_threat 等值过滤,不得用标题、摘要或 --q 关键词模糊匹配代替。

默认直接使用 tdir insights,并先读取目标叶子命令帮助。

  • 待办:tdir insights queue(近 7 天创建、未完成的洞察运营工单。标题以【EMDR】开头的是 EMDR 工单,其余都是抽检工单;EMDR 在前、抽检在后,同类内按创建时间正序。抽检不查 insight_sampling)。
  • 列表/聚合:tdir insights list [machine_id],按 --time-field(默认 alert_start_time)分页,可按 --series <rule_series_id>、--version <rule_version_id>、--verdict(含 none)、--ai-verdict、--human-verdict(含 none)、--compromised、--tenant-kind、--risk-min、--score-min、--topic、--agent-tag <workbuddy|codebuddy|codex|claudecode>、--q 过滤;--group-by machine_id 按终端聚合。JSON 每项的结论与摘要字段名为 verdict、ai_verdict、human_verdict、ai_summary、reviewed_at、agent_tags(在 --jq 中使用这些字段名,而非数据库物理列名 review_result / ai_review_result / human_review_result / llm_summary);ai_summary 以 <关联历史洞察AI研判> 开头表示该洞察已通过同簇历史洞察关联完成了 AI 自动研判传播(review_status=llm_auto_reviewed,ai_verdict 已定性)。
  • 快速了解与分诊(默认入口):tdir insights get <insight_uuid> 同时返回基本信息(含 agent_tags)、当前 AI/人工研判结论与关联工单;配合 tdir endpoints get <machine_id> --source <source> --platform <platform> 快速查看终端状态,不下载证据包也不执行遥测搜证。
  • 平台现成材料:tdir insights report|signals|rules|entities|provenance|risk-paths|trajectory <insight_uuid>(其中 tdir insights trajectory <insight_uuid> 支持 --status 仅看关联状态与规模,或 --session <session_id> 查看已绑定智能体会话的对话消息、工具调用及关联终端行为/命中告警;tdir insights signals <insight_uuid> 支持 --series <rule_series_id> / --version <rule_version_id> 仅过滤命中目标规则的告警);规则原文转 tdir rules get --version <id>;深入调查时再用 tdir insights evidence download <insight_uuid> --output-dir <dir> 按需下载 AI 研判证据包。
  • 结论:tdir insights verdict get <insight_uuid> 查看共享/AI/人工结论、结构化详情与写回版本。
  • 写回:tdir insights verdict update <insight_uuid> 写回人工研判结论。必须先 --dry-run,向用户展示待提交的 4 项参数(--verdict、失陷标记、--comment、--detail JSON)、目标洞察与绑定 version(及必要的 side_effects 与 warnings),不提交或展示 review_status、ops_status 等服务端内部状态字段;用户在当前对话中明确确认后才加 --yes 写入,写入后用 verdict get 回查;格式与确认规则见 references/verdict-status-and-metrics.md。
  • 工单:tdir insights tickets <insight_uuid> 查看关联运营工单。

References

  • 搜索、待办队列与聚合:references/insight-search.md
  • 详情、报告、溯源与风险路径:references/insight-detail-and-provenance.md
  • 告警、规则、实体、工单与报告表的关联:references/insight-relations.md
  • 新增/历史洞察、embedding cluster、物理合并与更新重判:references/lifecycle-clustering-and-updates.md
  • L1/传播/人工定性、完整状态值域、评分语义与人工研判写回:references/verdict-status-and-metrics.md

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/tdir-1258344699.cos.ap-guangzhou.myqcloud.com/tdir-insights">View tdir-insights on skillZs</a>