vmihalis/ctf-solve
GitHub: vmihalis/ctf-solve
为 Codex 和 Claude Code 设计的 CTF 单挑战解题治理包装器，通过范围隔离、状态持久化和证据验证机制约束 AI 代理的解题行为。
Stars: 0 | Forks: 0
# ctf-solve
一个严谨的**单一挑战** CTF 解题工具套件，专为 [Codex](https://github.com/openai/codex) 和 Claude Code 设计。
`ctf-solve` 是一个**治理包装器，而不是技巧库。** 它不知道如何破解 RSA 或获取 shell。它让 agent 运行一个干净、可追踪证据、难以偏离正轨的解题会话，并将实际工作路由到 [`ljagiello/ctf-skills`](https://github.com/ljagiello/ctf-skills) 中的分类指南。
## 它增添了什么
在上游 `solve-challenge` 调度器的基础上，此技能强制执行：
- **单一挑战范围** - 仅在当前挑战目录中运行，拒绝从 workspace 根目录运行，杜绝跨挑战上下文污染。
- **持久化本地状态** - 写入 `NOTES.md`、`ATTEMPTS.md` 和 `RESULT.md`（由标记拥有的区块），使得会话可恢复且易于交接。
- **防卡死检查点** - 在 3 次实验失败、10-15 分钟无进展或分类矛盾后，强制执行转移或卡滞交接。
- **基于证据的 flag 提升机制** - `unsolved -> candidate -> verified-format -> verified-repro -> stuck`。只有当 flag 能从挑战产物中复现时，才会被报告为最终结果，这防止了自信地报告诱饵 flag。
- **护栏** - 绝不自动提交，绝不活动解题过程中自动安装工具。
## 它没有增添什么
零解题技巧。所有的 crypto / pwn / web / reverse / forensics 能力都存在于 [`ljagiello/ctf-skills`](https://github.com/ljagiello/ctf-skills) 中，此技能会加载并路由到该库。请先安装它。
## 安装说明
先安装上游指南，然后再安装此包装器：
```
npx -y skills add ljagiello/ctf-skills -a codex -a claude-code
npx -y skills add vmihalis/ctf-solve -a codex -a claude-code
```
接着，在单个挑战目录内运行：
```
cd path/to/one-challenge
codex --yolo # or start a Claude Code session
$ctf-solve # optionally: $ctf-solve
```
## 路径说明
技能主体引用了作者的 workspace 布局（指南库使用 `~/ctf/.agents/skills/...`，运行时副本使用 `~/.codex/skills/...`）。如果你的布局不同，请调整 [`ctf-solve/SKILL.md`](ctf-solve/SKILL.md) 中的预检路径，使其指向你安装 `ljagiello/ctf-skills` 指南的位置。
## 许可与署名
- **此包装器**（`ctf-solve/SKILL.md` 及文档）采用 MIT 许可证，版权所有 (c) 2026 vmihalis - 见 [LICENSE](LICENSE)。
- **基于** [`ljagiello/ctf-skills`](https://github.com/ljagiello/ctf-skills) 构建（MIT，版权所有 (c) 2026 Lukasz Jagiello）。那些分类指南**没有在这里进行本地化或重新分发** - 请单独安装它们（见 [安装说明](#install)）。完整的上游 MIT 声明已在 [NOTICE](NOTICE) 中重现。
标签：AI编程代理, Claude Code, Codex, 任务治理, 工作流编排, 数字取证, 自动化脚本, 防御加固