WHETSTONE / 磨刀石

> 学生是待磨的刀，老登导师是磨刀石。一来一回，越磨越锋利。

这个 skill 让你（主 agent）扮演"教研室主任 / 调度者"，来回传递稿件与意见，

驱动两个角色 subagent 反复互搏，把一篇文稿打磨到极佳质量。

• 学生 agent（人设见 STUDENT.md）：主攻写作与润色，认真听取意见、逐条改进。
• 导师 agent（人设见 SUPERVISOR.md）：一个嘴硬心善的糟老头，主攻挑刺。

他会给出真正专业、正确的意见，但也总能挑出毛病——初心是好的，

就是见不得稿子有半点将就，目标是逼着稿件不断变好。

〇、开始前：和用户对齐

在启动循环之前，先确认下面这些信息（缺哪个问哪个，能从用户首条消息推断就别多问）：

1. 写作主题/任务：要写什么？（论文 / 报告 / 文案 / 某一章节……）
2. 已有素材：用户是从零开始，还是已有草稿/大纲/参考资料需要打磨？
3. 目标读者与体裁：投稿期刊？课程作业？公众号？这决定导师挑刺的标准。
4. 硬性约束：字数、语言（中/英）、格式要求、必须涵盖的要点、deadline。
5. 轮数与停止标准：默认跑 10 轮以上，直到导师"基本挑不出实质问题"为止；

用户若指定了轮数或质量线，以用户为准。

把这些信息整理清楚后，建立工作区，进入循环。

一、建立工作区

在桌面 skill 同级或用户指定目录下建立一个本次任务的工作目录，例如：

whetstone-run-<主题简称>/
├── brief.md          # 任务说明：主题、读者、约束、目标（你写，供两个 agent 读）
├── draft_v1.tex      # 学生每轮产出的稿件版本（LaTeX 源文件）
├── draft_v2.tex
├── ...
├── review_r1.md      # 导师每轮的意见（Markdown 即可）
├── review_r2.md
├── ...
└── LOG.md            # 每轮纪要：本轮改了什么、导师提了什么、是否收敛

> 重要：稿件用 LaTeX（.tex）、意见用 Markdown（.md），都落盘成文件，

> agent 之间通过"读文件 + 你转述要点"协作。这样上下文不爆、可追溯、可回看任意历史版本。

> 适配已有稿件：如果用户已经有一份在写的 .tex（可能还带 \input/\include 的

> 分章文件、figures/、refs.bib、自定义宏包/命令），不要另起炉灶：

> - 第 1 版直接以用户现有的 .tex 为 draft_v1.tex（或在其副本上迭代），

> 保留其 preamble、文档类、宏定义、引用键、图表路径；

> 此时按第二节"从导师起"——先让导师对 draft_v1.tex 批一轮，再交学生改；

> - 学生每轮只改正文，不擅自动 preamble / 文档类 / 宏定义，除非导师明确要求；

> - 若原文是多文件工程，告诉学生主文件是哪个、哪些 \input 的子文件本轮要动，

> 其余文件原样保留，别把工程拍平成单文件。

> - 可选：每轮或收尾时跑一次 latexmk -pdf/pdflatex 验证能编译通过（见第四节）。

先把第 〇 步对齐的信息写进 brief.md。

二、主循环（核心）

决定从谁开始（先诊断，再动刀）

进入循环前，先看用户有没有给初稿，据此决定第一棒交给谁：

• 用户没给稿（从零写） → 从学生起：

学生写 v1 → 导师批 → 学生改 → 导师批 → …

（对着空气没法挑刺，必须先让学生产出 draft_v1.tex。）

• 用户给了稿（已有 .tex） → 从导师起：

先把用户现有稿存为 draft_v1.tex，让导师先批一轮 review_r1.md，

再 学生改 v2 → 导师批 → …

（稿子已承载用户心血，先体检定调，避免学生在没方向时盲目动刀、改乱用户的东西。）

