关于 academic-paper-strategist
academic-paper-strategist 是面向基于 Codex 的软件工程论文规划技能,以现有代码仓库为依据。它将论点对应到项目证据,并为后续撰写整理提纲、修订范围及有依据的图表规划。
主要功能
- 01将论文论点映射到仓库证据
- 02审查草稿中的无依据内容
- 03规划章节提纲和改写范围
- 04规划有证据支持的图表与截图
- 05为 composer 准备交接材料
适用场景
- 01根据现有代码库规划论文
- 02依据项目证据审阅论文草稿
- 03界定手工修改稿的修订范围
- 04规划有依据的图表和运行截图
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ aaass554/ codex-academic-paper-skills --skill academic-paper-strategist安装后在 Claude Code 中输入/academic-paper-strategist确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/chinese-call-prompt-templates.mddetection-report-rewrite-playbook.mddraft-salvage-handoff-playbook.mdfinalization-task-rules.mdproject-grounding-rules.mdquality_standards.mdsearch_strategy.mdzjkj-undergrad-thesis-format.mdscripts/evaluate_samples.pygap_analysis.py详细介绍
学术论文策略规划
概述
这是面向基于 Codex 的软件工程论文的规划技能。从真实代码仓库撰写或定稿论文前,请先使用此技能。它旨在降低幻觉风险,将项目证据映射到各章节,并且只定义可由实际代码库和学校提供的格式样例加以佐证的论点、图表和测试。
配套流程:
academic-paper-strategist- 规划、证据映射、改写范围academic-paper-composer- 内容改写与最终稿组装drawio- 按需重新绘制工程风格的论文插图playwright- 论文需要运行系统证据时,截取真实运行界面doc- 生成并进行最终 DOCX 的视觉检查
当用户要求基于现有项目和草稿,生成可提交的本科论文时,不要跳过策略规划步骤。
核心规则
- 先阅读项目证据,再拟定大纲。优先查阅代码仓库文件、SQL、配置、文档、控制器、服务、实体和现有草稿。
- 将现有草稿视为不可信输入。只保留有项目证据支持的内容。
- 如果用户已手动编辑了部分草稿,将该工作草稿视为受保护的成果,并据此规划,而不要盲目替换整篇稿件。
- 如果用户提供了抄袭、相似度或 AIGC 检测报告,将其视为改写优先级信号,而不是项目事实的依据。遇到这种情况时,加载
references/detection-report-rewrite-playbook.md。 - 如果用户提供了学校格式样例,先加载
references/zjkj-undergrad-thesis-format.md,并将其视为结构和格式要求的最高依据。 - 如果任务是根据现有草稿定稿,还需加载:
references/project-grounding-rules.mdreferences/finalization-task-rules.md
- 当用户希望继续编辑过一部分的草稿、保留原有图表或添加运行系统截图时,加载
references/draft-salvage-handoff-playbook.md。 - 绝不虚构功能、API、数据表、性能数据、部署规模、用户规模、并发基准或测试结果。
- 对“创新”采取审慎表述,将其重新定位为工程亮点、实现方案、集成价值或可维护性优势。
- 只规划有代码或项目文档支持的图表。省略缺乏依据的图示。
- 确保论文兼容自动目录和学校要求的前置部分。
收集输入
- 代码仓库根目录
- 现有论文草稿(
.docx、.md,或两者都有) - 学校模板或格式样例(
.doc、.docx或.pdf) - 核心证据文件,例如:
- 构建文件(
pom.xml、package.json等) - 架构文档
- 业务逻辑文档
- SQL 架构 / 迁移文件
- 实体 / DTO / 控制器 / 服务
- 构建文件(
- 可用时提供的检测报告(
.pdf、.docx、截图、提取的文本) - 要求的交付文件路径
工作流程
步骤 1:收集约束
记录:
- 目标学校和论文类型
- 最终交付格式
- 任务仅为规划还是需要完整定稿
- 是否必须基于手动编辑过的工作草稿继续
- 用户是否希望保留原有图表
- 是否需要真实运行截图
- 要求的输出路径
如果用户提供了明确的源文件和目标路径,将其视为必须遵守的要求。
步骤 2:读取学校格式要求
如果用户提供了学校样例,读取 references/zjkj-undergrad-thesis-format.md 并提取:
- 前置部分的规定顺序
- 标题层级
- 正文字体排版与间距
- 图表题注规则
- 参考文献格式
- 附录与致谢规则
- 样例中体现的任何页码限制
如果样例中包含说明性文本框或占位提示,将其标记为“从最终稿中删除”。
第 3 步:审核现有草稿
将每个章节归类为:
- 保留,仅做少量修改
- 保留,但弱化论断
- 根据项目证据重写
- 完全删除
- 作为旧版资产保留,日后丢失时恢复
始终标记以下内容以便删除:
- 过程说明
- 模板提示词
- 指导性文本框
- 缺乏依据的新颖性论断
- 缺乏依据的指标或部署论断
- 彩色标题或超链接样式的文本
- 不符合工程论文风格的图表
同时标记:
- 用户希望保留的原始 E-R 图
- 原始数据库中每张表的字段说明块
- 不得覆盖的用户手动编辑内容
- 仅需替换部分范围的章节
第 3A 步:处理检测报告(如有)
当用户要求降低相似度或 AIGC 风险并提供了报告时,请阅读 references/detection-report-rewrite-playbook.md。
在此阶段,策划者应:
- 提取总体评分和热点页码
- 将热点对应到论文各章节
- 对成因和重写力度进行分类
- 告知撰写者哪些部分需要进行大幅结构性重写,哪些只需轻度清理
第 4 步:建立证据映射
对每个章节,将所有主要论断对应到仓库证据:
- 背景 / 系统定位 -> 文档和项目简介
- 架构 -> 软件包结构、配置、控制器、服务
- 数据库设计 -> SQL 模式和实体
- 业务工作流 -> 控制器、服务、文档
- 安全 / 一致性机制 -> 配置、服务逻辑、事务代码、锁定、签名、验证
- 测试章节 -> 仅使用真实截图、测试类、手动验证记录或可观察到的系统行为
如果某项论断无法对应到证据来源,就不得出现在最终论文中。
第 5 步:制定论文计划
输出一份交接材料,供撰写者使用,其中包含:
- 清理后的章节大纲
- 各章节的证据来源
- 允许出现的论断
- 禁止出现的论断
- 需要重新绘制的图
- 需要保留或恢复的旧版图表
- 用户仅要求部分重写时,需要替换的确切章节范围
- 需要人工核实的风险项
- 需要截图时的运行时截图采集计划
- 存在检测报告时:页码到章节的重写矩阵和重写优先级列表
如果交接材料将用于实时修订 DOCX,必须写得足够明确,让撰写者无需重新决定替换范围、保留列表或截图目标即可执行。
大纲通常应包括:
- 封面 / 声明 / 摘要 / 目录
- 第 1 章 绪论
- 第 2 章 需求分析
- 第 3 章 总体设计
- 第 4 章 详细实现
- 第 5 章 测试
- 第 6 章 结论
- 参考文献
- 致谢
- 必要时添加附录
第 6 步:制定图表和截图计划
当用户要求撰写软件工程本科毕业论文时,只允许使用以下图表类型:
- 系统架构图
- 功能模块图
- 业务流程图
- 时序图
- E-R 图
- 用例图
- 与论文实际章节对应的真实运行系统截图
对每个计划中的图表或截图,明确:
- 所在章节
- 代码 / 文档 / 运行时依据
- 必须显示的标签
- 不得出现的标签或组件
- 旧图能否保留,还是必须重绘
- 截图前是否需要准备演示数据
所有重绘的图表都必须采用工程论文的视觉风格:
- 白色背景
- 黑色或灰色线条
- 不使用装饰性图标
- 不采用信息图风格
- 不依赖颜色表达含义
现有草稿返工模式
当用户要求基于现有草稿完成论文定稿时:
- 除非草稿无法使用,否则不要从空白文档开始
- 确定需要保留和重写的内容
- 为
academic-paper-composer编写按章节划分的重写说明 - 明确指出必须删除而非弱化的无依据内容
- 要求撰稿器使用草稿副本或用户指定的工作草稿,绝不可使用错误文件
当用户明确要求继续编辑手工修改过的草稿时:
- 分别记录工作草稿路径和受保护的备份/原稿路径
- 仅根据正文标题样式规划替换锚点
- 在交接说明中禁止基于目录匹配锚点
- 指明重写时必须保留哪些旧图表
当用户明确要求降低查重率或 AIGC 检测率时:
- 找出导致检测分数偏高的最少章节
- 优先处理中文叙述段落,而非收益较低的格式性章节
- 优先进行少量高影响力的结构性重写,而非大范围浅层修改
- 使用
references/detection-report-rewrite-playbook.md中定义的重写模式
按需加载的参考资料
references/zjkj-undergrad-thesis-format.md- 学校格式规范references/project-grounding-rules.md- 防止编造和证据规则references/finalization-task-rules.md- 最终 DOCX 交付的强制工作流references/detection-report-rewrite-playbook.md- 如何将查重/AIGC 报告分类整理为重写说明references/draft-salvage-handoff-playbook.md- 如何规划局部替换、旧资产保留和运行截图references/chinese-call-prompt-templates.md- 用于规划和交接任务的可复制中文提示词
示例提示词
根据当前仓库和学校模板,先给我做一个本科论文定稿规划,只保留代码里能证实的内容。我已经手改初稿到正文 2.3 前了,帮我做 keep/rewrite/delete 矩阵,要求保留原数据库 E-R 图和每张表的字段说明。这是查重报告和 AIGC 报告,先别直接改正文,先把热点页映射到章节并给出重写优先级。继续在我现在的 working draft 上做规划,只替换 2.4 之后的正文内容,前面手改部分不要动。帮我给论文补一个运行截图规划,说明每张截图对应哪个角色、哪个页面、哪个章节。
输出要求
请提供:
- 最多包含 3 级标题的论文提纲
- 按章节整理的证据映射
- 当前草稿的保留/重写/删除矩阵
- 图表/截图重建计划
- 要删除的无依据论点清单
- 提交给
academic-paper-composer的交接材料 - 如提供了报告:包含热点页、对应章节和建议重写强度的检测报告分诊摘要
此阶段不要声称论文已达到提交要求。是否可以提交,应由撰稿器、drawio、playwright 和 doc 流程共同决定。