文档大纲

Claude-Red如何把专家经验写成AI可调用的资产

如果你在用 Claude Code、OpenClaw 这类 AI Agent 工具,迟早会发现一个尴尬:模型很聪明,但一遇到专业活儿——比如「帮我审一遍这个 API 的注入风险」——它给的答案泛泛而谈,全是「需要注意 SQL 注入」这种正确的废话。

原因其实不玄学:模型缺的不是通用知识,而是某个具体领域的方法论。什么探测顺序、什么 payload、卡住了往哪走、什么时候该停手——这些如果不写下来,模型每次都得从零推理。

Claude-Red 就是把这套东西补上的。它把 78 个安全领域的「专家人格」打包成标准 SKILL.md 文件,你按触发词挂上去,Claude 就能像换了个专业脑子的工程师那样干活。本文拆解它到底怎么做的,以及这套思路能怎么借鉴到你自己搭的 Agent 技能库里。

它是什么:一个把安全专家「装」进 Claude 的技能库

先给个坐标:这是一个 Python 为主体的开源项目,MIT 许可,2026 年 3 月建仓,到 10 月中已经攒到 8,601 星、1,106 个 fork。体量不算最大,但在「AI 做安全」这条赛道上,它是目前最成体系的一个。

仓库档案速览

项值
仓库SnailSploit/Claude-Red
总星标 / Fork8,601 / 1,106
主要语言Python(技能主体实为 Markdown)
许可MIT
技能数量78 个 SKILL.md,23 个分类
创建时间2026-03-04
最近推送2026-10-12
当前版本v0.3.0,Unreleased 进行中

一句话定位

把 Claude 变成「上下文感知的红队操作员」的即插即用攻击性安全技能库。注意它卖的不是工具,是方法论——每个技能文件本质上是一份写得极其具体的作战手册。

它到底做了什么:一份技能文件长什么样

这是全项目最值得学的部分。Claude-Red 的技能不是「一段提示词」,而是一份标准 SKILL.md 文件——YAML frontmatter 加结构化正文,写清楚某个攻击面的完整方法论:探测手法、绕过思路、工具链命令、边界情况,以及什么时候该升级到下一步。

触发词密度:技能能不能被自动触发,全看 description

以 SQL 注入技能为例,它的 description 长这样(原文):

Use when performing web application SQL injection testing, database enumeration, privilege escalation via SQLi, or assessing injection vectors in APIs and modern stacks.

注意这句话里塞进了多少触发词:SQL 注入、bug bounty、枚举、权限提升、WAF 绕过、ORM CVE、API 注入。这不是啰嗦——AI Agent 是靠语义匹配决定「要不要加载这个技能」的,description 里没写到的词,模型大概率就想不起来去调它。

正文结构:先给主流程,再逐层展开

同一个文件(9,880 字节)的正文是这么组织的:开头一个「Quick Workflow」给 5 步主流程,让人一眼看到全局;然后展开 Detection,按 Basic Probes → Error-Based → Boolean Blind → Time-Based 排开;每个手法后面直接跟 payload 代码块,而不是「了解 SQL 注入原理」这种正确的废话。

关键设计:用不到的技能,不占上下文

78 个技能不可能全塞进上下文窗口,所以它走的是按需加载:技能按对话触发词命中才被读进来,用不上就完全不占 token。这套机制和 OpenClaw 的 Skills 机制完全同构——你如果熟悉那一套,看这个项目会觉得很亲切。

23 个分类、78 个技能:覆盖面到底有多宽

为了让你快速判断「这玩意跟我的活儿有没有关系」,这里把完整分类列出来。注意看分布——它不是堆了一批同质化的 SQL 注入技能,而是把安全工作的整个面铺开了。

