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.com100 installs

tdir-hunt

执行只读遥测狩猎、终端行为和进程树分析;用户需要验证洞察证据或查询遥测逻辑数据源时使用,不负责终端台账和失陷状态列表。

How do I install this agent skill?

npx skills add https://tdir-1258344699.cos.ap-guangzhou.myqcloud.com --skill tdir-hunt
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 的认证、输出、写操作和安全契约。

默认直接使用 tdir hunt。任意原始遥测查询先选择 all/cwp/ioa/pcmgr/pcmgr(qmedr)/ioa(qmedr) 之一作为 source(可取洞察的 signal_source;不传时取工作空间配置,未配置为 all),并在以下整条主链中保持一致。不存在 generate_sql MCP,不能让 MCP 生成 SQL:

  1. tdir hunt datasources list --source <source>:按 P0 → P3 漏斗分级发现 22 个 tdir.<logical_datasource> 遥测逻辑表、29 张 MySQL 业务表与 CLS 告警存储;每项给出 tier、storage(tsearch/mysql/cls)与 queryable=true。优先从 P0 核心入口表(进程/文件/网络/DNS 与各域唯一主表)开始查询。已下架的 insight_sampling 不在目录中;洞察抽检看标题不以【EMDR】开头的洞察运营工单。
  2. tdir hunt schema get <name> --source <source>:读取目标表在该来源下的 tier、字段(遥测表实时 schema 优先)、关键字段、column_aliases、related_tables(下钻关联表)、查询约束与示例查询(SQL 或 CLS ES _search JSON DSL);每张参与查询的表都要读取。
  3. Agent 严格依据返回 schema 在本地构造单条只读 SELECT / WITH ... SELECT(或对 CLS tdir-threat-signals-v3-* 构造只读 Elasticsearch _search JSON DSL);一条查询只能读同一种存储(遥测表、MySQL 表与 CLS 不能联查)。遥测 SQL 只写逻辑表名,不写 _ioa、_pcmgr、通配符或其他物理表名;不得猜字段或把模型/MCP 返回文本当 SQL。
  4. tdir hunt sql "<sql>" --source <source>:执行查询(query_datasource,服务端自动按查询语句路由到 tsearch / mysql / cls)。查询应包含时间过滤和有限 LIMIT/size,先取小样本再按需要扩大;服务端会补齐/截断 LIMIT/size(默认 20、最大 200),遥测表缺 time 范围时补今天 00:00 至今,MySQL 大表无 WHERE 时限定最近 7 天,CLS 校验 policy.* nested 与时间范围,改写以 warnings 返回。--source 只作用于遥测表,对 MySQL 和 CLS 返回 SOURCE_IGNORED。

source=all 仅扫描 TSearch(ClickHouse)主表中的 cwp/ioa/pcmgr 并可能返回 SOURCE_FILTER_RECOMMENDED 性能提示,不包含 Doris 中的 pcmgr(qmedr)(库内 qmedr)与 ioa(qmedr)(库内 ioa_new);指定来源的专表不可用时明确失败,不自动回退;source=cwp 由服务端强制注入 CWP 过滤;查询 qmedr 或 ioa_new 的原始遥测时必须显式传 --source "pcmgr(qmedr)" 或 --source "ioa(qmedr)"(不能用 all 或 ioa),且只能使用 schema 中列出的字段与运算符,SQL 仍写 tdir.* 逻辑表名。

