ctf-solve-teach · 解题即教学
一个给 AI 用的 Skill：解 CTF 题的时候不许闷头算答案，必须边解边讲——这一步是什么套路、为什么用这个工具、背后的知识点是什么。
收尾自动在 solves/<题目名>/ 里产出可复现的完整 Writeup。
两种用法：作为 DSH 插件安装（npm: dsh-ctf-solve-teach，装完技能自动出现在技能目录），
或者把 skills/ctf-solve-teach/ 整个复制进任意 agent 的 skill 目录。
解决什么问题
用 AI 做 CTF，最常见的两种失败：
- 一口价答案。AI 三秒给出 flag，你抄完什么也没学到——下次换个皮还是不会。
- 流水账 WP。过程很详细，但没有"为什么用这个工具"，也没有"这个机制为什么存在"，看完只会做这一道题。
这个 Skill 把解题过程强制拆成七问循环，每一步都要交代因果；同时用目录契约和质量门，
保证每次都能留下来一份"三个月后自己还看得懂、别人能照着重做"的文档。
三条硬承诺（Skill 内置约束）
| # | 约束 | 具体表现 |
|---|
| 1 | 不许黑箱 | 任何命令落地前先说：现象 → 判断属于哪类套路 → 为什么是这个工具 → 期望输出 |
| 2 | 知识点讲因果 | 不说"PNG 改宽高"，要说"IDAT 解压字节数 = (1+宽×通道)×高，所以能反推" |
| 3 | 产物不外溢 | 所有中间文件都落在 solves/<题目名>/ 里，工作区根目录不许出现 out.png |
每一步长这样
① 现象：文件 1000 字节，file 说 data，前四字节 504b0304 —— PK 头
② 判断：ZIP 被改后缀（套路：容器嵌套）
③ 工具：7z l —— 只列目录不动文件，比 unzip 容忍坏结构；备选 ctf zip 能同时看伪加密位，下一步用
④ 执行：7z l chal.bin
⑤ 读结果：3 个条目，doc/flag.png 未加密、word.txt 加密 —— 伪加密/真加密分叉
⑥ 知识点｜ZIP 通用位标志
- 是什么：PK\x03\x04 后 offset 6 的 bit0 就是加密位
- 为什么在这：出题人改这一位就能让解压器喊"要密码"，而数据没加密
- 怎么认：能列条能看 CRC，一解压就报密码错
- 坑：bit3 数据描述符会让 CRC 失效，爆破要改用明文前缀
⑦ 下一步：先 --unpseudo 修伪加密；不成走明文攻击
产出物长这样
solves/真的假的/
├── README.md ← 最终 Writeup（9 个必备章节）
├── 00-brief.md ← 题目情报卡：题面原文 / 附件 / flag 格式 / 初始假设
├── journal.md ← 解题日志：每步七字段，含失败命令
├── flag.txt ← 一行 flag
├── artifacts/ ← 原始附件只读副本
├── work/ ← 解包产物、修复图、爆破日志
└── scripts/ ← 这次写的一次性脚本（别人能复跑）
solves/ 已写进 .gitignore：解题产物（flag、附件、他人题目内容）不会误提交。
README.md 的九个章节是质量门强制项（check_doc.py 会逐条查）：
- 题目情报 2. 一句话结论 3. 解题路径 4. 关键步骤复盘
- 工具与用法清单 6. 知识点地图 7. 卡壳与弯路 8. 可复用脚本 9. 同类题迁移
其中 第 7 章"卡壳与弯路" 和 第 9 章"同类题迁移" 是最少见的章节，
也是把"会做这道题"变成"会做这一类题"的关键。
安装
本仓库同时是 DSH 插件（npm 包 dsh-ctf-solve-teach）和 独立 skill，按需选一种。
方式一：DSH 插件市场（推荐）
在 DSH 里打开插件市场，搜索任一关键词：
ctf 教学式 CTF writeup 网络安全 取证
装完重启 DSH，技能目录里直接出现 ctf-solve-teach，不用再手动放文件。
插件的工作方式：cordis.patch.yml 把插件插进 profile，插件启动时读包内的
skills/ctf-solve-teach/SKILL.md，调用 ctx.skills.register() 注册成 runtime skill，
并把 references/ 与 scripts/ 作为 resourceBase 一起交出去——所以模型读到的是完整技能，
相对路径也能正确解析到示例与脚本。
方式二：纯 skill（不装插件，任何 agent 通用）
git clone https://github.com/Wangxiaolu0716/ctf-solve-teach.git /tmp/cst
cp -r /tmp/cst/skills/ctf-solve-teach ~/.dsh/skills/
Claude Code 把目标换成 ~/.claude/skills/；其他 agent 同理，只要它的 skill 目录认 SKILL.md。
方式三：本地开发
git clone https://github.com/Wangxiaolu0716/ctf-solve-teach.git
cd ctf-solve-teach
node --test # 插件冒烟测试，4 条
npm pack --dry-run # 看会发布哪些文件
用法
装好之后不用记命令，直接用自然语言触发：
帮我解一下这道杂项题，附件在 D:\ctf\chall.zip
这道流量分析题我的思路卡住了，边解边讲
给我写个 wp，按教学向的那种
Agent 会自动：建目录 → 建情报卡 → 逐步解题并讲解 → 收尾写 README → 跑质量门。
也可以手动调脚本
# 建目录骨架（可带附件，会复制进 artifacts/）
python skills/ctf-solve-teach/scripts/new_solve.py "题目名" --src 附件或目录 --category misc
# 交付前自检
python skills/ctf-solve-teach/scripts/check_doc.py "solves/题目名"
new_solve.py 是幂等的：目录已存在时只补缺失文件，不会覆盖你写了一半的 README。
目录结构
ctf-solve-teach/ # npm 包 dsh-ctf-solve-teach
├── package.json # 包元数据，dsh.bundle.patch 指向下面的补丁
├── cordis.patch.yml # 把插件插进 DSH profile 的 4 行补丁
├── plugin/
│ └── index.js # 零依赖：读 SKILL.md → ctx.skills.register()
├── test/
│ └── smoke.test.mjs # 冒烟测试：解析/注册/卸载/frontmatter
└── skills/ctf-solve-teach/ # ← 技能本体，可单独复制进任何 agent
├── SKILL.md # 三条承诺 + 七问循环 + 判型表 + 纪律
├── references/
│ ├── triage.md # 60 秒判型决策树（按附件类型分流）
│ ├── toolbox.md # 工具库：用途/命令/备选/何时别用
│ ├── knowledge-index.md # 知识点索引（ID 化，含深水区展开）
│ └── writeup-template.md # README 模板
├── scripts/
│ ├── new_solve.py # 建目录骨架
│ └── check_doc.py # 交付质量门
└── examples/ # 真实跑通、已过质量门的示例
插件是怎么工作的（60 行代码）
package.json 里的 dsh.bundle.patch 指向 cordis.patch.yml，DSH 安装时读这段补丁把插件挂进 profile：
- insert:
- id: ctf-solve-teach
name: 'dsh-ctf-solve-teach'
config: {}
插件启动后只做三件事：读 SKILL.md、剥掉 frontmatter、调 ctx.skills.register()。
同一份内容在插件里注册一次，文件系统 provider 那边就不用再放一份——runtime skill 优先级高于 user 层。
设计原则
- 教学优先：宁可多花 30 秒解释工具选型，也不要快进到答案。
- 可复现：命令原样保留，路径相对化，脚本进
scripts/。
- 诚实：做不出来就写
PARTIAL: ...，并在"卡壳与弯路"里说清卡在哪。
- 不绑平台：判型表和工具箱按"能力"组织，本地工具（
ctf CLI）只是示例，换环境照用。
English
A teaching-first CTF skill for AI agents. Instead of dumping the flag, the agent
narrates every step — what pattern this is, why this tool, what the underlying
mechanism is — and finally writes a reproducible writeup into
solves/<challenge-name>/ with a 9-section checklist enforced by check_doc.py.
Two install paths:
- DSH plugin — npm package
dsh-ctf-solve-teach. It ships cordis.patch.yml and
registers the skill on ctx.skills at load time; nothing to copy by hand.
- Plain skill — copy
skills/ctf-solve-teach/ into your agent's skill folder
(~/.dsh/skills/, ~/.claude/skills/, …).
Trigger with "solve this CTF challenge" or "teach me while solving".
License
MIT © Wangxiaolu0716
