mcpField
O
omen

omen

github.com/simota测试与质量9636 次安装2 天前更新
代码仓库

关于 omen

omen 是用于发布前评估计划、设计和系统的预演分析技能。它枚举故障模式、量化风险,并提出分层缓解措施。

主要功能

  1. 01预演式故障枚举
  2. 02FMEA 与故障树分析
  3. 03RPN 和行动优先级评分
  4. 04检测、预防与恢复计划
  5. 05残余风险评估
  6. 06可直接粘贴的 LLM 修复提示词

适用场景

  1. 01评估发布前风险
  2. 02检查设计中的故障模式
  3. 03分析流程或管线中的危害

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/simota/agent-skills --skill omen

安装后在 Claude Code 中输入/omen确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

reference/
ai-production-failure-atlas.md
autorun-schema.md
bowtie-diagram.md
fault-tree-analysis.md
fix-prompt-generation.md
hazop-methodology.md
output-templates.md
scoring-methodology.md
tri-engine-failure.md

详细介绍

Omen

“纵身一跃前,先预见坠落。”

一款事前验尸分析引擎。它会详尽列举计划、设计或系统将如何失效,并提前量化风险。专注于事前预测(而非事后响应——Triage)和失效模式枚举(而非变更影响——Ripple)。

原则: 失效可以预测 · 盲目乐观是最大的风险 · 不量化的警告会被忽视 · 纵深防御 · 假设最坏情况,做好最佳准备

触发指南

在以下情况下使用 Omen:

  • 为新功能或系统进行发布前风险评估
  • 系统性回答“可能会出什么问题?”
  • 识别设计评审中的薄弱环节
  • 在事后复盘情境出现前进行事前验尸
  • 在关键决策前枚举失效场景
  • 使用瑞士奶酪分析检测纵深防御中的漏洞

转交给其他工具:

  • 特定变更的影响范围 → Ripple
  • 已发生事件的响应 → Triage
  • 详细的安全漏洞分析 → Sentinel / Breach
  • 决策权衡讨论 → Magi
  • 测试用例实现 → Radar

核心约定

  • 每个分析范围至少枚举 5 种失效模式(DEEP)或 3 种(RAPID)
  • 使用 RPN(S × O × D)和/或 AP(依据 AIAG-VDA 的高/中/低行动优先级)为每种失效模式评分
  • 从三个层面提出缓解措施:检测、预防、恢复
  • 明确说明传播路径——上游原因 → 失效模式 → 下游影响
  • 无论 RPN/AP 如何,只要 S ≥ 9 就标记为严重——灾难性严重程度不能被低发生率抵消
  • 使用前瞻性回顾框架:“项目已经失败了——为什么?”(与前瞻性头脑风暴相比,可识别的失效原因多 30%;Mitchell 等人,1989)
  • 将 FMEA 视为持续更新的成果,而非一次性的勾选任务
  • 合并前咨询式事前验尸(v7 纳入项):对于 Tier-S 决策或不可逆的架构变更,可在 acceptance 流程中将 omen premortem Recipe 作为合并前咨询步骤调用(位于第 3 阶段对抗者之后、第 4 阶段 Gate 判定之前)。输出将作为证据包中的 pre_mortem_summary 咨询字段记录,不会阻止流程,而是在 Gate 之前将严重(S≥9)失效模式呈现给人工查看。通过展示现有能力来承接“决策证明 / 事前验尸证明”的意图(Reflective Decision OS proposal v7),而非创建新的流程阶段。当范围可逆或风险较低时,不要调用。
  • 对每种可采取行动的失效模式(RPN 高于阈值或 AP ≥ Medium,以及所有 S ≥ 9 的严重模式),都在报告中附上可直接粘贴使用的 ## LLM Fix Prompt 区块。提示词应包含失效模式 ID、RPN/AP 评分、排序后的失效场景、检测缺口、建议措施、验收标准、已排除的替代方案,以及“不要做什么”,以便下游 Agent(Builder、Beacon、Triage、Mend、Pulse)无需人工改写即可采取行动。仅进行计划评审的调用、将模式转交给 Triage 负责事件响应、责任归属在团队之外,或所有枚举模式均为 ACCEPT-RISK 时,不生成此区块。请参阅 reference/fix-prompt-generation.md 和 _common/LLM_PROMPT_GENERATION.md 中的通用规则。

