---
name: expert-review-handoff
description: Use when the user wants to package materials for an external expert, mentor, coauthor, boss, supervisor, or consultant to review, or wants ready-to-send reviewer messages such as 微信版、邮件版、发导师版、发合作者版、催看版、口语版. Trigger on requests like 给专家审核, 发给老师把关, 帮我写发审说明, 整理附件清单, 生成给导师/合作者的审核消息, 生成微信/邮件短消息, 可直接发送版本, 发老师版, 发合作者版, 像我平时说话发一下, or generate a handoff/message with review priorities, file paths, and scope notes. Do not use for reviewing the manuscript itself; use peer-review or research-audit for that.
---

# Expert Review Handoff

## Overview

这个 skill 用来把“我要请别人审核”这件事，整理成一份能直接发出去的交接材料。

核心原则：**不是继续做内容审稿，而是帮用户把审核对象、审核重点、附件路径、发送说明和边界条件整理清楚。**

## When to Use

出现以下需求时使用：
- 用户说“给专家审核”“发给老师把关”“请别人看一下”
- 用户说“给老师看看”“给导师过一眼”“给大佬过一眼”
- 用户说“帮我整理一版发审材料”“帮我打包给专家”
- 用户说“帮我写一段发给专家的话”“帮我配个审核说明”
- 用户说“给统计老师看”“给方法学老师看”“给临床老师看”“给投稿老师看”
- 用户要一段可直接转发的说明文字
- 用户要“审核重点”“请重点看什么”“附件清单”“文件路径索引”
- 用户要把 manuscript、图件、修改记录、补充材料打包给外部专家
- 用户要一个专家 handoff，而不是 AI 会话 handoff

不适用场景：
- 需要你亲自做论文评审、方法学审查、统计审查
- 只是给下一个 Claude/Codex 会话交接
- 只是普通摘要，不涉及外部专家接收材料

## Quick Workflow

### 1. 先判断审核对象是谁
默认分四类：
- **通用专家**：未说明专长时默认使用
- **临床/领域专家**：重点看术语、临床定义、纳排口径、结论表述
- **统计/方法学专家**：重点看样本量、模型口径、一致性、偏倚与方法透明度
- **写作/投稿专家**：重点看图注、标题、结构、期刊表达习惯

如果用户没说清楚，默认按“通用专家 + 当前最明显争议点”生成。

### 1.1 自动识别专家类型
可直接按自然语言自动路由：
- 出现 `统计专家` / `统计老师` / `方法学专家` / `方法学老师` / `请看样本量和模型` → 用 **统计/方法学专家**
- 出现 `临床专家` / `临床老师` / `领域专家` / `请看定义和纳排` → 用 **临床/领域专家**
- 出现 `投稿专家` / `写作老师` / `润色老师` / `请看图注标题和表达` → 用 **写作/投稿专家**
- 没说清楚 → 用 **通用专家**

### 2. 先找真实材料，不要凭空编路径
优先收集这些文件；只写**实际存在**的绝对路径：
- 主稿 Word / PDF
- 修订版 Word / PDF
- 修改过程记录或 change log
- 相关图件目录
- 如有需要：补充说明、流程图、审阅 memo

如果某个关键文件不存在：
- 明说缺失
- 不要假装已经准备好

### 2.1 自动发现当前目录材料
如果用户没有明确列出文件路径，优先自动扫描当前目录或用户指定目录：

```bash
python3 $HOME/.claude/skills/expert-review-handoff/scripts/discover_review_bundle.py . --expert-type general
```

指定专家类型：

```bash
python3 $HOME/.claude/skills/expert-review-handoff/scripts/discover_review_bundle.py . --expert-type methods
python3 $HOME/.claude/skills/expert-review-handoff/scripts/discover_review_bundle.py . --expert-type clinical
python3 $HOME/.claude/skills/expert-review-handoff/scripts/discover_review_bundle.py . --expert-type writing
```

这个脚本会优先找：
- 最新 manuscript Word / PDF
- 修改过程记录 / 审阅意见 / handoff
- 流程图 / supplementary figure / 图件目录
- 表格类补充材料

然后把它们整理成可直接复制进 handoff 的候选清单。

### 3. 输出固定五段
默认输出以下五段，必要时可精简：

1. **本次请审核的目的**
2. **建议重点审核的 3-6 个问题**
3. **附件清单（带绝对路径）**
4. **建议发送文案**
   - 简洁版
   - 正式版
