用途:把 security-audit 技能的运行结果整理成面向客户的 psquared 品牌安全审计 PDF 报告。
主要能力:读取运行目录中已验证的 findings.json,仅采用 confirmed 与 needs_validation 记录,跳过 rejected;结合 report.json 生成标题页(含严重级别计数)、简介、范围与方法、概览表、发现卡片、修复顺序和审查限制。脚本按 critical、high、medium、low 排序,同级内已确认优先再按标题排序,ID 依此顺序生成。卡片展示根因、建议修复,未验证记录显示 expectedSeverity、exp. 标签与 Not yet verified 状态,并列出 blockers 中的未决点。内部审计措辞与 attacker/victim 等词会被替换为中性表述。
使用方式:先执行 cd ~/Documents/psquared/psquared-skills/skills/create-security-report 与 bash setup.sh;复制 examples/report-example.json 为 report.json 并填写 doc、customer、provider、summaryNote、scope、expectedSeverity、fixOverrides、fixOrder、limits 等字段;用 python3 命令列出所有 needs_validation 的 fingerprint;再运行 python3 scripts/prepare.py --run <run-dir> --report <run-dir>/report.json --out /tmp/security-report-config.json 与 node build.mjs /tmp/security-report-config.json "<run-dir>/psquared-Security-Audit-<Customer>.pdf";最后用 pdftoppm -r 60 -png -f 1 -l 3 "<pdf>" /tmp/sr-prev 抽查页面。
限制:未验证记录缺少 expectedSeverity 时脚本停止;记录回退到通用修复文本时会告警,需补充 fixOverrides。expectedSeverity 属估计值,发送前应人工复核。资料未提供收费、平台与效果信息。