关于 octopus-security-audit
octopus-security-audit 是面向 Codex CLI 的安全审查技能,通过 Claude Octopus 编排工作流执行检查。它支持扫描变更文件的快速模式和覆盖整个代码库的深度审计,包括对抗式审查。
主要功能
- 01快速与深度审计模式
- 02OWASP 与注入漏洞检查
- 03身份验证与密钥审查
- 04依赖项和配置检查
- 05STRIDE 威胁建模
适用场景
- 01提交前检查代码变更
- 02审查身份验证或支付模块改动
- 03审计 CI/CD 配置
- 04排查 Git 历史中的密钥
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nyldn/ claude-octopus --skill octopus-security-audit安装后在 Claude Code 中输入/octopus-security-audit确认已加载。
附带文件agents/openai.yaml
详细介绍
Host: Codex CLI — 此技能最初为 Claude Code 设计,后适配至 Codex。 交叉引用命令在 Codex 中使用已安装的技能名称,而不是
/octo:*斜杠命令。 使用当前启用的 Codex shell 和子 Agent 工具。在当前会话尚未提供相应能力前,不要声称某个提供方、模型或宿主子 Agent 可用。 宿主工具的对应项请参阅skills/blocks/codex-host-adapter.md。
执行约定(强制 — 不可跳过)
此生成的 Codex 技能保留了源技能中的强制工作流约定。
禁止:
- 当此技能要求执行所引用的工作流命令时,不要总结、模拟或跳过该命令。
- 未检查实际文件或命令输出前,不要声称提供方输出或验证产物已存在。
- 必需的提供方、命令或宿主能力不可用时,不要默默继续;请报告不可用的依赖,并使用受支持的替代方案。
安全审计技能
你的第一行输出必须是: 🐙 **CLAUDE OCTOPUS ACTIVATED** - Security Audit
在 ink(交付)阶段调用安全审计员角色,进行全面的安全分析。支持快速 OWASP 扫描和完整的红队/蓝队对抗测试。
用法
# Quick scan via security-auditor persona
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh spawn security-auditor "Scan for SQL injection vulnerabilities"
# Adversarial red team via squeeze workflow
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "Security audit the authentication module"
# Via auto-routing (detects security intent)
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh auto "security audit the payment processing module"
模式(自动检测)
| 模式 | 自动触发条件 | 置信度门槛 | 范围 |
|---|---|---|---|
| 快速(默认) | 标准安全扫描,差异中不包含敏感文件 | 8/10 — 仅报告高置信度发现 | 仅变更文件 |
| 深度(自动升级) | 差异涉及身份验证/安全/CI 文件,或用户明确提出请求 | 2/10 — 标记所有可疑内容 | 整个代码库 |
自动升级至深度模式: 满足以下任一条件时,技能会自动切换至深度模式:
- 差异包含符合以下模式的文件:
*auth*、*login*、*password*、*session*、*token*、*secret*、*crypt*、*oauth*、*saml*、*jwt*、*permission*、*rbac*、*acl* - 差异包含 CI/CD 文件:
.github/workflows/*、Dockerfile*、docker-compose*、.gitlab-ci* - 差异包含依赖文件:
package-lock.json、yarn.lock、Gemfile.lock、requirements.txt、go.sum - 用户明确说“deep”“full”“comprehensive”或“CSO”
无需用户采取任何操作 — 模式会根据 git diff 上下文自动检测。
模型选择注意事项:Fable 5.1
默认情况下,不要将安全审计任务分派给 Claude Fable 5.1 或保留的 Fable 5 ID。在授权审计中,其安全分类器可能会拒绝带有对抗性红队措辞的请求。请将这些任务转至 OCTOPUS_FABLE5_FALLBACK_MODEL(默认值为 claude-opus-5),并确保提示词以防御性方式表述(查找并报告漏洞;不要要求提供可用的漏洞利用)。拒绝明确指定 claude-fable-5-1 或 claude-fable-5 的精确模型覆盖设置。若遭到拒绝,则在 OCTOPUS_FABLE5_NO_RETRY=1 未启用时,恰好在回退模型上重试一次;若禁用了重试或重试仍被拒绝,则报告拒绝情况,不再进行后续分派。OCTOPUS_FABLE5_MODE=off 是明确的例外:它会为常规环境固定设置停用自动重新路由,但指定精确 Fable 安全席位时仍会采取失败关闭策略。详情请参阅:skills/blocks/fable5-prompting.md。
能力
核心(两种模式均支持)
- OWASP Top 10 漏洞检测
- SQL 注入和 XSS 扫描
- 身份验证/授权审查
- 密钥和凭证检测
- 依赖项漏洞评估
- 安全配置审查
密钥考古(深度模式)
扫描 git 历史,查找可能已被“删除”但仍保留在提交中的泄露凭证:
# Search git history for common secret patterns
git log --all -p --diff-filter=D -- '*.env' '*.key' '*.pem' 2>/dev/null | head -200
git log --all -p -S 'AKIA' --pickaxe-regex 2>/dev/null | head -100 # AWS keys
git log --all -p -S 'sk-[a-zA-Z0-9]{20,}' --pickaxe-regex 2>/dev/null | head -100 # API keys
git log --all -p -S 'ghp_|gho_|github_pat_' --pickaxe-regex 2>/dev/null | head -100 # GitHub tokens
git log --all -p -S 'password\s*[:=]' --pickaxe-regex 2>/dev/null | head -100 # Passwords
报告任何发现,并注明提交 SHA、文件和轮换凭证的建议。
CI/CD 管道安全(深度模式)
审计 GitHub Actions 和 CI 配置,查找注入和权限提升问题:
# Find all workflow files
find .github/workflows -name '*.yml' -o -name '*.yaml' 2>/dev/null
# Check for dangerous patterns:
# 1. Untrusted input in run: blocks (command injection via PR titles/branch names)
# 2. pull_request_target with checkout of PR code (code execution from forks)
# 3. Overly broad permissions (write-all, contents: write)
# 4. Missing pinned action versions (uses: actions/checkout vs actions/checkout@v4)
# 5. Secrets exposed to pull_request events (accessible to forks)
为每项发现标注严重程度(CRITICAL/HIGH/MEDIUM/LOW)。
技能与插件供应链(深度模式)
验证已安装的 Claude Code 技能和插件的完整性:
# List installed plugins
ls -la ~/.claude/plugins/ 2>/dev/null
# Check for skills that execute arbitrary bash
grep -r 'exec\|eval\|bash -c' ~/.claude/skills/*/SKILL.md 2>/dev/null | head -20
# Verify plugin sources (are they from known registries?)
cat ~/.claude/plugins/*/plugin.json 2>/dev/null | grep -E '"source"|"registry"'
STRIDE 威胁建模(深度模式)
针对目标组件,列举涵盖全部 6 个 STRIDE 类别的威胁:
| 类别 | 问题 |
|---|---|
| S 欺骗 | 攻击者能否冒充用户或组件? |
| T 篡改 | 数据能否在传输中或静态存储时被修改? |
| R 抵赖 | 是否可以否认操作而不留下审计记录? |
| I 信息泄露 | 敏感数据是否会通过日志、错误或侧信道泄露? |
| D 拒绝服务 | 服务是否会被压垮或耗尽资源? |
| E 权限提升 | 低权限用户能否获得管理员访问权限? |
Persona 参考
此技能封装了以下文件中定义的 security-auditor persona:
agents/personas/security-auditor.md- CLI:
codex-review - 模型:
gpt-5.2-codex - 阶段:
ink - 专长:
owasp、vulnerability-scanning、security-review
提示词示例
"Scan for hardcoded credentials in the codebase"
"Check for CSRF vulnerabilities in form handlers"
"Review the API authentication implementation"
"Red team review the payment API"
对抗模式(squeeze 工作流)
如需进行全面的安全测试,请使用 squeeze 工作流运行 4 阶段对抗循环:
- 蓝队(防御):Codex 审查代码、识别攻击面并提出防御措施
- 红队(攻击):Antigravity 尝试突破防御并生成漏洞利用 PoC
- 修复(修复):Codex 修补发现的所有漏洞
- 验证(验证):Antigravity 重新测试,确认修复有效或判定失败
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "[user's security request]"
OWASP Top 10 覆盖范围
- 访问控制失效
- 加密失效
- 注入
- 不安全的设计
- 安全配置错误
- 易受攻击的组件
- 身份验证失效
- 软件完整性失效
- 日志记录与监控失效
- 服务端请求伪造
其他攻击模式
- 竞态条件、业务逻辑缺陷
- 拒绝服务、信息泄露
- 客户端攻击(XSS、CSRF)
高级选项
squeeze 只接受提示词,并运行一轮包含四个阶段的流程。它没有 --principles、--loop 或 --quality 选项,因此请在提示词中注明范围和严格程度:
# Focus on specific vulnerabilities
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "Audit for auth bypass only"
# Report every finding, however minor
${HOME}/.claude-octopus/plugin/scripts/orchestrate.sh squeeze "Zero tolerance audit: report every vulnerability, however minor"
何时使用对抗模式
| 方面 | 快速扫描(spawn) | 对抗模式(squeeze) |
|---|---|---|
| 速度 | 1-2 分钟 | 5-10 分钟 |
| 深度 | 单一视角 | 蓝队 + 红队 |
| 输出 | 问题列表 | 漏洞利用 PoC + 修复方案 |
| 适用场景 | 提交前检查 | 部署前审查 |
何时不应使用
- 生产系统(请使用真实的渗透测试工具)
- 合规审计(请聘用认证审计员)
- 法律验证(请咨询安全律师)
适用于:提交前安全检查、开发阶段测试、架构安全审查、CI/CD 安全门禁。