# 答辩 FAQ · /defend-my-work

> 一个 Skill：对外交付前，把 agent 写的东西变成你自己真懂的东西。挑战者出题，证据作答，标出你没掌握的部分。

把 agent 写的东西，变成**你自己真懂**的东西。挑战者出题，证据作答，**标出你没掌握的部分**。

「这是 AI 写的，**你自己懂吗？**」——现在答得上来。

## 它解决什么

读者是你本人，不是同事。

- 目标：对外交付、被追问和挑战时，每个问题都能凭**真实理解**答上来，而不是复述 agent 的结论。
- 重度依赖 agent 后，你对细节失控。这份资料要把失控的部分找出来并补上。

什么时候用：要对外交付一项（多由 agent 写成的）工作、即将被人追问或质疑时，对它说——「给我一份 FAQ」「帮我准备答辩」「我要能扛住提问」

## 六步流程

先摸清事实，再站到对面出题。

### 01 圈定范围

- 范围是你点名的工作（仓库、分支、MR、功能）。没点名时，用当前分支相对基线分支的 diff，加上相关提交说明、MR 描述和对话记录。
- 用一两句话复述这项工作「对外承诺了什么」和「交给谁」。拿不准就问一次，不猜。
- 识别听众：评审人、产品、测试、上级、客户。按听众分组出题。

### 02 先摸清事实，再出题

- 读真实代码和提交，弄清机制（参考 pstack `how`）和动机（参考 `why`：提交、MR 讨论、issue、文档）。
- 每条事实标来源：文件和行号、提交、测试、命令输出。
- 分清「已证实」「从代码推断」「不知道」。不编原因，找不到动机就写「没有记录」。

### 03 以挑战者身份出题

- 站在最难缠的对方立场，专挑你最可能答不上来的问题。
- 至少覆盖：是什么、为什么这样做、为什么不那样做、边界和风险（参考 `blast-radius`）、怎么证明是对的、坏了怎么办、成本。
- 尖锐质疑也要备好诚实的答法：「这是不是 AI 写的你自己懂吗」「这段为什么这么复杂」「为什么拖了这么久」「还剩哪些尾巴」。
- 能跑就跑：拿不准的说法当场用命令、测试或小脚本验证（参考 `interrogate`）。

### 04 每题一个讲得出口的答案

- 先给一两句口头能说的短答，再展开机制和原因，用人话讲，不堆函数名。
- 附可以指给对方看的证据位置。
- 不确定就明说：「目前不知道，需要查 X」，不替你编一个听起来对的答案。

### 05 我没掌握的部分（最重要）

- 把 agent 做了、但你大概率不清楚的细节单独成节：隐含的假设、顺手改的地方、绕过的问题、临时方案、TODO、没测的路径。
- 每条说明为什么值得补课，以及最快弄懂它的办法（读哪段代码、跑哪个命令）。

### 06 自测

- 末尾一组只有问题、没有答案的自测题，按难度排列，先自己答再对照。
- 不做表演式提问，不催促。想深入哪题，再按 `teach` 的方式展开讲。

## 用法与产出

一份 Markdown（或你指定的格式），只交给你本人。

### 怎么用

- 说一句「帮我准备答辩」，点名要答辩的工作：仓库、分支、MR 或功能。
- 不点名，就默认当前分支相对基线分支的 diff。
- 拿不准对外承诺或交付对象时，它只问你一次。

### 产出结构

1. 这项工作一句话 + 对外承诺
2. 按听众分组的问答（短答、展开、证据）
3. 我没掌握的部分
4. 自测题
5. 未证实和需要补查的清单

- 用你的语言写：直白、短句、先结论；去掉 AI 腔（参考 `unslop`）。
- 不改代码，不对外发送，只交给你本人。

## 安装

三种方式任选其一。装好后对 agent 说「帮我准备答辩」。

### 命令行

```sh
npx skills add https://defend.curl-share.top
```

- 用 vercel-labs/skills，需要 Node.js 22.20+；会问装到哪些 agent。
- 加 `-g` 装到个人目录；加 `-a claude-code -y` 跳过选择。设 `DO_NOT_TRACK=1` 关闭它的匿名统计。

### 复制给 agent

```text
请帮我安装 Agent Skill「defend-my-work」，只做下面这些，不要改写内容：
1. 下载 https://defend.curl-share.top/SKILL.md（纯文本 Markdown）。
2. 逐字保存为这两个文件，目录不存在就创建：
   - ~/.claude/skills/defend-my-work/SKILL.md（Claude Code 读这里，Cursor 也兼容）
   - ~/.agents/skills/defend-my-work/SKILL.md（Codex、Cursor 等读这里）
3. 核对两个文件的 sha256 都是 056799e73dfc234dc62c2aef33861efd8d72dd25fc37ae549ab132e4e282f056，并确认开头 frontmatter 里 name 是 defend-my-work。
4. 告诉我结果。之后我说「帮我准备答辩」就会用到它。
```

- 粘贴到 Claude Code、Codex、Cursor 等能读写文件的 agent。

### 手动

```sh
mkdir -p ~/.claude/skills/defend-my-work ~/.agents/skills/defend-my-work && curl -fsSL https://defend.curl-share.top/SKILL.md -o ~/.claude/skills/defend-my-work/SKILL.md && cp ~/.claude/skills/defend-my-work/SKILL.md ~/.agents/skills/defend-my-work/SKILL.md
```

- macOS / Linux。Windows 把 `~` 换成 `%USERPROFILE%`，或直接下载 [SKILL.md](https://defend.curl-share.top/SKILL.md) 放进同样的目录。

## 你，亲自阅读和理解最核心的部分

FAQ 是 agent 写的。真正让你扛住提问的，是你自己读懂其中**「我没掌握的部分」**（六步流程第 05 步）。

那一节列的是 agent 做了、你大概率不清楚的细节：隐含的假设、顺手改的地方、绕过的问题、临时方案、没测的路径。每条附最快弄懂它的办法。先读这一节，再看问答。

---

- SKILL.md：https://defend.curl-share.top/SKILL.md
- llms.txt：https://defend.curl-share.top/llms.txt