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-rules

检测规则目录与全库盘点分布(rules list --summary)、Sigma 原文(rules get)、版本历史与迭代前后检出对比(rules versions)、白名单查询(rules whitelists)与白名单草稿创建/删除(rules whitelists draft,加白)、告警命中趋势与异动(rules trend)、关联洞察研判结论与误报率统计(rules verdicts),校验规则并管理离线草稿(draft),以及通过 rules ops 调用 RuleAgent(规则自动优化战役/任务/报告/规则审核工单)与评测平台(评测周期/引擎检出与误报率/POC 样本结果/评测工单);不负责直接修改线上生效版本、启停规则或发布上线。

How do I install this agent skill?

npx skills add https://tdir-1258344699.cos.ap-guangzhou.myqcloud.com --skill tdir-rules
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 rules,先读取目标叶子命令 --help。

1. 领域模型与全局不变量

  • 版本集与状态生效铁律:series_id 标识规则或白名单版本集,version_id 标识其中一个具体版本。忽略历史遗留的 status 字段(experimental/test/stable 无业务意义);仅看 version_status(newest/old/draft)与 is_enable(ON/OFF),永远只有 version_status = 'newest' AND is_enable = 'ON' 在线上生效。
  • 当前指标 vs 历史迭代口径:历史 signal 与 insight 仍绑定触发当时的旧 version_id。评估当前线上规则总量、检出量或误报率时,必须只统计 newest + ON(tdir rules list --summary、tdir rules verdicts 默认、tdir rules trend --newest-only),严禁混入已下线 old 版本导致指标虚高;只有分析“版本迭代前后效果对比”时才比较同一系列的 old 与 newest。
  • 禁用 SQL 绕行:查规则原文、全库盘点、白名单、误报样本与回放效果时,必须走 tdir rules / tdir insights / tdir signals 专用命令,严禁用 tdir hunt sql 查 rules/rule_whitelists 或扫 tdir.process_activity 计数代替回放。
  • 写操作边界:CLI 只写 version_status = 'draft' 的离线规则草稿与白名单草稿(发布、启停在控制台完成)。所有写操作必须先 --dry-run 预览,在当前对话取得用户明确确认后才加 --yes 执行。
  • 汇报链接规范:汇报规则、版本迭代或草稿时,必须附上 series_id、version_id 及控制台链接:
    • 按系列:https://tdir.woa.com/page/rule_management?series_id=<series_id>
    • 按版本:https://tdir.woa.com/page/rule_management?version_id=<version_id>

2. 意图路由与渐进披露

任务意图首选命令入口按需深读 Reference / Playbook
全库盘点与目录检索(总量、引擎/平台分布、按条件或 ID 查规则)tdir rules list --summary<br>tdir rules list [--keyword ... --enabled ON]references/rule-lookup.md
读取 Sigma 原文与解释命中逻辑(含同时获取 old/newest/draft)tdir rules get --version <id>(推荐)或 --series <id><br>洞察命中规则:tdir insights rules <insight_uuid>references/rule-explanation.md
检出趋势、异动排行与误报率统计tdir rules trend [--last 7d] [--newest-only]<br>tdir rules verdicts [--summary] [--verdict-by effective|human|ai]口径未指定时先向用户确认 human(L2)/ ai(L1)/ effective;详见 references/rule-lookup.md
版本迭代检出变化 / 归零原因分析tdir rules versions --last 30d --enabled ON → tdir rules get --version <prev_version_id>见下方「工作流 A」与 references/rule-explanation.md
规则误报收敛、回放验证与草稿提交Rule → Insight → Signal → Events → tdir rules test → draft create见下方「工作流 B」与 references/rule-lookup.md(含 YAML / header_filter 模板)
白名单排查与加白草稿(whitelists)tdir rules whitelists [--series <id>] [--tenant <uid>]<br>tdir rules whitelists draft create|delete见下方「工作流 C」与 references/rule-lookup.md
RuleAgent 规则自动优化与审核工单(【RuleAgent规则审核】、战役、报告、二次改草稿)tdir rules ops rule-agent <missions|tasks|tickets|publishes>先读 references/rule-agent-ops.md;细则按需跑 tdir rules ops skills read rule-agent [missions|tasks|tickets|publishes]
评测平台运营与样本漏误报分析(Win11 引擎指标、评测工单对账、黑白样本漏误报归因、重放)tdir rules ops eval-platform <metrics|tickets|samples|admin>(别名 tdir rules ops eval)先读 references/eval-platform-ops.md;漏误报规则分析按需跑 tdir rules ops skills read eval-platform playbook/<ticket-ops|false-negative-analysis|false-positive-analysis>
评测平台 TDIR 样本运行日志客观取证还原(输出纯行为四板块《终端运行日志分析报告》及双采集源差异参考,严禁混入检出标签)tdir rules ops eval-platform samples <list|alerts|logs> + 本地 SQLite(qmedr_origin.db / ioa.db)必读 playbook/tasks/eval-platform-sample-analysis/PLAYBOOK.md 与配套 playbook/tasks/eval-platform-sample-analysis/references/sqlite-schema.md