分类技能数覆盖焦点
Web Application16OWASP Top 10、业务逻辑、高级 Web 漏洞
Wireless14802.11 / WPA2-3 / EAP / WPS / evil-twin / BLE / Zigbee / Z-Wave / LoRa
Infrastructure & Red Team7初始访问、EDR 绕过、Windows 内核
Exploit Development6栈/堆破坏、ROP、缓解机制、崩溃分析、TOCTOU
Fuzzing & Vuln Research4libFuzzer、AFL++、覆盖率引导、漏洞分类法
Post-Exploitation3横向移动、持久化、数据外泄
Auth & Identity2JWT 利用、OAuth/OIDC 滥用
Reconnaissance2OSINT 工具、结构化情报收集
API Security2REST/gRPC/WebSocket、业务逻辑滥用
Container & K8s2容器逃逸、集群攻击
CI/CD2流水线利用、密钥窃取
Cryptography2密码学实现攻击、TLS/SSL
Privilege Escalation2Linux/Windows 提权
Supply Chain2供应链攻击、依赖混淆
Social Engineering2钓鱼、vishing、smishing、U 盘投毒
Forensics & C22反取证、C2 框架操作
Active Directory1内网 AD 攻击方法论
Cloud1AWS/Azure/GCP 攻击路径
Mobile1Android/iOS 应用测试
IoT & Embedded1硬件、固件、RTOS、ICS/OT
Network Attacks1二层/三层攻击、MITM、协议投毒
AI Security1提示注入、越狱、RAG 投毒
Utility2快速分诊清单、专业报告模板

Web 应用占 16 个:密度最高,也最贴近日常

如果你是做业务的,16 个 Web 技能基本覆盖了你日常会遇到的:注入、XSS、反序列化、SSRF、文件上传、鉴权绕过、业务逻辑。每一个都是独立技能,而不是一篇「Web 安全大全」。

无线安全 14 个:少见的"重"领域

802.11 握手、WPA2/3 破解思路、evil-twin 钓鱼热点、蓝牙、Zigbee、LoRa——这块在 AI 安全项目里几乎没人做。它说明作者不是跟风做热点,而是按安全工作的真实分工在铺。

IoT 与嵌入式只有 1 个:诚实的留白

硬件、固件、RTOS、工业控制系统被归成 1 个技能,而另一些方向却拆成十几个。分类粒度的差异本身传递了信息:作者知道哪块是难点,哪块还只是浅尝。

AI Security 那 1 个:给 AI 时代补的一格

提示注入、越狱、RAG 投毒单独成类。在一个 2026 年的安全技能库里,这格的存在本身就是信号——它承认 AI 系统本身也是攻击面,而不只是干活的工具。

两个被低估的「元资产」

78 个技能本身是资产,但真正让这个项目「可运营」的是另外两个文件。它们的思路比技能内容更值得抄。

MINDMAP.md:把技能库当资产管理,不是当文档堆

这是一张 6,995 字节的 mermaid 思维导图,把 78 个技能全部铺开。它当然可以当导航用——但作者真正的用法是覆盖度审计:在接手一次安全评估之前,先对着导图看一遍,哪里是空的、哪块技能只覆盖了一半,一目了然。

这个差别很大。多数人的技能库是「攒」,攒到哪儿算哪儿;这里是「盘」,每次动手前先盘一遍家底。放到你自己身上同样成立——你有多少个电商运营技能、覆盖到哪类活动、哪个环节还是空白,一张图胜过翻目录。

CHANGELOG.md:把「变厚了」记成可审计的事实

v0.3.0 那次深度重写,CHANGELOG 里记的不是「优化了若干技能」,而是具体行数变化:

技能重写前重写后
offensive-deserialization183 行600+ 行
offensive-ssti347 行758 行
offensive-graphql207 行567 行
offensive-advanced-redteam146 行640 行

同时列出了 Phase 1~6 的拆分计划:Active Directory 拆 16 个、云身份拆 10 个、IoT 拆 10 个等。拆分即版本化——当一个技能太粗时,正确做法不是把它写得更长,而是拆成若干更细的技能,让触发更准、加载更省。

