SuperAPI AI 工具集

academic-paper-strategist

写作与研究

查看项目

更新于 10-15 11:10

技能介绍

用途

Academic Paper Strategist 是面向 Codex 的软件工程论文规划技能,适用于在正式撰写或定稿本科论文之前,从真实代码仓库出发进行规划。它的核心目标是降低幻觉风险、把项目证据映射到论文章节,并只定义能够由实际代码库和用户提供的学校格式样例所支撑的论点、图、表和测试。

该技能属于配套流程中的规划环节:academic-paper-strategist 负责规划、证据映射与重写范围;academic-paper-composer 负责内容重写与最终稿件组装;drawio 用于按需重绘工程风格论文图;playwright 用于在论文需要运行系统证据时截取真实运行截图;doc 用于生成并目视检查最终 DOCX。当用户要求基于现有项目和初稿产出可提交的本科论文时,不应跳过 strategist 步骤。

主要能力

  • 在列提纲前先读取项目证据,优先使用仓库文件、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 schema/迁移文件、实体/DTO/控制器/服务;检测报告(如有,.pdf、.docx、截图、提取文本);所需交付路径。

工作流程包括:

  1. 摄取约束:记录目标学校与论文类型、最终交付格式、任务是仅规划还是完整定稿、是否必须从手工编辑的工作稿继续、是否希望保留原始图表、是否需要真实运行截图、所需输出路径。若用户给出明确的源路径和目标路径,将其视为约束。
  2. 加载学校格式权威:当存在学校样例时,读取 references/zjkj-undergrad-thesis-format.md,提取前置部分顺序、标题层级、正文排版与间距、图表标题规则、参考文献格式、附录与致谢规则、样例中可见的页码约束。若样例包含说明性文本框或占位提示,标记为“从最终稿件中移除”。
  3. 审计现有初稿:将每个章节分类为“小幅编辑保留”“保留但降低论断”“依据项目证据重写”“完全删除”“作为遗留资产保留并在丢失时恢复”。始终标记移除:过程笔记、模板提示、说明性文本框、无支撑的新颖性论断、无支撑的指标或部署论断、彩色标题或超链接样式文本、不符合工程论文风格的图。同时标记:用户希望保留的原始 E-R 图、原始数据库逐表字段说明块、不可覆盖的用户手工编辑、只应替换部分范围的章节。 3A. 当存在检测报告时进行分诊:读取 references/detection-report-rewrite-playbook.md,提取头部分数与热点页,将热点映射回论文章节,分类原因与重写强度,告知 composer 哪些地方需要重度结构重写、哪些只需轻度清理。
  4. 构建证据映射:为每一章将每个主要论断映射到仓库证据。背景/系统定位对应文档与项目摘要;架构对应包结构、配置、控制器、服务;数据库设计对应 SQL schema 与实体;业务流程对应控制器、服务、文档;安全/一致性机制对应配置、服务逻辑、事务代码、锁、签名、校验;测试章节只对应真实截图、测试类、人工验证记录或可观察的系统行为。若某论断无法映射到证据来源,则不能出现在最终论文中。
  5. 产出论文规划:输出给 composer 的交接包,包含清理后的章节提纲、逐章证据来源、允许的论断、禁止的论断、需重绘的图、需保留或恢复的遗留图表、若用户只想要部分重写时的精确替换章节范围、需人工验证的风险项、需要截图时的运行截图捕获计划;当存在检测报告时,还包括页到章节的重写矩阵与重写优先级列表。提纲通常包括:封面/声明/摘要/目录;第1章引言;第2章需求分析;第3章总体设计;第4章详细实现;第5章测试;第6章结论;参考文献;致谢;附录(如需要)。
  6. 产出图与截图计划:当用户要求软件工程本科论文时,只允许以下图类型:系统架构图、功能模块图、业务流程图、时序图、E-R 图、用例图、与论文实际章节对应的真实运行系统截图。对每个计划中的图或截图,定义章节位置、代码/文档/运行时的来源依据、必须出现的标签、不得出现的标签或组件、旧图可保留还是必须重绘、截图是否需要先准备演示数据。所有重绘图必须使用工程论文视觉风格:白底、黑或灰线条、无装饰图标、无信息图风格、不依赖颜色传达含义。

现有初稿返工模式

当用户要求从现有初稿产出最终论文时:除非初稿不可用,否则不要从空白论文开始;识别哪些保留、哪些重写;为 academic-paper-composer 创建逐章重写简报;明确注明必须删除而非弱化的无支撑内容;要求 composer 在初稿副本或用户指定的工作稿上操作,绝不操作错误文件。

当用户特别要求继续手工编辑的初稿时:分别记录工作稿路径与受保护的备份/原始路径;仅按正文标题样式规划替换锚点;在交接中禁止基于目录的锚点匹配;识别哪些旧图表必须在重写中保留。

当用户特别要求降低相似度或 AIGC 时:识别主导分数的最小章节集合;优先处理中文叙述段落而非低产出的形式化章节;偏好少量高影响结构重写而非广泛浅层编辑;使用 references/detection-report-rewrite-playbook.md 中定义的重写模式。

适用场景

  • 基于当前仓库和学校模板,先做本科论文定稿规划,只保留代码里能证实的内容。
  • 已手工修改初稿到正文某处,需要做 keep/rewrite/delete 矩阵,并要求保留原数据库 E-R 图和每张表的字段说明。
  • 拿到查重报告和 AIGC 报告,先不直接改正文,而是把热点页映射到章节并给出重写优先级。
  • 继续在当前 working draft 上做规划,只替换某章节之后的正文内容,前面手改部分不动。
  • 为论文补充运行截图规划,说明每张截图对应哪个角色、哪个页面、哪个章节。

限制

该技能在规划阶段不声称论文已可提交,该决定属于 composer + drawio + playwright + doc 流程。它不编造任何功能、API、数据表、性能数字、部署规模、用户规模、并发基准或测试结果。若某论断无法映射到证据来源,则不能出现在最终论文中。图只允许有代码或项目文档支撑的类型。关于收费、价格、平台支持等具体信息,资料中暂未提供。