5. **本轮暂不需要重点看的内容**（可选，但很有用）

### 4. 输出风格要求
- 中文为主
- 路径必须是绝对路径
- 优先短句，方便复制发送
- 不写空泛客套话
- 不要把“你审核一下”写成没有重点的泛请求

## 快捷口令（可直接说）

下面这些口头语都应该直接触发本 skill：

- `请用 $expert-review-handoff 给专家整理一版审核说明。`
- `请用 $expert-review-handoff 给老师把关这版稿子。`
- `请用 $expert-review-handoff 帮我打包一版发给导师的审核材料。`
- `请用 $expert-review-handoff 给大佬过一眼这版 manuscript。`
- `请用 $expert-review-handoff 生成一份发给合作者的审核 handoff。`
- `请用 $expert-review-handoff 帮我列一下请专家重点看的问题和附件路径。`
- `请用 $expert-review-handoff 基于当前目录材料，生成一版发审说明。`
- `请用 $expert-review-handoff 给统计老师整理一版审核说明。`
- `请用 $expert-review-handoff 给临床老师整理一版审核说明。`
- `请用 $expert-review-handoff 给投稿老师整理一版审核说明。`

如果用户不显式写 skill 名，以下口语化说法也应视为同类触发：

- `帮我整理一版给专家看的`
- `帮我写个发给老师审核的说明`
- `帮我把这些材料打包给导师`
- `我想发给合作者看看，你帮我整理一下`
- `你帮我配一下请专家审核的话术`
- `把这次修改整理成给外部专家的交接`
- `给统计老师看看，你帮我整理一下`
- `给临床老师看看，帮我列重点问题`
- `给投稿老师过一眼，帮我配个说明`

### 短消息 / 可直接发送模式的额外触发词

如果用户出现下面这些说法，也应直接触发本 skill，并优先考虑输出“可直接发送文案”而不是长篇说明：

- `整理成短消息版本`
- `给我一个微信版`
- `给我一个邮件版`
- `给我一个发老师版`
- `给我一个发导师版`
- `给我一个发合作者版`
- `给我一个催看版`
- `像我平时说话那样发一下`
- `给我几种不同语气版本`
- `帮我写成可以直接发的`
- `帮我写成可复制发送版本`
- `帮我配一段微信 / 邮件话术`
- `帮我整理成六种总结模式`
- `直接给我发人的版本`

如果用户只说：

- `发老师怎么说`
- `发导师怎么写`
- `发合作者怎么发`
- `微信里怎么说`
- `邮件怎么写`

也默认触发本 skill。

## Reviewer-Type Routing

| 审核对象 | 优先强调内容 |
|---|---|
| 通用专家 | 本轮修改目的、最可能出问题的 3-4 个点、附件入口 |
| 临床/领域专家 | 疾病定义、纳排标准、暴露/结局定义、图文口径一致性 |
| 统计/方法学专家 | 样本量口径、cross-sectional vs longitudinal、协变量、模型与图表一致性 |
| 写作/投稿专家 | 标题、图注、legend、表达是否符合投稿习惯 |

如果用户明确说“请统计专家看”，就把问题列表改成方法优先；不要还把大量语言润色问题放前面。

## Auto-Discovery + Auto-Routing Pattern

默认优先顺序：
1. 识别专家类型
2. 自动扫描当前目录真实文件
3. 选 3-5 个最值得发的材料
4. 按专家类型生成重点问题
5. 再输出可直接发送的话术

如果用户只说一句很短的话，例如：
- `给统计老师看看`
- `帮我整理一版发给导师`
- `给投稿老师过一眼`

也应该尽量自动完成以上 5 步，而不是反复追问。

## Default Output Contract

默认按以下顺序给用户：

### A. 一段可直接发送的说明
先给一个**可直接复制**的版本。

### B. 重点审核问题
建议 3-6 条，编号输出：
- Q1
- Q2
- Q3

### C. 附件清单
用表格或条目列出：
- 文件用途
- 绝对路径
- 是否建议优先打开

### D. 可选补充
如有必要，再补：
- 当前已经改了什么
- 暂时没改什么
- 看完后希望对方重点回复什么

## Six-Mode Direct-Send Output

当用户明确提到“短消息版本 / 可直接发送 / 微信版 / 邮件版 / 发老师版 / 发合作者版 / 六种模式”时，默认优先输出下面六种模式；除非用户明确只要一种，否则尽量一次给全，方便直接复制：

