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-reportIs 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。不得绕过脚本手工拼接最终报告。
一、核心原则与阅读时长门禁(最高优先级)
- 5 分钟阅读时长硬约束:整份报告阅读单元
<= 2250。不写总述,不贴长评论,不为 0 数据画占位大框。上游警告只写.quality.json和 stderr。 - 单页,不是两级 Tab。不要再做「运营态势 / 运营工作」,也不要按来源拆成多份章节。顺序固定为:
- 标题
TDIR 安全运营周报,同一行紧跟周期YYYY-MM-DD HH:MM ~ YYYY-MM-DD HH:MM,字号、字重、颜色与标题相同 - 一个窄分段开关,宽度贴住选项:
ALL(默认)|iOA|iOA(QMEDR)|CWP|PCMgr|PCMgr(QMEDR) 一、运营数据漏斗二、时效和质量三、运营工单情况
- 标题
- 开关只改第一、二章。第三章是全平台工单,不随数据源变化,也不再写「当前 ALL」之类的句子。
- 视觉:白底、蓝色。页标题与同一行周期都是 20px / 600、颜色
#0f172a,章标题同样是 20px / 600。漏斗节点、底部四项指标、时效卡片上的数字同一字号字重(15px / 700),单位 12px。小数点后是 0 就去掉。切换数据源只改文字,不改字号和字重。人物图标用#1d70db。 - 新增失陷数可点。标签用蓝色,并带一个小跳转箭头。点击后在页面内打开绝对定位抽屉(父级
position: relative,不要用position: fixed)。这个抽屉不是警告框。除它以外,正文不得出现诊断<aside>。 - 评测/内测机器剔除铁律(与 apiserver /
system_stats.data_v2100% 对齐):除了日志量(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> --jsontdir 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 --jsontdir 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 的篇幅和章节门禁。
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-weekly-report">View tdir-weekly-report on skillZs</a>