| name | ctf-writeup |
| description | 生成一个标准化的提交风格 CTF writeup，便于比赛交接和组织者审核。用于解决 CTF 挑战后，以结构化格式记录解决步骤、使用的工具和经验教训。 |
| license | MIT |
| compatibility | 需要基于文件系统的代理（如 Claude Code 或类似工具），支持 bash 和 Python 3。 |
| allowed-tools | Bash Read Write Edit Glob Grep Task WebFetch WebSearch |
| metadata | {"user-invocable":"true","argument-hint":"[challenge-name]"} |
CTF Write-up Generator
生成一个标准化的提交风格 CTF writeup，用于已解决的挑战。
默认行为：
- 在比赛进行中，优化速度、清晰度和可复现性
- 保持 writeup 简短，方便队友或组织者快速验证解题
- 始终生成
submission 风格的 writeup
- 优先提供从挑战数据到最终 flag 的完整解题脚本
工作流程
第一步：收集信息
从当前会话、挑战文件和用户输入中收集以下内容：
- 挑战元数据 — 名称、CTF 赛事、类别、难度、分数、flag 格式
- 解决方案产物 — 利用脚本、payload、截图、命令输出
- 时间线 — 关键步骤、死胡同、转折点
find . -name '*.py' -o -name '*.sh' -o -name 'exploit*' -o -name 'solve*' | head -20
grep -rniE '(flag|ctf|eno|htb|pico)\{' . 2>/dev/null
第二步：生成 Write-up
使用下面的提交模板，将 writeup 文件写为 writeup.md（或 writeup-<challenge-name>.md）。
模板
提交格式
---
title: "<挑战名称>"
ctf: "<CTF 赛事名称>"
date: YYYY-MM-DD
category: web|pwn|crypto|reverse|forensics|osint|malware|misc
difficulty: easy|medium|hard
points: <分数>
flag_format: "flag{...}"
author: "<你的名字或团队>"
---
# <挑战名称>
## 概述
<1-2 句简述：挑战内容及核心技术，保持简洁明了。>
## 解决方案
### 第一步：<操作>
<用 3-8 行简短说明关键观察，保持直接。>
\`\`\`python
<从提供的挑战数据到打印最终 flag 的完整解题脚本>
\`\`\`
### 第二步：<操作>（可选）
<仅当第二步有助于提升可读性时添加，例如将核心观察与最终验证分开。>
### 第三步：<操作>（可选）
<仅在挑战确实需要时使用。保持步骤总数较少。>
## Flag
\`\`\`
flag{example_flag_here}
\`\`\`
指导原则：
- 总步骤数优先保持在 1-3 步
- 代码保持为最小完整解题脚本
- 不要将“恢复密钥”、“推导密钥”和“解密 flag”拆分成多个片段
- 脚本应从挑战数据开始，最终打印 flag
- 避免冗长的背景介绍
- 避免死胡同，除非解释关键转折
- 避免多条备选解法，选择一条清晰路径
- 仅在用户明确要求时才遮蔽 flag
最佳实践检查清单
在完成 writeup 前，请确认：
质量指南
应当：
- 解释足够的信息以便快速验证
- 包含一条完整的解题路径，而非多条备选路线
- 包含一段完整的脚本，直至最终获取 flag
- 展示实际输出（若过长可截断），以证明方法有效
- 给代码块标注语言（如
python、bash、sql 等）
- 将主要路径放在前面，方便读者快速验证
不应：
- 直接复制粘贴未经解释的终端原始输出
- 粘贴多个片段，迫使读者自行拼凑最终解法
- 在最终写作中留下占位符文本
- 包含与解题无关的枝节内容
- 假设读者了解具体的挑战设置
挑战
$ARGUMENTS
