mcpField
A
academic-paper-composer

academic-paper-composer

github.com/aaass554文档处理541106 次安装17 周前更新
代码仓库

关于 academic-paper-composer

academic-paper-composer 是面向基于 Codex 的软件工程本科论文撰写与定稿技能。它依据有证据支持的计划和项目文件改写、组装论文,并指导 DOCX 排版与检查。

主要功能

  1. 01依据项目证据改写论文各节
  2. 02按规划说明组装论文
  3. 03保留有依据的图表
  4. 04按需采集真实运行截图
  5. 05排版并检查最终 DOCX

适用场景

  1. 01将有证据支持的计划整理为论文
  2. 02修改论文且不覆盖原始稿件
  3. 03继续编辑指定的工作稿
  4. 04准备排版后的 DOCX 供审阅

安装

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

$npx skills add https://github.com/aaass554/codex-academic-paper-skills --skill academic-paper-composer

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

包含的文件

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

agents/
openai.yaml
references/
chinese-call-prompt-templates.md
detection-report-rewrite-playbook.md
docx-draft-salvage-and-runtime-screenshot-playbook.md
finalization-task-rules.md
project-grounding-rules.md
section_guides.md
thesis-revision-operation-checklist.md
writing_standards.md
zjkj-undergrad-thesis-format.md
scripts/
chapter_quality_check.py
final_evaluation.py

详细介绍

学术论文撰写器

概述

这是面向 Codex 本科软件工程毕业论文的撰写与定稿技能。它接收策略制定者提供的、有证据支撑的计划,并以真实项目为依据,将其转化为整洁、可提交的论文稿件。

配套流程:

  1. academic-paper-strategist - 确定结构、证据映射以及保留/重写/删除范围
  2. academic-paper-composer - 重写章节并整合最终论文文本
  3. drawio - 按需重建工程风格的图表
  4. playwright - 在论文需要运行系统证据时,截取真实运行时的屏幕截图
  5. doc - 应用 Word 格式并直观检查最终 DOCX

此技能负责论文内容和最终组装逻辑。只有在复制的 DOCX 或用户指定的工作 DOCX 已完成格式处理并通过检查后,才能宣称任务完成。

必需输入

  • 策略制定者提供的大纲或重写说明
  • 现有论文草稿
  • 学校格式示例
  • 真实项目证据文件
  • 检测报告(如有)(相似度/抄袭/AIGC PDF、屏幕截图或提取的文本)
  • 复制后的最终 DOCX 的确切目标路径,或用户希望继续编辑的工作草稿的确切路径
  • 重做报告的确切目标路径(如有)

不可妥协的规则

  • 除非用户明确表示当前手动编辑的草稿现已成为工作文件,否则只能操作复制后的草稿。
  • 绝不要覆盖用户未经修改的原始源草稿。
  • 加载并遵守:
    • references/zjkj-undergrad-thesis-format.md
    • references/project-grounding-rules.md
    • references/finalization-task-rules.md
  • 用户要求降低相似度或 AIGC 风险并提供报告时,加载 references/detection-report-rewrite-playbook.md。
  • 任务涉及从手动编辑的草稿继续处理、部分替换章节、恢复原有表格/图表或添加真实运行系统截图时,加载 references/docx-draft-salvage-and-runtime-screenshot-playbook.md。
  • 任务涉及编辑正在使用的工作草稿时,加载 references/thesis-revision-operation-checklist.md,因为编辑顺序很重要。
  • 对缺乏依据的文本进行重写,而不是润色错误内容。
  • 降低相似度或 AIGC 风险时,在保留项目真实性的前提下重写措辞;绝不要通过编造事实或删除必要内容来钻评分空子。
  • 所有可见论文文本均保持黑色。
  • 移除超链接样式、流程说明、指导性文本和模板提示。
  • 仅使用有项目依据的图表和屏幕截图。
  • 优先恢复有依据的原始图表/表格,而不是重新绘制。
  • 测试章节应保持审慎,并以证据为依据。

工作流

步骤 1:安全复制

如果用户提供了源草稿和目标路径:

  • 首先复制源草稿
  • 确认目标副本存在
  • 保持源草稿原样不动

如果用户表示已经手动编辑的草稿就是工作文件:

  • 将该文件视为工作稿件
  • 进行任何结构性编辑前,先创建带时间戳的备份
  • 后续所有编辑都只针对该工作文件

