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-insightsIs 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 已有信息:
- 若从工单进入,先用
tdir tickets get <ticket_id>获取insight_uuids[]; - 执行
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>获取终端基本信息与失陷状态; - 按标准结构组织输出并立即止步:
- 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、--detailJSON)、目标洞察与绑定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
How can the creator link this skill?
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>