fuxi

# AGENTS.md — fuxi（复习教练）

本仓库是一个**学科通用的"复习教练"技能**。任何 agent(Claude Code / **Codex** / 其他)在本目录工作时:

> **请阅读并遵循 `SKILL.md` 全文,按它的六阶段流程(阶段0–5)执行。** `references/` 是按需加载的方法库,`scripts/` 是抽料脚本,`templates/` 是产物模板。

在 Codex 上"启用本技能"= 读 `SKILL.md` 并照做,**无需任何特殊命令**;本文件会让 Codex 自动把技能载入上下文。

## 跨工具兼容(本技能不绑定任何厂商专有工具,缺什么走退路,流程照常)

- **出图**:图形解释一律以 **SVG 文件**为最终产物——把 `<svg>…</svg>` 写到 `复习/<科目>/图/*.svg`(浏览器可开)。有渲染器(如 Claude 的 `visualize` MCP)就同时渲染在对话里;**无渲染器(如 Codex)时,写文件就是"出图"**,并在回复里给出文件路径 + 一句话说明图意。
- **抽取资料**(用系统命令/脚本,不依赖专有 skill):
  - docx:`unzip x.docx -d out` + `node scripts/extract_docx.js out`
  - PDF 文字:`pdftotext -layout x.pdf out.txt`;中文图形字体/扫描件失败(CMap 报错或乱码)时,用 `python scripts/render_pdf.py <pdf> <起页> <止页> <输出目录>` 把页面渲染成 PNG 再**视觉读取**(先渲染目录页拿结构,再按需逐章)。缺库 `pip install pymupdf`。
  - 图片:直接视觉读取。
- **进度/记忆**:无 memory 工具时,`复习/<科目>/进度.json` 就是续学依据。

## 快速开始(务必遵守 SKILL.md 顶部的「响应分级 + 启动铁律」)

**先判档**:只问一个概念/一道题 → 轻量档,免 intake 直接讲透(不联网搜资料)。要复习一门课/备考 → 完整档:**第一步只做 intake**(问资料 + 画像菜单),**问完就停,等用户回答**;回答前不要建大纲、不要写讲解。

- **绝不自己联网搜索复习资料**;资料等用户提供,或用户明确说"你来定"时才用标准知识(说明不基于其教材)。
- 收到资料 → 确认"就这些吗" → 才进抽料 / 建大纲。
- 拿不准就多问一句,别抢跑。