Paper-Tutor-Skills 学术辅导套件

简体中文 | English

Paper-Tutor-Skills 是一套装进编程智能体（Claude Code / Codex / 国内 WorkBuddy）的学术辅导 skills，简体中文优先——AI 管效率（检索、整理、核对、结构化），人管研究决策（想法、判断、数据、结论）。为中文研究生与科研工作者设计——学生自助研究、导师带学生做科研训练、投稿前批量自查（工具形态不变）。当前 v0.1.2：25 个命令入口（/paper-init /paper-help /paper-doctor /paper-daily 四个工作台基础设施 + 选题 / 检索 / 写作 / 评审 / 投稿全链路 21 个研究命令），分布在 23 个 skill 目录，覆盖学术研究 5 阶段全生命周期。命令的准确清单与各自的已知观察项以 skills/_shared/commands.yaml 为准。

设计理念

AI 提供知识、方法与过程辅导，Skill 提供实践工具，工程化方法帮助记录与复盘；最终的研究思考、判断与成果，由学习者自己完成。

Paper-Tutor-Skills 把 AI 定位为导师与教练，而不是研究任务的执行者；把 Skill 定位为学习与实践工具，而不是一键完成研究的自动化能力；并把软件工程中的结构化、版本控制、过程留痕、可追溯引入学术研究学习——让长周期工作可中断、可续接、可审计。基于通用 agent skills 标准（SKILL.md + references/），不绑定单一宿主。

不可妥协的底线：不编造（文献核验以真实 API 响应为准，不凭模型记忆）、留痕如实（使用记录如实反映人机分工，不美化）。这条底线不与其他目标权衡。

✅ 能做的 / ⛔ 不做的

"不代写"不是缺点，是对研究诚信的承诺。面对"直接帮我写一篇"这类请求，Paper-Tutor-Skills 会先共情你的目标，再用你自己的语言讲清风险，最后给一个 5 分钟内可见成果的第一步——把目录搭好、把材料归位、从选题澄清起步。

每条「不做」的审查判据、依据与出口指引，见 边界拒绝清单——含 4 条评估过并拒绝的自动化机制（全链编排器、评分排序、静默降级、自动改写既有文件）。

研究全流程 × Paper-Tutor-Skills 能力

快速开始

25 个命令入口已发布（v0.1.2——已知边界见 CHANGELOG），覆盖学术研究 5 阶段全生命周期，逐命令见上表。今天就能先试一个（/paper-doctor 有 验收记录）。

安装

复制下面对应你的智能体的那段话，粘贴给它就行——它会自己装完，你不用敲任何命令。

装到 Claude Code 👇

帮我安装 Paper-Tutor-Skills 学术辅导套件：

1. 把 https://github.com/cabbage2000-lab/paper-tutor-skills 克隆到一个临时目录
2. 确保 ~/.claude/skills/ 存在（没有就创建），把仓库 skills/ 下的**全部子目录**
   复制进去，一个都不能少（23 个 paper-* 加 1 个 _shared）
   - 同名目录直接覆盖，这就是更新
   - 该目录下其他来源的 skill 一个都别动，千万不要清空目录
   - _shared/ 没有 SKILL.md、不会显示成命令，但每个 skill 都用 ../_shared/ 引用它，
     漏装会全面断链，必须一起装
3. 删掉临时目录
4. 告诉我装到了哪里、有哪些命令可用

装到 Codex 👇

帮我安装 Paper-Tutor-Skills 学术辅导套件：

1. 把 https://github.com/cabbage2000-lab/paper-tutor-skills 克隆到一个临时目录
2. 确保 ~/.codex/skills/ 存在（没有就创建），把仓库 skills/ 下的**全部子目录**
   复制进去，一个都不能少（23 个 paper-* 加 1 个 _shared）
   - 同名目录直接覆盖，这就是更新
   - 该目录下其他来源的 skill 一个都别动，千万不要清空目录
   - _shared/ 没有 SKILL.md、不会显示成命令，但每个 skill 都用 ../_shared/ 引用它，
     漏装会全面断链，必须一起装
