mcpField
A
academic-paper

academic-paper

github.com/quan0715文档处理1451 次安装9 周前更新
代码仓库

关于 academic-paper

academic-paper 是用于学术文档的技能和可运行起始工作区,面向研究者及 Agent 的起草与迭代。它提供学术排版规则和 React/MDX 示例文件,但不适合作为可直接投稿的 IEEE 或 ACM 格式。

主要功能

  1. 01A4 单栏学术版式
  2. 02罗马数字章节与斜体子标题
  3. 03摘要、索引词和数字引用
  4. 04图表自动编号
  5. 05可运行的 React/MDX 起始工作区

适用场景

  1. 01在 LaTeX 排版前起草研究论文
  2. 02迭代会议论文内容
  3. 03准备期刊预印本或 arXiv 风格草稿
  4. 04撰写课程论文、实验报告或论文各章

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/quan0715/open-press --skill academic-paper

安装后在 Claude Code 中输入/academic-paper确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

starter/
package.openpress.json
starter/press/
design.md
starter/press/academic-paper/
press.tsx
starter/press/academic-paper/chapters/01-introduction/content/
01-introduction.mdx
starter/press/academic-paper/chapters/02-methods/content/
01-methods.mdx
starter/press/academic-paper/chapters/03-results-and-discussion/content/
01-results.mdx
starter/press/academic-paper/chapters/04-acknowledgment/content/
01-acknowledgment.mdx
starter/press/academic-paper/chapters/05-references/content/
01-references.mdx
starter/press/academic-paper/components/
Page.tsx
starter/press/academic-paper/components/ChapterOpenerVisual/
index.tsx
starter/press/academic-paper/components/TokenSwatchGrid/
index.tsx
starter/press/academic-paper/components/TypeSpecimen/
index.tsx
starter/press/academic-paper/media/
figure-placeholder.svg
README.md
starter/press/academic-paper/theme/
fonts.css
README.md
tokens.css
starter/press/academic-paper/theme/base/
page-contract.css
print.css
typography.css
starter/press/academic-paper/theme/page-surfaces/
back-cover.css
chapter-opener.css
cover.css
toc.css

详细介绍

学术论文

一种用于研究风格写作的文档样式:衬线标题、摘要块、编号章节(I、II、III)、斜体小节标题(A、B、C)、编号图表,以及 [N] 数字引用。灵感来自 IEEE 会议版式,但采用单栏布局并兼顾屏幕阅读器体验——专为起草/预印本/迭代阶段设计,不适用于生成可提交给 IEEEtran 的输出。

这是一项包含起步模板的技能:它提供 SKILL 规则,以及一个可运行的 starter/ 工作区(React/MDX 入口、主题、设计文档、示例章节)。使用 openpress 初始化 OpenPress 运行时工作区;此技能负责提供学术论文起步文件和设计规则。

视觉特征

  • 字体:全文使用衬线字体(Source Serif 4 / Noto Serif TC)。标题采用大号展示字重;正文阅读字号约为 10.5pt。
  • 章节:顶级章节使用罗马数字 + 小型大写字母(I. INTRODUCTION);小节使用斜体句首字母大写格式(A. Maintaining the Integrity…);次小节使用行内斜体(a) Positioning Figures and Tables:)。
  • 摘要:行内粗体标签 **Abstract**—,正文为斜体,正文开始前有全宽色带。
  • 索引词:行内粗体标签 **Index Terms**—,正文为斜体,紧接摘要下方。
  • 参考文献:使用 [1]、[2] 数字样式,并采用悬挂缩进。
  • 图/表:自动编号;图注置于图下方/表注置于表上方;使用窄细线边框。
  • 版式:A4 单栏。双栏论文需要专用的页面/框架组件;此起步模板不保证生成出版商最终版的 IEEE/ACM 版式。

适用场景

  • 研究论文草稿(LaTeX 排版前)
  • 会议论文迭代(转换为 IEEEtran 并提交之前)
  • 期刊预印本/arXiv 风格草稿
  • 课程学期论文、实验室报告、技术说明
  • 论文各章节(按章节编写,或采用扩展结构编写完整论文)

不适用场景

  • IEEE / ACM 会议最终投稿——此类投稿需要使用出版商的 LaTeX 类文件。可在起草和 Agent 协作阶段使用此起步模板;提交时需手动导出为 LaTeX。
  • 营销或以设计为主导的文档——其字体排版节奏适用于学术文本,而非宣传文案。
  • 幻灯片或单页文档。

如何应用(套用到新工作區)

当用户说“use academic-paper”或“start a research paper”时,运行:

npm create @open-press <target> -- --type slides
cd <target>
rm -rf press
cp -R <this-skill>/starter/press press

<this-skill> 表示已安装的技能目录,或此仓库中的 skills/academic-paper 目录。OpenPress 不会为你获取此起步模板; Agent 会读取该技能并复制或调整其中的文件。

然后:

  1. 在 press/<slug>/press.tsx 中 <Press> 属性以及封面 JSX 里的 title / subtitle(论文的运行副标题)/ organization(院系、机构)/ author 填入相应内容。将 starter/package.openpress.json 合并到工作区 package.json 的 "openpress" 字段中,以配置部署/PDF 设置。
  2. 起步模板附带了一个基于 IEEE 会议模板的示例结构(Introduction、Methods / Ease of Use、Results / Prepare Your Paper、Acknowledgment、References)。请将各章节替换为自己的内容。
  3. 编辑 press/design.md,设置项目专属规范(例如首选引用样式、缩写规则)。
  4. 编辑完成后运行 npm run build,以验证并渲染。

应做与避免

应做:

  • 为每个图和表编号;在正文中用 Fig. N / Table N 引用。
  • 用 [N] 引用文献;在参考文献章节中按统一格式汇总参考文献。
  • 公式单独成行,编号采用右对齐的 (1) 样式;表格前使用 <TableCaption>。
  • 首次使用时定义缩写——即使在摘要中已经用过,也要定义。

避免:

  • 除非确实无法避免,否则不要在标题或主要标题中使用缩写。
  • 不要在摘要或参考文献列表中加入脚注。
  • 不要用 Eq. (1) 或 equation (1) 进行括号内引用——只用 (1)。仅在句首使用 Equation (1)。
  • 不要把每个段落都编号成一个章节。H4 用于区分不同技术或子流程,而不是调节行文节奏。

深层设计规则

详细的排版层级、间距、编号规则和 CSS 层职责见 starter/press/design.md——将 starter 复制到工作区后,该文件便成为面向用户和 Agent 的项目级设计规范。

评论

支持 Markdown