用途:编写任务导向的技术文档,覆盖 README、API 文档、架构文档与 Markdown 文档;也可在逆向、渗透测试、CTF 等安全分析完成后生成正式技术报告。触发场景包括:任务已产出核心结论(算法还原、签名破解、绕过方案)、已发现并验证漏洞、CTF 拿到 flag,或用户明确要求写报告/文档/writeup。
主要能力与用法:采用渐进披露分层输出,从一句话描述、快速开始代码到完整 API 参考与架构说明;警告、破坏性变更和前置条件置于顶部。写作遵循任务导向、Show Don't Tell,标题使用句首大写、最多三级标题、代码块标注语言、内部链接用相对路径,结构化数据用表格。报告模板按任务类型选择:APK/二进制/so 逆向、渗透测试、CTF 解题、JS/Web 签名逆向,以及恶意软件/APT 分析,参考 references/security-report-templates.md 与 references/vendor-report-rules.md。厂商报告结构支持 malware、apt 两种 flavor,vuln 为可选 thin overlay,无 flavor 时不强制 IOC/ATT&CK。输出位置为当前项目目录(若有 docs/ 则优先),文件名格式 YYYY-MM-DD_[类型]-[目标简称]-report.md,UTF-8 编码,语言跟随对话。图表通过 diagram-generator 生成 Mermaid 代码块嵌入报告。质量要求包括代码块可直接运行、无 placeholder/TODO、关键发现需证据支撑、复现步骤可独立重现、敏感信息以占位符替代,并包含 Evidence → Finding → Path 链。
限制:本技能为纯文本生成,不依赖外部工具,无需 bootstrap;渲染图表需调用 diagram-generator。具体工具路径依赖 ../tool-index.md 与 bootstrap 说明,原文未提供详细路径与安装命令。