3. 删掉临时目录
4. 告诉我装到了哪里、有哪些命令可用

装完新开一个会话才会加载——已开的会话看不到新命令。

只想在单个项目里用？ 把提示词里的 ~/.claude/skills/ 换成该项目根目录下的 .claude/skills/（Codex 换成 .codex/skills/）。

用的是别的宿主（WorkBuddy 等）？ 同一段提示词，把目标路径换成该宿主的 skills 目录即可。装错位置的表现是命令一个都不出现、且没有任何报错——Codex 不读 .claude/skills/，Claude Code 也不读 .codex/skills/，两个宿主都用就各装一份。

想先只试一个？ 把第 2 步换成「只复制 skills/paper-init 和 skills/_shared」。

更喜欢自己敲命令？两个宿主都支持插件式一键安装

本仓库自身就是插件市场，插件形态多一个好处：能用一条命令更新。

Claude Code——在会话里依次执行：

/plugin marketplace add cabbage2000-lab/paper-tutor-skills
/plugin install paper-tutor@paper-tutor-marketplace

25 个命令以 paper-tutor: 前缀成组出现（/paper-tutor:paper-init、/paper-tutor:paper-verify……），更新用 /plugin update paper-tutor。

Codex——在终端里执行：

codex plugin marketplace add cabbage2000-lab/paper-tutor-skills
codex plugin add paper-tutor@paper-tutor-marketplace

命令直接是 /paper-init、/paper-verify（Codex 不加 plugin 名前缀）。

两条路装的是同一套 skill，别两种都装——会出现两份、命令重复。插件形态只改变命令的显示方式，skills/ 散装主体原样保留，跨宿主装载不受影响。

30 秒试一下

装好后，随便建一个空目录，对你的 AI 助手说：

用 /paper-init 帮我建个科研工作目录

它会一次性问你四个问题：

1. 项目名（会成为目录名，比如"ChatGPT 对本科生写作效率的影响"）
2. 范围（只做这一个项目，还是多项目并行的工作区）
3. 建在哪（默认当前目录）
4. 要不要 git 版本管理（默认要）

你确认方案后，它只建目录骨架 + README + .gitignore，绝不预建留痕目录、不生成任何研究内容——后续命令发布后，留痕目录 .paper/ 会在你首次使用时自动创建。

怎么开口问：按研究阶段的提问示例

不用背命令名。 用你自己的话说出你卡在哪，宿主会匹配到对应的 skill；实在不知道该用哪个，就问一句 /paper-help，它一轮提问帮你定位（回复「看我用到哪了」还能扫 .paper/ 出研究全貌）。当然你也可以直接显式调用 /paper-verify 这样的命令名，两种方式等价。

提问只是开场，不是一问一答。 每个命令都会先问清你的情况、在检查点停下等你拍板，确认前零落盘。研究决策始终在你手上——它给的是选项、事实、对照与疑问句，不是答案。跨天、跨会话也没关系：.paper/ 留痕让每个阶段都能新开一个会话续上。

起步与日常（跨阶段基础设施，任何时候都能用）

阶段 A · 选题与立项

阶段 B · 执行研究：这里没有命令

数据采集、实验、分析属于物质世界的环节，明文留给你自己。所以 "帮我跑个实验" "帮我编一组数据凑结论" 会被拦下——这是「AI 负责效率、人负责研究决策」的边界，不是缺口。

阶段 C · 成文

阶段 D · 评审与修订

阶段 E · 发表与发表后

这些问法会被拦下来——但每条都有替代出口

