Skip to content
Back to search

research-writing-skill

科研写作助手 (Research Writing Assistant)

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/norman-bury--research-writing-skill/badge.svg)](/listings/norman-bury--research-writing-skill)

HTML

<a href="/listings/norman-bury--research-writing-skill"><img src="/api/listings/norman-bury--research-writing-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:直接下载

下载仓库,解压后把 `research-writing-skill/` 复制到你的论文写作目录就可以用了。

方式二:Git Clone

git clone https://github.com/Norman-bury/research-writing-skill.git
cd research-writing-skill

各平台安装

- **Codex**:参考 `.codex/INSTALL.md` - **OpenCode**:参考 `.opencode/INSTALL.md` - **其他平台**:将整个目录放入论文项目根目录即可

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.

SKILL.md · Manifest · 214 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: research-writing-assistant
  3. description: Use when writing academic papers, theses, or research articles - supports brainstorming, chapter writing, literature review, and LaTeX output
  4. allowed-tools: Read Write Edit Bash WebSearch
  5. ---
  6. # 科研写作助手 (Research Writing Assistant)
  7. 面向本科与研究生论文写作的执行型 Skill。
  8. ## 哲学原则
  9. - **流程优于即兴** — 头脑风暴先行,结构确认再写作
  10. - **证据优于声称** — 引用可追溯,绝不编造文献
  11. - **简洁优于复杂** — 去AI化写作,拒绝机械表达
  12. - **确认优于假设** — 每章用户确认,避免返工
  13. ## 新架构(v3.0)
  14. 本 Skill 已升级为模块化技能架构,支持多平台:
  15. | 平台 | 配置 |
  16. |------|------|
  17. | Claude Code | `.claude-plugin/plugin.json` |
  18. | Cursor | `.cursor-plugin/plugin.json` |
  19. | Codex | `.codex/INSTALL.md` |
  20. | OpenCode | `.opencode/INSTALL.md` |
  21. | Gemini CLI | `GEMINI.md` |
  22. ## 技能列表
  23. ### 核心流程技能
  24. | 技能 | 路径 | 说明 |
  25. |------|------|------|
  26. | using-research-writing | `skills/using-research-writing/` | 入口技能,规则和路由 |
  27. | paper-orchestration | `skills/paper-orchestration/` | 中型/整篇任务编排 |
  28. | brainstorming-research | `skills/brainstorming-research/` | 头脑风暴,7轮问答 |
  29. | writing-chapters | `skills/writing-chapters/` | 章节写作 |
  30. | latex-output | `skills/latex-output/` | LaTeX 输出 |
  31. ### 写作支持技能
  32. | 技能 | 路径 | 说明 |
  33. |------|------|------|
  34. | writing-core | `skills/writing-core/` | 核心写作规范 |
  35. | writing-humanities | `skills/writing-humanities/` | 文科写作 |
  36. | writing-medical | `skills/writing-medical/` | 医学写作 |
  37. | writing-law | `skills/writing-law/` | 法学写作 |
  38. | literature-review | `skills/literature-review/` | 文献综述 |
  39. | evidence-driven-writing | `skills/evidence-driven-writing/` | 文献驱动引言/相关工作 |
  40. | experiment-results-planning | `skills/experiment-results-planning/` | 实验、结果和 mock 数据规划 |
  41. ### 工具技能
  42. | 技能 | 路径 | 说明 |
  43. |------|------|------|
  44. | verification | `skills/verification/` | 验证机制,确保完成声称有证据 |
  45. | figures-python | `skills/figures-python/` | Python 数据图表 |
  46. | figures-diagram | `skills/figures-diagram/` | 流程图/架构图 |
  47. | peer-review | `skills/peer-review/` | 自审检查 |
  48. | statistical-analysis | `skills/statistical-analysis/` | 统计分析 |
  49. | prompts-collection | `skills/prompts-collection/` | 提示词集合 |
  50. | environment-setup | `skills/environment-setup/` | 环境配置 |
  51. ## Red Flags(停止并检查)
  52. ### 流程类 Red Flags
  53. | AI的想法 | 正确做法 |
  54. |----------|----------|
  55. | "用户说得很清楚了,直接开始写" | 必须先完成 brainstorming-research |
  56. | "这只是修改一小段" | 检查是否有 plan/,没有则先创建 |
  57. | "先写一段看看效果" | 必须先确认论文类型和章节结构 |
  58. | "用户很着急,跳过讨论" | 流程可以加速,但不能跳过关键确认 |
  59. | "这是简单任务,不需要 plan" | 任何写作任务都需要 plan 记录 |
  60. | "我知道怎么写论文" | 必须按用户选择的类型和结构写 |
  61. | "先把内容写完再说格式" | 格式在 brainstorming 阶段确定 |
  62. | "这章内容很简单,不用确认" | 每章写完都必须让用户确认 |
  63. ### 文献类 Red Flags
  64. | AI的想法 | 正确做法 |
  65. |----------|----------|
  66. | "文献我可以补充一些" | 绝不编造文献,必须可追溯 |
  67. | "我记得这个技能的内容" | 技能会更新,必须重新读取当前版本 |
  68. | "这个引用看起来很合理" | 没有来源的引用一律不写 |
  69. | "用户应该知道这个领域" | 不假设用户知识,问清楚再写 |
  70. ### 验证类 Red Flags(来自 verification 技能)
  71. | AI的想法 | 正确做法 |
  72. |----------|----------|
  73. | "应该写完了" | 运行验证命令确认 |
  74. | "章节看起来完整" | 执行字数统计和结构检查 |
  75. | "引用应该是真的" | 调用 CrossRef API 或搜索验证 |
  76. | "格式应该没问题" | 运行格式检查脚本 |
  77. | "搜索完成" | 检查结果数量和 DOI 列表 |
  78. | "我很确信" | 确信 ≠ 证据,运行验证 |
  79. | "就这一次跳过验证" | 没有例外 |
  80. <EXTREMELY-IMPORTANT>
  81. 任何论文写作任务开始前,必须先调用 `skills/using-research-writing/` 确定流程。
  82. 不允许跳过头脑风暴直接写作。
  83. </EXTREMELY-IMPORTANT>
  84. ### 标准流程
  85. 1. **入口路由** → 调用 `using-research-writing`
  86. - 中型/整篇任务先转入 `paper-orchestration`
  87. - 简单章节任务继续检查 plan/ 与章节状态
  88. 2. **中型任务编排** → 调用 `paper-orchestration`
  89. - 多章节、文献驱动、实验图表或质量返工任务必须先生成任务包
  90. - 完成后记录 capability-use audit(能力使用审计)
  91. 3. **头脑风暴** → 调用 `brainstorming-research`
  92. - 确认论文类型(7种)
  93. - 确认学科领域
  94. - 确认题目、研究背景、方法
  95. - 确认章节结构
  96. - 检测 LaTeX 模板
  97. - 创建 plan/ 和 chapters/
  98. 4. **章节写作** → 调用 `writing-chapters`
  99. - 每章独立文件
  100. - 两阶段 Review(见下方)
  101. - 用户确认后继续
  102. 5. **LaTeX 输出**(可选)→ 调用 `latex-output`
  103. - 用户提供模板
  104. - 输出 .tex 文件
  105. - 可直接编译
  106. 4. **两阶段 Review**(每章完成后)
  107. - **阶段一:规范合规** — 检查字数、结构、引用格式是否满足要求
  108. - **阶段二:质量检查** — 检查去AI化、语言流畅度、学术表达
  109. ## 模块兼容(向后兼容)
  110. ## 两阶段 Review 机制
  111. 每章写作完成后,执行两阶段检查:
  112. **阶段一:规范合规检查**
  113. - 字数是否符合要求
  114. - 章节结构是否完整
  115. - 引用格式是否正确
  116. - 小节标题是否清晰
  117. **阶段二:质量检查**
  118. - 去 AI 化:无机械过渡词、无空壳强调句
  119. - 语言流畅:无重复表达、无冗余
  120. - 学术表达:使用"本文"、"本研究"等客观表述
  121. - 段落结构:优先连贯段落,不使用列表堆砌
  122. ## 模块兼容(向后兼容)
  123. 原有 `modules/` 目录仍然保留,可通过以下方式使用:
  124. | 场景 | 模块 |
  125. |------|------|
  126. | 通用写作 | `modules/writing-core.md` |
  127. | 文科写作 | `modules/writing-humanities.md` |
  128. | 医学写作 | `modules/writing-medical.md` |
  129. | 法学写作 | `modules/writing-law.md` |
  130. | 文献综述 | `modules/literature-review.md` |
  131. | 文献驱动写作 | `skills/evidence-driven-writing/` |
  132. | 论文工作流编排 | `skills/paper-orchestration/` |
  133. | 实验结果规划 | `skills/experiment-results-planning/` |
  134. | 翻译润色 | `modules/prompts-collection.md` |
  135. | 自审检查 | `modules/peer-review.md` |
  136. | Python图表 | `modules/figures-python.md` |
  137. | 流程图 | `modules/figures-diagram.md` |
  138. | 环境配置 | `modules/environment-setup.md` |
  139. | LaTeX指南 | `modules/latex-guide.md` |
  140. ## 输出规范
  141. ### 去 AI 化
  142. - 禁用机械过渡词:首先、其次、最后、此外
  143. - 禁用空壳强调句:值得注意的是、需要指出的是
  144. - 语气客观,使用"本文"、"本研究"
  145. ### 格式规范
  146. - 段落之间空一行
  147. - 正文不使用加粗
  148. - 论文正文优先连贯段落,不使用列表堆砌
  149. ### 引用规范
  150. - 绝不编造文献
  151. - 引用必须可追溯
  152. ## 文献与事实规则
  153. 1. 绝不编造文献。
  154. 2. 英文文献可检索后引用,中文文献优先让用户提供来源。
  155. 3. 任何引用必须可追溯(作者、年份、出处至少完整两项)。
  156. ## 版本信息
  157. - **版本**:3.1.0
  158. - **更新日期**:2026-05-10
  159. - **维护目标**:可执行、可追踪、流程化、多平台适配
  160. ### v3.1 更新内容
  161. 1. **哲学原则** — 明确核心价值观
  162. 2. **CSO优化** — 所有技能 description 使用 "Use when..." 格式
  163. 3. **增强 Red Flags** — 从10条扩展到12条
  164. 4. **两阶段 Review** — 规范合规 + 质量检查
  165. 5. **语言默认规则** — 毕业论文默认中文,期刊根据要求
  166. 6. **结构模板** — 7种论文类型的默认结构模板
  167. 7. **交互优化** — 让用户少做选择,多做确认
