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

tdir-weekly-report

生成阅读时间不超过5分钟的单页交互式 HTML《TDIR 安全运营周报》。页顶一个数据源开关驱动运营数据漏斗和时效质量;运营工单独立于数据源。不负责单条洞察深度取证或安全响应处置。

How do I install this agent skill?

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

生成前必须读取 references/report-contract.md。指标定义、时间窗、来源映射、工具命令、SQL、缓存和验收门禁以该契约为唯一明细口径。

默认直接使用内置脚本 scripts/build-weekly-report.py 编排 tdir overview、tdir endpoints、tdir rules、tdir entities、tdir tickets 与 tdir rules ops 并发取数并渲染 HTML,先读取目标命令或脚本 --help。不得绕过脚本手工拼接最终报告。

一、核心原则与阅读时长门禁(最高优先级)

  1. 5 分钟阅读时长硬约束:整份报告阅读单元 <= 2250。不写总述,不贴长评论,不为 0 数据画占位大框。上游警告只写 .quality.json 和 stderr。
  2. 单页,不是两级 Tab。不要再做「运营态势 / 运营工作」,也不要按来源拆成多份章节。顺序固定为:
    • 标题 TDIR 安全运营周报,同一行紧跟周期 YYYY-MM-DD HH:MM ~ YYYY-MM-DD HH:MM,字号、字重、颜色与标题相同
    • 一个窄分段开关,宽度贴住选项:ALL(默认)|iOA|iOA(QMEDR)|CWP|PCMgr|PCMgr(QMEDR)
    • 一、运营数据漏斗
    • 二、时效和质量
    • 三、运营工单情况
  3. 开关只改第一、二章。第三章是全平台工单,不随数据源变化,也不再写「当前 ALL」之类的句子。
  4. 视觉:白底、蓝色。页标题与同一行周期都是 20px / 600、颜色 #0f172a,章标题同样是 20px / 600。漏斗节点、底部四项指标、时效卡片上的数字同一字号字重(15px / 700),单位 12px。小数点后是 0 就去掉。切换数据源只改文字,不改字号和字重。人物图标用 #1d70db。
  5. 新增失陷数可点。标签用蓝色,并带一个小跳转箭头。点击后在页面内打开绝对定位抽屉(父级 position: relative,不要用 position: fixed)。这个抽屉不是警告框。除它以外,正文不得出现诊断 <aside>。
  6. 评测/内测机器剔除铁律(与 apiserver / system_stats.data_v2 100% 对齐):除了日志量(log_count)、信号量(signal_count)、日活终端数(machine_avg_active)外,所有洞察、L1/L2、存量/新增失陷终端、失陷原因/租户、MTTD/MTTA-L1/MTTA-L2、L1 检出率/精确率、人工复核扇面及洞察运营工单全部强制剔除内测/评测终端(internal_test_machine,含 测试机器-评测平台、测试机器-IOA 等测试标签及评测终端)。

二、一键取数与生成工具脚本

使用内置脚本 scripts/build-weekly-report.py 一步完成并发取数 + 格式锁定渲染 + 5 分钟阅读时长门禁校验:

python3 skills/tdir-weekly-report/scripts/build-weekly-report.py \
  --start "2026-10-15 10:00" \
  --end "2026-10-23 10:00" \
  --data-dir /tmp/tdir-weekly-20261023 \
  --output tdir-weekly-report-20261023.html