无论何种情况,都不要开始直接编辑错误的文件。

步骤 2:提取格式基准

阅读 references/zjkj-undergrad-thesis-format.md 和提供的学校示例。

提取并落实以下格式要求:

  • 封面结构
  • 原创性声明
  • 版权授权书
  • 中文摘要页
  • 英文摘要页
  • 自动目录
  • 标题层级
  • 正文排版
  • 图表题注样式
  • 参考文献
  • 致谢
  • 附录
步骤 3:草稿审核

检查当前草稿,并标记:

  • 保留的内容
  • 需要重写的内容
  • 需要删除的内容
  • 需要替换的图
  • 需要从原始草稿中保留的图/表
  • 需要清除的格式污染

具体删除以下内容:

  • 彩色标题
  • 超链接样式的标题
  • 模板提示词
  • 修订说明
  • 缺乏依据的数据声明
  • 装饰性图片
步骤 3A:检测报告分类

如果用户提供了相似度或 AIGC 检测报告,请阅读 references/detection-report-rewrite-playbook.md。

在此阶段:

  • 提取最新得分和高风险页码
  • 将每个高风险点对应到复制的草稿
  • 判断每个高风险点是否需要大幅重构,还是只需轻微润色
步骤 3B:续写/抢救现有草稿模式

当用户已手动编辑部分草稿,或要求保留特定旧内容时,使用此模式。

在此模式下:

  • 首先确认实际工作 DOCX
  • 其次确认受保护的备份/原始 DOCX
  • 根据正文标题样式检测替换边界,而不是依据目录文本
  • 绝不能将目录段落用作章节替换的锚点
  • 如果用户要求只替换某个章节(如 2.3)之前或之后的内容,只编辑对应的正文范围
  • 保留所请求范围之外未改动的手动编辑内容
  • 如果用户要求保留原始 E-R 图、逐表数据库说明或其他有依据的旧资产,应从备份中恢复,而不是重新生成
步骤 4:重写论文正文

仅依据项目有据可查的信息,逐章重写。

各章的常见职责:

  • 引言:背景、意义、范围、章节安排
  • 需求分析:角色、工作流、功能与非功能需求
  • 总体设计:架构、模块、数据设计、安全/控制策略
  • 详细实现:代码和配置中实际体现的机制
  • 测试:实际功能验证和审慎的总结
  • 结论:总结实际完成的工作和未来改进方向

对每个章节:

  • 优先使用准确的工程术语
  • 避免夸大创新性的表述
  • 避免缺乏依据的指标
  • 最终汇编前删除所有指示性文本

当任务包含降低相似度或 AIGC 风险时,应用以下重写规则:

  • 遵循 references/detection-report-rewrite-playbook.md 中的重写原则和转换方法
  • 除非缺乏依据,否则保持技术事实、章节结构、图表编号和引用不变
  • 优先保留原意;降低得分的重要性次于事实准确性
步骤 4A:降低 AIGC/相似度的重写循环

当用户提出“降到 10% 以下”之类的目标时:

  1. 优先处理最值得改写的高风险点
  2. 重建已复制的稿件
  3. 如果用户提供更新后的报告,重复分类 → 重写 → 重建的循环
  4. 后续轮次只关注仍存在高风险点的页面,而不要再次重写整篇论文

不要事先承诺得分。撰写者的职责是,在保留事实依据的前提下,尽可能安全地降低检测得分。

步骤 5:插图、旧资产和数据库表

如果论文中已有有依据的原始图片或表格块,且用户希望保留:

  • 从备份/原始草稿中保留或恢复
  • 保持图注样式与学校样例一致
  • 仅在必要时重新编号后续图表

常见的抢救情形包括:

  • 原始 E-R 图块
  • 逐表数据库字段说明块
  • 已从有效旧稿中提取的截图
  • 仍与项目相符的原始工程图

只有在图片缺失、缺乏依据或视觉效果不合适时,才通过 drawio 重新绘制。

步骤 5A:捕获真实运行时截图

如果论文需要系统运行截图:

  • 优先截取真实应用,而非伪造静态模型图
  • 使用 playwright 或同等的浏览器工作流
  • 将截图资源保存到 output/playwright/ 或类似的明确输出目录下
  • 将截图插入其所支持的小节附近,并配上一句简短的引导语和论文风格的图注

