report
确认漏洞后产出正式 SRC/0day 提交稿 DOCX 报告的收口 skill。仅在漏洞已确认、准备成稿时使用——负责查重、过分层验证门、按固定 DOCX 骨架生成报告(Heading 2 章节 + Step 式 PoC + 内嵌真实截图)、语义化命名、放对目录、处理驳回追加。不负责挖掘/验证漏洞本身。TRIGGER:用户说"写报告/出报告/成稿/提交稿/生成漏洞报告",或漏洞已验证到位准备交付时;或 /report。EN: Turns confirmed vulnerabilities into submission-ready DOCX reports for SRC/0day platforms (verification gates, fixed layout, step-style PoC, mandatory real screenshots). Trigger on "write report" or /report.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/v-yun--vuln-report-skill)HTML
<a href="/listings/v-yun--vuln-report-skill"><img src="/api/listings/v-yun--vuln-report-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install = make `SKILL.md` reachable as an instruction file by your agent. Examples:
# Claude Code: project-level skills directory cp -r vuln-report-skill <your-project>/.claude/skills/report # Claude Code: user-level (global) cp -r vuln-report-skill ~/.claude/skills/report # other agents: copy SKILL.md content into your rules/instructions file, # or point the agent at SKILL.md when a report is needed
`SKILL.md` and `template.docx` must stay in the same directory.
Package layout (tools are bundled — nothing extra to fetch):
vuln-report-skill/ ├── SKILL.md # skill 本体(总纲三指标+验证门+冷读门+版式+流程) ├── 0day.md # 0day/通用产品收录审查门 A-D + 通用型模板(成稿前必读) ├── README.md / LICENSE ├── template.docx # 版式基准(与 SKILL.md 同级,勿分离) ├── templates/submission_scope_gate_template.md # .gate.md 侧栏模板(定级推导+受理门三查) ├── templates/report_skeleton/ # 客户模板重写骨架(build_report.py + content 模板) ├── rigs/ # 截图 rig(Excel行/终端/CDP浏览器/全屏/OCR降级) ├── tools/ │ ├── dedup_check.py # 查重(语料 = 你自己的报告库) │ ├── ai_taste_check.py # 去AI味机器审计(零 LLM 计数器) │ ├── submit_gate.py # 交单物理闸(读 .gate.md 侧栏逐项校验,不过闸不出稿) │ ├── white_shot/ # 白底档案证据截图(客户交付观感) │ └── yakit_shot/ # 数据包截图渲染 Yakit 风格(国内平台形) └── docs/ # 本 README 效果图
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 388 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: report
- description: 确认漏洞后产出正式 SRC/0day 提交稿 DOCX 报告的收口 skill。仅在漏洞已确认、准备成稿时使用——负责查重、过分层验证门、按固定 DOCX 骨架生成报告(Heading 2 章节 + Step 式 PoC + 内嵌真实截图)、语义化命名、放对目录、处理驳回追加。不负责挖掘/验证漏洞本身。TRIGGER:用户说"写报告/出报告/成稿/提交稿/生成漏洞报告",或漏洞已验证到位准备交付时;或 /report。EN: Turns confirmed vulnerabilities into submission-ready DOCX reports for SRC/0day platforms (verification gates, fixed layout, step-style PoC, mandatory real screenshots). Trigger on "write report" or /report.
- ---
- # report — 漏洞报告成稿收口
- > **EN**: This skill turns confirmed vulnerabilities into submission-ready DOCX reports. The body is in Chinese because the target platforms (Chinese SRCs, CNVD/CNNVD, EDUSRC) require Chinese reports; the methodology is language-agnostic. See README.md for an English overview.
- > 这是**薄编排层**,只做一件事:把**已确认**的漏洞写成可直接提交给审核方的 **DOCX** 提交稿。
- > 漏洞怎么挖、怎么验证不在本 skill 范围;但"什么漏洞够格写成报告"的**分层验证门已内联在本文**,自成一体。
- ## 总纲:三条硬指标 + 一条生产原理(其余章节全部服务于这四句)
- **指标一 质量碾压**:同批报告里审核最先看懂、最没得挑的是我们的。护城河四件套,每份报告必有:
- - **首屏判决书**——名称+等级+一句话终局危害,审核 30 秒抓住全貌(他一天看几十份,谁省他时间谁赢)
- - **零摩擦复现**——报文原字节可重放,有条件就配双击即用的复现工具(HTML 工具/脚本),审核不用动脑就能验
- - **证据密度**——每个关键声明旁边就是截图/报文,全文没有一句需要"相信我";数字全部实测("实测3条跨3省、枚举空间万级、oracle 引导"这种写法),禁"可能导致严重信息泄露"式空话
- - **危害独立成节且量化**——这是和别人拉开差距的主段,不是描述段的附庸
- **指标二 速度**:竞测按提交时间判 dup。内容一次写对、改=整体重写、全文循环≤2轮;同平台第二份起 15 分钟出稿(骨架缓存填空)。
- **指标三 省 token**:生产原理=**报告 = 缓存骨架 + 已归档证据 + 约 15 句本洞独特内容**。模型只写那 15 句(发现过程的关键判断、根因一句、危害数字、修复点),其余全是拼装——章节定式、平台要件、格式、图注套话都不该现场生成。证据在挖的时候已归档(req.raw/resp.raw/截图+一行溯源),报告期回头重抓一次都算违规。
- **冲突裁决**:质量 > 速度 > 省 token。但三者 90% 场景不冲突——冲突通常意味着在错的层打补丁(回 md 层整节重写)。
- ## 何时用 / 何时不用
- - ✅ 用:漏洞已确认(硬门过了)、准备成稿交付、扩大危害后更新报告、被驳回后追加申诉。
- - ❌ 不用:还在挖 / 还在验证 / 只有单点信号没到终局 → 继续验证,别急着开报告。
- **前置铁律**:无 PoC = 不存在漏洞;影响没落地到链路终局 = 不写报告。P3 以下不写。
- ---
- ## 分层验证门(成稿前必过,本 skill 自带完整判据)
- > 分两层:**硬门**(所有漏洞必过,缺一不报)+ **按类型命门**(不同类型的"关键钥匙")+ **质量项**(尽力,不卡报告)。
- > **同源同步律(立)**:本节若与内部总档同源双拷,改任一处必同步另一处——两处判决漂移=审核口径分裂。
- ### 硬门(所有漏洞必过,缺一不报)
- 0. **先证伪(正常功能排除)** — 先假设"这就是正常功能",主动跑否定实验去推翻它:未授权→用 `zzz不存在<时间戳>` 跑同协议,看是不是 catch-all/公开/样例;越权→用合法 body 重测排除 400 假阳性、POST 排除 SPA 回退;SSRF→确认是不是服务端正常连接功能而非越过边界。**证伪必须枚举并杀掉正常功能解释的最大版本**(厂商实际持有的完整设计模型,如"对象本就公开+PII主动脱敏即其隐私设计")——杀了第一个 plausible 窄假设就停=假阳性证伪(某判例定罪);响应里厂商主动脱敏的字段/公开路径前缀="他们想过曝光"的设计痕迹,反着读;外部区分不了"坏了"vs"设计如此"时禁按 High 交。**证伪不掉,才可能是漏洞;证伪掉了,作废不报。**
- 1. **PoC 可复现** — 能直接粘贴抓包工具原始请求块,不需要额外解释上下文。
- 2. **真实业务影响(链路终局,危害要实际打出来)** — 拿到别人的 ≥3 个敏感字段真实数据 / 操作真实生效改了别人业务状态 / 凭证实际访问到敏感内容。是数据泄露/账户接管/资金损失/服务端 RCE/内网横向的**终局结果**,不是中间信号(文档/token/拓扑泄露不是终点),不是"理论上有风险"。打不出实际危害 = 信号作废 = 不报。
- 3. **服务端/权限边界确认** — 是服务端或权限边界问题,不是浏览器 JS 假象/调试功能/页面渲染。
- 4. **类型命门** — 命中下方按类型命门表中对应行的硬条件。
- 5. **链式追问到终局** — 已顺根因穷举同类接口 + 纵深追到危害边界(不是问一层就交),或已记录"为什么到此为止"。
- ### 按类型命门表(不同类型,关键钥匙不同)
- | 漏洞类型 | 命门(硬条件) |
- |---------|--------------|
- | 数据泄露 | 别人的数据 + ≥3 敏感字段 + 非公开/非样例/非模板;自己测试账号数据 ≠ 漏洞 |
- | 越权 / IDOR | **A/B 交叉证明**:A 拥有的资源,B 的 token 能读/改;只读到自己不报;**B 回 `[]`/null ≠ 被拦**——必须对 owner 视图比对,B 非空且=A 内容才算成立 |
- | RCE / 命令执行 | 真实命令执行实证;"别人的数据"对 RCE **天然不适用**,能执行命令本身就是危害 |
- | SSRF | 服务端发出(回调 UA 证明 Java/Go/Python,非客户端 JS fetch)+ **有官方靶场必须先过靶场(不过不收);无靶场必须回显内网数据**(云元数据/内网服务 banner/内网页面内容)。**DNSlog 只是其中一步**:出网响了 = 敲门砖,必须继续打到回显/危害终点,仅 dnslog 记录直接交 = 半成品不收 |
- | 认证绕过 / ATO | **任意**用户可绕过/接管,不只证明自己能登自己号;OAuth/JWT/密码重置逻辑要 A/B 双账号证明 |
- | 业务逻辑 / 资金 | 操作**真实生效** + 影响的是他人业务状态(金额/订单/状态机跳转),不是自己测试数据 |
- | 文件上传 | **造成实际效果才算**:webshell 可执行(getshell)或存储型 XSS 触发(HTML/SVG 被服务端解析);只传上去/能访问但纯存储不解析 = 不成立 |
- | 注入 (SQL/NoSQL/SSTI/XXE) | 有确定输出/副作用证明(错误回显、时间差、OOB marker),不是"报错就报";**SQL 注入最低共识 = 注出库名 `database()`**(盲注需时间差 + 库名内容,特殊情况另议) |
- ### 质量项(不卡报告,写进报告说明即可)
- - **否定实验**:对存疑结论写出"如果这不是漏洞,最可能的解释"并执行证伪。
- - **跨环境复现**:两个 IP/浏览器/账号/机器之一复现。
- - **WAF/防护绕过已记录**:有防护→试了哪些绕过→结果;无防护→说明确认方式。
- - **审核自助六件**(学习报告吸收):①复验指引——凭证会过期,写明审核如何自助换新(具体到"新值从哪取");②清理台账+基线回核——动了生产状态列恢复动作+回核证据,不只说"已恢复";③边界声明——一段"没做什么"(未读值/未横向/未外传真实数据);④咬合证据——副作用写时刻与服务器日志/ID 毫秒级对上;⑤对照组内嵌——PoC 里放否定对照步骤(见「双重可读」否定对照条);⑥否定性结论修正段——主张不了的升级(RCE/接管)写判定矩阵(哪条路/证据/判死原因)+重评触发条件,防"通常可 RCE"式漂移。
- - **前置可达性台账**:报告里每个粘贴出来的 UUID/ID/token/邮箱/cookie/预制状态,答得出"攻击者起点能力→获取或创建步骤→活证据"一行;复现步骤开头禁出现无来源值("先拿到受害者 UUID"式开头=整条不成立)。
- - **独立第二方技术复现**(学习报告吸收,某公开复盘范本):Critical 级/生产实测类成稿前,spawn 独立会话用**独立构造的请求**(非重放原报文)复现一次核心链——两方独立复现⇒误报风险排除,写进报告附录。
- ### 双轨提交制(首报节奏;判轨标准 = 平台经济模型)
- - **走量轨**(Bugcrowd/Intigriti 等接收即计分平台):硬门 0/1/3/4 + 第 0 步查重过 + 类型命门命中**即交**;硬门 2(终局危害)和硬门 5(链式追问)不阻塞首报——Low/Medium 被接收就有分,深挖做成后作追加评论升级报告,不压首报(多份中等质量首报的总收益 > 单份完美稿,且首发占 dup 优势)。
- - **深度轨**(0day/政企攻防/H1 深度线等 per-report 高赏金):全部门含终局危害,一个不少。
- - 判不准时默认深度轨。
- ---
- ## 核心写作标准:双重可读(每份报告都要同时做到)
- 报告必须**同时**满足两个维度,缺一份都不合格:
- **① 小白可复现** —— 让完全不懂安全的审核者也能照着一步步复现出来:
- - 每个 Step 让人看懂:**做什么** → **在哪个 URL 操作** → **实际看到什么结果**;不跳步、不省略上下文、不用只有安全圈才懂的黑话而不解释。
- - 但"能复现"≠啰嗦:背景交代一两句够用,禁止八股标签和填充语(见下方「简洁硬规」)。
- - PoC 给可直接复制粘贴的完整原始 HTTP 请求块(**不放 curl**),配真实截图,照做就能看到同样结果。curl 只是传输工具:用它发包后把 `curl -i` 原始输出逐字转成 raw HTTP 请求块再进报告(机械无损动作),这份字节同时就是 yakit_shot 的输入。
- - **密度硬规——删解释句,留事实句**:每个 Step 的说明文字 ≤2 行;「漏洞描述」≤3 段、每段 ≤5 行;叙述句必须带事实锚(数字/路径/ID/时间/字段名),光有因果连接词和形容词的解释句=删。证据承载二选一:**形态A(正文贴原文,默认)**=自写叙述行数 ≤ 引用原文行数;**形态B(截图承载证据)**=正文叙述占比高属正常,但前提是每步都有配套截图+图注,两者皆无=纯叙述稿。AI 味的根源是叙述密度均匀+每句都在解释——人写报告是原始证据堆/截图流+极短的连接句。
- - **「结果:」跟逐字原文**:不只 HTTP 响应——服务端日志、终端输出、**回传侧证据**(收集服务器/beacon 收到什么、VPS 日志收到分块、pbpaste 读出写入值)都是"结果",0-click/外带类危害的终局证据常在回传侧不在响应里,原样贴进报告。
- - **否定对照写成正式 Step**:证伪/对照实验不留在心里——不存在的值→false、不经桥纯 JS→NetworkError、异源图→哈希不同,作为编号 Step 或差分判据表进复现步骤,审核直接看到"对照也做了",不等他自己怀疑。
- - 逻辑连贯顺滑,像一条能走通的路,不是散落的证据堆。
- **② 技术不空洞** —— 该有的技术深度一分不能少:
- - 讲清**根因**:为什么会有这个漏洞(鉴权缺失在哪一层/逻辑缺陷在哪/信任边界哪里破了)。
- - 讲清**原理**:接口如何工作、参数如何被利用、鉴权差异如何证明、payload 为何生效。
- - 给出**关键技术证据**:真实请求/响应字段、路由映射、代码片段、鉴权头对照、规模化数据统计。
- - 结论有据可查,不是"我觉得有问题",而是"因为 X 技术事实所以是 Y 漏洞"。
- > 判断标准:一个产品经理照着能复现,一个安全工程师看了觉得技术扎实、无懈可击。两个都过才算合格。
- ---
- ## DOCX 版式规格(格式基准,不得自由发挥)
- **生成方式**:python-docx。从同目录 `template.docx` 复制起步(已含全部样式),逐节 append。**不要**手写 HTML 再转换。
- **样式**(模板已内置,直接用样式名):
- - 正文 `Normal`(微软雅黑 11pt);章节标题 `Heading 2`(13pt 加粗);Step 标题 `Heading 3`;bullet 用 `List Bullet`。
- - **全文统一黑色**:模板已去除 Word 默认主题蓝(Heading/Title/边框全部 000000),标题与正文颜色一致。生成时不得再给任何文字/边框手动设置彩色。
- - **客户交付字体口径(政企客户报告定标)**:全文只两个字体族——正文中文宋体小四(12pt)+西文 Times New Roman;一级标题黑体四号(14pt)加粗、二级标题黑体小四(12pt)加粗;报文块等宽 Consolas 10.5pt。**七类段首标签词加粗**(问题描述:/测试地址:/验证过程:/风险程度:/风险分析:/修复方案:/边界说明:——只粗标签不粗正文,run手术=剥前段字符+插bold新run至pPr后)。漏洞等级只写等级不写推导;**国内客户稿不写 CWE 编号**;**问题描述/风险分析/修复方案尽量≤80字**(视觉宽=CJK计1/ASCII计0.5),挤出去的事实下沉验证步骤不丢。项目模板自带字体且客户未提异议时以模板为准,客户点名才切本口径。
- - **客户交付版式口径**:①每洞起新页(h3全部 pageBreakBefore),但**紧跟章标题的首洞不换页**——注意 w:pageBreakBefore 必须按 schema 顺序 insert_element_before(放在 outlineLvl 之后=Word 行为不稳定),比较前置段样式要用全名(当轮模板实际样式名)不是泛型'h2';②概况布局=段落→漏洞清单表→"测试对象为…"描述段→对象表(两表必须有描述段缓冲,不许贴脸);③目录sdt后的模板空段全删,概况顶格起;④页脚 PAGE 域页码(宋体9pt居中);⑤返回包不进正文——有图就不再写响应报文块(请求块保留);⑥**工具话术禁令**:正文禁"(工具内重放)"类编辑旁白,一眼AI;⑦**不脱敏令**:证据里的手机号/账号等一律原文,脱敏禁令>机器审计ID复现规则(冲突时按用户令保留并留档说明)。
- - 不用表格堆排版、不用卡片/配色——审核接受的是朴素的线性文档。
- **章节骨架**(Heading 2 按此顺序,可选节用〔〕标注):
- | 章节(Heading 2) | 内容要求 |
- |------|---------|
- | 漏洞名称 | 一句话:`资产 存在 漏洞类型 + 终局危害 漏洞` |
- | 漏洞等级 | 严重/高危/中危 + 一句定级依据(标题就叫"漏洞等级",不加"自评"等后缀;依据锚**目标平台自己的体系**——VRT/outcomes/判例带的档名,平台无体系才落 CVSS 分) |
- | 漏洞类型 | 类型全称 + CWE(如有) |
- | 漏洞影响资产 | 主资产域名/范围 + API 路径 + 关联资产 |
- | 漏洞URL | 纯 URL 列表,一行一个,**不写注解**("它是干什么的、参数怎么被利用"归漏洞描述讲) |
- | 漏洞描述 | 功能如何工作 → 根因 → 攻击者能干什么(编号列点)→ 关键验证结论(规模数字/IP/已确认事实) |
- | 〔测试账号与会话上下文〕 | 测试角色、account_id、复验用 Cookie/token(注明"过期重登替换即可")。账号从哪来的(自建注册/官方渠道);受害者与攻击者怎么隔离(双测试号/同机副本实例);测试环境说明(PoC 服务器/域名/证书来源——用公共 CA 免费证书则写明"受害者无需预置信任")。前置可达性台账在此节交代:报告正文每个陌生 ID/token 首次出现前,获取路径已说清 |
- | 漏洞复现步骤(POC) | 见下方 Step 规格 |
- | 漏洞危害 | 危害枚举(编号,每条带已验证事实)+ 影响数据明文样本(便于审核直接验证,不打码)+ 边界声明(未做的越权动作)。就这一节,不另开"影响数据示例" |
- | 修复建议 | 具体可执行(编号,含网段/参数级细节;根因已在漏洞描述讲清,不另开"根因分析"节) |
- 报告正文到「修复建议」为止。**「复验清单」「建议评级说明」「实际攻击场景」「根因分析」「漏洞关键点」「影响数据示例」一律不单开节**——复验走上方分层验证门(内部动作);定级理由只保留「漏洞等级」里的一句;攻击链时序和根因并进漏洞描述;数据样本并进漏洞危害。
- **定级纪律(立;全文见 .gate.md 模板 `docs/templates/submission_scope_gate_template.md`,勿在别处复写)**:档位锚目标平台自己的体系(VRT/outcomes/判例带),无体系才 CVSS 兜底;「漏洞等级」一句话=结论,**完整推导禁入报告正文**,写侧栏 `<报告名>.gate.md`(模板含:定级推导/L级/受理三查/敌意triager演练/先验%三段式);压价与虚高同罪(前置条件只计价一次);成稿跑 `python tools/submit_gate.py <报告.md>`,不过闸不进提交流程。
- ## 冷读门与成稿一致性(某保险众测实战定罪:P0 硬证据被审核三轮打回,全栽在呈现层)
- > 以下九条全部 当轮实锤,违反任一不出稿。
- **冷读门(出稿前最后一道独立 pass,人化 pass 之后)**:把全文当成只知道报告内容的零背景审核员**逐段读到底**(禁抽读),每段三问:这段在干什么?每个陌生值(UUID/密文/产品码/内部ID)首次出现时说清哪来的了吗?审核照这段能落到具体动作吗?任何一问答不上→补齐再交。实锤:某密文片段在截图里无源,审核问了三轮。
- **占位符禁令**:出稿报文/数据零占位符。`<AES密文>`、`<时间戳>`、`xxx` 类待填标记混进正文=伪造证据同罪,审核拿去重放必报错,信任一轮归零。没有原始字节就去抓,抓不到这步就不写。
- **证据禁自造**:截图/表格必须来自真实工具或真实文件的原样捕获。用自造 HTML 表格冒充资产清单截图(当轮实锤)=直接返工;正确做法=打开真实来源截真图(Excel COM 跳行截图一类)。
- **神秘值溯源律**:每个非显然值首次出现处必须一句交代来源+复验方法(哪个文件/哪条响应/哪个 URL 参数、审核怎么自己拿到)。说不清来源的值不进报告。
- **输入输出分明**:参数/加密类报告,每步开头一句"输入是什么、返回里哪些是服务端给的",杜绝把输出误读为前提(当轮:审核以为该密文是查询条件)。
- **整节重写律**:改结构=整节重写。禁止往旧段落间插补丁段——补丁摞补丁的实锤:步骤号 1→2→5、"实证1条/3条"自相矛盾、标签顺序反两次、孤儿段挂错位,全是"图快插一段"的产物。
- **一致性清单(出稿前逐项过)**:步骤编号连续;"实证N条"类数字声明全文唯一且一致;每个"下图/下两图"引用有对应物;模板必填标签成对齐全(漏洞编号/名称等);正文引用的密文/ID 在文中找得到完整值(截断须注明)。
- **交付环境适配**:给用户的复现件(数据包/脚本/工具)必须在**用户实际环境**(工具+出口)验证可跑才算交付,只验"我这边通"不算。环境有差异(TLS 版本/出口 WAF 改写)先造桥再交(当轮:包在我链路全通,用户 Yakit 连错三轮,最终靠 TLS1.2 降级桥收口)。
- **项目模板优先**:开写第一动作=找该项目的原生模板/已接受样例/规则文档(当轮实锤:某政务系统已是新定式,我还套旧模板被骂)。找到就照它的结构和格式走,找不到才用本 skill 通用骨架。
- **传统企业/政企稿法规锚**:银行/保险/政企类在「漏洞危害」节尾加一句合规锚——危害落个人信息引《个人信息保护法》、落数据安全/大量数据引《数据安全法》、落关键信息基础设施/网络运行安全引《网络安全法》,只引与已实证危害对得上的那部,不堆三部。审核方向上级汇报用合规语言,这句是他可直接抄的汇报材料;互联网 SRC 稿**不加**(量级实测数字才是它的语言,法规句反而外行)。
- **平台要件对表(开写第一动作)**:每个众测/SRC 的规则文档=需求文档。写前先读该平台的规则文件(如某保险众测《漏洞确认规则及测试红线要求》),把它明文要求的报告要件逐条抄成 checklist(该平台六要件:漏洞URL/具体参数/证明截图/利用报文/漏洞危害/修复建议 + 命名规则 + 工具日志留存),成稿后逐项打勾——**明文要件缺一不交**。同时按规则里的定级表/漏洞条目表对类型名和等级,禁自定义名称。实锤:003 缺危害节,审核说"该有的没有";参数来源 20 段又"不该有"。
- ---
- **模板重写TOC三坑**:①复制客户模板重写正文后,目录域缓存仍是**上一个客户的条目**,交付即泄漏他司系统名;②新插标题必须**段落级直设 `w:outlineLvl`**(模板老标题是 pPr 直设、样式里不带——探针读老标题的 val 复制),否则 Word 重建目录只剩模板残留的附录一条;③成稿后必须 Word COM `TablesOfContents.Update()+Fields.Update()` 重存 docx(缓存目录写进包里,不依赖客户打开时刷新),COM 存完再清一次 docProps(Word 回写 lastModifiedBy);COM 一进程一文档(连开第二个必 RPC 0x800706BA 阵亡)。**出稿前必跑渲染目检**:Word COM 存 PDF → PyMuPDF 逐页 PNG → 目检目录页/封面/报文截图页——文本层验证抓不到缓存目录这种渲染层缺陷。**批量图号重排后必 grep 双字头('图图')与孤儿引用再 build**。
- **图片尺寸与截图密度定标**:①docx 内嵌图宽=模板基线(探 wp:extent 取值)且**高≤4.3in**,图段落设 `keep_with_next` 防图注孤行——从第一次 build 就带上,别靠重建轮次修分页;②竖版大证据(pretty JSON 档案)**禁止整段铺**,必须节选关键字段+「其余略」重排成横版;③截图渲染密度对齐:860px 宽 @5.5in ≈157dpi,13px 字≈6pt 印刷可读——1300px 窗口渲的图按 5.5in 塞进 docx 会缩成 ~4pt 不可读;④深色控制台风截图在白底报告里观感差,档案证据一律白底+高亮+表格化展示,数据仍零改动原文。
- **报文图三律**:①**每洞一张关键报文图**——有报文复现价值的写操作/数据实证类才配图,trivial 读取类(正文已完整承载的 GET/配置面)不配,不是每洞机械配图更不是每步配图;②**固定常规尺寸**:渲染前对 raw 做请求≤24行/响应≤20行/单行≤180字符截断(截断处标记行"……(截断)"),禁止整包渲染大响应;③**样式统一性逐图审计**:全篇报文图必须同一渲染器同一风格,交付前逐图过一遍;**不可重放的写操作洞**(重放=再搞坏生产):图可按正文当时落档的 PoC 报文渲染,前提是正文记录来自当次实测落档,且图注如实描述。
- **用户编辑后手术律**:客户/用户在 Word 里改过交付文件后,**一律 docx 手术(run/段落级增删替换),禁止从内容模块重建**——重建=冲掉用户编辑。手术前先 diff 段落+表格两层摸清对方改了什么;手术时保用户格式(跨 run 替换用整段重写兜底);手术后一致性自查:概况计数与正文条目数、交叉引用编号、图号顺延、章节号引用。
- **python-docx 插入顺序坑(实锤两次)**:`insert_paragraph_before` 按调用逆序落位——先插"漏洞名称:"再插"3"再插"漏洞编号:",最终顺序是反的(漏洞编号最靠近锚点)。正解:要么按逆序调用,要么全插完后用 `ps[i].text` 逐一重写。下次用 python-docx 批量插段,插入完 print 一遍段落序确认。
- **字体统一流程(现场摸索)**:docx 字体不一致时——读模板 Normal 样式的 theme fonts(打开 docx 的 word/theme/theme1.xml 取 minorFont 的 latin + eastAsia,如 Cambria/宋体)→ 遍历全文所有 run 显式设置 `rFonts` 的 ascii/hAnsi/eastAsia 三个属性 → 同时设 `font.size = None` 让字号跟随样式。只设 `font.name` 不够(只改 ascii 不改 eastAsia),必须操作 rFonts XML 属性。
- **Excel COM 截图 ASCII 路径警告(GBK 坑)**:PowerShell 5.1 的 GBK 编码读不了中文路径——`Workbooks.Open('E:\报告库\...')` 直接报"找不到文件"。正解:先把 xlsx 拷到纯 ASCII 路径(如 `E:\tmp.xlsx`),COM 打开 ASCII 路径,截完删临时文件。rigs/excel_row_shot.ps1 已固化此流程。
- **视觉结论必须像素对拍(实锤:同一张参考图得到两种相反描述)**:视觉模型对复杂 UI 截图的描述不稳定——同一张图一次说"有标签栏"一次说"没有"。任何用于指导操作的视觉结论,必须用像素采样交叉验证(`PIL.getpixel()` 取关键位置颜色/布局边界)才可作为行动依据;纯视觉描述只能当线索,不能当事实。截图复刻类任务尤其如此:视觉说"左边白色右边深色",像素测出来两边都是 #EEF0F3——按视觉描述改就改错了。
- ---
- ## Token/时间经济(立法:先打出来 ≠ 先交上,报告慢=把首报权让给 dup)
- > 用户定性:洞比别人先出,报告写得久,别人先交。竞测按提交时间判 dup——报告环节的每一分钟都在烧首报权。四条铁律:
- **改=整体重写(禁 docx 补丁)**:审核意见回来后,按意见修改内容,然后**从头重新生成整个 docx**(python-docx 从模板起步全量写入)。禁止在已有 docx 上逐段插入/删除/改文字——python-docx 的段落操作是当轮十几轮返工的直接病根(insert_paragraph_before 逆序、图片错位、标签丢失、编号断档全是这么来的)。整体重写=内容一次到位+零残留问题。Word 文件被锁时直接告诉用户关文件,不盲试。
- **项目模板优先读(不预存不缓存)**:每个项目开始时,先找该项目/平台给的原生模板(已接受样例、规则文档、导入表格式),照着它走结构——它要什么章节就写什么章节,要什么格式就什么格式。内容质量永远按本 skill 的标准写(冷读/一致性/证据密度/去AI腔),不因项目模板降低。不预建平台缓存:每个项目现场读它的模板,比用过期缓存更准。("不缓存"只指平台/项目原生模板——指标二/三说的"骨架缓存"= template.docx + 通用章节定式 + 图注套话这类通用件,可缓存复用,两者不冲突。)
- **证据随挖随归档(报告期只拼装)**:漏洞确认的当轮就把 `req.raw/resp.raw/shot_*.png` + 每件证据一行溯源注释落进 `<工作目录>/evidence/`。报告期禁止回头重新抓包/截图/解密——当轮实锤:报告阶段反复重抓证据,每次都是完整一遍流程的 token。
- **全文读写循环 ≤2 轮**:checklist 可以多份,但全文级别的读+改循环最多两轮——第 1 轮成稿(写时就把要件/一致性/人化内联做掉),第 2 轮冷读批量修补一次收口。需要第 3 轮 = 说明在打补丁,回「整节重写律」推倒重写那一节。同平台第二份起目标 15 分钟出稿。**格式轮也算轮**:分页/图片尺寸引起的重建同样计入——超限说明版式参数没前置,正解=把图尺寸/keep_with_next/字体规范在第一次 build 就写死(骨架已带),不是辩解"格式轮不算内容轮"。骨架模板在 `templates/report_skeleton/`:build_report.py 换内容模块不换结构(含 outlineLvl/TOC-COM/孤儿媒体剥离/字体清扫全套钩子),同型第二份报告目标压到 5 分钟内。
- ---
- ## 成稿流程(按序执行)
- ### 第 0 步:查重(写之前必做,命中重复就停)
- 先跑确定性撞车检查(零 LLM,秒出):
- ```
- python tools/dedup_check.py <草稿.md|草稿.docx> # 已有草稿
- python tools/dedup_check.py --title "..." --asset "..." --vuln-type "..." # 落稿前快查
- ```
- - **HIGH(≥0.6)→ 停**:并报进原报告(第 5 步融合改写)或撤稿换资产/换类型——交上去就是 dup 罚声望(HP/H1 均扣 5)。
- - **MID(≥0.35)→ 人工四要素复核**:对照命中文件逐项核 `资产(同域名/IP)/根因(同一鉴权缺失/逻辑缺陷)/接口/影响面`,重合 ≥3 项走并报;只重合资产但根因/影响不同 → 可新写,报告里说明与已有报告的区别。
- - 脚本不可用(语料目录异常等)→ 回落老办法:Glob/Read 目标单位报告目录按上表四项人工查。
- ### 第 1 步:过分层验证门(判据见本文「分层验证门」节)
- 逐条打勾,硬门缺一不写。**0day / 通用产品漏洞先读 `0day.md`**:收录审查门 A-D(版本公开性/类型前提/案例证据/投递纪律)+ 通用型模板 + Step 规格全在那份文件里,任一否决项命中不按 0day 成稿(回挖掘或换平台通道)。
- ```
- [ ] 硬门0 证伪:假设"这是正常功能"并跑了否定实验,证伪不掉
- [ ] 硬门1 PoC 可复现:能直接粘贴原始请求块,不需额外解释
- [ ] 硬门2 危害是链路终局:资金/数据/接管/RCE/横向,不是中间信号
- [ ] 硬门3 服务端/权限边界确认:不是浏览器 JS 假象/调试/渲染
- [ ] 硬门4 命中类型命门(见上方按类型命门表对应行)
- [ ] 硬门5 同根因接口穷举完、纵深追到边界,或记录"为什么到此为止"
- [ ] 质量 否定实验:对存疑结论写出"如果这不是漏洞最可能的解释"并证伪
- [ ] 质量 跨环境/跨账号/跨IP 至少一种复现
- [ ] 质量 WAF:有防护记录绕过;无防护说明确认方式
- [ ] 质量 审核自助六件+前置可达性台账(见质量项节);Critical 级另加独立第二方技术复现
- [ ] 截图 每一步都有真实截图(浏览器打开原始 URL / 抓包工具 Repeater 实际响应 / yakit_shot 真实字节渲染),无一处自造渲染
- [ ] 双读 小白照着能复现(操作→PoC→结果)且技术不空洞(根因+原理+关键证据)
- ```
- 硬门全过 → 写。质量项缺 → 不卡报告,但报告里说明。
- ### 第 2 步:人化改写 pass → 机器审计 → 生成 DOCX
- **改写 pass 是独立强制步骤,不是"写作时注意"**——初稿文本整篇回读一遍,只干一件事:按上方「去AI腔硬规」(含结构级九条)+「人化对照」降噪改写。改完数一遍:圆括号注解 ≤8、"攻击者" ≤5、同一 ID 无第二次完整出现,超限继续改。实证:规则齐全、写作时也"注意了"的成稿仍带 61 处括号注解被人读出 AI 味——只靠写作时注意替代不了这一遍。
- **机器审计(立,主观回读不咬合就上计数器)**:改写完跑零 LLM 计数器,全绿才进 DOCX 生成:
- ```
- python tools/ai_taste_check.py <草稿.md|草稿.docx>
- ```
- 逐项数:八股连接词(首先/其次/综上/值得注意等=0 容忍)、括号注解(≤8 处且每处 ≤15 字)、"攻击者"(≤5)、"该X"(≤6)、名词化动词"进行/实现+名词"(≤2)、节尾总结句"由此可见/综上该"(0)、三连同构排比(0)、同一长 ID 完整复现(无第二次)、空话套话("严重影响/极大风险"无数字支撑=0)。任一项超标 → 回改写,**禁跳过禁手动放行**;英文稿加测 model-isms(the aforementioned/please note/furthermore 等)。
- 从 `template.docx` 复制起步 → python-docx 按「DOCX 版式规格」**一次性全量写入**(不分段生成,不分轮修改——需要改就从头重写整个文件)。要求:
- - 每个 Step 的截图用 `doc.add_picture(png路径, width=Inches(6))` 内嵌,紧跟"截图(...):"段落;分片截图(`_p2/_p3…`)**全部按序循环嵌入**,一张不落。
- - PoC 请求块保持等宽可读:整块作为独立 Normal 段落(可用单个段落内换行),**不打码**。
- - 数字、IP、marker、时间等所有事实**必须与截图/原始日志逐字一致**——写完回读截图核对一遍。凭记忆写数字极易出错(真实教训:一份报告里 DNSLog 数字凭记忆写了四处,全错,复核时才抓出来)。
- ### 截图铁律(最高优先级,绝不违反)
- **报告每一步都必须配真实截图,绝不允许自己 PS/仿造/手绘渲染效果。**
- - 截图来源只能是:浏览器打开目标原始 URL/响应后截图(可用浏览器自动化工具的截图能力)、抓包工具 Repeater 实际请求/响应截图、`tools/yakit_shot/render.py` 渲染的调试工具式截图(输入=真实抓包字节,契约见下)。
- - 凡绕过限制后能在浏览器直接打开渲染的图片/视频/页面/文件/JSON 响应 → **必须用浏览器打开原始 URL 截图**放进报告。
- - 每个 Step 的关键结果都要有对应截图,让审核者能看到"我确实在真实目标上看到了这个"。
- - **唯一例外**:目标内容客观无法在浏览器渲染时,才允许离线渲染/转存,并在报告里**明确写出为什么无法用浏览器直接截图**。
- - **PoC 数据包截图走 yakit_shot**(按用户参考图复刻):`python tools/yakit_shot/render.py --req req.raw --resp resp.raw --host api.example.com --out shot.png`,产出中文调试工具风格截图(863×435:行号双栏/蓝灰-琥珀-橄榄绿语法着色/转发-取消-目标 chrome/右缘检查器条,`--width` 等比缩放)。**契约=证据铁律**:req/resp 逐字节来自真实抓包(`curl -i` 原始输出/抓包日志/抓包工具导出文件),禁止手敲或改写任何字节,渲染只做外壳(着色 span 只包字不改字);拿不准的元数据留默认不编造。**改一字节=伪造证据**,比没截图严重得多。文本 PoC 同步保留 raw HTTP 请求块(永不 curl)。
- **截图来源优先级(某保险众测实锤:审核更认真工具界面,渲染图降级为兜底)**:
- ① 用户实际使用的抓包工具原生界面(Yakit 等抓包工具面板——用户已在用就取其原生截图/历史导出)→ ② 目标在浏览器可渲染的,浏览器打开原始 URL 截图 → ③ 来源物原样截图(Excel 原表跳行截图 / 可见终端跑脚本截图 / CDP 驱动真实浏览器截 HTML 工具页——rig 已固化在 `rigs/`)→ ④ yakit_shot(tools/yakit_shot/render.py,863×435 Yakit风格+完整语法着色,v8定版用户验收通过;命令: python tools/yakit_shot/render.py --req req.raw --resp resp.raw --host 域名 --out shot.png --ms 实测ms)/ yakit_shot 渲染图(工具:tools/yakit_shot/render.py 仿 Yakit Web Fuzzer 风格——输入同样是真实抓包字节,渲染只做外壳,视觉验收 9/10)。①可得时禁用④。
- **长报文分片多图律**:渲染器已**去截断+高度自适应+超限自动分片**——响应超单片容量(yakit 90 视觉行)时自动输出 `shot.png, shot_p2.png, shot_p3.png…`,每片完整工具外壳、行号跨片延续。**docx 生成必须把全部分片按序嵌入**(`add_picture` 循环 `_p2/_p3…`),只嵌第一片=新的"只显示一部分";分片全嵌后正文 raw HTTP 块仍是完整可复制的全文(图给审核看、块给审核拷,两不缺)。
- **截图与正文绑定律**:每张图注指向的报文/值必须已在正文出现过("图1解密第2步请求中的 requestBodyJson"——该密文第2步正文必须有)。图里出现而正文没有的值(UUID/密文/ID)=审核"这哪来的"定时炸弹,要么进正文要么换图。(实锤:工具截图里的密文正文无源,审核连问三轮。)
- 截图 PNG 与 DOCX 同目录留存备查(如 `漏洞报告/国内/<单位>src/shots/`、国际线 `漏洞报告/国外/<平台>src/shots/`),DOCX 内图片为内嵌副本。任务收尾时截图随报告保留,不删。
- #### 截图工具速查(rigs/ 已固化,30秒选型)
- | 场景 | 工具 | 命令/位置 |
- |------|------|----------|
- | 数据包PoC截图(默认款,工具界面感强=真证据观感) | yakit_shot | `python tools/yakit_shot/render.py --req X --resp Y --host Z --out W --ms N` |
- | 档案证据展示图(JSON节选/表格化/代码行,白底+关键字段高亮) | white_shot系 | (报文对渲染) |
- | Excel原表行截图 | excel_row_shot | `rigs/excel_row_shot.ps1`(先拷ASCII路径!) |
- | 终端跑脚本截图 | console_run_shot | `rigs/console_run_shot.ps1` |
- | 浏览器截工具页 | browser_cdp_shot | `rigs/browser_cdp_shot.py`(需websocket-client) |
- | 全屏截图 | screen_capture | `rigs/screen_capture.ps1 <输出.png>` |
- | OCR读图降级 | ocr3 | `rigs/ocr3.ps1 <图片路径>` |
- #### 审核驳回恢复(收到意见后的标准动作,不现场想)
- 1. **分类**:意见是"缺要件"(补内容)还是"多了不该有"(删内容)还是"格式问题"(修格式)还是"复现不了"(修证据)?
- 2. **只改这一类**:不要"顺便优化"其他没被骂的地方——今天改A明天B又坏。
- 3. **整体重写**:按修改后的内容从头重新生成整个 docx,不在旧文件上打补丁。
- 4. **冷读被骂的那一段**:把自己当审核重读那一段,确认问题真正修了(不是换了个说法)。
- 5. **重交前一致性过一遍**:编号/数字/引用/标签——被骂过的报告二次提交又有低级错=信任归零。
- #### 截图能力检测与降级(开工前先判定,三级阶梯)
- **AI 不是天生会截图**——截图能力来自浏览器自动化工具(MCP)。成稿流程开始时先检测当前环境,按三级阶梯走:
- 1. **自动检测**:检查当前可用工具列表,凡是能"打开 URL + 截图"的都算——Playwright MCP、chrome-devtools MCP、Puppeteer MCP 等浏览器自动化工具提供的 navigate/screenshot 工具。**检测到就直接用**,每个 Step 由 AI 打开原始 URL 自动截图,无需询问用户。
- 2. **没有工具 → 给建议**:明确告诉用户"检测到当前环境没有浏览器工具,无法自动截图",并给出推荐安装命令(如 `claude mcp add playwright -- npx @playwright/mcp@latest`)。用户愿意装 → 装完回到第 1 级全自动。
- 3. **用户不装 → 人工供图**:每到一个需要截图的 Step,明确告诉用户"请把这一步的抓包工具/浏览器截图保存为 `shots/step<N>_<说明>.png`",用户放好后嵌入对应位置。**禁止**因为没工具就静默跳过截图、用"此处应有截图"占位、或用文字描述代替。
- 用户也不提供截图 → 报告不满足截图铁律,明确告知"缺真实截图的报告大概率被平台驳回",由用户决定是否继续,不偷偷降级成无图报告。
- #### 提交前自检(交稿前必过)
- - [ ] **冷读门过**:零背景视角逐段读完全文,三问全过(见「冷读门与成稿一致性」节)
- - [ ] **一致性清单过**:编号连续 / 数字声明全文唯一 / "下图"引用有物 / 标签成对齐全
- - [ ] **零占位符零自造**:报文无待填标记,截图表格全部真实来源原样捕获,神秘值全部有溯源
- - [ ] 截图裁掉/遮盖:任务栏、本机用户名(含路径里的用户名)、其他浏览器标签页标题、书签栏、浏览器登录头像
- - [ ] 请求块:不含与漏洞无关的个人标识(自己的 cookie/token/测试账号之外的隐私信息)
- - [ ] PoC/正文:本地路径打码;IOC 按目标平台风控规则脱敏(有平台会因正文含特定 IOC 关键词整单拒收,被拦时二分定位脱敏)
- - [ ] DOCX 元数据:作者/公司字段清空(生成后检查 docProps/core.xml)+ **隐藏部件整件剔除**:`docProps/thumbnail.wmf|jpeg`(文档属性预览图——docx 若从历史模板起步,可能携带上一位客户的整页缩略图并随派生件扩散;WPS 保存会再生)与 `docProps/custom.xml`(WPS KSOTemplateSaveRecord:hdid 设备ID+userId 账号ID);清法=zipfile 重写剔两件+同步清 [Content_Types].xml 与 _rels/.rels 引用;审计法=zip 逐 entry 提 ASCII 串+UTF-16LE 串+24+ 长 base64 试解码(XML grep 抓不住 WMF 二进制内嵌串,出库前按此扫一遍)
- - [ ] **Provenance 已落**:docProps 或侧栏 .gate.md 写明生产会话与生成时间——查无出处的 docx 按废稿隔离(幽灵稿判例:无会话留痕+范围外目标)
- - [ ] 报告内不留测试基础设施细节(代理、接码、邮箱服务商等)
- - [ ] **速度复盘(只记录、零豁免)**:全文读写循环 ≤2 轮,第 3 轮=回「整节重写律」推倒那一节;同平台第 2 份起记成稿耗时,超 15 分钟写拖慢原因进复盘。计时/轮数任何一项不构成跳过或压缩质量门的理由——冷读/一致性/机器审计/受理门永远先过完(质量 > 速度 > 省 token)
- #### 去 AI 腔检查(交稿前必过)
- 平台审核开始用 AI 检测+人工直觉筛报告,模板化 AI 腔会被降权/忽略。逐条过:
- - [ ] **句式人化**:消灭"首先/其次/综上所述/值得注意的是"类连接词;长短句混排,允许口语化短句("这里直接就断了""这步没拦")
- - [ ] **结构去模板**:不机械分"漏洞描述/漏洞危害/复现步骤"八股标题堆砌;按这个洞的叙事顺序走(怎么发现的→怎么验证的→打到什么)
- - [ ] **删掉正确的废话**:危害段不写"攻击者可能利用该漏洞造成严重影响"类空话,只写实际打出来的东西
- - [ ] **保留人味细节**:复现里带上真实判断痕迹("一开始以为是 X,测了 Y 排除"),这种否定实验过程 AI 腔写不出来,也是审核信任点
- - [ ] **术语不翻译腔**:直接用 Yakit/越权/getshell 等行话,不写"未经授权的访问漏洞(IDOR)"类教科书腔
- - [ ] **列表节制**:满屏 bullet 是 AI 指纹;能一段话说清的不拆列表
- - [ ] **括号注解数过一遍**:全文 ≤8 处、每处 ≤15 字(真数,不是"感觉没有")
- - [ ] **"攻击者"计数 ≤5**:多数句子无主语或受事开头
- - [ ] **同一 mid/订单号/数字无第二次完整出现**:后文全部用"该 mid"式指代
- - [ ] **详略不均匀**:核心 Step 最长,次要 Step 一眼扫过;每步等长=回去改
- - [ ] **机器审计全绿**:`python tools/ai_taste_check.py <docx>` 零超标(连接词/括号/攻击者/该X/名词化/节尾总结/三连排比/ID复现/空话,立)
- ### 第 3 步:语义化命名
- 文件名格式:`资产 存在 漏洞类型 漏洞.docx`
- ```
- api.example.com 存在订单接口越权读取他人敏感信息漏洞.docx
- console.example.com 存在文件上传绕过致存储型XSS漏洞_详细复现_2026-08-01.docx
- ```
- 阶段总结类可用:`单位SRC测试工作存在阶段总结报告.docx`
- ### 第 4 步:放对目录
- 一切报告统一进 `漏洞报告/`,国内/国外分仓(重组后约定,旧 `reports/` 已并入不再使用):
- | 目标 | 目录 |
- |------|------|
- | 国内企业 SRC | `漏洞报告/国内/<单位>src/` |
- | EDU | `漏洞报告/国内/edu报告/` |
- | 国内众测 | `漏洞报告/国内/众测/<项目>/` |
- | **政企攻防** | `漏洞报告/攻防/<项目名>/`——落盘前**先 ls 该目录对齐既有结构与命名**;文件名带 `_YYYYMMDD` 后缀、截图进 `shots_<子目录>/` 子目录;**政企攻防类永不去 国内/众测/**(用户怒斥判例:实测:政企报告误落众测目录,正确位=攻防/<项目>/ 且已有同项目成稿多份) |
- | 国内未提交暂存 | `漏洞报告/国内/未提交/` |
- | 0day / 通用产品 | `漏洞报告/0day/`(成稿前必先过 `0day.md` 收录审查门;未提交→待审核→作废分段;走通用型模板;报告内需含测绘语法、独立 IP 数、统计来源和时间) |
- | 国际平台(Intigriti/YesWeHack/HackenProof/H1 等) | `漏洞报告/国外/<平台或单位>src/`(英文稿;已提交移待审核/) |
- | 其他新单位(国内) | 在 `漏洞报告/国内/` 下新建 `<单位>src/` |
- | 其他新单位(国外) | 在 `漏洞报告/国外/` 下新建 `<平台或单位>src/` |
- **只有确认漏洞的最终 DOCX 进这里**。JS/抓取归档/临时产物一律不进,任务结束即删。
- ### 第 5 步:受理门(交用户前必过——"洞是真的"和"平台会收"是两道门)
- 立:曾两平台连判驳回(测错路径判 OoS、另两份判 informative),全部交前对用户打包过票、被连扣分。
- - 分层验证门过完只证明**洞成立**,不证明**平台受理**。交前必须按**这个程序自己的规则**做判断:scope 条款原文怎么定义、不收清单写了什么、近期同类判例怎么判——每个程序不一样,禁止拿上一个程序的理解来套;读多深按程序按情况定,不设固定动作。
- - **settled-class 第四查(某判例定罪:技术全确认仍判 N/A)**:该程序 GitHub issues/disclosed 报告里查这个问题**类别**是否已被裁决关闭——查重扫不到"已和解类",合约/协议/链历史类必查;命中 = 不交。
- - **红队分离评审(报告进未提交后、提交平台前必过)**:spawn 一个零上下文的独立红队评审(新会话/新 agent,不带生产语境),以最敌意 triager 视角逐份找 OoS/N-A 驳回理由(受理门四样:policy 原文映射/不收清单+判例/口味画像/settled-class)。红队结论与生产者结论并列交用户终审,红队判驳回 → 回去补证据或撤稿。自己写自己审 = 验证门形同虚设。
- - 判断产出 = 三段式答复:**预判(受理/OoS/N-A 风险)+ 依据(policy 原文哪条)+ 剩余风险(模糊点)**。对用户禁裸答"不会";答不出剩余风险 = 没查完,不许交。需亮依据时用 `docs/templates/submission_scope_gate_template.md` 的三查表格式(表是格式不是流程)。
- - 模糊点把握不住(条款两种读法/无同类判例)→ 如实说两种读法和各自后果,由用户裁决,不许自己挑利好的那种读法当成唯一可能。
- ### 第 6 步:更新 vs 驳回(两种截然不同的处理)
- - **正常补强 / 扩大危害**(未被驳回)→ **融合改写**:把新证据整合进对应章节(描述/Step/危害/评级),必要时重排 Step、替换旧证据为更强证据,重新生成一版干净 DOCX。**不要**在底部堆"补充/追加/扩大说明"。
- - **被审核驳回 / 需申诉**(明确被打回)→ **底部追加**:保留原报告上下文,在 DOCX 底部追加"驳回后补充说明/复核证据/申诉证据"(Heading 2 + 同样 Step 规格),不覆盖不另起;关键 PoC 发送到抓包工具重放器便于复核。
- ### 第 7 步:收尾
- - 只保留 DOCX(+ shots/ 截图源文件),删除对应临时目录/中间产物(Markdown 稿、转换中间文件也删)。
- - 确认漏洞后写复盘记录(什么信号命中的、哪步卡过、下次怎么更快)。
- ---
- ## 硬约束速查
- - **每一步配真实截图**,绝不自己 PS/仿造渲染;来源只能是浏览器打开原始 URL / 抓包工具 Repeater 实际响应 / yakit_shot(真实抓包字节渲染外壳)。
- - **PoC 永远是抓包工具原始 HTTP 请求块,报告里 curl 永不出现**(交过 curl 版被爆粗点名,定性=偷懒不是不知道)。curl 只作传输;数据包截图走 yakit_shot,契约=逐字节真实抓包,渲染只做外壳。
- - 报告内证据**不打码**(提交稿要能被平台验证);普通聊天里可摘要。
- - 只写能证明**非公开、他人数据、真实业务影响**的证据;公开内容/默认样例/自己测试账号数据 ≠ 危害,不写进危害。
- - 单纯密钥/token 泄露不单独成报,只作高危链证据。
- - CORS/安全头/版本号/Cookie 标志位/Self-XSS 不成报。
- - 报告最终产物只有 **DOCX**,不留 HTML/Markdown。
- - **受理预判永远三段式**(预判+依据+剩余风险),禁裸"不会"——答不出剩余风险=受理门没过,不许交。
- - **交付物只有 DOCX**——把 md 当交付物递给用户=违约,用户直接打回;md 永远是中间稿。发平台的任何文本(评论/申诉/说明)先过人化回读再出手。
README.md · README · 213 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # report — Submission-Ready Vulnerability Reports (AI Agent Skill)
- [English](#english) | [中文](#中文)
- ---
- ## 工作流程 / Workflow
- ```mermaid
- flowchart TD
- A0["挖掘中遇到信号"] --> A1{"⓪ 信号快筛<br/>止损 / 待验证 / 候选"}
- A1 -->|"明显不够格"| A2["当场止损,不烧 token 深挖"]
- A1 -->|"候选漏洞"| A["验证确认(有 PoC、打到真实危害)"]
- A --> B["触发:/report 或「写报告」"]
- B --> C{"① 查重<br/>同资产+同根因+同接口+同影响面?"}
- C -->|"撞车"| C1["不新写 → 补强旧报告 / 换资产"]
- C -->|"无重复"| D{"② 分层验证门<br/>硬门 + 类型命门"}
- D -->|"硬门缺一"| D1["打回继续验证,不允许开写"]
- D -->|"全过"| E["③ 生成 DOCX<br/>章节骨架 + Step 式 PoC + 真实截图"]
- E --> F["④ 语义化命名 + 归档"]
- F --> G{"平台审核"}
- G -->|"驳回"| H["⑤ 底部追加申诉证据(不重写)"]
- G -->|"通过"| I["收录 ✓"]
- ```
- ## 效果预览 / Demo
- > 演示对象为虚构靶标 `demo-shop.example`,仅展示生成报告的版式与结构;第 3 张为公共靶场(AltoroJ / demo.testfire.net)实拍,演示真实浏览器渲染页的嵌入效果。
- > Demo uses a fictional target to showcase the layout of generated reports; page 3 is a real browser capture from a public practice target, showing how rendered pages are embedded.
- | 报告首页(章节骨架) | PoC 步骤页(Step + 请求块 + JSON 截图) | PoC 步骤页(真实浏览器渲染截图) |
- |---|---|---|
- |  |  |  |
- 国内平台风格数据包截图(`tools/yakit_shot` 渲染:Yakit Web Fuzzer 风格 863×435,同样字节级忠实):
- 
- ---
- ## English
- A skill for AI coding agents (Claude Code, Codex CLI, Cursor, or any agent that reads markdown instructions) that turns **confirmed** vulnerabilities into submission-ready **DOCX** reports for SRC (Security Response Center) and 0day platforms.
- It doesn't find vulnerabilities — it makes sure the **report** is good enough to survive review.
- ### What it enforces
- - **Two-stage review**: a lightweight signal triage runs **while digging** (stop-loss on dead ends before burning tokens on verification) + full layered verification gates before writing (hard gates: reproducible PoC / impact driven to the final harm / server-side confirmation / falsification tests; per-type criteria for data leak, IDOR, RCE, SSRF, injection; 0day acceptance gates). No gate, no report — this filters out "signal ≠ vulnerability" garbage at the source.
- - **Dual readability standard**: a product manager can reproduce it step by step; a security engineer finds it technically solid. Both or rework.
- - **Fixed DOCX layout**: `template.docx` ships all styles (Heading 2 sections, uniform black, linear plain document), generated section by section with python-docx.
- - **Step-style PoC spec**: every step = one-line title + context + raw HTTP request block copied from any proxy tool (Yakit / mitmproxy — no curl) + conclusion + real screenshot.
- - **Screenshot ironclad rule**: every step needs a real screenshot from the live target; fabricated renders are forbidden. Captures run **fully in the background** (headless / CDP) — no browser or proxy window is ever yanked to the foreground. Packet evidence is embedded as raw text blocks; if the proxy UI is screenshotted, it must be the request/response detail pane, never the history list.
- - **Anti-AI-tone rules + machine audit**: kills template phrasing, filler words, and boilerplate — platform reviewers use AI detection plus human intuition, and template-tone reports get downgraded. Enforced by a zero-LLM counter (`tools/ai_taste_check.py`): paren-annotation quota, "attacker"-subject quota, textbook-"该X" quota, nominalized verbs, section-tail summaries, triple parallelism, repeated long IDs, empty severity phrases, EN model-isms. All green before the DOCX is generated.
- - **Packet screenshot renderer** (`tools/yakit_shot/render.py`): turns real captured bytes (req/resp) into a Yakit Web Fuzzer style screenshot (863×435, syntax palette) — byte-faithful, styling wraps bytes without altering them; changing one byte = fabricated evidence.
- - **Production economics (quality > speed > token)**: the report is assembled from a cached skeleton + evidence archived at discovery time + ~15 sentences unique to this bug — the model never re-generates boilerplate. Edits are whole-file rewrites (never docx patching), ≤2 full read-write rounds, second report on the same platform targets 15 minutes. A cold-read gate (9 rules from a real triage pain round) makes a zero-context reviewer understand every paragraph, every mystery value sourced, zero placeholders.
- - **Client-template rewrite skeleton** (): when the client hands you a fixed docx template (cover table + auto-TOC + per-finding seven-section layout), rewrites the whole file from it — outlineLvl probe, TOC refresh via COM, orphan-media strip, font sweep, image sizing all built in. Swap the content module, keep the structure.
- - **White-background archive shots** (): renders packet pairs onto a clean white canvas with key-field highlighting — for client-facing deliverables where dark debugger chrome reads badly.
- - **Capture rigs** (`rigs/`): battle-hardened helpers — Excel row screenshot (COM + ASCII-path pitfall), console run capture, CDP browser capture, screen capture, OCR fallback. Paths parameterized; nothing campaign-specific inside.
- - **Severity discipline + submission gate**: rating anchors to *the platform's own* system (VRT / outcomes / precedent bands) — CVSS only as fallback; full reasoning lives in a `<report>.gate.md` sidecar (template bundled), never in the report body. `tools/submit_gate.py` reads the sidecar and physically blocks submission until every check passes.
- - **Acceptance gate**: before submitting — policy-word mapping + out-of-scope list + precedent + settled-class check + independent red-team review (spawned via the Agent tool as an adversarial triager whose KPI is rejection), answered as verdict + basis + residual risk.
- - **Full workflow**: dedup check → gates → humanize rewrite pass + machine audit → DOCX generation → semantic naming → archiving → update-vs-appeal handling → cleanup.
- ### Install
- Install = make `SKILL.md` reachable as an instruction file by your agent. Examples:
- ```bash
- # Claude Code: project-level skills directory
- cp -r vuln-report-skill <your-project>/.claude/skills/report
- # Claude Code: user-level (global)
- cp -r vuln-report-skill ~/.claude/skills/report
- # other agents: copy SKILL.md content into your rules/instructions file,
- # or point the agent at SKILL.md when a report is needed
- ```
- `SKILL.md` and `template.docx` must stay in the same directory.
- Package layout (tools are bundled — nothing extra to fetch):
- ```
- vuln-report-skill/
- ├── SKILL.md # skill 本体(总纲三指标+验证门+冷读门+版式+流程)
- ├── 0day.md # 0day/通用产品收录审查门 A-D + 通用型模板(成稿前必读)
- ├── README.md / LICENSE
- ├── template.docx # 版式基准(与 SKILL.md 同级,勿分离)
- ├── templates/submission_scope_gate_template.md # .gate.md 侧栏模板(定级推导+受理门三查)
- ├── templates/report_skeleton/ # 客户模板重写骨架(build_report.py + content 模板)
- ├── rigs/ # 截图 rig(Excel行/终端/CDP浏览器/全屏/OCR降级)
- ├── tools/
- │ ├── dedup_check.py # 查重(语料 = 你自己的报告库)
- │ ├── ai_taste_check.py # 去AI味机器审计(零 LLM 计数器)
- │ ├── submit_gate.py # 交单物理闸(读 .gate.md 侧栏逐项校验,不过闸不出稿)
- │ ├── white_shot/ # 白底档案证据截图(客户交付观感)
- │ └── yakit_shot/ # 数据包截图渲染 Yakit 风格(国内平台形)
- └── docs/ # 本 README 效果图
- ```
- ### Usage
- Once a vulnerability is verified, just say:
- ```
- /report
- ```
- or "写报告 / 出报告 / 成稿 / 生成漏洞报告". The skill triggers automatically and runs gates → layout → workflow end to end.
- ### Requirements
- - `python-docx`: `pip install python-docx`
- - **Bundled tools** — `tools/` ships with the skill (dedup / AI-tone audit / submission gate / packet-shot renderer). No extra install; commands in SKILL.md refer to `<skill directory>/tools/...`.
- - **`yakit_shot` needs a local Chrome or Edge** for headless rendering — auto-detected from common install paths; override with the `YAKITRP_SHOT_CHROME` env var if yours lives elsewhere.
- - **Dedup corpus is your own report library** (default `漏洞报告/` under the working directory; point the `DEDUP_CORPUS` env var at your report library). An empty library gets an explicit warning and no verdict — the protection grows as you accumulate reports.
- - Screenshots — the AI can only capture screenshots if it has a browser tool. At startup the skill **auto-detects** available browser MCPs (Playwright / chrome-devtools / Puppeteer / etc.) and uses whatever it finds, capturing **in the background without stealing window focus**. If none:
- - **Auto (recommended)**: give your agent a browser tool — e.g. the Playwright MCP (`claude mcp add playwright -- npx @playwright/mcp@latest` on Claude Code, or the equivalent hook-up for your agent). The AI then opens original URLs and captures each step itself.
- - **Manual fallback**: if you don't install one, the skill switches to asking you to save each step's screenshot into `shots/` — it embeds them for you. It will never fabricate a render or silently skip a screenshot.
- - `shots/` is temporary: images are embedded into the DOCX, and the folder is deleted when the report is finished.
- ### Notes
- - The skill body (`SKILL.md`) is written in Chinese because the target platforms (Chinese SRCs, CNVD/CNNVD, EDUSRC) require Chinese reports. The methodology — verification gates, per-type criteria, PoC structure, anti-AI-tone rules — is language-agnostic.
- - **What it refuses to write**: signals without proven end-to-end harm, your-own-test-account data, below-P3 findings, CORS/security-header non-issues. The gate blocks them and tells you why.
- ---
- ## 中文
- 一个给 AI 编码代理用的 skill(Claude Code / Codex CLI / Cursor 等任何能读 markdown 指令的 agent 通用):把**已确认**的漏洞写成可直接提交 SRC / 0day 平台审核方的 **DOCX** 提交稿。
- 它不教你怎么挖漏洞,只解决一件事:**报告写得够不够好**。
- ### 它约束什么
- - **双重审查机制**:第一道在**挖掘过程中**跑——遇到信号先快筛(明显不够格的当场止损,不浪费 token 深挖);第二道在成稿前跑——完整分层验证门(硬门 / 按类型命门表 / 0day 收录审查门)。不过门不成稿,从源头挡掉"信号当漏洞"的垃圾报告。
- - **双重可读写作标准**:产品经理照着 Step 能复现,安全工程师看完觉得技术扎实——两个维度缺一返工。
- - **固定 DOCX 版式**:`template.docx` 内置全部样式(微软雅黑、Heading 2 章节、全文统一黑色),python-docx 逐节生成,朴素线性文档,不堆表格卡片。
- - **Step 式 PoC 规格**:每步 = 一句话标题 + 操作上下文 + 原始请求块(从 Yakit 等任意抓包工具原文复制,不放 curl)+ 结果结论 + 真实截图。
- - **截图铁律**:每步必须配真实目标截图,严禁自造渲染。截图**全程后台完成**(headless/CDP),不把浏览器或抓包工具窗口弹到前台;数据包以原始文本块入报告,截工具界面时只截请求/响应详情面板,不截历史列表。
- - **简洁硬规 + 去 AI 腔硬规 + 机器审计**:消灭八股标签、填充语、形容词渲染、模板化句式——平台 AI 检测和人工直觉都会筛掉模板腔报告。配套零 LLM 计数器 `tools/ai_taste_check.py`(括号注解/主语复读/教科书腔/名词化动词/节尾总结/三连排比/ID 复现/空话/英文 model-isms 逐项计数),全绿才进 DOCX 生成。
- - **数据包截图渲染**(`tools/yakit_shot/render.py`):真实抓包字节 → Yakit Web Fuzzer 风格截图(863×435,行号/语法着色),字节级忠实,渲染只做外壳。国内平台另有 Yakit Web Fuzzer 风格变体(`tools/yakit_shot/render.py`,863×435)——按审核习惯选形。
- - **生产三指标(质量 > 速度 > 省 token)**:报告 = 缓存骨架 + 挖掘期已归档证据 + 约 15 句本洞独特内容,模型不现场生成套话;改 = 整体重写(禁 docx 补丁),全文读写 ≤2 轮,同平台第二份起目标 15 分钟出稿。冷读门九条(零背景审核逐段读到底:占位符禁令/证据禁自造/神秘值溯源/整节重写律/一致性清单)管呈现层不死在最后一米。
- - **截图 rig**(`rigs/`):实战固化件——Excel 原表行截图(COM+ASCII 路径坑已防)、终端跑脚本截图、CDP 浏览器截图、全屏截图、OCR 降级;路径已参数化,不含任何战役残留。
- - **定级纪律 + 交单物理闸**:定级锚目标平台自己的体系(VRT / outcomes / 判例带),CVSS 只兜底;完整推导写 `<报告名>.gate.md` 侧栏(模板随包),禁入报告正文;`tools/submit_gate.py` 读侧栏逐项校验,不过闸不进提交流程。
- - **完整成稿流程**:查重 → 过验证门 → 人化改写 pass + 机器审计 → 生成 DOCX → 语义化命名 → 归档 → 更新/驳回两种处理 → 收尾清理。
- ### 安装
- 安装 = 让你的 agent 能把 `SKILL.md` 当指令文件读到,按你所用 agent 的方式接入:
- ```bash
- # Claude Code:项目级 skills 目录
- cp -r vuln-report-skill <your-project>/.claude/skills/report
- # Claude Code:用户级(全局)
- cp -r vuln-report-skill ~/.claude/skills/report
- # 其他 agent:把 SKILL.md 内容并入你的 rules/指令文件,
- # 或在需要写报告时让 agent 直接读 SKILL.md
- ```
- 目录内需保持 `SKILL.md` 与 `template.docx` 同级。工具随包分发,SKILL.md 里的命令以 `<skill目录>/tools/...` 引用,无需另装。
- ### 使用
- 漏洞验证到位后直接说:
- ```
- /report
- ```
- 或"写报告 / 出报告 / 成稿 / 生成漏洞报告",skill 会自动触发,按验证门 → 版式 → 流程走完全程。
- ### 依赖
- - `python-docx`(生成 DOCX):`pip install python-docx`
- - **工具随包自带**:`tools/` 目录(查重 / 去AI味审计 / 交单物理闸 / 数据包截图渲染)随 skill 分发,无需另装
- - **yakit_shot 需要本机有 Chrome 或 Edge** 做 headless 截图渲染——自动检测常见安装路径,找不到时设环境变量 `YAKITRP_SHOT_CHROME` 指向浏览器可执行文件
- - **查重语料 = 你自己的历史报告库**(默认当前目录 `漏洞报告/`,环境变量 `DEDUP_CORPUS` 可指向你的报告库)。空库会明确告警且不给出判定——保护力随你的报告库积累而增长
- - 截图——AI 手里有浏览器工具才能自动截图。skill 开工时会**自动检测**当前环境里可用的浏览器类 MCP(Playwright / chrome-devtools / Puppeteer 等),检测到什么就用什么,**全程后台截图不抢窗口焦点**。都没有则:
- - **自动(推荐)**:给你的 agent 配一个浏览器工具,例如 Playwright MCP(Claude Code 用 `claude mcp add playwright -- npx @playwright/mcp@latest`,其他 agent 按各自方式接入),AI 就能自己打开原始 URL 逐步截图。
- - **手动降级**:不装工具时,skill 会改成"你把每步截图存进 `shots/` 目录,我来嵌入"。绝不会自造渲染图,也不会静默跳过截图。
- - `shots/` 是临时目录:图片已内嵌 DOCX,报告成稿后该目录自动清除。
- ### 快速上手(完整流程示例)
- 前提:你已经**验证确认**了一个漏洞(有可用 PoC、打到真实危害)。这个 skill 不负责挖漏洞,只负责成稿。
- ```
- 你: 我刚确认了 api.example.com 的订单接口越权,B 的 token 能读 A 的订单,
- 手机号/地址/身份证都拿到了,抓包和截图都在。写报告。
- Claude:(自动触发本 skill)
- 1. 查重 —— 翻你历史报告目录,确认没写过同根因的
- 2. 过验证门 —— 逐条核对硬门/类型命门,不够格会直接告诉你缺什么
- 3. 生成 DOCX —— 按固定版式:章节骨架 + Step 式 PoC + 内嵌截图
- 4. 语义化命名 ——「api.example.com 存在订单接口越权读取他人敏感信息漏洞.docx」
- 5. 归档到 reports/<单位>src/;shots/ 截图目录成稿后自动清除(图片已内嵌 DOCX)
- ```
- 产物只有一份 DOCX,可以直接交平台。被驳回后说"报告被驳回了,补充申诉证据",会走底部追加模式而不是重写。
- **它会拒绝写什么**:只有信号没到终局危害的、自己测试账号的数据、P3 以下、CORS/安全头类——验证门会直接拦下并说明原因,不会硬凑一份垃圾报告。
- ### 适用场景
- - 企业 SRC 漏洞提交稿(各厂商 SRC 通用版式)
- - EDUSRC 教育行业漏洞报告
- - 0day / 通用产品漏洞报告(内置通用型模板章节骨架 + 收录审查门)
- ## License
- MIT — 详见 [LICENSE](LICENSE)。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.