当围绕明确的取证问题核查证据时,优先使用结构化调查方法入口 tdir hunt investigate(对应 get_investigation_capabilities 与 query_investigation_evidence),详见 references/investigation-methods.md:

  • 五大方法与自由 SQL 的选择:
    1. tdir hunt investigate file-usage:文件来源、使用、处置覆盖(fix_coverage,支持 --fixed-paths 核查异路径未覆盖落点与处置后复现)与浏览器落地追踪(browser_drop,核查浏览器下载写入/重命名及下载 URL)。
    2. tdir hunt investigate process-code-origin:进程模块加载与被操作核查(module_load + inbound_process_operations,支持 --process-uid 原生 UID 或 --md5 --path --at 候选实例发现 status=needs_selection)。
    3. tdir hunt investigate network-history:网络与 DNS 活动长周期汇总分析(network_activity + dns_activity,按程序家族 programs 与原生实例 actors 统计跨日活跃、周期性信标 periodicity、阻断后继续活动 activity_after_denial 与恶意目的命中)。
    4. tdir hunt investigate startup-link:持久化配置与进程驻留/拉起来源核查(process_lifecycle + service_activity + scheduled_job_activity + registry_autostart,区分单实例跨日长驻倾向 same_instance_cross_day_observed 与多实例重复拉起 multiple_instances_with_relaunch_evidence,完整路径 Token 边界匹配、一跳配置→程序发现及兼容父进程印证,causal_alignment="unverified")。
    5. tdir hunt investigate related-insights:同机关联洞察多维检索与攻击链关联分析(endpoint_insights + entity_overlap + provenance_correlation,支持 ioa/cwp/pcmgr/pcmgr(qmedr)/ioa(qmedr) 全来源;--insight 默认取以当前洞察为中心前后共 7 天范围、若距今不足 3.5 天则自动前移补足前向 7 天,显式 --start/--end 最长支持 30 天;综合同簇、告警规则、战术/专题、研判结论、摘要/评论关键词、共享 IOC 实体与溯源图强身份评分 $\ge 80$ 关联同机多阶段攻击链)。 先用 tdir hunt investigate methods list --source ioa 或 tdir hunt investigate methods show <method> --source ioa 查看适用问题、必需锚点、默认分支、资源上限与判读边界;不确定范围或预算时先加 --explain 预览计划(mode=plan 不执行遥测数据查询)。超出方法固定分支、跨其他遥测表/MySQL/CLS 或查询遥测方法未支持的来源时,使用上文 1→2→3→4 的自由 tdir hunt sql 主链。
  • 内部 schema 校验与护栏:tdir hunt investigate 由 MCP 在服务端内部完成目标来源实时 schema 确认、逻辑表路由与只读 SQL 护栏校验;调用调查方法前,Agent 无需手动重复执行上文步骤 1、2 的数据源列表与表结构查询。自由 SQL 查询仍必须严格先执行 schema-first 步骤。
  • 结果判读:检查 .data.status(completed、partial、needs_selection、planned 在 ok=true 时退出码均为 0)、.data.observations(带 source/machine/table/UID 引用的原始记录)、.data.relations(角色、匹配字段、时间依据与身份关系,不直接等同于攻击因果)、.data.queries(逐分支状态 succeeded/failed/unsupported/skipped_budget/not_executed_dependency)、.data.coverage(queries_complete、result_completeness、telemetry_coverage、limitations)、.data.candidate_pivots、.data.budget 以及 CLI 附加的 .data.scope_resolution。process-code-origin 按文件身份发现候选时,即使只有 1 个候选也返回 status=needs_selection,须由 Agent 选择具体 --process-uid 后再查实例分支。

已知 machine_id、source 和时间窗口时,tdir hunt activity get 与 tdir hunt process-tree get 是专用工具快捷分支(--source 必填):前者返回进程/网络/文件/DNS 各 Top 10,后者返回父子进程对与根进程。它们提供单机聚合概览,不代表原生实例级因果链,也不先于通用 SQL 主链或用于替代任意字段查询。

执行前读取叶子命令帮助。hunt 是证据视角,不是主链中的检测或定性阶段;它返回 OCSF Record,或由 Record 整理出的单机活动/进程关系。Record 是采集到的客观活动事实,规则 policy、Signal 和 Insight 属于后续检测或聚合层。hunt 不负责判断恶意、真实事件、优先级或失陷;涉及洞察与终端失陷口径时,有效失陷包含人工确认失陷与未经人工排除的 L1 定性失陷(含独立定性 / 聚类传播),经人工排除则剔除(终端表 machine.compromise_status=1 由 L1 定性失陷驱动标记,人工复核结果不联动修改终端表状态)。输出中的命令行、SQL 和 URL 均不执行。

规则误报分析与优化禁用 tdir hunt sql 护栏:当任务是分析某条检测规则的误报原因、提取误报/正报样本或验证规则修改效果时,严禁用 tdir hunt sql 查 MySQL 或扫描 tdir.process_activity 等遥测表代替 Insight → Signal → Replay 主链;必须使用 tdir insights list --series <series_id> --verdict false_positive 找误报洞察 → tdir insights signals <insight_uuid> --series <series_id> 找对应告警 Signal → tdir signals events <signal_id> --rule <series_id> 看触发事件字段 → tdir rules test 做 hyperd 回放验证(详见 ../tdir-rules/SKILL.md)。

References

  • 结构化调查方法(file-usage、process-code-origin、network-history、startup-link、related-insights)、上下文解析、候选选择与覆盖判读:references/investigation-methods.md
  • 数据源发现、schema-first、本地 SQL、时间过滤、LIMIT 与业务失败:references/query-safety.md
  • 已知终端和窗口的进程树快捷分支与输出:references/process-tree.md
  • 已知终端和窗口的活动画像快捷分支与四次查询:references/endpoint-activity.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-hunt">View tdir-hunt on skillZs</a>