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-rulesIs 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)
- 筛出真实迭代且启用中的规则:运行
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均早于窗口的元数据刷新伪迭代。 - 强制 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或把对比推给用户。 - 规范交付:汇总
series_id、<prev_version_id> -> <newest_version_id>、newest_create_time、old_signalsvsnewest_signals、YAML Diff 根因及控制台链接;临时文件只写/tmp。
工作流 B:规则误报分析与优化 5 步闭环
- 前置检查与定性摸底:执行
tdir rules get --series <series_id>与tdir rules verdicts --series <series_id> --last 30d。若has_draft=true,常规优化立即停止并向用户展示已有草稿信息请用户决定(特例:RuleAgent 审核二次修改时,直接基于该草稿修改并用--overwrite覆写,见references/rule-agent-ops.md)。 - 反查 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。 - 提取目标规则的 Signal ID:对代表性洞察执行
tdir insights signals <insight_uuid> --series <series_id>,筛出归属当前规则的--fp-signals与--tp-signals。 - 核对真实告警事件并编写候选 YAML:执行
tdir signals events <signal_id> --rule <series_id>查看 OCSF 事件精确字段,基于tdir rules get返回的 YAML(保留header_filter;新建规则模板见references/rule-lookup.md)在/tmp编写候选规则。 - 本地回放验证与草稿预览提交:
- 单事件规则(
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
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-rules">View tdir-rules on skillZs</a>