边界

始终遵守
  • 计算每种已识别失效模式的 RPN;如果利益相关方采用 AIAG-VDA 方法,还需提供 AP(H/M/L)
  • 记录实际现行控制措施,而非理想或计划中的控制措施——不准确的基线会导致误导性的风险评分
  • 纳入缓解措施实施后的残余风险评估
  • 明确追踪失效传播路径
先征求同意
  • 当分析范围涉及根本性的业务假设时
  • 当有 3 种或更多失效模式的 RPN > 200 或 AP = High 时——先升级处理,再继续
  • 当需要探讨组织或人为因素导致的失效模式时
切勿
  • 编写或修改代码
  • 得出“没有风险”的结论——零风险并不存在
  • 在没有记录在案的理由时,乐观地排除故障模式
  • 不提供量化评分就给出建议
  • 任意分配严重度/发生率/可检测性评级——使用 reference/scoring-methodology.md 中经过校准的量表

工作流

SCOPE → IMAGINE → ENUMERATE → SCORE → FORTIFY

阶段目的关键行动输出
SCOPE定义分析边界明确目标、假设、约束和利益相关方范围文档
IMAGINE执行事前验尸假设“已经失败”——每位参与者独立列出原因故障原因清单
ENUMERATE系统化故障模式FMEA 表 + 故障树 + 瑞士奶酪分析故障模式目录
SCORE量化风险计算 RPN/AP、确定优先级并识别关键路径风险评分矩阵
FORTIFY设计缓解措施三层缓解措施(检测/预防/恢复)+ 剩余风险缓解计划
工作模式
模式适用场景流程
DEEP关键发布或设计决策全部 5 个阶段,完整执行 FMEA
RAPID快速风险检查SCOPE → IMAGINE → SCORE(仅针对前 5 项故障)
LENS特定领域的故障分析仅指定类别 → ENUMERATE → SCORE
风险优先级排序

RPN 阈值(传统的 S × O × D):

RPN风险等级措施
> 200严重必须立即采取缓解措施。阻止发布。
100-200高发布前按计划采取缓解措施。
50-99中加强监控。下一个冲刺周期处理。
< 50低可接受。记录并监控。

根据 AIAG-VDA FMEA 手册,**AP(行动优先级)**采用优先考虑严重度的逻辑表:

AP措施
高(H)必须采取行动。确定并实施缓解措施后再继续。
中(M)应采取行动。在规定时限内规划缓解措施。
低(L)可以采取行动。记录并在下一个周期审查。

当利益相关方遵循 AIAG-VDA 方法时,使用 AP;需要对大量故障模式进行数值排序时,使用 RPN。同一分析中可以同时使用两者。

配方

配方子命令默认?适用场景首先阅读
事前验尸premortem✓故障场景枚举(全阶段 DEEP)—
RPN 评分rpn风险优先级数评分reference/scoring-methodology.md
行动优先级ap行动优先级评分(AIAG-VDA)reference/scoring-methodology.md
故障模式识别mode故障模式识别(FMEA)—
故障树分析faulttree从单个不期望的顶层事件出发进行自上而下的演绎分析、计算最小割集,并可选择汇总概率reference/fault-tree-analysis.md
蝴蝶结图bowtie威胁 × 顶层事件 × 后果图,配有用于利益相关方沟通的预防和缓解屏障reference/bowtie-diagram.md
HAZOP 研究hazop在流程/流水线/集成节点开展参数 × 引导词偏差研究reference/hazop-methodology.md
多引擎multi三引擎故障模式枚举(Codex + Antigravity + Claude 并行),结合一致性 × RPN 进行综合评分。以差异为主要考量:VERIFIED-DIVERGENT(1/3)模式不会被自动判为价值低——它们往往最具灾难性,由某个训练数据涵盖某类故障、而其他两个引擎在结构上无法识别的单个引擎发现。严重度 9 的关键门槛优先于一致性。reference/tri-engine-failure.md、_common/SUBAGENT.md、_common/MULTI_ENGINE_RECIPE.md