3. 核心内建工作流(Playbooks)

工作流 A:版本迭代检出变化与归零原因分析(严禁只看备注不看 YAML Diff)

  1. 筛出真实迭代且启用中的规则:运行 tdir rules versions --last 30d --enabled ON 配合 tdir rules trend --last 30d,定位 old_signals > 0 而 newest_signals = 0(或大幅下降)的系列。严格剔除 is_enable = 'OFF' 的主动停用规则,以及 old_last_day 与 newest_create_time 均早于窗口的元数据刷新伪迭代。
  2. 强制 Diff 新旧版本 YAML:对每个目标系列的 prev_version_id 执行 tdir rules get --version <prev_version_id>(一次返回旧版 .data.content 与新版 .data.newest_version.content)。逐项对比 detection 选择块、filter_* 排除块、condition 与 header_filter,给出字段级缩量根因;严禁只抄 version_description/remark 或把对比推给用户。
  3. 规范交付:汇总 series_id、<prev_version_id> -> <newest_version_id>、newest_create_time、old_signals vs newest_signals、YAML Diff 根因及控制台链接;临时文件只写 /tmp。

工作流 B:规则误报分析与优化 5 步闭环

  1. 前置检查与定性摸底:执行 tdir rules get --series <series_id> 与 tdir rules verdicts --series <series_id> --last 30d。若 has_draft=true,常规优化立即停止并向用户展示已有草稿信息请用户决定(特例:RuleAgent 审核二次修改时,直接基于该草稿修改并用 --overwrite 覆写,见 references/rule-agent-ops.md)。
  2. 反查 FP / TP 洞察并按场景去重采样:执行 tdir insights list --series <series_id> --verdict false_positive --last 30d 与 --verdict incident --last 30d。同一 cluster.source_insight_uuid 或同机克隆洞察只挑 1–2 个代表性 insight_uuid。
  3. 提取目标规则的 Signal ID:对代表性洞察执行 tdir insights signals <insight_uuid> --series <series_id>,筛出归属当前规则的 --fp-signals 与 --tp-signals。
  4. 核对真实告警事件并编写候选 YAML:执行 tdir signals events <signal_id> --rule <series_id> 查看 OCSF 事件精确字段,基于 tdir rules get 返回的 YAML(保留 header_filter;新建规则模板见 references/rule-lookup.md)在 /tmp 编写候选规则。
  5. 本地回放验证与草稿预览提交:
    • 单事件规则(single_match)执行 tdir rules test --file /tmp/candidate.yml --series <series_id> --fp-signals <...> [--tp-signals <...>] --report /tmp/<name>.json(基线必须复现命中,FP 归零且 TP 保持命中;FAIL_BASELINE_MISS 为验证缺口,不得算成功)。多事件关联规则(multi_event/correlation)用 tdir rules validate + 提交草稿后 tdir rules check <version_id> 查看异步 llm_rule_analysis。
    • 执行 tdir rules draft create --file /tmp/candidate.yml --series <series_id> --replay-report /tmp/<name>.json --dry-run 预览(UUID 自动管理,无需手工剥离),展示改动、回放结果与风险,经用户确认后加 --yes 提交。