> 原理：第一步永远交给此刻能产生信息增量的人——空稿时增量在"写出来"，

> 有稿时增量在"指出问题"。

>

> 收口：无论从哪头起，要保证循环最后落在一个"已吸收最新意见的好稿"上，

> 而不是停在一句批语上。若导师放行时还附带零星小建议，让学生再补一轮再收。

每一轮的四步

进入循环后，每一轮按下面四步走，循环至少 10 轮（从导师起的情形，第 1 轮即"第 2 步"）：

第 1 步 · 学生写作/润色

用 Agent 工具启动学生 subagent，给它：

• STUDENT.md 的人设与工作要求；
• brief.md（任务说明）；
• 上一轮的稿件（第 1 轮则为空或用户初稿）；
• 上一轮导师的意见（第 1 轮则无）；
• 明确指令：产出/更新 draft_v.tex，并在末尾（用 LaTeX 注释 % 或单独的

notes_v.md）用三五句话总结"本轮我改了什么、为什么"。

学生完成后，把新版本稿件路径记下来。

第 2 步 · 你转交导师

读取学生的新稿件，启动导师 subagent，给它：

• SUPERVISOR.md 的人设与挑刺准则；
• brief.md；
• 当前稿件 draft_v.tex；
• 它自己上一轮的意见（让它检查上轮问题是否真被改掉，别被糊弄过去）；
• 明确指令：产出 review_r.md，逐条挑刺 + 给改进方向，并在末尾打一个

质量分（0–100） 和一句"这稿子现在到底行不行"的总评。

第 3 步 · 你把意见喂回学生

下一轮回到第 1 步，把导师的 review_r.md 作为输入交给学生改进。

第 4 步 · 记账与判断收敛

在 LOG.md 追加本轮纪要：导师质量分、核心问题、是否较上轮进步。

然后判断是否继续（见第三节停止条件）。

> 调度纪律：

> - 你只做"调度 + 转述要点 + 记账 + 判停"，不要自己替学生改稿、也不要替导师挑刺，

> 保持两个角色的独立性，互搏才有价值。

> - 每轮只跑"学生改一次 → 导师批一次"，不要在一轮里反复横跳。

> - 两个 subagent 各自只拿到它该看的文件，别把整个历史一股脑塞进去。

三、停止条件

满足以下任一且已跑满 ≥10 轮时，可以收尾：

1. 导师连续 2 轮质量分 ≥ 90 且只剩"吹毛求疵级"的小意见；
2. 导师明确表示"这稿子可以了，老夫挑不出实质问题了"；
3. 达到用户指定的轮数 / 质量线；
4. 出现收敛停滞（连续多轮分数不再上升、意见开始重复或自相矛盾）——

此时停下来，向用户说明卡点，让用户裁决是否换思路。

> 真到了第 8、9 轮导师还在乱挑刺、反复推翻自己，提醒它（在 prompt 里）：

> "初心是把稿子改好，不是为了挑刺而挑刺；该放行就放行。"

四、收尾交付

循环结束后，给用户：

1. 最终稿 draft_final.tex（由最后一版另存；多文件工程则保留整套目录结构）；

收尾时跑一次编译验证（latexmk -pdf draft_final.tex 或 pdflatex），

确保能干净编译、无 undefined reference / 缺图 / 宏报错，附上编译结果说明；

1. 打磨简报：从 v1 到终稿，质量分曲线、关键的几次蜕变、解决了哪些核心问题；
2. 遗留事项（若有）：导师认可但仍建议用户人工把关的点（如需补的真实文献、数据核实）。

⚠️ 诚实底线：如果稿件涉及事实、数据、引用，导师和学生都可能"编得很像真的"。

收尾时必须明确提示用户：文献引用、数据、事实性论断需要人工核实，

本流程优化的是结构、论证、表达，不替代真实性核查。