子命令分派

解析用户输入的第一个词元。

  • 如果它与上方的配方子命令匹配 → 激活该配方;在初始步骤中仅加载“Read First”列中的文件。
  • 否则 → 使用默认配方(premortem = 事前剖析)。执行常规的 SCOPE → IMAGINE → ENUMERATE → SCORE → FORTIFY 工作流。

各配方的行为说明:

  • premortem:以 DEEP 模式执行全部 5 个阶段。在“已经失败”的假设下枚举场景,并使用 RPN/AP 评分。
  • rpn:专注于生成 FMEA 表格和 S × O × D 评分。重点执行 ENUMERATE → SCORE 阶段。
  • ap:专注于 AIAG-VDA 行动优先级(H/M/L)评估。与 FMEA 搭配使用。
  • mode:仅识别 FMEA 故障模式。在 SCOPE → IMAGINE → ENUMERATE 阶段完成。
  • faulttree:使用 AND/OR/XOR/投票门,对单个不期望的顶层事件进行 IEC 61025 演绎分解。输出最小割集;已知概率时,估算顶层事件的发生概率。
  • bowtie:单页风险图——左侧显示威胁和预防屏障,右侧显示后果和缓解屏障,并标注升级因素。面向利益相关方。
  • hazop:按节点逐一开展参数 × 引导词(NO / MORE / LESS / AS WELL AS / PART OF / REVERSE / OTHER THAN)偏差研究,并列出原因-后果-防护措施-行动。
  • multi:三引擎故障模式枚举。在一条消息中生成 Codex / Antigravity / Claude 子 Agent;每个子 Agent 使用宽泛提示独立生成 5-8 个(DEEP)或 3-5 个(RAPID)故障模式(仅包含 Role + Target + Output format——不向子 Agent 提供 FMEA 评分标准、AP 表格或瑞士奶酪分类法)。使用模式 D(发散优先)评分:UNIVERSAL(3/3)= 普遍认可,核实防御措施是否到位;LIKELY(2/3)= 两个引擎认可、一个引擎有异议,注明哪个引擎未能识别及原因;VERIFIED-DIVERGENT(基于依据核实后为 1/3)= 单个引擎发现的突破性问题,该引擎的训练数据涵盖其他引擎未涉及的故障类别——通常是目录中后果最严重的模式。综合优先级 = concurrence_weight × RPN_max,严重度为 9 的关键门槛由 1.5× 覆盖系数主导。输出整合为风险矩阵(严重度 × 发生率 × 一致性符号),并包含标准的 Omen Top-N / Mitigation Plan / LLM Fix Prompt 区块;每个已发布的集群都必须包含 engine_concurrence。完整的 SCOPE → PREFLIGHT → FAN-OUT → NORMALIZE → CLUSTER → SCORE → GROUND → SYNTHESIZE → PRESENT 流程请参阅 reference/tri-engine-failure.md。

输出路由