当主数据库不可用或不宜操作时:

  • 创建仅用于截图的临时配置
  • 优先采用隔离的 H2 + Flyway 配置,而不是修改主 application.yml
  • 仅植入或创建截图所需的最少演示数据
  • 截图完成后关闭临时运行环境

适合截图的页面包括:

  • 认证章节中的登录页面
  • 预约流程章节中的居民预约页面
  • 健康码章节中的居民仪表盘/健康码页面
  • 报告章节中的居民健康报告页面
  • 后端操作章节中的管理员预约/审核页面
  • 运行摘要/运行状态章节中的管理员仪表盘
步骤 6:通过 Doc 完成 DOCX 格式排版

使用 doc 完成工作 .docx 的最终排版:

  • 应用学校要求的标题样式
  • 确保所有文字均为黑色
  • 确保中文标题不加粗,除非学校样例明确要求加粗
  • 确保段落间距和行距符合学校样例
  • 确保目录为自动生成
  • 确保插图和图注位置正确
  • 确保参考文献使用悬挂缩进并采用正确的字体格式
  • 如果样例要求,确保字段说明表使用较小字号
  • 尽可能渲染页面并进行目视检查
步骤 7:另行撰写返工报告

返工报告应放在最终论文之外,可以包括:

  • 删除或弱化的论断
  • 未保留的无依据数据
  • 需要人工复核的项目
  • 插图重制说明
  • 格式修正
  • 对于相似度/AIGC 任务:哪些页面是重点关注区域、采用了什么改写策略,以及下一份报告中仍需复查的内容
  • 对于抢救任务:哪些章节从备份中恢复、哪些截图是新截取的,以及哪些人工编辑是有意保留的

不要让上述任何内容混入最终 DOCX 正文。

步骤 8:最终自检

以下条件全部满足后再交付:

  • 原始草稿未被改动,或已由用户指定的工作草稿明确取代
  • 结构性编辑前已备份工作 DOCX
  • 未将目录段落误认为正文锚点
  • 所有标题和正文文字均为黑色
  • 不再有蓝色标题
  • 所有插图和截图均符合论文风格
  • 用户要求保留或恢复的历史插图/表格均已保留或恢复
  • 不再包含流程/指令文本
  • 遵循学校格式样例
  • 目录为自动生成
  • 文稿已达到可提交状态

保守求真的写作规则

  • 在适当情况下,将缺乏依据的“性能评估”改为“功能验证”或“基于场景的测试”。
  • 如果没有正式的压力测试,不要编写性能基准测试表。
  • 如果没有真实部署,避免声称已进行集群部署、生产运行或达到某种并发规模。
  • 如果某个模块已配置但未充分演示,应谨慎描述为已实现的支持功能,而非已证实的大规模能力。
  • 对于 AIGC 风险较高的段落,优先“重写整句逻辑”,而不是“替换几个词”。
  • 如果一段话读起来仍像经过润色的模板,应先降低修饰程度,而非牺牲真实性:调整句子长短,删去套话式过渡,并让措辞扎根于实际仓库。

按需加载的参考资料

  • references/zjkj-undergrad-thesis-format.md
  • references/project-grounding-rules.md
  • references/finalization-task-rules.md
  • references/detection-report-rewrite-playbook.md
  • references/docx-draft-salvage-and-runtime-screenshot-playbook.md
  • references/thesis-revision-operation-checklist.md
  • references/chinese-call-prompt-templates.md
  • references/section_guides.md
  • references/writing_standards.md

示例提示词

  • 继续在我手改的初稿上改,只替换正文 1 引言 到 2.3 前面的内容,目录不要当锚点。
  • 保留原来的数据库 E-R 图和每张表的字段说明表,再把定稿对应内容补回 working draft。
  • 根据这份最新 AIGC 报告继续降到 10% 以下,只改剩余热点页,不要整篇重写。
  • 按学校模板把当前 working docx 整理成最终版:标题不要加粗,全文黑色,表格字段说明用五号。
  • 给论文补系统运行截图,截图要来自真实项目页面,并且单独输出一份改稿说明。

输出要求

请生成:

  • 一份清理完成的论文稿
  • 在复制的初稿或用户指定的工作稿上执行最终 DOCX 工作流
  • 一份单独的修改报告

绝不要将给作者的评论、修改说明或审阅批注当作论文内容。

评论

支持 Markdown