工程配套:作者考虑的是「别人怎么用起来」

一个技能库能不能被真的用起来,取决于安装门槛。这个项目的配套做得比同类扎实:

install.sh:支持只装一个分类

交互式安装,带 --target 和 --category 参数。你不需要 78 个技能全上身——只关心 Web 那一类,装 16 个就够。这直接决定了「上手成本」和「实际采用率」。

git sparse-checkout:避免全量 clone

配合按分类安装,仓库支持稀疏检出。78 个技能加上文档,完整克隆并不小;能只拉你需要的部分,说明作者清楚这东西会被放在什么环境里用。

claude-skills.json 与 convert_skills.py

前者是一份 58,607 字节的全量技能元数据索引,后者是一个 8,353 字节的批量转换脚本。一个管「查」,一个管「改」,让技能库可以被程序化地维护,而不是靠人手一个个编辑。

SECURITY.md:攻击性内容项目的标配

做红队内容必然有人会问「怎么用来搞别人」。作者直接把安全披露流程写清楚,这一步不少项目省了——省掉的后果是:一旦被滥用,仓库就成了别人攻击的现成手册。

引用基准公开:MITRE ATT&CK / OWASP WSTG / PayloadsAllTheThings

每个技能都能追溯到公开的攻防基准。这既是可信度背书,也方便读者交叉验证,不用只信作者一家之言。

六条能直接抄走的方法论

看完它做了什么之后,真正值得你带走的其实是下面这六条。它们跟安全无关,你搭任何 Agent 技能库都用得上。

一、description 写法是技能触发成功率的真正杠杆

它的 description 不是一句概括,而是一串触发词密集堆叠的「Use when…」句式。对比一下我们多数自己写的技能——「一句话摘要 + 几个关键词」,命中率差着量级。

可落地的动作很轻:把你高频真实用到的说法(中英文各一套)显式写进 description 的「Use when…」句式里。这不是玄学优化,改一次触发率就有肉眼可见的变化。

二、单技能 500–800 行是「深度密度」基准

重写后的技能普遍 500–800 行,每行都是可直接复制运行的 payload、命令或具体绕过点。我们多数技能正文不到 100 行——差距不在篇幅本身,而在每节都带可以直接用的东西。

方法论要落到可复制的具体物上。写「需要注意异常处理」没用,写出「执行哪个命令、看到什么输出、然后怎么做」,才叫方法论。

三、把覆盖度审计当一等公民

MINDMAP 的真正价值不是导航,是让缺口可见。作者靠它在开工前发现覆盖不足的地方。你也可以给自己的技能库维护一张「能力域 × 技能」矩阵,把「我觉得还差点什么」从模糊感觉变成一份可视化清单。

四、拆分即版本化

面对「一个 AD 技能太粗」的痛点,作者的做法是拆成 16 个细分技能,而不是继续往一个技能里塞。这条原则直接可用:一个巨型技能的上下文成本高、触发不准;拆细之后,每个都能被精确命中。

你可以拿自己手上的技能试试——如果某个技能经常「该触发时没触发」,八成是它同时想管太多事。

五、用可审计的事实替代模糊的形容词

「183 → 600+ 行」这种记录方式,把「这个技能变厚了」变成了可核对的事实。你自己的技能更新日志也可以这么写:新增覆盖点数量、扩展了哪几类场景、替换掉哪些过时步骤——远比「优化了 XX」有用。

六、攻击-防御镜像对:共用一套分类语言

GitHub 当日榜单上,一个做防御(多阶段安全审计)的头部项目和一个做进攻(红队技能库)的头部项目同时在榜——作者自己把它们称作镜像对。这个现象值得借鉴的是结构而非内容:用同一套能力域划分,让「审计方」和「被审计方」说同一种语言,才能互相检查覆盖缺口。

怎么用起来:上手路径