工作流 C:白名单漏过滤排查与加白草稿

  • 排查“为何未被白名单过滤”:① 用 tdir rules get --version <hit_version_id> 核对规则内建 filter_*;② 用 tdir rules whitelists --series <rule_series_id> 核对四层准入:状态层(version_status='newest' AND is_enable='ON')、规则范围层(rule_series_ids 为空或含该系列)、作用域层(告警 tenant_id/metadata.tenant_uid 是否在白名单 tenant_uids 内,警惕同一客户新旧租户 UID 不一致,以及 effective_region/platform)、检测条件层(detection 字段及是否锁死单台 device.uid)。
  • 创建加白草稿:先用 tdir signals events <signal_id> --ocsf-ndjson 核对真实字段;哈希必须写 process.file.hashes.md5(禁止写不存在的 process.file.md5),优先用“目录 + 哈希”约束 process.* 而非仅约束父进程 actor.*;租户内部业务加白必须限定 --tenant 与 --insight。先 tdir rules whitelists draft create ... --dry-run 展示 detection、作用范围与警告,用户确认后加 --yes(详见 references/rule-lookup.md)。

4. 外部规则运营平台桥接(tdir rules ops)

tdir rules ops 复用 tdir auth login 联合授权调用 esec-ops。终端安全 TAPD 空间 70187792 下三套工单严禁混用:TDIR 常规运营工单用 tdir tickets,RuleAgent 规则审核工单用 tdir rules ops rule-agent tickets,评测平台样本漏误报工单用 tdir rules ops eval-platform tickets。

  • RuleAgent(tdir rules ops rule-agent):日期统一传 8 位 YYYYMMDD,返回时间已是北京时间(禁止 +8h);publish_status=ALL_PUBLISHED 仅代表已写入草稿箱。查审核单、读 optimization_report 及 engine=tdir 候选规则二次修改覆写草稿闭环见 references/rule-agent-ops.md。
  • 评测平台(tdir rules ops eval-platform / eval):所有子命令(metrics、tickets、samples、admin)引擎参数统一传 win11_tdir_qmedr、win11_tdir_ioa、win11_qmedr、win11_ioa、win11_sysrepair、sandbox。执行工单对账、黑样本漏报分析、白样本误报分析前,先按 references/eval-platform-ops.md 读取对应 playbook/*;需要对评测平台 win11_tdir_qmedr / win11_tdir_ioa 样本产出零检出标签的纯客观《终端运行日志分析报告》时,直接读取内建剧本 playbook/tasks/eval-platform-sample-analysis/PLAYBOOK.md。

References

  • get/list/versions/whitelists/trend/verdicts/validate/test/draft/check 细则与 YAML/白名单模板:references/rule-lookup.md
  • Sigma 原文解读、OCSF Record/policy 主链、informational 与 GraphEdge 边界:references/rule-explanation.md
  • RuleAgent 运营边界、审核工单与候选规则二次修改草稿闭环:references/rule-agent-ops.md
  • 评测平台运营边界、Win11 引擎映射、四级命令与三大作战剧本入口:references/eval-platform-ops.md
  • 评测平台 TDIR 样本单主体运行日志取证还原与双采集源 SQLite 聚合速查:playbook/tasks/eval-platform-sample-analysis/PLAYBOOK.md、playbook/tasks/eval-platform-sample-analysis/references/sqlite-schema.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-rules">View tdir-rules on skillZs</a>