README.md · README · 254 lines

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

  1. # 科研写作助手 (Research Writing Assistant)
  2. > 📄 English version: [README_EN.md](README_EN.md)
  3. 把"论文写作"从一次性聊天,升级成可追踪、可恢复、可复用的工程化协作流程。
  4. 这个 Skill 面向本科生、研究生和早期科研人员,目标很直接:少走弯路,减少返工,把时间花在真正有价值的研究内容上。
  5. ## 项目定位
  6. 这不是一个"只会润色句子"的提示词包,而是一套完整的科研写作协作系统。
  7. 它会在任务开始前先对齐目标与约束,通过头脑风暴确认论文类型、研究背景、方法和章节结构,再按学科和任务路由到对应技能模块执行。
  8. 如果你在做毕业论文、课程项目论文或投稿初稿,这个 Skill 会比普通对话式写作工具更稳定,因为它强调流程、记录和回写,不依赖单轮记忆。
  9. ## 核心能力
  10. - **头脑风暴**:7轮问答确认论文类型、学科、题目、研究背景、方法、章节结构
  11. - **AI辅助写作**:从选题推进、正文写作、图表生成到投稿前自审,按阶段门禁执行
  12. - **去AI化写作**:不把润色等同于压缩,优先保留研究对象、数据口径、方法条件、指标含义和结论边界
  13. - **图表生成支持**:Python 负责可复现数据图,Gemini 等生图工具负责流程图、架构图和概念图提示词
  14. - **学科化写作支持**:工科、社科、医学、法学模块分流
  15. - **文献综述支持**:英文检索整合与中文文献整理协作
  16. - **LaTeX模板支持**:用户提供学校/期刊模板,自动生成可编译的LaTeX项目
  17. - **环境自动化**:Miniconda 安装、虚拟环境创建、绘图依赖安装与排错
  18. ## 适用平台
  19. 本 Skill 采用目录化设计,已适配以下平台:
  20. | 平台 | 配置文件 |
  21. |------|----------|
  22. | Claude Code | `.claude-plugin/plugin.json` |
  23. | Cursor | `.cursor-plugin/plugin.json` |
  24. | Codex | `.codex/INSTALL.md` |
  25. | OpenCode | `.opencode/INSTALL.md` |
  26. | Gemini CLI | `GEMINI.md` |
  27. | 其他 | `AGENTS.md` |
  28. ## 你会得到什么产物
  29. 默认情况下,Skill 产物是项目内文件,不是 Word 成品文件。
  30. | 产物类型 | 默认格式 | 说明 |
  31. |---|---|---|
  32. | 写作正文 | `.md` / 纯文本 / `.tex` | 便于版本管理和后续再加工 |
  33. | 章节文件 | `chapters/*.md` | 每章一个独立文件 |
  34. | LaTeX项目 | `chapters/*.tex` + `main.tex` | 可直接编译 |
  35. | 图表脚本 | `.py` | 可复现图表生成逻辑 |
  36. | 提示词资产 | `.md` | 可复用的翻译、润色、去AI化模板 |
  37. ## 去AI化写作边界
  38. 这里的去AI化不是把原文压短。除非用户明确要求缩写,Skill 不会主动删减事实、数据、限定条件和解释句。研究对象、数据范围、样本口径、方法条件、指标含义、实验边界、结论限制和专有名词都应保留,语言调整只服务于表达自然、逻辑清楚和口径稳定。
  39. 正文优先使用连续段落,不把论文内容改成项目符号堆砌,也不依赖加粗或斜体制造重点。写作时会避开"首先、其次、最后、此外、另外、接下来、总之"等机械连接词,也会避开"值得注意的是、需要指出的是、重要的是、必须强调的是"等空壳句式。遇到原文信息完整、语序自然但略显啰嗦的情况,只做轻微整理,不为了显得精炼而压掉必要信息。
  40. ## 重要边界(务必先看)
  41. 1. Skill 默认不会自动生成或直接写入 `.docx`。
  42. 2. Skill 默认不会替你"打开 Word 并排版",需要你手动复制或用工具转换。
  43. 3. Skill 可以生成适合粘贴进 Word 的纯文本段落,但最终样式(标题级别、页眉页脚、目录、参考文献域)需要你在 Word 端处理。
  44. 4. 文献与数据不会编造,引用需可追溯;高风险结论请你二次核验。
  45. ## 安装
  46. ### 方式一:直接下载
  47. 下载仓库,解压后把 `research-writing-skill/` 复制到你的论文写作目录就可以用了。
  48. ### 方式二:Git Clone
  49. ```bash
  50. git clone https://github.com/Norman-bury/research-writing-skill.git
  51. cd research-writing-skill
  52. ```
  53. ### 各平台安装
  54. - **Codex**:参考 `.codex/INSTALL.md`
  55. - **OpenCode**:参考 `.opencode/INSTALL.md`
  56. - **其他平台**:将整个目录放入论文项目根目录即可
  57. ## 图表示例(真实产物)
  58. 数据结果图优先由 Skill 生成 Python 脚本,再在本地运行绘制。下面两张图展示的是这种方式得到的论文结果图示例,适合用于训练曲线、指标对比和实验结果复核。
  59. <p align="center">
  60. <img src="img/python-miou-comparison.png" alt="本地 Python 绘图示例:验证集 mIoU 对比" width="48%">
  61. <img src="img/python-training-loss-comparison.png" alt="本地 Python 绘图示例:训练损失对比" width="48%">
  62. </p>
  63. 流程图、模型结构图和机制图可以先由 `figures-diagram` 生成提示词,再交给 Gemini 等生图工具绘制。下面两张图是按提示词生成的图示示例。
  64. <p align="center">
  65. <img src="img/gemini-federated-calibration-diagram.png" alt="Gemini 生成图示示例:联邦校准流程" width="48%">
  66. <img src="img/gemini-mask2former-decoder-diagram.png" alt="Gemini 生成图示示例:Mask2Former 解码机制" width="48%">
  67. </p>
  68. ## 标准协作流程(推荐)
  69. 1. **头脑风暴**:说"我要写论文",Skill会引导你确认论文类型、题目、研究背景等
  70. 2. **章节规划**:确认章节结构后,Skill在 `chapters/` 创建框架
  71. 3. **逐章写作**:按章节顺序写作,每章一个文件
  72. 4. **图表生成**:需要数据图时,Skill生成Python脚本
  73. 5. **自审检查**:使用peer-review技能进行投稿前自审
  74. 6. **交付**:手动迁移到Word/LaTeX完成最终排版
  75. ## 质量门控
  76. 中型或整篇论文任务先使用 `skills/paper-orchestration/` 生成任务包,并在 `plan/progress.md` 记录 capability-use audit。引言和相关工作必须先形成 `refs/evidence-map.md` 或 `plan/evidence-map.md`。实验与结果章节必须先形成 `plan/experiment-protocol.md`、`tables/table-schema.md` 和 `figures/data-manifest.md`。
  77. 常用检查命令:
  78. ```powershell
  79. powershell -ExecutionPolicy Bypass -File scripts/check_skill_integrity.ps1
  80. powershell -ExecutionPolicy Bypass -File scripts/research_quality_gate.ps1 -ProjectPath <paper-project>
  81. ```
  82. ## 技能地图
  83. | 场景 | 技能 |
  84. |---|---|
  85. | 入口与路由 | `skills/using-research-writing/` |
  86. | 中型/整篇任务编排 | `skills/paper-orchestration/` |
  87. | 头脑风暴 | `skills/brainstorming-research/` |
  88. | 文献驱动引言/相关工作 | `skills/evidence-driven-writing/` |
  89. | 章节写作 | `skills/writing-chapters/` |
  90. | 实验与结果规划 | `skills/experiment-results-planning/` |
  91. | LaTeX输出 | `skills/latex-output/` |
  92. | 通用写作规范 | `skills/writing-core/` |
  93. | 文科/社科写作 | `skills/writing-humanities/` |
  94. | 医学/生物写作 | `skills/writing-medical/` |
  95. | 法学写作 | `skills/writing-law/` |
  96. | 文献综述 | `skills/literature-review/` |
  97. | 翻译/润色/去AI化 | `skills/prompts-collection/` |
  98. | 投稿前自审 | `skills/peer-review/` |
  99. | 统计分析 | `skills/statistical-analysis/` |
  100. | Python 图表 | `skills/figures-python/` |
  101. | 流程图/架构图 | `skills/figures-diagram/` |
  102. | 环境安装与排错 | `skills/environment-setup/` |
  103. ## 交流讨论
  104. 如果你在使用过程中想交流论文结构、文献整理、图表提示词、去AI化写作或模板适配,欢迎加入科研写作讨论群,大家一起讨论和交流。
  105. QQ群:827924233
  106. <p align="center">
  107. <img src="img/qq-research-writing-group.jpg" alt="科研写作讨论群 QQ 群" width="260">
  108. </p>
  109. ## LaTeX模板使用
  110. 如果你有学校或期刊提供的LaTeX模板:
  111. 1. 将模板文件(`.cls`, `.sty`, `.tex`等)放入 `latex-templates/` 目录
  112. 2. 告诉AI"使用我的LaTeX模板"
  113. 3. AI会解析模板结构并生成对应的章节 `.tex` 文件
  114. 详细说明见 `latex-templates/README.md`
  115. ## 如何把 Markdown 交付到 Word
  116. ### 方案 A:手动复制(默认推荐)
  117. 1. 让 Skill 输出"纯文本段落版"正文(避免 Markdown 标记)
  118. 2. 在编辑器中复制正文并粘贴到 Word
  119. 3. 在 Word 中应用学校模板样式(标题、正文、图注、表注)
  120. 4. 手动检查公式、参考文献、图表编号与交叉引用
  121. ### 方案 B:Pandoc 转换(可选)
  122. 如果你本地已安装 Pandoc,可以先确认命令可用:
  123. ```bash
  124. pandoc --version
  125. ```
  126. 最简单的转换方式是把 Markdown 转成 Word:
  127. ```bash
  128. pandoc draft.md -o draft.docx
  129. ```
  130. 如果你已经有学校或期刊的 Word 样式模板,可以使用参考模板生成 `.docx`:
  131. ```bash
  132. pandoc draft.md --reference-doc=template.docx -o draft.docx
  133. ```
  134. Pandoc 主要解决格式转换和样式继承,不替代最终人工校对。转换后仍需检查标题层级、图表编号、公式、参考文献、页眉页脚和目录域。
  135. ## FAQ
  136. ### 为什么默认产物不是 Word?
  137. 因为科研协作更需要可追踪、可复用、可版本化的文本资产,Markdown 更适合过程迭代。Word 适合最终交付,所以放在最后一步处理更稳妥。
  138. ### 可以直接让我"生成最终可提交版本"吗?
  139. 可以做接近终稿的内容,但学校模板、目录域、页码、参考文献域、格式细节仍建议在 Word 端完成。
  140. ### 这个 Skill 会不会瞎编文献?
  141. 不会。规则层面明确禁止编造文献与数据;引用要求可追溯。
  142. ## 仓库结构
  143. ```text
  144. research-writing-skill/
  145. ├── SKILL.md # 主入口(兼容旧平台)
  146. ├── AGENTS.md # 通用代理配置
  147. ├── GEMINI.md # Gemini CLI 配置
  148. ├── CHANGELOG.md # 版本记录
  149. ├── .claude-plugin/ # Claude Code 配置
  150. ├── .cursor-plugin/ # Cursor 配置
  151. ├── .codex/ # Codex 配置
  152. ├── .opencode/ # OpenCode 配置
  153. ├── hooks/ # 会话启动脚本
  154. │ ├── session-start
  155. │ ├── hooks.json
  156. │ └── hooks-cursor.json
  157. ├── img/ # README 示例图片
  158. ├── skills/ # 技能模块目录
  159. │ ├── using-research-writing/
  160. │ ├── paper-orchestration/
  161. │ ├── brainstorming-research/
  162. │ ├── evidence-driven-writing/
  163. │ ├── writing-chapters/
  164. │ ├── experiment-results-planning/
  165. │ ├── latex-output/
  166. │ ├── literature-review/
  167. │ ├── figures-python/
  168. │ ├── figures-diagram/
  169. │ ├── peer-review/
  170. │ ├── statistical-analysis/
  171. │ ├── verification/
  172. │ ├── environment-setup/
  173. │ ├── prompts-collection/
  174. │ ├── writing-core/
  175. │ ├── writing-humanities/
  176. │ ├── writing-medical/
  177. │ └── writing-law/
  178. ├── latex-templates/ # 用户LaTeX模板目录
  179. ├── modules/ # 旧模块(保留兼容)
  180. ├── templates/ # 代码模板
  181. ├── plan-template/ # 计划模板
  182. └── scripts/ # 工具脚本
  183. ```
  184. ## 版本
  185. - 版本:3.1.0
  186. - 更新日期: 2026-05-10

Ratings and comments

Sign in to rate this skill.

Sign in

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