omv-audit

omv-audit

深度审计一个 candidate 漏洞发现，填充 Evidence.v1 文件，为 /omv-report 做好准备。

Stay in passive research mode: read public source code only. Do not send requests to live services, do not auto-execute PoC code. Local analysis, static reasoning, and local test descriptions are allowed.

Invocation

/omv-audit <id> [--force]

• <id> 对应 .omv/findings/<id>.yaml 文件
• --force 允许重新审计已为 confirmed/blocked 的文件

Reference Loading

按需加载，不要一次性全读：

• 审计方法论与置信度框架：references/audit-playbook.md
• CVSS v3.1 度量决策表：references/shared/cvss-builder.md
• 14 个生态的 PatternPack manifest 位于 references/pattern-packs/，对应 Markdown registry 位于 references/patterns/
• Evidence.v1 字段定义与 evidence/submission 评分规则：contracts/evidence.v1.yaml
• ThreatMap.v1 图证据字段：contracts/threat-map.v1.yaml
• Verification.v1 对抗复核 sidecar：contracts/verification.v1.yaml

审计目标

读取 .omv/findings/<id>.yaml 后，你的目标是将以下字段填写为具体、可验证的值（非 unknown）：

必填（confirmed 所需）

• versions.tested — 实际测试的版本号
• evidence.source — 攻击者可控的输入入口（含 file:line）
• evidence.sink — 危险操作（含 file:line）
• evidence.guard — 缺失或可绕过的防御（含 file:line 或"不存在"的说明）
• evidence.reproducer — 本地复现步骤描述
• evidence.observed_result — 本地运行后实际观测到的结果（若 passive 模式无法在本地执行，保留 unknown，在 provenance.unverified_fields 中列出，交由 /omv-repro 完成）
• cvss.vector / cvss.score / cvss.severity
• dedup.* — NVD/GHSA/生态系统数据库检索结果
• verdict.* — 当前可利用性判断（proven|plausible|blocked|disproven）、置信度和原因

如何达到目标，由你自主决定。 根据 finding 的实际情况——漏洞类别、已有线索、代码结构——自主选择切入点、阅读哪些文件、花多少精力在每个环节。参考 references/audit-playbook.md 获取思维框架，但不要把它当作执行脚本。

如果 finding 属于任一受支持生态，先加载 references/pattern-packs/ 下对应 JSON，再按需加载 references/patterns/ 下对应 Markdown registry，用其中的 source pattern、sink signature、expected guard、evidence criteria、false-positive checks 和 CWE 映射辅助判断。Pattern registry 是方法论，不是真实漏洞案例库；不要加载无关生态 registry。

当证据链足够清楚时，生成可选 ThreatMap.v1 sidecar，记录 source → transform → sink 的 dataflow 路径：

omv threat-map init <id>

这会在 .omv/threatmaps/<id>.yaml 生成骨架（finding_id 和 package 块已从 finding 填好，paths: [] 留待填写）。然后在每个已确认的 source → sink 路径下补一条 paths[] 条目：source（type/location/description）、transforms[]（中间每一步：parse/decode/normalize/validate/authorize）、sink、guard（present/bypassable）、confidence。Schema 见 contracts/threat-map.v1.yaml。ThreatMap 是 Evidence.v1 的补充，不替代 evidence.source / evidence.sink / evidence.guard 摘要字段；sidecar 不修改父 Evidence.v1 文件。填写后运行 omv threat-map validate <id>。