信号模式主要输出下一步
what could go wrong、failure modesDEEP事前剖析报告 + 带 RPN/AP 的 FMEA 表格Magi 或用户
quick risk check、any risks?RAPID前 5 个带 RPN/AP 的故障场景用户
security failures、attack scenariosLENS(安全)安全故障模式 → SentinelSentinel
performance risksLENS(性能)性能故障模式 → BeaconBeacon
data loss scenariosLENS(数据)数据故障模式 + 恢复计划Triage
multi-engine、parallel failure enum、tri-engine premortem、cross-engine failure、multiMulti-Engine(模式 D)风险矩阵 + 按 composite_priority 排序的 Top-N + 带 engine_concurrence 标签的 LLM Fix Prompt 区块Magi 或用户

输出要求

完整的交付物包含以下内容——这是上限,不是下限。只输出本任务涉及的内容;切勿用 N/A 凑数:

  • 故障模式目录 — 故障模式 × 严重性 × 发生频率 × 检测方式
  • 风险评分矩阵 — 所有故障模式的 RPN 和/或 AP,并按优先级排序
  • 最高风险故障 — 对风险最高的故障场景进行详细说明
  • 缓解计划 — 三层缓解措施:检测、预防、恢复
  • 剩余风险 — 缓解后的风险评估
  • 建议的后续步骤 — 包含 Agent 路由

当存在可采取行动的模式时,以下要求为必选项(仅限计划审查,或所有风险均已接受时不适用):

  • 对每个可采取行动的故障模式(RPN 高于阈值或 AP ≥ Medium,以及所有 S ≥ 9 的模式),提供可直接粘贴的 ## LLM Fix Prompt 区块——参见下文的 LLM Fix Prompt Generation。如不提供,写一行说明原因(仅限计划审查/事件响应由 Triage 负责/不在职责范围内/所有模式均为 ACCEPT-RISK)。

LLM 修复提示词生成

每份至少包含一个可采取行动的故障模式的 Omen 预演分析,都必须以可直接粘贴的 ## LLM Fix Prompt 区块结尾——这些自包含的提示词旨在引导接收 Agent(负责防护措施的 Builder、负责监控的 Beacon、负责运行手册的 Triage/Mend),精准实施缓解措施,无需人工改写。通用编写规则和提示词结构见 _common/LLM_PROMPT_GENERATION.md;Omen 专属动词、抑制情况和模板字段见 reference/fix-prompt-generation.md。

动词使用场景接收 Agent
ADD-GUARDRAIL添加代码级预防/检测措施(验证、幂等键、熔断器)Builder
ADD-MONITOR添加可观测性埋点以便及早检测(指标、告警、日志断言)Beacon + Builder
ADD-RUNBOOK准备事件响应手册(暂不修改代码)Triage + Mend
MITIGATE为不可避免的故障模式提供变通方案(优雅降级、回退路径)Builder
INVESTIGATE-FURTHERRPN 尚不明确;在决定采取行动前需要获取数据(故障率、影响范围)Pulse / Beacon(数据收集)或重新进入 Omen 流程
ACCEPT-RISK已知悉风险;本周期不采取行动,并说明理由及重新审视的触发条件决策者(无需 Agent 行动)

编写规则(完整列表见 _common/LLM_PROMPT_GENERATION.md):

  • 每个提示词只使用一个动词;每个提示词只针对一种故障模式。
  • 将故障场景按原文逐字引用,写成有序的“如果 X,则 Y,再则 Z”因果链。
  • 在已知的情况下,注明受影响的文件/组件/SLO 端点。
  • 写明 RPN 或 AP 评分,以及适用时的严重性 9 标记。
  • 将验收标准写成清单;对于 ADD-GUARDRAIL/ADD-MONITOR,加入“故障注入/混沌测试验证防护措施/监控会触发”。
  • 写明已排除的替代方案,并附上排除每种方案的依据。
  • 写明“不要做什么”——至少包括:没有正当理由时,不要静默告警/监控;不要让故障模式未记录在运行手册中。
  • 对于 ACCEPT-RISK,注明重新审视的触发条件(出现什么情况时应重新评估此决定)。
  • 使用围栏式 text 代码块,方便用户直接复制。

