用途:为 offensive-claude 仓库编写或编辑技能(skill)时提供约定,使调度器能发现技能、操作者能信任技能。该规范把 superpowers 的技能约定适配到攻击性安全领域。
主要能力与要求:
- 前置背景:需先掌握 superpowers:writing-skills(通用约定)与 superpowers:test-driven-development(技能像代码一样测试,先有基线失败)。
- description 字段只写触发条件与症状,用“Use when…”句式,绝不概括工作流,否则 Claude 会照描述执行而不读技能。第三人称;仅当技能本身针对特定技术时才写技术名;名称用动词优先或动名词。
- 技能布局采用渐进披露:skills/<name>/ 下含 SKILL.md(薄路由,≤180 行)、references/(逐技术深入:理论、2024-2026、代码、检测、OPSEC)、scripts/(可运行工具,无占位符)。
- 领域(技术)技能 SKILL.md 章节顺序:frontmatter → When to Activate → Technique Map(Technique | ATT&CK Txxxx | CWE | reference | script)→ Quick Start → OPSEC & Detection 表 → Deep Dives(链接到 references/)。
- 纪律技能(硬规则,如 finding/scope/opsec-discipline):Overview 含 Iron Law → 规则 → Red Flags(STOP 信号)→ Rationalizations 表(借口 | 现实)。明确“违反字面即违反精神”,并显式堵住漏洞。
- 四大支柱(每个技术):2024-2026 时效性(经网络搜索核实的 CVE,不得编造 id,未核实需标注)、可运行脚本、OPSEC 与检测配对、技术级 ATT&CK + CWE。
- 流程图仅用于非显而易见的决策点或“可能过早停止”之处;参考资料用表格,代码用代码块,线性步骤用列表。
- 交叉引用只写名称并加显式标记,如 REQUIRED: scope-discipline;不要用 @ 链接(会强制加载、消耗上下文)。frontmatter 的 references:/scripts: 列出技能附带文件。
- 信任前先测试:纪律技能须能抵抗压力下的合理化,把无技能时 agent 的借口逐条放入 Rationalizations 表并复查;安全相关脚本需 tests/ 套件(运行 pytest)并通过对抗性审查。
Red Flags:description 概括工作流需改为仅触发条件;领域技能缺 Technique Map、ATT&CK+CWE 或检测则不完整;纪律技能缺 Red Flags 或 Rationalizations 表则难以在压力下成立;伪造 CVE/arXiv id 需标注 UNVERIFIED 或删除。
限制:资料未提供具体安装命令、收费、平台或效果信息。