下面是一条最省事的路径,你自己也能走一遍——不是为了用红队手段,而是为了体会「专业技能库」是怎么搭起来的。

第一步:只看,不要装

先打开 MINDMAP.md 和任意一个 SKILL.md 的原文。看两件事:description 怎么写、正文是不是每节都带可直接复制的东西。这一步不需要任何环境,也是判断「值不值得学它的写法」最快的方式。

第二步:挑一个分类装

用 --category 只装你看得懂的那一类。对绝大多数读者来说,Web Application 或 Utility 就够了。别一上来全量 clone 再在目录里迷路。

第三步:观察它是怎么被触发的

装好之后,故意用几种不同说法提同一个需求,观察技能有没有被正确拉起来、命中的是不是最合适的那一个。这个观察过程,比读十遍 description 都有用。

第四步:抄它的写法,改你自己的技能

挑你自己的两个技能:一个改 description(加触发词句式),一个改结构(每节补可复制命令),然后对比触发命中率的差别。这是最低成本的验证。

什么时候用不上它:几个诚实的场景

不是所有项目都值得你投入,下面这些情况可以直接跳过。

你不做安全相关的工作

这 78 个技能全是攻防方法论。你要做的如果是内容运营、电商运营、常规后端业务,装了它们不会带来任何收益——它们唯一的价值在于「专业领域方法论怎么写」。

你的环境不允许装这类技能

有的团队对外部技能库、Claude 技能挂载有明确的安全规范,那就先看规范再看项目,别先装上再想办法解释。

你期待它直接给出可用结论

它是方法论库,不是答案机。给你的是「怎么查、按什么顺序查、卡住了往哪走」,具体结论仍然要你在自己环境里跑出来。别把装技能当成自动化。

你想找的是防御工具

这项目偏进攻侧(红队)。如果你要的是防御侧的审计工具,那是另一个方向的成熟项目,别在一棵树上找两边的果子。

内容声明与使用边界

Claude-Red 属于攻击性安全内容。本文只从方法论与技能工程的角度讨论它——怎么组织专家知识、怎么写 description、怎么用 MINDMAP 做覆盖度审计、怎么拆分技能。

本文讨论的技术内容仅供安全研究与防御参考。相关技能不部署、不用于任何未授权测试,不应用于攻击任何真实系统或他人资产。任何实际使用都必须在获得明确书面授权、且在自有或受控隔离环境内进行。

关于合规边界的三点提醒

第一,方法论本身没有违法与不违法之分,未经授权使用才有。你把「SQL 注入有 Error-Based、Boolean Blind、Time-Based 三类探测路径」写进自己的技能库,和你拿它去扫别人的站,是两件完全不同性质的事。

第二,公开漏洞与授权测试之间要画线。CVSS 分数高不等于获准测试;对方没给书面授权,再「只是验证一下」也可能构成未授权访问。

第三,把安全边界写进流程,比写在口头承诺里可靠。给自己团队的技能库加一条默认规则——涉及真实目标的技能必须显式标注授权范围——这个成本极低,能挡掉绝大多数麻烦。

结语:真正值得带走的是那个「思路」

Claude-Red 有 8,601 颗星,但如果你只是把它当成一个「红队工具包」来理解,你看不出它最有价值的地方。

它真正示范的是一件事:怎么把一个专家脑子里的隐性知识,变成 AI 可以按需调用、可以版本管理、可以审计覆盖度的显性资产。这件事跟安全没什么关系,它对任何专业领域都成立——电商、运营、数据分析、财务、法务,任何需要「让 AI 干专业活」的场景都适用。

如果你也在搭自己的 Agent 技能库,这篇文章里最值得你立刻动手的只有三件:给 description 加上「Use when…」触发词句式、给每个技能正文补上可复制的具体物、以及给技能库画一张覆盖度矩阵。

三件都不复杂,一下午就能做完第一个。而效果,通常比换模型来得明显。

阅读量: 311