mcpField
A
academic-paper-strategist

academic-paper-strategist

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

关于 academic-paper-strategist

academic-paper-strategist 是面向基于 Codex 的软件工程论文规划技能,以现有代码仓库为依据。它将论点对应到项目证据,并为后续撰写整理提纲、修订范围及有依据的图表规划。

主要功能

  1. 01将论文论点映射到仓库证据
  2. 02审查草稿中的无依据内容
  3. 03规划章节提纲和改写范围
  4. 04规划有证据支持的图表与截图
  5. 05为 composer 准备交接材料

适用场景

  1. 01根据现有代码库规划论文
  2. 02依据项目证据审阅论文草稿
  3. 03界定手工修改稿的修订范围
  4. 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.yaml
references/
chinese-call-prompt-templates.md
detection-report-rewrite-playbook.md
draft-salvage-handoff-playbook.md
finalization-task-rules.md
project-grounding-rules.md
quality_standards.md
search_strategy.md
zjkj-undergrad-thesis-format.md
scripts/
evaluate_samples.py
gap_analysis.py

详细介绍

学术论文策略规划

概述

这是面向基于 Codex 的软件工程论文的规划技能。从真实代码仓库撰写或定稿论文前,请先使用此技能。它旨在降低幻觉风险,将项目证据映射到各章节,并且只定义可由实际代码库和学校提供的格式样例加以佐证的论点、图表和测试。

配套流程:

  1. academic-paper-strategist - 规划、证据映射、改写范围
  2. academic-paper-composer - 内容改写与最终稿组装
  3. drawio - 按需重新绘制工程风格的论文插图
  4. playwright - 论文需要运行系统证据时,截取真实运行界面
  5. doc - 生成并进行最终 DOCX 的视觉检查

当用户要求基于现有项目和草稿,生成可提交的本科论文时,不要跳过策略规划步骤。

核心规则

  • 先阅读项目证据,再拟定大纲。优先查阅代码仓库文件、SQL、配置、文档、控制器、服务、实体和现有草稿。
  • 将现有草稿视为不可信输入。只保留有项目证据支持的内容。
  • 如果用户已手动编辑了部分草稿,将该工作草稿视为受保护的成果,并据此规划,而不要盲目替换整篇稿件。
  • 如果用户提供了抄袭、相似度或 AIGC 检测报告,将其视为改写优先级信号,而不是项目事实的依据。遇到这种情况时,加载 references/detection-report-rewrite-playbook.md。
  • 如果用户提供了学校格式样例,先加载 references/zjkj-undergrad-thesis-format.md,并将其视为结构和格式要求的最高依据。
  • 如果任务是根据现有草稿定稿,还需加载:
    • references/project-grounding-rules.md
    • references/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 流程共同决定。

评论

支持 Markdown