CTF Super Hub — 它是什么以及如何工作

一句话概括

CTF Super Hub 是 CTF（夺旗赛）和逆向工程挑战的初学者友好“前门”——它告诉 AI 助手如何逐步引导你完成挑战，从“我完全不知道该怎么办”开始。

它不是工具集合，不是题库，也不需要你编写代码。它是一组技能——把技能想象成一份书面剧本，告诉 AI：“当用户给你一个挑战时，按照这个流程操作。”

---

它解决的问题

README 明确陈述了核心问题：“不是缺少工具——而是当你拿到挑战时，往往不知道第一步该做什么。”

它解决的典型初学者痛点：

• 无法判断挑战是 Web、Crypto、Reverse、Pwn 还是 Misc
• 看到许多技能名称，但不知道先调用哪个
• 不知道要输入的第一个命令是什么
• 希望 AI 逐步引导，而不是倾倒术语
• 希望有不同的输出风格（教学 vs. 竞赛 vs. 仅提示）

---

两个入口（你只需记住这两个）

1. ctf-super-hub（默认，推荐大多数人使用）

这是整个仓库的单一编排中心。它：

• 自动猜测问题可能属于哪个挑战类别
• 如果信息不足，先与你进行最小化头脑风暴
• 在三种输出风格之间切换：teaching、competition、hints-only
• 扫描你机器上实际安装的技能，只路由到这些技能（它永远不会推荐你未安装的技能）
• 可以将 Web/接口/漏洞验证工作交给 strix-* 技能
• 支持团队组建：1 个主要角色 + 最多 2 个助手

2. ctf-beginner-hub（适合纯新手）

主入口的更温和变体。相同的路由规则，但用通俗语言解释术语，并先提供简短教程。如果你是全新用户或容易被术语淹没，请使用此入口。

---

工作原理：两种模式

模式 1 — 自动路由

当你已有材料时使用：挑战文本、附件、URL、IP:PORT、源代码或二进制文件。它做三件事：

1. 判断挑战最可能属于哪个类别
2. 决定是否切换到更具体的 ctf-* 或 strix-* 技能
3. 只告诉你接下来 1–3 个最有价值的步骤

模式 2 — 先头脑风暴，再路由

当你完全不理解挑战、不知道材料是否足够、或不知道下一步该收集什么信息时使用。它做三件事：

1. 帮助你明确目标
2. 整理线索和缺失信息
3. 然后决定调用哪个技能

---

strix-* 是什么

它是增强层，不是第二个主系统。主流程由 ctf-super-hub / ctf-beginner-hub 处理；strix-* 仅在 Web、接口和漏洞验证操作时介入。你不需要记住 strix-* 名称——主入口会处理。

---

防止偏离轨道的两条规则

1. 交接契约：技能在当前任务完成前不会进入下一步。只有当你明确询问“下一步是什么？”时，它才会返回编排中心——它不会自行串联技能。
2. 安装感知路由：编排中心在推荐任何内容之前扫描实际安装的内容。永远不会建议未安装的技能。

---

如何使用（快速开始）

1. 安装技能文件夹到你的 AI 工具的技能目录（Codex、Claude Code、Gemini CLI 或 OpenCode——选择你使用的那个）。
2. 开始新对话（旧的、长的对话不太可靠）。
3. 粘贴起始提示，例如：

   “请使用 ctf-super-hub 帮助我解决这个挑战。如果你能确定类型，自动路由到最合适的 ctf-* 技能。如果信息不足，先与我进行最小化头脑风暴。默认使用教学风格。”

4. 粘贴你拥有的任何材料——挑战文本、URL、IP:PORT、附件、源代码、你已经尝试过的命令、你卡住的地方。你不需要完美组织。
5. 遵循它的下一步指令。 如果它说需要更多信息，这是正常的——它在工作，而不是坏了。

你也可以请求特定风格：teaching（更多解释）、competition（快速进展）或 hints-only（仅提示，不提供完整解决方案）。

---

安装（简要）

• Codex（推荐，最简单）：从仓库根目录运行内置脚本 ./install-to-codex.sh。它会创建目标目录，备份任何同名的现有技能，并复制所有内容。
• Claude Code / Gemini CLI / OpenCode：手动将文件夹 brainstorming、solve-challenge、ctf-*、strix-* 复制到工具的技能目录（例如 ~/.claude/skills、~/.gemini/skills、~/.opencode/skills）。
• 安装后，重启工具或打开新会话。

要验证安装：检查 ctf-super-hub/SKILL.md 是否存在于你的技能目录中，或启动新会话并用虚拟挑战测试。

---

版本检查和更新

自 v1.1.0 起，主入口自动检查更新：

• 每次进入时，它读取 UPDATE.json 并每 24 小时最多发出一次网络请求（失败是静默的，不影响使用）
• 如果存在新版本，会出现 🔔 提醒，显示版本号和说明
• 在提醒后立即回复 1 会触发更新脚本（拉取并重新同步所有技能）
• 如果你对技能有未提交的本地更改，更新拒绝运行并列出文件——它不会覆盖你的工作
• 也可以通过 scripts/update_skills.sh 手动更新（带有 --dry-run 标志预览）

---

质量保证

仓库有三层验证系统：

• L1 — 结构验证：python3 scripts/validate_skills.py 检查所有 35 个技能的前置元数据、描述触发名称、相对链接、Python 脚本语法和关键仓库文件。支持 --json 用于 CI 集成。
• L2 — 行为冒烟测试 / L3 — 保留回归：evals/hub-routing/ 包含 5 个盲测场景（RSA 分类、SQLi 增强、OSINT 反例、组合编排、reverse/pwn 保留）。不知道预期答案的执行者运行真实路由，然后法官 + 人工审查评分。任何路由规则更改后，所有测试重新运行；fixtures 作为回归基线。
• 轻量审计：叶子技能精简原则记录在 docs/skill-weight-audit.md。

---

需要记住的关键事实

• 你不需要先学习挑战类型分类——这正是重点。
• 你不需要记住技能名称——只需记住 ctf-super-hub 和 ctf-beginner-hub。
• 不建议只安装主入口——主入口的价值来自路由到其他技能。请一起安装 brainstorming、solve-challenge、ctf-* 和 strix-*。
• 单个 URL、zip 文件或 ELF 二进制文件足以开始——你不需要一开始就有完整信息。
• “我需要更多信息”是好迹象——这意味着系统在工作。
• 防病毒误报是预期的：仓库不包含可执行文件——只有 Markdown 文档、两个可读的 shell 脚本（一个复制技能文件夹，一个检查/打印需要安装哪些工具）和一个 Python 验证脚本。安全教育内容可能触发启发式检测；如果来自官方仓库，请将其加入白名单。

---

仓库结构（对你重要的部分）

你真正需要关心的只有三件事：

• ctf-super-hub/ — 主编排中心
• ctf-beginner-hub/ — 初学者变体
• START-HERE.md — 快速入门指南

其余部分（ctf-*/ 类别技能、strix-*/ 增强层、solve-challenge/、brainstorming/、scripts/、evals/、docs/）支持系统，但作为用户不需要关注。

---

社区

GitHub 负责分发；LinuxDo 社区负责中文反馈和讨论。项目通过 issues/PRs 和社区反馈邀请贡献，反馈哪些步骤最令人困惑。

底线：这个项目不是试图给你更多技能——它试图解决初学者最难的部分：当你不知道从哪里开始时，如何开始一个挑战。