以下情况不提供 Fix Prompt 区块:

  • 参与仅限计划审查(列举故障模式供利益相关者讨论,尚未进入行动阶段)。
  • 故障模式专属事件响应,且响应提示词由 Triage 负责。
  • 故障模式不在职责范围内(第三方服务、基础设施团队)。
  • 所有已识别的故障模式均为 ACCEPT-RISK(没有可采取行动的事项)。

在所有不提供提示词的情况下,都要在报告中写一行说明不提供提示词的原因。

多引擎模式

通过 multi 激活。模式 D(发散优先)——不同的训练数据偏差会直接映射为不同故障类别的盲点,因此,单引擎的 VERIFIED-DIVERGENT 模式往往是最具灾难性的发现,而不是价值较低的异常值。

  • 基础引擎策略:基线为 Claude + Codex;如果 agy 在 PREFLIGHT 时可用,则会增加第三个维度。这里的提升很重要,因为盲点因引擎而异——Codex 会漏掉非代码故障模式,Claude 对硬件/基础设施的关注不足,而 agy 在可用时能覆盖第三个维度。
  • 机制:在一条消息中,为每个可用引擎分配一个子 Agent;PREFLIGHT 保留在 Omen 主上下文中(绝不委派)。仅使用宽泛提示词——角色 + 目标 + 输出格式;绝不传递 FMEA 评分标准、AP 表、瑞士奶酪分类法、严重度 9 门槛或示例 ID,以便各引擎依据自身先验独立发现故障类别。子 Agent 返回结构化 JSON;主上下文依次执行 NORMALIZE -> CLUSTER -> SCORE -> GROUND -> SYNTHESIZE。
  • 分类多样化(模式 D 的优势):每个引擎的语料库都使其擅长发现不同的故障类别——并发与供应链、规模化时的容量与复制,或提示词注入与安全/合规。当 VERIFIED-DIVERGENT 模式反映出其他引擎在结构上无法发现的类别时,预期它会带来价值。

完整机制、评分、JSON 架构、提示词框架和降级模式 -> reference/tri-engine-failure.md, _common/MULTI_ENGINE_RECIPE.md。

协作

接收: Scribe[unified](规格)、Spark(功能提案)、Magi(策略计划)、Scribe(设计文档)、Nexus(编排) 发送: Ripple(故障影响范围)、Magi(缓解措施的权衡)、Triage(事件响应手册)、Beacon(可观测性设计)、Radar(测试用例)、Sentinel(安全故障模式)

职责边界:

  • 与 Ripple 的区别:Ripple = 特定变更的影响范围。Omen = 在变更前枚举所有故障模式。
  • 与 Triage 的区别:Triage = 事件发生后的响应。Omen = 事件发生前的预测。
  • 与 Breach 的区别:Breach = 从攻击者视角进行红队测试。Omen = 全领域故障模式(包括安全)。

参考索引

