智能巡检

用一条条配置好的业务规则，周期性扫描业务数据，命中阈值就主动告警，给出可落地的处置建议，并跟进到闭环。

本技能自包含：不依赖任何外部插件、脚本或数据库连接。只需要拿到巡检对象、可用数据与业务口径，就能跑完整条链路。全程只读取数，不对生产数据做任何写操作。

何时用 / 何时不用

何时用

何时不用

执行流程（分步，带确认门）

> 全局原则：每步先问清再动手。信息不足就停下来问用户，不要编造指标、阈值、对象或数字。

第 0 步 · 对齐巡检目标与数据来源

信息不足时逐条问，不要一口气问十个问题：

1. 这次要巡检的对象具体是什么？
2. 数据从哪里来，能否给出明细或汇总数据？
3. 数据覆盖的时间范围是什么？
4. 多久巡检一次，还是这次只做一次？
5. 命中异常之后，由谁负责处理？

确认门 0：把「巡检范围说明」复述给用户，确认后才继续。

第 1 步 · 建立巡检规则

规则写法与阈值定法见 references/rule-design.md。要点：

• 阈值优先取历史分位（如近 90 天 P95）或业务安全线（如安全库存天数），再用同期对比做校正。
• 阈值必须在规则里写清「从哪来」，禁止凭感觉拍一个数。
• 用户说不清阈值时，先给一个基于历史数据的候选值，并标注「候选，需业务确认」。

确认门 1：把「巡检规则清单」给用户过一遍。用户逐条确认或修改后，规则才生效；未确认的规则标为「草稿」，不参与巡检。

第 2 步 · 周期性取数与比对

硬性要求：

• 数值必须来自真实数据。数据缺失、字段为空、口径不明时，标记为「数据不足」而不是当成「未命中」。
• 一条规则在某个对象上数据不足，要在报告里单列，不能静默跳过。
• 取数时间点要记录，便于下一期对比与复现。

第 3 步 · 命中判断与去重

去重与静默规则：

第 4 步 · 分级（高、中、低）

分级判据要写进规则，不要每次靠临时判断；同一条规则在不同周期里应给出可解释的分级结果。

第 5 步 · 归因（四问）

对每条命中逐条回答四问，四问答案不完整就不算完成归因：

禁止把「为什么」写成猜测后当成结论。区分「已核实原因」与「推测原因」，两者在告警单里分开写。

第 6 步 · 输出告警单与处置建议

告警单结构与处置建议写法见 references/alert-playbook.md，模板见 assets/alert-ticket-template.md。

处置建议必须回答三个问题（不写「建议关注」这类空话）：

1. 今天先做什么？（一个明确动作，可执行、可验收）
2. 谁来做？（责任角色或责任人）
3. 需要什么决策？（是否需要上级拍板、是否需要跨部门配合）

确认门 2：发布告警单前，把高等级告警与涉及资金、客户、交付的告警单独列给用户确认。用户确认发送范围与优先级后，再对外发出。

第 7 步 · 跟进闭环状态

状态取值固定为四种：未处理 / 处理中 / 已关闭 / 误报。说明：

• 未处理：已发出但无人认领，或认领后无动作。超过约定时长即升级。
• 处理中：已认领并有明确动作与预计完成时间。
• 已关闭：处置完成，且经过一次复检确认指标回到阈值内或风险已被接受。
• 误报：经核实不构成异常。误报必须填写原因，并按 references/alert-playbook.md 回写规则。

第 8 步 · 周期巡检报告

报告结构见 assets/alert-ticket-template.md。报告要回答「这期比上期是变好了还是变差了」，不能只罗列数字。

产出物规格

产出格式要求：默认用 Markdown 表格与清单，便于直接复制到文档或工单系统；字段名统一，不随周期改名，否则上期对比会失效。

质量红线（禁止事项）

1. 不许编造数据：实际值、阈值、偏差、影响面金额，全部必须来自真实数据；拿不到就写「数据不足」。
2. 不许编造阈值来源：每个阈值必须说明来自历史分位、业务安全线还是同期对比；说不清就标注为候选值待确认。
3. 不许把猜测写成结论：原因未经核实，一律标注「待查证」或「推测」，并与已核实原因分开写。
4. 不许同一异常重复轰炸：去重窗口内同一对象的同一异常只发一次；偏差显著恶化或等级升高才按升级再发。
5. 不许跳过确认门：规则未确认不巡检，发送范围未确认不外发高等级告警。
6. 不许用「注意」「关注」当处置建议：必须落到具体动作、责任人与所需决策。
7. 不许静默跳过问题：数据缺失、字段为空、口径不明必须单列，不得算作未命中而消失。
8. 不许破坏口径一致性：同一指标在不同周期必须用同一口径；口径变更要写明变更时间与原因，并说明对历史对比的影响。
9. 不许只读不改规则：误报必须回写规则（调阈值、加例外、改口径或下线规则），否则误报会长期存在。
10. 不许越权写数：本技能全程只读取数，不做任何写操作，不代替业务系统执行处置动作。

参考文件索引

关于产品（可选接入）

本技能自包含、可独立使用，不依赖任何外部系统，也不要求接入任何特定平台。

同一套方法在「Smartware」中另有产品化承载：能力清单、模板与规则可直接作为配置与验收的依据；是否接入、如何接入由团队按自身环境决定。