用途:将单个已确认的安全漏洞整理为可直接披露的报告,输出为 report.md,可粘贴进安全公告、审计发现或维护者 issue。
主要能力:按固定章节顺序撰写报告,必含 Summary、Details、Root Cause、Proof of Concept (PoC)、Impact;要求嵌入至少一段决定性代码片段并说明其证明内容;将仓库文件与补丁引用转为 GitHub markdown 链接,优先内联到解释句中;链接使用最新 commit SHA 而非分支名以保持稳定。报告须自包含,读者无需打开任何同目录工作文件即可理解漏洞、追踪、影响与复现。
使用方式:确认报告只针对一个漏洞;提取证明所需最小事实(脆弱组件或行为、攻击者可控输入或缺失校验、前置条件与信任边界、利用结果、实际影响、最强复现路径、决定性源码位置及相关修复提交);区分已证实事实与推断并显式说明假设;按 references/report-template.md 的章节顺序起草;保存到以严重性标识加小写连字符 slug 命名的文件夹,如 C1-cross-site-websocket-hijacking-re-enabled-by-allow-websocket/report.md,标题与内部引用也使用该 ID(如 [C1] Cross-Site WebSocket Hijacking)。
限制:仅处理单个漏洞;Low 严重性不单独出报告,只记入汇总表;除非用户明确要求,不添加 Affected Components 或 Remediation 章节;禁止指向 draft.md、debate.md、adversarial-review.md、metadata.json 等兄弟文件或内部阶段 ID(pN-NNN、AP-NNN),需要时须内联内容;可运行证据文件(如 poc.<ext>、evidence/<file>)仅允许在 PoC 或 Impact 章节引用。其他细节暂未提供。