1. **微信超短版**
   - 2-4 句
   - 适合先发给老师 / 导师 / 合作者试读

2. **微信标准版**
   - 1 段主说明 + 1 段结论边界 + 1 条主路径
   - 适合正式但仍然简短的转发

3. **微信催看版**
   - 语气更轻
   - 默认用于二次提醒、关系较熟或只需要对方快速过目

4. **邮件版**
   - 默认包含：邮件主题 + 正文
   - 适合导师、PI、正式合作方

5. **发合作者版**
   - 语气比发导师更平实
   - 强调想请对方重点看什么，而不是过度客套

6. **用户口吻版**
   - 尽量模仿用户平时的自然表达
   - 适合“像我平时说话那样发一下”“别太官方”的需求

### 六种模式的默认选择逻辑

- 如果用户说 `给我短消息版本 / 直接发人的版本 / 六种模式` → **默认六种全给**
- 如果用户说 `给老师 / 给导师 / 给老板 / 给 PI` → 优先给 **微信超短版 + 微信标准版 + 邮件版**
- 如果用户说 `给合作者 / 给同事 / 给朋友帮看` → 优先给 **微信超短版 + 发合作者版 + 用户口吻版**
- 如果用户说 `催一下 / 提醒一下 / 再发一次` → 优先给 **微信催看版**
- 如果用户说 `正式一点` → 优先给 **邮件版 + 微信标准版**
- 如果用户说 `自然一点 / 口语一点 / 像我平时说话` → 优先给 **用户口吻版**

### 六种模式的最小成功标准

只要在输出“六种模式”里的任意一种，就尽量同时满足：

- 能直接复制发送
- 说清本次请对方看什么
- 有 1 个核心结论，不堆太多信息
- 如涉及附件，优先只给 1 个主入口路径
- 不写空泛的“帮我看看有没有问题”

## Scope Guardrails

### 该 skill 应该做的
- 为外部专家整理审核 handoff
- 生成可转发文案
- 生成附件路径索引
- 帮用户明确“请重点看什么”
- 根据专家类型调整问题重点

### 该 skill 不该做的
- 代替专家做正式学术评审
- 大段改正文稿内容
- 杜撰不存在的文件或路径
- 输出只有礼貌、没有任务边界的消息

## File Selection Rules

优先级建议：
1. **最应该先看**：最新修订版稿件（Word 或 PDF）
2. **第二优先**：修改过程记录 / 修改对照说明
3. **第三优先**：相关图件或补充材料目录
4. **如专家时间有限**：只给最小必要文件包

如果用户没说要给很多附件，优先控制在 **3-5 个文件**，避免材料过载。

## Suggested Questions Pattern

高质量“请审核什么”通常长这样：
- 这次修改后，**样本量和分析口径是否前后一致**？
- 某个定义是否**足够严谨**？
- 某个图注/legend 是否**达到投稿稿件水平**？
- 是否还需要把相同口径同步到摘要、结果或 supplement？

避免这种空泛写法：
- “老师帮我看看有没有问题”
- “麻烦审核全文”
- “请提意见”

## Optional Save-to-File Pattern

如果用户希望落盘，默认可写为：
- `YYYY-MM-DD_专家审核交接.md`
- 或 `专家审核说明_YYYY-MM-DD.md`

推荐内容结构：
- 审核背景
- 重点问题
- 附件清单
- 建议发送文案
- 审核回复建议格式（可选）

## Resources

- 模板参考：`references/templates.md`
- 自动发现材料脚本：`scripts/discover_review_bundle.py`

需要快速生成不同风格文案时，优先读取这个模板文件，而不是每次从头发挥。
当用户没有明确给出文件路径时，优先运行自动发现脚本。

## Common Mistakes

- 给专家发一堆文件，但没说“这次请重点看什么”
- 路径写成相对路径，别人打不开
- 把 session handoff 错当 expert handoff
- 明明是统计专家，却把语言润色放第一位
- 杜撰“已修改完成/已核实”，但其实还没验证
- 一上来就发 10 个附件，导致对方抓不到重点

## Minimal Success Standard

在宣称 expert handoff 已准备好之前，至少确认：
- 已确认审核对象类型（或做了合理默认）
- 已列出真实存在的关键文件
- 已给出 3-6 个具体审核问题
- 已给出一段可直接复制发送的说明
- 已明确本轮审核范围，而不是让对方“通篇找问题”
