# Paper Lifecycle Skills
<p align="center">
<img src="assets/paper_lifecycle_three_conference_results_7200x9600.png" alt="Review Revision Skill three-conference review score improvement chart" width="100%">
</p>
<p align="center">
<a href="#中文">中文</a> · <a href="#english">English</a>
</p>
<a id="中文"></a>
## 中文
[Switch to English](#english)
`paper-lifecycle` 现在是一个科研写作 skills suite。根目录只做项目说明，真正可安装、可调用的 skill 是两个平级目录：
```text
review-revision/
rebuttal-response/
```
### 两个 Skill
**Review Revision**
路径：`review-revision/`
用途：对已有论文、初稿、被拒稿件或已有明确方向的 idea 做审稿式体检和修改规划。它会检查问题是否真实，insight 是否成立，novelty 是否站得住，method 是否服务于机制，experiments 是否支撑 claim，writing 是否把审稿人带到正确理解。
适合：
- 论文 PDF、LaTeX、Word 或 Markdown 初稿诊断
- A 会、期刊或 workshop 投稿前 checklist
- introduction、related work、method、experiments 等逐节修改
- theory、statistics、reproducibility、figures/tables 审计
调用示例：
```text
Use $review-revision to audit this manuscript, plan revisions, and produce a final checklist.
```
**Rebuttal Response**
路径：`rebuttal-response/`
用途：专门处理审稿意见和 rebuttal。它不是泛泛润色回复，而是把 reviews 拆成 AC 能判断的证据包：哪些 concern 会影响接收，哪些 reviewer 可能被说服，优先补哪些证据，怎样写 AC-facing summary，怎样逐 reviewer 回复，怎样纠正事实错误但不显得攻击 reviewer。
适合：
- 收到 reviews 后做问题分类和优先级排序
- 写 AC-facing executive summary
- 回复 novelty、baseline、实验设置、方法动机、scope、事实误解
- 检查 rebuttal 语气，删掉过度道歉、硬刚、空泛承诺
- 生成 rebuttal checklist 和 camera-ready promise list
调用示例：
```text
Use $rebuttal-response to triage these reviews, plan new evidence, and draft a concise rebuttal.
```
### Codex 安装
建议把整个仓库 clone 到一个普通目录，再把两个 skill 分别链接到 Codex skills 目录。
Windows PowerShell：
```powershell
git clone https://github.com/M1n-n9/paper-lifecycle.git "$env:USERPROFILE\.codex\research-skills\paper-lifecycle"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.codex\skills\review-revision" -Target "$env:USERPROFILE\.codex\research-skills\paper-lifecycle\review-revision"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.codex\skills\rebuttal-response" -Target "$env:USERPROFILE\.codex\research-skills\paper-lifecycle\rebuttal-response"
```
macOS / Linux：
```bash
git clone https://github.com/M1n-n9/paper-lifecycle.git ~/.codex/research-skills/paper-lifecycle
ln -s ~/.codex/research-skills/paper-lifecycle/review-revision ~/.codex/skills/review-revision
ln -s ~/.codex/research-skills/paper-lifecycle/rebuttal-response ~/.codex/skills/rebuttal-response
```
### Claude / Claude Code / 其他 Agent
不依赖 Codex skill 机制时，直接让 agent 读取对应目录即可。
Review Revision：
```text
review-revision/SKILL.md
review-revision/references/review_revision_skill.md
```
推荐提示词：
```text
Read review-revision/SKILL.md and review-revision/references/review_revision_skill.md, then use the review-revision workflow to analyze this manuscript.
```
Rebuttal Response：
```text
rebuttal-response/SKILL.md
rebuttal-response/references/rebuttal_playbook.md
```
推荐提示词：
```text
Read rebuttal-response/SKILL.md and rebuttal-response/references/rebuttal_playbook.md, then triage these reviews and draft an evidence-based rebuttal.
```
### 目录结构
```text
paper-lifecycle/
├── README.md
├── CLAUDE.md
├── assets/
│ └── paper_lifecycle_three_conference_results_7200x9600.png
├── review-revision/
│ ├── SKILL.md
│ ├── agents/
│ │ └── openai.yaml
│ └── references/
│ └── review_revision_skill.md
└── rebuttal-response/
├── SKILL.md
├── agents/
│ └── openai.yaml
└── references/
└── rebuttal_playbook.md
```
<a id="english"></a>
## English
[切换到中文](#中文)
`paper-lifecycle` is now a research-writing skills suite. The repository root is documentation only. The actual installable skills are two sibling directories:
```text
review-revision/
rebuttal-response/
```
### Skills
**Review Revision**
Path: `review-revision/`
Purpose: reviewer-style diagnosis and revision planning for an existing manuscript, draft, rejected paper, or paper idea with a concrete direction. It checks whether the problem is real, the insight is defensible, the novelty holds, the method serves the mechanism, the experiments support the claims, and the writing guides reviewers through the argument.
Use it for:
- PDF, LaTeX, Word, or Markdown manuscript diagnosis
- A-tier, journal, or workshop submission checklists
- section-level revision for introduction, related work, method, and experiments
- theory, statistics, reproducibility, figures, and table audits
Prompt:
```text
Use $review-revision to audit this manuscript, plan revisions, and produce a final checklist.
```
**Rebuttal Response**
Path: `rebuttal-response/`
Purpose: review-response and rebuttal planning. It does not merely polish replies. It turns reviews into a decision-ready evidence package for the AC: which concerns can change the decision, which reviewers are persuadable, what evidence to add, how to write an AC-facing summary, how to draft per-reviewer responses, and how to correct factual misunderstandings without sounding hostile.
Use it for:
- triaging reviews and ranking concerns
- writing an AC-facing executive summary
- responding to novelty, baseline, experimental setup, method motivation, scope, and factual-error objections
- removing excessive apology, defensiveness, vague promises, and hostile wording
- producing a rebuttal checklist and camera-ready promise list
Prompt:
```text
Use $rebuttal-response to triage these reviews, plan new evidence, and draft a concise rebuttal.
```
### Codex Installation
Clone the suite into a normal directory, then link each skill into the Codex skills directory.
Windows PowerShell:
```powershell
git clone https://github.com/M1n-n9/paper-lifecycle.git "$env:USERPROFILE\.codex\research-skills\paper-lifecycle"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.codex\skills\review-revision" -Target "$env:USERPROFILE\.codex\research-skills\paper-lifecycle\review-revision"
New-Item -ItemType Junction -Path "$env:USERPROFILE\.codex\skills\rebuttal-response" -Target "$env:USERPROFILE\.codex\research-skills\paper-lifecycle\rebuttal-response"
```
macOS / Linux:
```bash
git clone https://github.com/M1n-n9/paper-lifecycle.git ~/.codex/research-skills/paper-lifecycle
ln -s ~/.codex/research-skills/paper-lifecycle/review-revision ~/.codex/skills/review-revision
ln -s ~/.codex/research-skills/paper-lifecycle/rebuttal-response ~/.codex/skills/rebuttal-response
```
### Claude / Claude Code / Other Agents
If you are not using the Codex skill loader, ask the agent to read the relevant skill directory directly.
Review Revision:
```text
review-revision/SKILL.md
review-revision/references/review_revision_skill.md
```
Recommended prompt:
```text
Read review-revision/SKILL.md and review-revision/references/review_revision_skill.md, then use the review-revision workflow to analyze this manuscript.
```
Rebuttal Response:
```text
rebuttal-response/SKILL.md
rebuttal-response/references/rebuttal_playbook.md
```
Recommended prompt:
```text
Read rebuttal-response/SKILL.md and rebuttal-response/references/rebuttal_playbook.md, then triage these reviews and draft an evidence-based rebuttal.
```
### Repository Structure
```text
paper-lifecycle/
├── README.md
├── CLAUDE.md
├── assets/
│ └── paper_lifecycle_three_conference_results_7200x9600.png
├── review-revision/
│ ├── SKILL.md
│ ├── agents/
│ │ └── openai.yaml
│ └── references/
│ └── review_revision_skill.md
└── rebuttal-response/
├── SKILL.md
├── agents/
│ └── openai.yaml
└── references/
└── rebuttal_playbook.md
```