页面模板是 scripts/weekly-report-page.html、scripts/weekly-report.css 和 scripts/weekly-report.js,由 scripts/build-weekly-report.py 内联进最终 HTML。

  • 默认复用与当前时间窗、schema version 和文件 SHA-256 全部匹配的缓存;任一项不匹配时自动在 staging 目录重新取数,全部校验通过后才原子替换旧缓存。--force-fetch 强制刷新;--render-only 只允许从已验证缓存渲染;--fetch-only 只刷新缓存;--validate-cache 只验缓存。
  • 自动取数范围:
    • tdir overview --start <start_date> --end <end_date> --source <all|ioa|ioa(qmedr)|cwp|pcmgr|pcmgr(qmedr)|emdr> --json
    • tdir endpoints compromised summary --start <start_ts> --end <end_ts> --source <all|ioa|ioa(qmedr)|cwp|pcmgr|pcmgr(qmedr)> --top 20 --json(先取 20 个候选场景;含上一等长周期对比)
    • 对候选 scene_key 用 tdir hunt sql 汇总同一场景的 human_review_result:已有人工复核但无任何人工 incident 的场景整体剔除,再保留前 5 名
    • tdir rules list --summary --json、tdir rules verdicts --summary --start <start_ts> --end <end_ts> --json、tdir rules versions --start <start_ts> --end <end_ts> --enabled ON --limit 200 --json
    • tdir entities summary --start <start_ts> --end <end_ts> --json
    • 分别对 insight、entity、rule 执行 tdir tickets list --category <category> 并翻完所有游标,再按返回的 created_at 本地过滤到精确半开区间
    • 规则运营不得只看平台分类。 tdir tickets list --category rule 为 0 只说明平台「规则运营」分类没有工单,不能据此写「规则运营 0」。必须同时翻完下面两路,并按 created_at 过滤到同一半开区间:
      • tdir rules ops rule-agent tickets list --engine tdir --created-from YYYYMMDD --created-to YYYYMMDD --page-size 100:标题 【RuleAgent规则审核】
      • tdir rules ops eval-platform tickets list --engine-type tdir --created-after YYYYMMDD --created-before YYYYMMDD --limit 100:标题 【TDIR引擎(iOA采集)】
      • tdir rules ops eval-platform tickets list --engine-type tdir_qmedr ...:标题 【TDIR引擎(QMEDR采集)】
      • 日期参数只用于覆盖查询,入表仍以 created_at ∈ [周期开始, 周期结束) 为准。单页上限 100,total 超过一页时递增 --page 翻完。严禁用 tdir tickets list --owner RuleAgent 或无日期的评测工单列表代替。
    • 先执行 tdir hunt schema get 校验 threat_incident_review_detail 与 llm_insight_verdict_report 字段,再用 tdir hunt sql 按工单关联 incident_uuid 读取 L1 结论、来源域与最近成功 L1 失陷结论
    • MTTD / MTTA-L1 用一条按 signal_source 分组的 SQL:alert_start_time 落在半开窗口、created_at <= 窗口结束、review_status != 'pending',并剔除内测/评测终端。不要再用 finished 系列把自动归档排除在外。缓存 schema 为 6。

三、三章内容

规则与情报的存量、变更不进这页。脚本仍可拉取,但不得再渲染「规则与情报治理」章节。

1. 一、运营数据漏斗

标题下面、流转图上面,从左到右四项:日活终端数、每万台失陷数、存量失陷数、新增失陷数。

每万台失陷数 = 新增失陷 ÷ 周期天数 ÷ 日活终端 × 10000。日活是日均,新增失陷是整个周期的累计,所以要先除以天数。小于 1 保留两位,否则一位,再去掉末尾 0。悬停说明写明这个公式。

流转图保持已确认的蓝色流向:左侧五个来源各自标真实日志量(日志 xx亿 或 日志 xx万),中间是 威胁信号、威胁洞察,右侧 L1Agent 展开五类(真实事件、恶意软件、风险行为、误报、不确定),再连到 人工。人工展开四类加待处理。来源节点只作高亮,不是第二套开关。

  • 威胁洞察悬停:新增洞察 N;历史洞察 M。两者之和必须等于洞察总数。不要写「独立」「新生成」「历史复用」。
  • L1Agent 节点显示「L1Agent」和 l1_review.total(finished / llm_finished / reviewed)。悬停显示「新增洞察(已分析) N」。这个数是已分析完成的新增洞察,不含 pending,也不要改成 new_insight_count。流转图不写可见标题,也不要加 SVG <title>。
  • L1Agent 到人工的连线悬停:EMDR 中 L1 定性为真实事件,或常规抽检。
  • 人工扇面按洞察工单结论计数。EMDR 是所属数据源里的重点租户,工单按关联洞察的 signal_source 归到该源,ALL 等于各源之和。待处理是未完成的洞察工单。