串起来看：一个课题从头到尾会问些什么

 1. "帮我建个课题目录"                              → /paper-init
 2. "我想研究短视频对青少年注意力的影响，说不清具体做什么" → /paper-topic   （你拍板 RQ）
 3. "有没有人研究过这个"                            → /paper-search  （文献笔记表）
 4. "这批文献怎么筛"                                → /paper-screen  （做系统综述才需要）
 5. "问卷能回答我的 RQ 吗？涉及未成年人要伦理审查吗"    → /paper-method
 6. "我要开题了"                                    → /paper-proposal
 ── 采数据、跑实验、做分析：AI 不进场，这一段是你自己的 ──
 7. "论文分几章好"                                  → /paper-outline
 8. "这段方法写不下去"                              → /paper-draft
 9. "RQ 和结论对得上吗"                             → /paper-logic
10. "帮我提炼摘要"                                  → /paper-abstract
11. "这些引用是真的吗 / 格式符合国标吗 / 结论说过头了吗" → /paper-verify（含 format / claim）
12. "审稿人会提什么意见"                            → /paper-review
13. "收到意见了，怎么逐条回"                         → /paper-revise
14. "要交 AI 使用说明" / "投稿要交什么" / "要 Word 版"  → /paper-disclose → /paper-submit → /paper-typeset

每一步都可以是一个新会话——.paper/ 里的留痕负责把上下文续上，不必把整个课题压在一次对话里。

为什么可信

Paper-Tutor-Skills 把研究诚信的承诺落进了可验证的工程设计：

• 核验六态：每条引用的核验结果是六种状态之一——VERIFIED（已核实）、METADATA_MISMATCH（元数据不符）、RETRACTED（已撤稿）、NOT_FOUND（未查到）、UNVERIFIED（未核验）、PENDING_MANUAL（待人工核对）。定位是存在性核验（存在 ≠ 引用恰当），以真实 API 响应为准，绝不凭模型记忆判断。

  量化门槛（虚构检出率、真实误报率、中文误伤等）目前不是发布门的必要条件，按需补跑并回填到 evals/。但"以真实 API 响应为准、绝不凭模型记忆"是产品底线，不与任何目标权衡。

• 中英双轨检索：英文文献接开放 API（arXiv、OpenAlex、Semantic Scholar、Crossref）自动检索；中文文献走"自动 + 引导"混合路径——带 DOI 的中文期刊文献自动命中，其余生成知网 / 万方检索方案（检索式 + 筛选条件）引导你执行并回填。检索产出声明各来源覆盖方式（自动 / 回填 / 未覆盖）——缺了这个提示，你可能把"英文库没有"误判成"没人研究过"。中文文献 API 覆盖不到的绝不判为编造，而是落 PENDING_MANUAL 态并附人工核对包。

• 跨宿主不锁死：实现不依赖任何宿主专有机制，编排与断点续跑用纯文件约定。目录约定是增强不是依赖——检测到标准目录则产物归位，否则落当前目录并提示。

仓库结构

四区：skills/（skill 包 + _shared/ 共享层，开发规范）、tests/（行为验收与语料）、evals/（裸模型 vs 带 skill 并排对比）、docs/（产品 PRD 与学术论文全流程示例）。其余设计文档（specs、实现计划、评审记录）为内部稿，不随仓库发布——本 README 与 PRD 是对外公开信息的事实来源。

贡献

想参与开发或二次定制，先读 skills/README.md 的开发规范（skill 包标准结构、发布门、横切要求）与 CONTRIBUTING.md。发布门是三条：核心确定性逻辑有单测且通过、至少一条真实输入手工走通、commands.yaml 的 status 同步翻转；量化门槛、行为验收多场景、裸模型对比不是必要条件，按需补。

许可

本项目采用 PolyForm Noncommercial License 1.0——源码完全开放，允许个人学习、研究、教学、非商业分发与改造，但禁止任何商业使用（包括但不限于销售、打包进收费产品、商业服务集成）。许可全文见仓库根目录的 LICENSE 文件，或 PolyForm 官网。