关于 academic-paper-composer
academic-paper-composer 是面向基于 Codex 的软件工程本科论文撰写与定稿技能。它依据有证据支持的计划和项目文件改写、组装论文,并指导 DOCX 排版与检查。
主要功能
- 01依据项目证据改写论文各节
- 02按规划说明组装论文
- 03保留有依据的图表
- 04按需采集真实运行截图
- 05排版并检查最终 DOCX
适用场景
- 01将有证据支持的计划整理为论文
- 02修改论文且不覆盖原始稿件
- 03继续编辑指定的工作稿
- 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.yamlreferences/chinese-call-prompt-templates.mddetection-report-rewrite-playbook.mddocx-draft-salvage-and-runtime-screenshot-playbook.mdfinalization-task-rules.mdproject-grounding-rules.mdsection_guides.mdthesis-revision-operation-checklist.mdwriting_standards.mdzjkj-undergrad-thesis-format.mdscripts/chapter_quality_check.pyfinal_evaluation.py详细介绍
学术论文撰写器
概述
这是面向 Codex 本科软件工程毕业论文的撰写与定稿技能。它接收策略制定者提供的、有证据支撑的计划,并以真实项目为依据,将其转化为整洁、可提交的论文稿件。
配套流程:
academic-paper-strategist- 确定结构、证据映射以及保留/重写/删除范围academic-paper-composer- 重写章节并整合最终论文文本drawio- 按需重建工程风格的图表playwright- 在论文需要运行系统证据时,截取真实运行时的屏幕截图doc- 应用 Word 格式并直观检查最终 DOCX
此技能负责论文内容和最终组装逻辑。只有在复制的 DOCX 或用户指定的工作 DOCX 已完成格式处理并通过检查后,才能宣称任务完成。
必需输入
- 策略制定者提供的大纲或重写说明
- 现有论文草稿
- 学校格式示例
- 真实项目证据文件
- 检测报告(如有)(相似度/抄袭/AIGC PDF、屏幕截图或提取的文本)
- 复制后的最终 DOCX 的确切目标路径,或用户希望继续编辑的工作草稿的确切路径
- 重做报告的确切目标路径(如有)
不可妥协的规则
- 除非用户明确表示当前手动编辑的草稿现已成为工作文件,否则只能操作复制后的草稿。
- 绝不要覆盖用户未经修改的原始源草稿。
- 加载并遵守:
references/zjkj-undergrad-thesis-format.mdreferences/project-grounding-rules.mdreferences/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% 以下”之类的目标时:
- 优先处理最值得改写的高风险点
- 重建已复制的稿件
- 如果用户提供更新后的报告,重复分类 → 重写 → 重建的循环
- 后续轮次只关注仍存在高风险点的页面,而不要再次重写整篇论文
不要事先承诺得分。撰写者的职责是,在保留事实依据的前提下,尽可能安全地降低检测得分。
步骤 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.mdreferences/project-grounding-rules.mdreferences/finalization-task-rules.mdreferences/detection-report-rewrite-playbook.mdreferences/docx-draft-salvage-and-runtime-screenshot-playbook.mdreferences/thesis-revision-operation-checklist.mdreferences/chinese-call-prompt-templates.mdreferences/section_guides.mdreferences/writing_standards.md
示例提示词
继续在我手改的初稿上改,只替换正文 1 引言 到 2.3 前面的内容,目录不要当锚点。保留原来的数据库 E-R 图和每张表的字段说明表,再把定稿对应内容补回 working draft。根据这份最新 AIGC 报告继续降到 10% 以下,只改剩余热点页,不要整篇重写。按学校模板把当前 working docx 整理成最终版:标题不要加粗,全文黑色,表格字段说明用五号。给论文补系统运行截图,截图要来自真实项目页面,并且单独输出一份改稿说明。
输出要求
请生成:
- 一份清理完成的论文稿
- 在复制的初稿或用户指定的工作稿上执行最终 DOCX 工作流
- 一份单独的修改报告
绝不要将给作者的评论、修改说明或审阅批注当作论文内容。