chAng-L19/codex-redteam-mode

GitHub: chAng-L19/codex-redteam-mode

为 Codex CLI 提供按需启用的红队攻击模式配置框架,通过分层路由和轻量级 hooks 解决常驻型提示词污染正常工作和上下文爆炸的问题。

Stars: 265 | Forks: 25

# Codex 红队选择启用模式 English | [中文](./README_ZH.md) 一个轻量级、阶段感知的 Codex 红队操作配置。 本项目默认将 Codex 保持在**普通模式**,仅在你明确开启时才启用**攻击路由**。它现在新增了: - 选择启用的红队模式 - 轻量级 hooks - 结构化 JSON 模式状态 - 规则优先 + 语义阶段检测 - 会话隔离的模式状态 - 结构化攻击任务编排 - **阶段 → 方法 → 路由器 → 叶子节点** 路由 - 针对 `qiushi-skill`、`hack-skills` 和 `Anthropic-Cybersecurity-Skills` 的技能包风格集成参考 - 根目录下的 `config.toml` + `instruction.ctf.md` 配置文件布局 ## 为什么做这个项目 大多数“常驻型红队提示词”都以以下两种方式之一失败: 1. 它们**污染了正常工作** 2. 它们通过大量植入原则导致**上下文爆炸** 本项目采取了相反的方法: - **普通模式保持正常** - **红队模式需显式开启** - **hooks 保持轻量** - **路由保持分层** ## 特性 - **仅选择启用** - 普通模式为默认模式 - 红队模式仅在显式启用后激活 - **分层路由** - 阶段 - 方法 - 路由器 - 叶子节点 - **技能集成** - `qiushi-skill` → 方法层 - `hack-skills` → 技术路由层 - `Anthropic-Cybersecurity-Skills` → 技能包结构与渐进式披露参考 - **扩展的攻击领域** - web - ad - postex - reverse - code-audit - payload - evasion - **规则优先 + 语义回退** - 直接匹配优先 - 轻量级语义回退捕获不匹配精确关键词的自然语言提示词 - **会话隔离** - 一个会话不会覆盖另一个会话的模式状态 - **结构化编排层** - 侦查 → 策略 → 漏洞利用开发 → 审查 → 报告 - 产出模式与关卡 - 交付前审查工作流 - **跨平台安装** - Windows / macOS / Linux - **验证与测试** - 安装验证 - hook 验证 - router 验证 - 编排关卡验证 - 普通模式纯净度检查 ## 安装 安装程序执行的是**托管式增量安装**: - 保留现有的 `AGENTS.md` 和 `hooks.json` - 将本项目托管的代码块合并到 `AGENTS.md` 中 - 将本项目托管的 hooks 合并到 `hooks.json` 中 - 直接移除旧版安装中先前托管的运行时代码路径 - 全新安装当前运行时版本 - 为下次升级写入本地安装清单 - 安装后运行验证 ### Python ``` python scripts/install.py ``` ### Windows ``` powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 ``` ### macOS / Linux ``` python3 scripts/install.py ``` ## 快速开始 ### 启用红队模式 ``` 进入红队模式 开启红队模式 /redteam on /redteam light /redteam full enable red team mode ``` ### 进入强制红队模式 在启用 Redteam 后: 输入 Redteam Full ### 禁用红队模式 ``` 退出红队模式 关闭红队模式 /redteam off disable red team mode ``` ### 验证安装 ``` python scripts/validate.py ``` ## 工作原理 ### 1. 模式门控行为 项目在**普通**模式下启动。 除非显式启用红队模式,否则它**不会**将攻击原则注入到普通工作中。 ### 2. 轻量级 hooks 运行时 hooks 刻意保持轻量: - 极小的会话启动上下文 - 没有巨型提示词注入 - 没有常驻型攻击偏向 ### 3. 分层红队路由 运行时现在会发出一个紧凑的路由信封: ``` [security:redteam] [mode:redteam-light] [phase:web] [method:investigation-first] [router:auth-sec] [leaf:jwt-oauth-token-attacks] ``` ### 4. 结构化编排 对于较大型任务,项目包含一个轻量级编排层: ``` recon -> strategy -> exploit-dev -> review -> reporting ``` 该层**不是**常驻型运行时自动化。 它是一个结构化的规划与关卡框架。 ## 仓库布局 ``` .github/ config.toml instruction.ctf.md agents/ skills/ red-team-command-doctrine/ codex/ AGENTS.md hooks/ router/ orchestrator/ docs/ scripts/ templates/ tests/ ``` 规范的提示词现在位于: - `./instruction.ctf.md` 并且仓库根目录的 `config.toml` 通过以下方式指向它: ``` # Codex red-team profile model_instructions_file = './instruction.ctf.md' ``` ## 验证 项目会验证: - 模式启用/禁用 - 阶段路由 - 方法/路由器/叶子节点路由 - 语义回退 - 普通模式纯净度 - 会话隔离 - 编排关卡 ## 已知限制 - 这是一个**控制/配置层**,而不是一个完整的攻击平台 - 它不包含 RAG 或私有知识检索 - 执行深度仍然取决于你的 MCP/工具面 ## ⚠️ 免责声明 **本项目仅用于授权的渗透测试、红队研究和防御性安全实验。** - 仅在您拥有明确授权的情况下使用它。 - 严禁针对第三方或生产系统进行未经授权的使用。 - 作者和贡献者对滥用、法律后果、服务中断或数据丢失**不承担任何责任**。 - 使用本项目即表示您承担遵守适用法律和交战规则的全部责任。 ## 许可证 MIT 许可证,附带仅供授权使用声明。 参见 [LICENSE](./LICENSE)。
标签:AI合规, AI提示词工程, AI攻防模式, CISA项目, Codex定制, CSV导出, DNS 反向解析, Homebrew安装, HTTP工具, IP 地址批量处理, LLM路由, Prompt注入, Python安全, Red Team, Web安全, 云资产清单, 会话隔离, 免杀技术, 大语言模型安全, 数据展示, 无线安全, 暴力破解检测, 机密管理, 知识技能包, 红队, 结构化任务编排, 网络攻防, 蓝队分析, 载荷生成, 逆向工具, 逆向工程, 防御加固