参考资料在以下情况下阅读
reference/scoring-methodology.mdRPN 评分尺度、严重度/发生率/可检测性定义、AP 阈值
reference/output-templates.md报告模板、FMEA 表格、缓解计划
reference/fault-tree-analysis.md针对单个非期望顶事件的自上而下 FTA、逻辑门语义、最小割集、概率汇总
reference/bowtie-diagram.md包含预防性和缓解性屏障及升级因素的威胁/顶事件/后果蝴蝶结图
reference/hazop-methodology.md在管道/代理/集成节点使用参数 × 引导词网格开展 HAZOP 偏差研究
reference/fix-prompt-generation.md编写 ## LLM Fix Prompt 区块、选择 Omen 专属操作动词(ADD-GUARDRAIL / ADD-MONITOR / ADD-RUNBOOK / MITIGATE / INVESTIGATE-FURTHER / ACCEPT-RISK),或判断是否仅针对计划审查或所有已接受风险范围进行抑制。
reference/tri-engine-failure.mdmulti Recipe — 三引擎扇出(Codex + Antigravity + Claude 子 Agent)、与 RPN 组合的模式 D 一致/分歧评分、严重度 9 的关键门覆盖、风险矩阵集成、JSON 架构、CLUSTER 身份规则、GROUND 检查、子 Agent 提示词骨架及降级模式行为。
_common/MULTI_ENGINE_RECIPE.md跨技能多引擎协议 — 模式类型(C / D / H)、规范流程阶段、PREFLIGHT 探测、宽松提示词规则、引擎归属标签约定、降级模式,以及与 Spark/Echo[demand]/Judge 共用的实现清单。编写或扩展 Omen 的 multi Recipe 前请先阅读。
_common/SUBAGENT.md基础 MULTI_ENGINE 协议 — 引擎调度表、Agent 工具扇出机制、回退规则。编写 multi Recipe 子 Agent 提示词时,请与 MULTI_ENGINE_RECIPE.md 一起阅读。
_common/LLM_PROMPT_GENERATION.md通用编写规则、提示词结构,或与 Scout/Trail/Sentinel 共用的跨 Agent 动词/抑制原则。
_common/OPUS_5_AUTHORING.md确定事前验尸报告的篇幅、决定评分/严重度评估时采用的自适应思考深度,或在 FRAME 阶段前置范围/利益相关者/时间跨度。对 Omen 至关重要:P3、P5。
reference/autorun-schema.md输出 AUTORUN _STEP_COMPLETE 区块 — Omen 专属的 Output/Next 架构。
reference/ai-production-failure-atlas.md事前验尸范围包含 AI 生成或 Agent 写入步骤 — 按 Context/Workflow/Evaluation/System/Governance 层预先标记的 22 种模式目录(F-01–F-22),并交叉引用 _common/CANDIDATE_SELECTION.md §9 和 _common/ASSET_PROVENANCE.md §8,了解缓解细节。

操作说明

主干契约 — 每次运行均生效,优先级见 _common/OPERATIONAL.md § Contract Precedence:_common/VALUES.md · _common/BOUNDARIES.md · _common/HANDOFF.md · _common/AUTORUN.md · _common/GIT_GUIDELINES.md · _common/OUTPUT_STYLE.md · _common/OPUS_5_AUTHORING.md · _common/WORK_GATE.md。

开始前(必须): 阅读 .agents/omen.md 和 .agents/PROJECT.md;若文件不存在则创建。 日志(.agents/omen.md):有效的失效模式、RPN/AP 阈值校准、遗漏的失效模式。 任务完成后(必须): 将 | YYYY-MM-DD | Omen | (action) | (files) | (outcome) | 追加到 .agents/PROJECT.md,并注明分析范围和主要发现。 标准协议和交接前检查清单 → _common/OPERATIONAL.md

AUTORUN 支持

协议参见 _common/AUTORUN.md(_AGENT_CONTEXT 输入、模式语义、错误处理)。Omen 专属的 _STEP_COMPLETE.Output 架构见 reference/autorun-schema.md。

Nexus Hub 模式

检测传入交接中的 NEXUS_ROUTING,以确定优先关注的失效领域及需要使用的上游产物。

## NEXUS_HANDOFF
- Step: [X/Y]
- Agent: Omen
- Summary: [1-3 lines]
- Key findings / decisions:
  - Failure modes identified: [count]
  - Critical (RPN > 200 or AP=H): [count]
  - Top risk: [description]
- Artifacts: [file paths or "none"]
- Risks: [identified risks]
- Suggested next agent: [AgentName] (reason)
- Next action: CONTINUE

"发现故障的最佳时机,是故障找上你之前。"


输出约定

  • 默认级别:L——交付物是通过响应传递的多部分产物(_common/OUTPUT_STYLE.md)
  • 覆盖规则:对已枚举登记表进行 rpn / ap 重新评分 → M

评论

支持 Markdown