Skip to content
Back to search

academic-paper-writer

面向 CS / AI / ML 领域的证据驱动、分节推进的论文写作 Agent Skill。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joshua-zyy--academic-paper-writer/badge.svg)](/listings/joshua-zyy--academic-paper-writer)

HTML

<a href="/listings/joshua-zyy--academic-paper-writer"><img src="/api/listings/joshua-zyy--academic-paper-writer/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "academic-paper-writer",
  3. "owner": {
  4. "name": "joshua-zyy"
  5. },
  6. "plugins": [
  7. {
  8. "name": "academic-paper-writer",
  9. "source": {
  10. "source": "github",
  11. "repo": "joshua-zyy/academic-paper-writer"
  12. },
  13. "description": "Evidence-driven, section-by-section CS/AI/ML paper writing skill collection",
  14. "version": "1.2.0",
  15. "author": {
  16. "name": "joshua-zyy"
  17. },
  18. "homepage": "https://github.com/joshua-zyy/academic-paper-writer",
  19. "repository": "https://github.com/joshua-zyy/academic-paper-writer",
  20. "license": "MIT",
  21. "keywords": ["academic", "paper", "writing", "cs", "ai", "ml"],
  22. "category": "productivity"
  23. }
  24. ]
  25. }
README.md · README · 637 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <h1 align="center">📝 Academic Paper Writer</h1>
  3. <p align="center">证据驱动 · 分节闭环 · 模块协作 · 硬门控 · 可验证</p>
  4. <p align="center">
  5. <a href="https://github.com/joshua-zyy/academic-paper-writer/blob/main/LICENSE">
  6. <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
  7. </a>
  8. <img src="https://img.shields.io/badge/domain-CS%2FAI%2FML-brightgreen" alt="Domain">
  9. <img src="https://img.shields.io/badge/status-active-success" alt="Status">
  10. <img src="https://img.shields.io/badge/skill%20system-8%20skills-9A4D8E" alt="Skills">
  11. <img src="https://img.shields.io/badge/architecture-Core%20%2B%20Subskills-orange" alt="Architecture">
  12. </p>
  13. <p align="center">
  14. <a href="https://joshua-zyy.github.io/academic-paper-writer">
  15. <img src="https://img.shields.io/badge/🌐_访问项目页面-blue?style=for-the-badge" alt="官网">
  16. </a>
  17. </p>
  18. </p>
  19. ---
  20. Academic Paper Writer 是面向 `CS / AI / ML` 论文写作场景的 **模块化、证据驱动** 的 Agent Skill 集合。
  21. <table>
  22. <tr>
  23. <td><strong>你是否也遇到过这些论文写作焦虑?</strong>
  24. <br>
  25. <blockquote>
  26. <table>
  27. <tr>
  28. <td width="4px" bgcolor="#0F4D92">🤷</td>
  29. <td><strong>无从下笔</strong> — 模型代码全部跑通,对着空白文档却不知第一句话写什么</td>
  30. </tr>
  31. <tr>
  32. <td width="4px" bgcolor="#42949E">📐 </td>
  33. <td><strong>表述不准</strong> — 算法和公式在脑中模糊,只有大概的思路</td>
  34. </tr>
  35. <tr>
  36. <td width="4px" bgcolor="#B64342">🎨</td>
  37. <td><strong> 图表头秃</strong> — 实验数据堆了一桌子,论文级的可视化不知道从何画起</td>
  38. </tr>
  39. <tr>
  40. <td width="4px" bgcolor="#9A4D8E">🔍</td>
  41. <td><strong> 缺少支点</strong> — 直觉上知道自己的工作有意义,但找不到让 reviewer 信服的论证锚点</td>
  42. </tr>
  43. </table>
  44. </blockquote>
  45. 你不是一个人,学术写作的最大障碍往往不是做得不够,而是不知道怎么写出来。</td>
  46. </tr>
  47. </table>
  48. **这不是一个简单的一次性生成整篇论文的 prompt,而是一套工程化写作系统: 先把论文拆成多个可独立验证的环节,按证据审计 → 文献检索 → 实验复核 → 起草 → 质量门 → 验证的闭环逐节推进。每个环节都设硬门控,证据不足就阻塞或降级,绝不硬写。**
  49. **核心思想在于将各位researcher从枯燥的论文写作中解放出来,将更多的时间与经历投入到对于论文/模型创新点的思考与设计当中。**
  50. ---
  51. ## 💬 反馈与改进
  52. <p align="center">
  53. <em>独自迭代与维护这个项目,必然会陷入思维逻辑的困境</em><br>
  54. <strong>非常重视与欢迎各位 researcher 提出在实际使用中遇到的问题以及对项目的改进想法</strong>
  55. </p>
  56. <table align="center">
  57. <tr>
  58. <td align="center"><strong>🐛 遇到问题</strong></td>
  59. <td align="center"><strong>💡 有改进建议</strong></td>
  60. <td align="center"><strong>🤔 有疑问</strong></td>
  61. </tr>
  62. <tr>
  63. <td>工作流卡住、gate 误判、文档不清晰</td>
  64. <td>觉得某个步骤可以优化、需要新的 skill 或 probe</td>
  65. <td>不确定某个设计为什么这样、或者想了解最佳实践</td>
  66. </tr>
  67. </table>
  68. <p align="center">
  69. <a href="https://github.com/joshua-zyy/academic-paper-writer/issues">
  70. <img src="https://img.shields.io/badge/📝_提交反馈-GitHub_Issues-blue?style=for-the-badge" alt="提交反馈">
  71. </a>
  72. </p>
  73. <p align="center">
  74. <em>每条 issue 描述清楚复现步骤或期望行为即可,我会定期查看并纳入迭代计划</em>
  75. </p>
  76. ---
  77. ### 🚧 开发进度
  78. <p align="center">
  79. <img src="https://img.shields.io/badge/📊_数据图绘制-积极完善中-purple" alt="数据图绘制">
  80. <img src="https://img.shields.io/badge/✨_文字润色-积极完善中-purple" alt="文字润色">
  81. <img src="https://img.shields.io/badge/🔍_文献检索-积极完善中-purple" alt="文献检索">
  82. <img src="https://img.shields.io/badge/📚_引用管理-积极完善中-purple" alt="引用管理">
  83. </p>
  84. <p align="center">
  85. <strong>项目正在积极优化中,欢迎各位 researcher star 和 fork 项目,一起推动项目发展</strong>
  86. </p>
  87. ---
  88. <h2 id="目录">📑 目录</h2>
  89. - [Skills 一览](#skills-一览)
  90. - [快速开始](#快速开始)
  91. - [Claude Code 插件安装](#方式一claude-code-插件安装推荐)
  92. - [Codex CLI 安装](#方式二codex-cli-安装)
  93. - [手动加载](#方式三手动加载)
  94. - [推荐配置](#推荐配置)
  95. - [核心设计](#核心设计)
  96. - [编排器核心工作流](#编排器核心工作流)
  97. - [使用示例](#使用示例)
  98. - [适用场景](#适用场景)
  99. - [文档分层](#文档分层)
  100. - [项目结构](#项目结构)
  101. - [安全边界](#安全边界)
  102. - [维护与验证](#维护与验证)
  103. - [参考项目](#参考项目)
  104. ---
  105. <h2 id="skills-一览">📋 Skills 一览</h2>
  106. | Skill | 角色 | 用途 | 典型触发词 |
  107. |-------|------|------|-----------|
  108. | 🧠 **academic-paper-writer** | **核心编排器** | 完整论文起草、section loop、Hard Gates、子 skill 调度 | `写论文`、`paper draft` |
  109. | 🔍 **academic-citation** | 文献取证 | 文献检索、核验、Citation-to-Claim 映射、本地文献库优先搜索、subagent 全文阅读、Exemplar Set | `找引用`、`citation pass` |
  110. | 🔬 **academic-experiments** | 实验取证 | 实验证据盘点、最小可复核执行、协议风险审计 | `复核实验`、`verify results` |
  111. | ✅ **academic-reviser** | 审稿人 | 证据审查、三轮自审、Verification 判定 | `审修`、`self review` |
  112. | ✨ **academic-polishing** | 文体打磨 | Prose Quality Gate、Claim Strength Audit、去 AI 化 | `润色`、`claim strength` |
  113. | 📊 **academic-figure** | 数据图生成 | 实验数据图(Python 代码)、图表审查与修改;架构图只记录手工绘制需求 | `绘图`、`训练曲线`、`消融实验` |
  114. | 🏛️ **academic-venue-research** | 期刊调研 | 调研目标 venue 投稿要求与写作风格,产出标准化 Venue Brief | `期刊调研`、`venue research`、`投稿要求` |
  115. | 📐 **academic-latex-layout** | latex排版 | 学术论文 LaTeX 布局、图表浮动体放置、模板适配与布局修复(独立调用) | `LaTeX 布局`、`float placement`、`layout repair` |
  116. ---
  117. <h2 id="快速开始">🚀 快速开始</h2>
  118. <h3 id="方式一claude-code-插件安装推荐">方式一:Claude Code 插件安装(推荐)</h3>
  119. #### 选项 A:开发版(自动更新)
  120. 使用 `main` 分支,每次启动 Claude Code 自动获取最新版本。
  121. ```bash
  122. # 1. 添加 marketplace(main 分支)
  123. /plugin marketplace add joshua-zyy/academic-paper-writer
  124. # 2. 安装插件
  125. /plugin install academic-paper-writer@academic-paper-writer
  126. ```
  127. > 💡 **自动更新**:main 分支版本无需手动更新,每次启动 Claude Code 会自动检测并同步最新代码。
  128. #### 选项 B:稳定版(手动更新)
  129. 使用 `stable` 分支,只获取经过测试的稳定版本。
  130. ```bash
  131. # 1. 添加 marketplace(stable 分支)
  132. /plugin marketplace add joshua-zyy/academic-paper-writer@stable
  133. # 2. 安装插件
  134. /plugin install academic-paper-writer@academic-paper-writer
  135. ```
  136. > ⚠️ **手动更新**:稳定版需要手动执行更新命令:
  137. > ```bash
  138. > /plugin update academic-paper-writer@academic-paper-writer
  139. > ```
  140. #### 版本对比
  141. | 版本 | 分支 | 更新方式 | 适用场景 |
  142. |------|------|----------|----------|
  143. | **开发版** | `main` | 自动更新 | 开发者、早期用户、想要最新功能 |
  144. | **稳定版** | `stable` | 手动更新 | 生产环境、稳定性要求高的用户 |
  145. #### 安装后可用命令
  146. - `/academic-paper-writer` - 完整论文工作流
  147. - `/academic-citation` - 文献检索与核验
  148. - `/academic-experiments` - 实验复核
  149. - `/academic-reviser` - 审稿验证
  150. - `/academic-polishing` - 文体打磨
  151. - `/academic-figure` - 图表生成
  152. - `/academic-venue-research` - 期刊调研
  153. - `/academic-latex-layout` - LaTeX 布局与浮动体放置
  154. <h3 id="方式二codex-cli-安装">方式二:Codex CLI 安装</h3>
  155. #### 选项 A:开发版(main 分支)
  156. ```bash
  157. # 克隆到用户级目录(推荐)
  158. git clone https://github.com/joshua-zyy/academic-paper-writer.git ~/.agents/skills/academic-paper-writer
  159. ```
  160. #### 选项 B:稳定版(stable 分支)
  161. ```bash
  162. # 克隆 stable 分支到用户级目录
  163. git clone -b stable https://github.com/joshua-zyy/academic-paper-writer.git ~/.agents/skills/academic-paper-writer
  164. ```
  165. #### 选项 C:指定版本(tag)
  166. ```bash
  167. # 克隆特定版本
  168. git clone -b v1.0.0 https://github.com/joshua-zyy/academic-paper-writer.git ~/.agents/skills/academic-paper-writer
  169. ```
  170. #### 更新插件
  171. ```bash
  172. # 进入 skill 目录
  173. cd ~/.agents/skills/academic-paper-writer
  174. # 拉取最新代码(main 分支)
  175. git pull
  176. # 或切换到 stable 分支
  177. git checkout stable
  178. git pull
  179. # 或切换到特定版本
  180. git checkout v1.0.0
  181. ```
  182. #### 版本对比
  183. | 版本 | 分支/标签 | 更新方式 | 适用场景 |
  184. |------|-----------|----------|----------|
  185. | **开发版** | `main` | `git pull` | 开发者、早期用户 |
  186. | **稳定版** | `stable` | `git pull` | 生产环境 |
  187. | **指定版本** | `v1.0.0` 等 | 手动切换 | 需要锁定版本 |
  188. <h3 id="方式三手动加载">方式三:手动加载</h3>
  189. ```bash
  190. git clone https://github.com/joshua-zyy/academic-paper-writer.git
  191. ```
  192. 在支持 Skill 机制的 Agent 平台中加载对应 SKILL.md:
  193. | 场景 | 加载方式 |
  194. |------|---------|
  195. | 📄 **完整论文工作流** | 加载 `skills/academic-paper-writer/SKILL.md` |
  196. | 🎯 **单一专项任务** | 直接加载对应子 skill 的 `SKILL.md` |
  197. 本项目本身不依赖额外 Python 包或 Node 运行时,主要内容是 skill 文档、reference、schema 和辅助脚本。
  198. ### 可选依赖
  199. 以下 Python 脚本为可选工具,按需安装:
  200. | 脚本 | 用途 | 依赖 |
  201. |------|------|---------------------------|
  202. | `skills/academic-citation/scripts/convert-pdfs-to-md.py` | 将本地 PDF 文献转换为 Markdown(默认使用 MinerU API,含图片提取与索引生成) | Python 3.10+, MinerU API Token |
  203. | `scripts/check_schemas.py` | 验证跨技能 schema 一致性 | Python 3.12+|
  204. ### 3. 准备输入材料
  205. 越完整的输入,skill 的表现越稳定:
  206. <pre>
  207. 📂 代码仓库路径 🏛️ 目标会议 / 期刊 🌐 写作语言
  208. 📊 实验日志 / CSV 📄 已有草稿 / outline 📝 研究摘要 / 贡献点
  209. </pre>
  210. ---
  211. <h2 id="推荐配置">⚙️ 推荐配置</h2>
  212. ### 推荐模型
  213. | 模型 | 说明 |
  214. |--------------------------|------------------------------------------------------------------------------------------|
  215. | 🚀 **gpt-5.5** | anyRouter中提供免费的api,需要使用vpn+教育邮箱/linux do账号注册,地址: https://anyrouter.top/register?aff=hZXa |
  216. | 🚀 **claude-4.8** | agentRouter中提供免费的api,需要使用github账号注册,地址: https://agentrouter.org/register?aff=Wpuc |
  217. | 🚀 **DeepSeek V4 Flash** | token价格低,且是推理模型支持1m上下文,可以用于测试skill效果,缺点是无多模态能力 |
  218. ### 推荐 Agent 平台
  219. | 平台 | 安装方式 | 更新方式 | 说明 |
  220. |------|----------|----------|--------------------------------------------|
  221. | ⚡ **OpenCode** | `git clone` 到 `~/.agents/skills/` | 手动 `git pull` | 强烈推荐,对于本skill多智能体派发编排最适配,开源 Agent 平台,灵活可扩展 |
  222. | 🤖 **Claude Code** | `/plugin marketplace add` + `/plugin install` | 自动更新(main分支)或手动 `/plugin update` | Anthropic 官方 CLI 工具,原生支持 Skill 机制,推荐使用 |
  223. | 🔧 **Codex CLI** | `git clone` 到 `~/.agents/skills/` | 手动 `git pull` | OpenAI 代码助手,支持多种编程任务 |
  224. > 💡 **提示**:使用支持 Skill 机制的 Agent 平台可获得最佳体验,其他平台也可通过加载 SKILL.md 文件使用本项目。
  225. ---
  226. <h2 id="核心设计">🏗️ 核心设计</h2>
  227. ### 🔍 证据优先,逐节闭环
  228. 每一节经历固定闭环,不允许跳过任何环节:
  229. ```text
  230. ┌─────────────────────────────────────────────────────────────┐
  231. │ 逐节闭环(每节必须经历) │
  232. │ │
  233. │ ✏️ Draft v1 → 📌 占位符审计 → ⚖️ 证据合规审查 │
  234. │ → ✨ Prose Gate → 📏 Expansion → ✅ Self-Review │
  235. │ → Verification │
  236. │ │ │
  237. │ ├── passed ▶️ 推进下一节 │
  238. │ └── failed 🔁 回到 ⚖️ 证据合规审查 重来 │
  239. └─────────────────────────────────────────────────────────────┘
  240. ```
  241. - 初稿可以带占位符,但占位符必须被记录、审计和追踪
  242. - `Verification` 未通过时不能假装通过
  243. ### 🧩 Core + Subskills 架构
  244. 核心编排器负责:判断任务模式 → 确认 venue/language → 组织 section queue → 维护 cumulative draft → 吸收子 skill 的专项结果。
  245. | Core 环节 | 委托 Skill | 处理方式 |
  246. |-----------|-----------|---------|
  247. | 🏛️ 目标 Venue 调研 | `academic-venue-research` | dispatch 子 Agent |
  248. | 🔍 文献检索与核验(含本地文献库优先 + subagent 全文阅读) | `academic-citation` + `literature-reader-agent` | dispatch 子 Agent |
  249. | 🔬 实验证据复核 | `academic-experiments` | dispatch 子 Agent |
  250. | 📊 数据图 / 实验结果图 | `academic-figure` | dispatch 子 Agent |
  251. | ✨ Prose Quality Gate | `academic-polishing` | **内化调用**(主 Agent 自行执行) |
  252. | ✅ 证据审查与 Verification | `academic-reviser` | dispatch 子 Agent |
  253. > **设计原则**:主 Agent 直接撰写论文正文,确保叙事风格一致。子 Agent 仅提供工具型专项输出,不得直接修改 Cumulative Draft。
  254. ### 🚧 Hard Gates + 数据契约
  255. 五个不可跳过的基础关卡:
  256. | Gate | 触发位置 | 核心条件 | 失败处理 |
  257. |-----------------------|---------|---------|---------|
  258. | 🏛️ **E:Venue 调研** | Step 1 → Step 5 | 若用户提供本地 PDF 文献库,Step 2 已验证 MD 目录;venue 确认后必须完成 Step 4 并生成 venue-brief.md | 阻塞,不得进入 Step 5 |
  259. | 🔬 **A:证据完备** | Step 5 → Step 9 | 至少一条可引用证据(`newly_run` 或 `preexisting_artifact`) | 降级路径或阻塞 |
  260. | 📖 **B:当前节引用就绪** | Step 6 → Step 9 | 当前 section 的关键 claims 有 VERIFIED 引用、Citation-to-Claim Map、项目证据或显式 `[REF_NEEDED]` debt | Intro/RW 阻塞;Method/Results 可带记录的 debt |
  261. | 🚪 **C:Verification** | Step 9.8 → Step 10 | 所有 hard debt 闭合 + `thin_draft=no` | passed/blocked/failed |
  262. | 📚 **D:全文引用数量** | Step 11 → 输出 | 全文去重引用 >= `min_citations` | 未达标时提醒,可补充后重检 |
  263. 跨 skill 之间通过显式 **数据契约** 交换信息:
  264. ```yaml
  265. 📦 Evidence Inventory # 实验证据盘点 → academic-experiments → orchestrator
  266. ✅ Verified References # 核验文献清单 → academic-citation → orchestrator
  267. 📖 LiteratureReadingReport # 文献阅读报告 → literature-reader-agent → orchestrator
  268. 📋 Verification Report # 验证状态报告 → academic-reviser → orchestrator
  269. 🗺️ Citation-to-Claim Map # 引用-主张映射 → academic-citation → orchestrator
  270. ```
  271. ---
  272. <h2 id="编排器核心工作流">🔄 编排器核心工作流</h2>
  273. ```text
  274. ┌──────────────────────────────────────────────────────────────────────────┐
  275. │ 编排器核心工作流 │
  276. │ │
  277. │ 🎯 Step 0 判定任务模式 │
  278. │ ↓ │
  279. │ 🔒 Step 1 确认 venue / 语言 / min_citations + 本地文献库(🔴硬阻塞) │
  280. │ ↓ │
  281. │ 📄 Step 2 PDF→MD MinerU 转换确认(条件执行,缺 MD 时阻塞等待用户) │
  282. │ ↓ │
  283. │ 🔍 Step 3 项目上下文提取 │
  284. │ ↓ │
  285. │ 🏛️ Step 4 Venue Requirements Research(生成 venue-brief.md) │
  286. │ ↓ │
  287. │ 🔬 Step 5 并行证据审计(⚡涉及多 probe 时必须并行 dispatch) │
  288. │ ↓ │
  289. │ 📚 Step 6 文献检索与核验(本地优先 + 联网 + 全文阅读 + Gate B) │
  290. │ ↓ │
  291. │ 🔬 Step 7 实验事实复核 │
  292. │ ↓ │
  293. │ 🧩 Step 8 Section Plan / Section Contract / Blueprint │
  294. │ ↓ │
  295. │ ┌──────────────────────────────────────────────────────────────────┐ │
  296. │ │ Step 9 Section Complete Loop │ │
  297. │ │ 🧭 Step 9.0 Section Contract Gate │ │
  298. │ │ 🔎 Step 9.1 前置深度探查(多 probe 时必须并行 dispatch) │ │
  299. │ │ ✏️ Step 9.2 Draft v1(占位符系统 + 待补充清单) │ │
  300. │ │ 📝 Step 9.3 写入 paper_draft.md │ │
  301. │ │ 📌 Step 9.4 占位符审计 + 数据图代码 / 手工图表需求 │ │
  302. │ └──────────────────────────────────────────────────────────────────┘ │
  303. │ ↓ │
  304. │ ┌──────────────────────────────────────────────────────────────────┐ │
  305. │ │ 质量门(双阶段审查) │ │
  306. │ │ ⚖️ Step 9.5 证据合规审查(Review Phase 1) │ │
  307. │ │ ✨ Step 9.6 Prose Quality Gate(Review Phase 2,内化调用) │ │
  308. │ │ 📏 Step 9.7 Expansion Pass(内容密度检查) │ │
  309. │ └──────────────────────────────────────────────────────────────────┘ │
  310. │ ↓ │
  311. │ ✅ Step 9.8 Self-Review & Verification │
  312. │ │ │
  313. │ ├── passed → Step 9.9 更新 Cumulative Draft → 推进下一节 │
  314. │ │ ↓ │
  315. │ │ 🔄 Step 10 依赖感知 Section Loop │
  316. │ └── failed → ⬆️ 回到 Step 9.5 证据合规审查 重来 │
  317. │ │
  318. │ 📌 Abstract 后置 — 所有核心章节全部 passed 后才允许生成 │
  319. │ 📋 Step 11 引用清单生成(**强制**,核验 >= `min_citations`) │
  320. │ ↓ │
  321. │ 🖼️ Step 12 数据图批量生成(**强制**,执行数据图代码 + 复核手工图表需求)│
  322. └──────────────────────────────────────────────────────────────────────────┘
  323. ```
  324. > - 🔒 Step 1 是硬阻塞,缺少 venue/language + 本地文献库确认时不能继续
  325. > - Step 11→Step 12→输出最终稿,两者均为强制步骤,不可跳过
  326. > - 📐 `section-drafting` 也要走完整闭环,只是缩小证据范围
  327. > - 🚧 Introduction / Related Work 在零 VERIFIED 引用时必须阻塞
  328. > - ⚡ Step 5 / Step 9.1 涉及多个 probe 时**必须并行** dispatch,不得串行
  329. > - 📋 论文完成时 Step 11 **强制**生成引用清单,核验 >= `min_citations`
  330. ---
  331. <h2 id="使用示例">💡 使用示例</h2>
  332. ### 📄 完整论文起草
  333. ```text
  334. 我有一个图神经网络项目仓库,想写一篇投 NeurIPS 的论文。
  335. 请先确认 venue 和语言,然后按 section 逐节推进,
  336. 不要一次性生成整篇。
  337. ```
  338. ### ✨ 单独润色 Method
  339. ```text
  340. 帮我把这段 Method 改成论文正文口吻,
  341. 但不要把不确定的设计动机写成已确认事实。
  342. ```
  343. ### 🔗 单独做引用核验
  344. ```text
  345. 帮我为 Introduction 找 5-8 篇 VERIFIED 引用,
  346. 并生成 Citation-to-Claim Map。
  347. ```
  348. ### 🔬 单独做实验复核
  349. ```text
  350. 先盘点这个仓库里的 checkpoint、日志和结果表,
  351. 尽量用最小可复核方式确认 Main Results。
  352. ```
  353. ---
  354. <h2 id="适用场景">🎭 适用场景</h2>
  355. <table>
  356. <tr>
  357. <td width="50%" align="center">
  358. ### ✅ 适合
  359. </td>
  360. <td width="50%" align="center">
  361. ### ❌ 不适合
  362. </td>
  363. </tr>
  364. <tr>
  365. <td>
  366. - 📁 有代码仓库、实验日志、结果表、草稿、研究笔记
  367. - 📑 需要逐节推进完整论文
  368. - 🧩 需要区分"能写的"和"暂时不能下结论的"
  369. - 🎛️ 希望对文献、实验、claim 强度做显式控制
  370. </td>
  371. <td>
  372. - 🚫 非 CS/AI/ML 领域论文
  373. - ⚡ 只想要一次性成稿的通用 prompt
  374. - 📐 只需要 LaTeX 排版 / 浮动体修复时,不应走核心论文编排器;请直接调用 `academic-latex-layout`
  375. - ⚠️ 要求无视证据边界强行写成已验证结论
  376. </td>
  377. </tr>
  378. </table>
  379. ---
  380. <h2 id="文档分层">📚 文档分层</h2>
  381. | 层级 | 文件 | 作用 |
  382. |------|------|------|
  383. | **战略层** | `SKILL.md` | 高层规则、触发条件、Hard Gates 摘要、数据契约、reference 导航 |
  384. | **战术导航** | `orchestration-workflow.md` | 导航索引,指引到按阶段拆分的执行文件 |
  385. | **战术执行** | `workflow-step-0-7.md`<br/>`workflow-step-8-9.5.md`<br/>`workflow-step-9.6-12.md` | 拆分为 3 个文件的详细执行手册,每个包含独立 dispatch 模板、step-by-step 流程、fallback 路径。**按阶段加载以节省上下文窗口** |
  386. > 💡 **阅读建议**:改规则摘要、使用边界、导航 → 看 `SKILL.md`。改具体执行步骤、模板、失败路径 → 按 Step 阶段加载对应的 `workflow-step-*.md`。
  387. ---
  388. <h2 id="项目结构">📁 项目结构</h2>
  389. ```text
  390. academic-paper-writer/
  391. ├── README.md
  392. ├── LICENSE
  393. ├── .claude-plugin/ # Claude Code 插件配置
  394. │ ├── plugin.json # 插件清单
  395. │ └── marketplace.json # 市场定义
  396. ├── scripts/ # 项目级工具脚本
  397. │ └── check_schemas.py # 跨技能 schema 一致性检查
  398. └── skills/
  399. ├── shared/
  400. │ ├── schemas/ # 跨技能数据契约(5 个 schema)
  401. │ └── core/ # 共享证据、非编造与输出边界规则
  402. ├── academic-paper-writer/ # 📌 核心编排器
  403. │ ├── SKILL.md
  404. │ ├── agents/ # probe agent 定义
  405. │ └── references/ # 工作流(导航索引 + 3 阶段文件 + exemplars)
  406. ├── academic-polishing/ # ✨ 文体打磨
  407. ├── academic-citation/ # 🔍 文献取证
  408. │ ├── agents/ # citation_agent + literature-reader-agent
  409. │ ├── scripts/ # citation_audit.py + convert-pdfs-to-md.py
  410. │ └── references/ # 检索策略、核验协议、引用映射、reading report schema
  411. ├── academic-reviser/ # ✅ 审修验证
  412. │ ├── agents/ # reviser_agent
  413. │ ├── scripts/ # placeholder_audit.py
  414. │ └── references/ # 检查清单、Verification 判定、常见陷阱
  415. ├── academic-experiments/ # 🔬 实验取证
  416. │ ├── agents/ # experiment_agent
  417. │ ├── scripts/ # evidence_scanner.py
  418. │ └── references/ # 证据盘点、运行策略、协议风险
  419. ├── academic-figure/ # 📊 数据图生成
  420. │ ├── agents/ # figure_agent
  421. │ ├── scripts/ # chart_template.py + qa_figure.py
  422. │ └── references/ # 设计理论、图表类型、QA、教程
  423. ├── academic-venue-research/ # 🏛️ 期刊调研
  424. │ ├── agents/ # venue-research-agent
  425. │ └── references/ # 投稿要求、风格分析、venue brief 模板
  426. └── academic-latex-layout/ # 📐 LaTeX 布局
  427. ├── SKILL.md
  428. ├── manifest.yaml
  429. ├── references/ # 浮动体放置、模板约束、PDF 预览循环
  430. └── static/core/ # 核心规则与边界
  431. ```
  432. ### 建议阅读顺序
  433. ```
  434. 1️⃣ README.md
  435. 2️⃣ skills/academic-paper-writer/SKILL.md
  436. 3️⃣ references/orchestration-workflow.md(导航索引)
  437. 4️⃣ references/workflow-step-*.md(按 Step 阶段加载)
  438. 5️⃣ skills/shared/schemas/*
  439. 6️⃣ 你关心的子 skill SKILL.md
  440. ```
  441. ---
  442. <h2 id="安全边界">🛡️ 安全边界</h2>
  443. > 这个项目最重要的不是"写得快",而是**不越界**。
  444. | 边界 | 说明 |
  445. |------|------|
  446. | 🚫 不编造 | 禁止编造文献、作者、年份、venue、DOI、arXiv 编号、实验结果、图表、命令或日志 |
  447. | ⚠️ 不混淆 | 不把 `UNVERIFIED` 文献写成 `VERIFIED`,不把 `user_claim` 写成可引用证据 |
  448. | 📛 不夸大 | 不把内部验证包装成 `SOTA`、`generalization`、`strong evidence` |
  449. | 📌 不静默 | 缺失信息必须显式保留 `[REF_NEEDED]`、`[RESULT_NEEDED]` 等占位符,不得静默略过 |
  450. > 它允许输出"当前最佳草稿",但不允许输出"伪装成已验证完成稿的草稿"。
  451. ---
  452. <h2 id="维护与验证">🔧 维护与验证</h2>
  453. ### 版本管理
  454. 本项目使用 Git 分支和标签进行版本管理:
  455. | 分支/标签 | 说明 | 适用场景 |
  456. |-----------|------|----------|
  457. | `main` | 开发分支,最新功能 | 开发者、早期用户 |
  458. | `stable` | 稳定分支,手动合并 | 生产环境、稳定性要求高的用户 |
  459. | `v1.0.0` 等标签 | 版本标记 | 需要锁定特定版本的用户 |
  460. **Claude Code 用户**:
  461. - 使用 `main` 分支:自动获取最新版本
  462. - 使用 `stable` 分支:需要手动执行 `/plugin update` 命令
  463. **Codex CLI 用户**:
  464. ```bash
  465. # 切换到 stable 分支
  466. cd ~/.agents/skills/academic-paper-writer
  467. git checkout stable
  468. git pull
  469. # 切换到特定版本
  470. git checkout v1.0.0
  471. ```
  472. ### 结构一致性检查
  473. ```bash
  474. # 使用自动化脚本检查跨技能 schema 对齐
  475. python scripts/check_schemas.py --skills-root ./skills
  476. ```
  477. 检查项:
  478. - ✅ 各子 skill schema 是否指向 `shared/schemas/` 的权威版本
  479. - ✅ 所有 debt 字段在 schema 和 SKILL.md 之间是否对齐
  480. - ✅ SKILL.md 中引用的 reference 文件是否存在
  481. - ✅ 步骤编号是否一致
  482. <h2 id="参考项目">📖 参考项目</h2>
  483. - ⚡ [superpowers](https://github.com/obra/superpowers)
  484. - 🌿 [nature-skills](https://github.com/Yuan1z0825/nature-skills)
  485. - 🎓 [academic-research-skills](https://github.com/Imbad0202/academic-research-skills)
  486. ### 相关文档
  487. - 📘 [Claude Code 插件文档](https://docs.anthropic.com/en/docs/claude-code/plugins)
  488. - 📗 [Codex CLI 文档](https://github.com/openai/codex)
  489. - 📙 [Agent Skills 规范](https://agentskills.io)
  490. ---
  491. ## 📄 许可
  492. [MIT License](LICENSE)
  493. > ⚠️ **免责声明**:本项目旨在辅助学术写作的结构化与质量控制,最终论文的学术诚信、实验真实性、引用准确性与投稿合规性由使用者本人负责。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.