点击新增失陷数打开抽屉,两个页:

  • 失陷原因 TOP5:入口、意图、主体,加上按归并终端数的前五个场景(告警名、终端数、占比、执行链)。
  • 失陷租户 TOP5:租户、新增失陷、存量失陷、占比。占比沿用接口的 ratio_pct。先丢掉租户 0、unknown、tdir-pcmgr-unknown-tenant、tdir-pcmgr-global,再取接下来的真实租户,最多 5 个。

PCMgr 和 PCMgr(QMEDR) 没有租户。这两个来源隐藏租户页和页签,只留失陷原因。不要为了凑满 5 行去编租户。

存量失陷是当前仍失陷的全部终端。新增失陷是其中 compromise_at 落在本周期的终端。页面只用这两个词,不要写「本轮失陷」。

2. 二、时效和质量

五张卡片,随页顶开关变化:MTTD、MTTA-L1、MTTA-L2、L1 检出率、L1 精确率。不要再单列一张 MTTA,也不要「合计(≤5分钟)」。

  • MTTD 副标题固定为 威胁发生到洞察产生。计算是剔除内测/评测终端后的 AVG(created_at - alert_produce_time),只保留差值在 0 到 86400 秒的记录。不要改成 alert_start_time → created_at,ALL 含 qmedr。
  • MTTA-L1 副标题固定为 自动归档 + L1 研判。它是非 pending 队列上的 AVG(mtta_seconds),0 秒自动归档和非 0 秒一起算。
  • MTTA-L2 只算威胁洞察工单,来源是 EMDR 和常规抽检,取正数 handling_seconds 的均值。规则工单和情报工单不算。EMDR 工单按关联洞察的 signal_source 归到所属源。ALL 副标题 EMDR + 抽检。某个源同时有 EMDR 和抽检时副标题写 EMDR + 抽检,只有抽检写 抽检。没有洞察工单写 无洞察工单,数值 —。
  • L1 检出率 =(L1 判为真实事件且人工确认为真实事件)/ 人工确认的真实事件。
  • L1 精确率 =(L1 判为真实事件且人工确认为真实事件)/ L1 判为真实事件。
  • 悬停要写出公式,以及分子、分母。分母为 0 时数值是 —,并说明没有可计算样本。不再展示召回率、误报率、漏报率。
  • 检出率、精确率和人工扇面使用同一批洞察工单。EMDR 不单独拆桶,按关联洞察的 signal_source 归入所属源,因此 ALL 等于各源之和。第三章仍把 EMDR 作为洞察运营里的一行。

3. 三、运营工单情况

不写开头那两句汇总。两张表:

  • 分类表列:分类、事项、工单、完成、未完成、完成率、超时、工单耗时。分类只留洞察运营、规则运营、情报运营。洞察运营分 EMDR、常规抽检。规则运营分 RuleAgent、内测指标;平台「规则运营」有工单才加一行。情报运营事项列写 —。RuleAgent 没有超时字段,超时列写 —。
  • 处理人表列:处理人、工单、完成、未完成、超时、工单耗时。

工单耗时是该行正数处理时长的均值。它和第二章的 MTTA-L2 不是同一个数:第二章只看洞察工单,这张表按各自行自己的工单算。

整体运营负责人周度复盘

本报告是量化输入。用户同时要求整体运营复盘时,按 ../tdir-overall-ops/SKILL.md 另给简短的重点问题处理记录:TOP5 共性原因、专业运营验证结论、风险知会与影响面遗漏、未解决/Reopen、负责人和完成时间、下周重点。历史未完工单不受本报告创建窗口限制,应按该工作流另行查全;不得用周期结单率代替积压跟进,也不得把接口无超时字段写成零超时。保留 HTML 的篇幅和章节门禁。

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-weekly-report">View tdir-weekly-report on skillZs</a>