# PaperSpine · 快速入门

> 社区开源 skill，非 the AI provider 官方产物。
> 许可：MIT · 仓库：https://github.com/WUBING2023/PaperSpine
> 整理：Ameureka × CCAF101（独立中文学习社区，并非认证方官网）

## 一句话定位

以 motivation 为主线的论文写作编排套件：先学场景、确认动机、再逐单元写作，端到端产出 LaTeX/PDF/Word

## 核心能力

以 motivation 为主线的论文与报告写作编排套件：先学习目标场景和优秀样例、与用户确认主控 motivation、构建写作思路矩阵，再逐单元写或改写，端到端产出 LaTeX/PDF/Word。

## 关键特性

- 双主流程：Rewrite Existing（改写已有论文，不降级为简单润色）与 Build From Materials（从素材文件夹构筑论文）；素材可含说明文档、图片、PDF、数据摘要、部分初稿
- 四类目标场景 journal / conference / report_review / competition；研究深度分 flash（3 篇样例+3 篇近期论文）与 pro（6+6）两档；输出语言 en/zh
- 强制 motivation 确认：研究后生成 motivation_options_after_research.md，停等用户确认写入 confirmed_motivation.md 才动笔；核心产物 writing_rationale_matrix.md 逐单元解释写作理由，浅矩阵即判失败
- citation_support_bank 逐句 claim 级引用候选库：默认目标 20×3=60 候选，约 80% 来自近三年；引用先绑定句子级 claim 再进正文，绝不杜撰数据/p 值/引用
- 本地优先参考文献读取（local_first / specified_paths / web 三模式），可读 PDF/BibTeX/RIS/模板/笔记/学校或竞赛文档，不能绕过付费墙
- 完整审计链：integrity_audit.py + latex_guard + word_guard + translate_guard，最终产出 final_paper/main.tex、paper.pdf（有 TeX 引擎时）、paper.docx、translation_zh/ 翻译包

## 安装

三种方式任选：(1) 一键脚本——git clone 后运行 install.ps1 -Target all（Windows）或 install.sh（macOS/Linux），可加 -CleanLegacy 清理旧版嵌套目录；脚本记录版本到 ~/.paperspine/install_state.json 并保留全局 config.json。(2) 手动复制扁平 suite：Codex 把 dist/codex/skills/* 复制到 ~/.codex/skills/；AI Code Assistant 把 dist/claude/skills/* 复制到 ~/.ai-config/skills/、dist/claude/commands/*.md 复制到 ~/.ai-config/commands/；OpenClaw 把 dist/openclaw/skills/* 复制到 ~/.openclaw/skills/。注意不要把整个仓库直接丢进 skills 目录（会重复/缺失 skill）。(3) AI Code Assistant 插件：/plugin marketplace add https://github.com/WUBING2023/PaperSpine → /plugin install paper-spine → /reload-plugins。安装后重启宿主。版本同步由 sync_local_installs.py --dist-only 负责，单一真源在 dist/claude/skills/<skill>/SKILL.md。

## 使用流程

1. 安装：git clone 后运行 install.ps1 -Target all（或手动复制对应 dist/<host>/skills/* 到 ~/.codex/skills 等目录），重启 Codex / reload AI Code Assistant / 重启 OpenClaw
2. 启动：AI Code Assistant 用 /paperspine，Codex 用 $paper-spine，OpenClaw 用 paper-spine；配置缺失时第一个工具动作是运行 launch_paperspine_ui.ps1 打开终端 intake UI（paper-spine-ui + paper-spine-intake），落盘 paper_spine_config.json
3. 研究：paper-spine-research 按 reference_mode 先索引本地参考材料再网络补充，产出 research_dossier.md / exemplar_learning_dossier.md / style_profile.md / sota_gap_map.md / motivation_options_after_research.md
4. 引用与动机：paper-spine-citation 构建 citation_support_bank.md；停等用户确认 motivation 并写入 confirmed_motivation.md 后才进入写作
5. 写作：按 workflow 选 paper-spine-rewrite（改写）或 paper-spine-build（从素材构筑），先建 section_blueprints.md 与 writing_rationale_matrix.md 作为执行计划再成稿
6. 组装与审计：paper-spine-latex 产出 main.tex/PDF/可选 Word，paper-spine-translate 产出 translation_zh/（需 translate_guard PASS），最后 paper-spine-audit 检查完整性/引用库质量/翻译覆盖/写作思路深度/文件健康度；integrity_audit.md 不得有 BLOCKED 项才能编译

## 适用人群

需要严格格式输出且重视可审计写作轨迹的研究者与学生：期刊论文、会议论文、课程/技术报告、综述、竞赛论文作者；尤其适合目标 venue 格式重要、需要逐句引用支撑与降 AI 检测率的场景。

## 示例 Prompt

```text
帮我端到端写一篇期刊论文，从我的素材文件夹构筑，先确认 motivation 再逐单元写作，最后输出 LaTeX 与 PDF
```

## 能力边界（诚实说明）

精确匹配原版仓库 WUBING2023/PaperSpine（MIT License，v3.3.0）。仓库 README 明确注明作者于 2026 年 7 月初前暂停日常维护，Issue/PR/讨论会延迟回复——功能本身可正常使用，仅响应速度受影响。本卡片为社区 skill 客观介绍，与 Anthropic / OpenAI / 原作者无官方关联，不暗示任何背书。仓库内 SKILL.md 文件共 37 个（claude/codex/openclaw 三份镜像 + 1 个 legacy 自包含包），去重后为 12 个独立 skill。

## 完整源码

见 https://github.com/WUBING2023/PaperSpine（本文件为 CCAF101 编辑整理的快速入门，非完整仓库镜像）。

---

Ameureka × CCAF101 · 独立中文学习社区，并非认证方官网。文中第三方产品名为其各自厂商商标，CCAF101 不与之关联且不暗示使用关系。