SuperAPI AI 工具集

paper-formal-writer

写作与研究

查看项目

更新于 10-16 02:29

技能介绍

用途:这是 Standard 流程中唯一的正式写作与最终稿件产出技能,把刚通过的 S6 证据链转成经审计的 Markdown 源文与含原生公式的 Word 文档,适用于 S7/S8 阶段。

进入前提:正式写作前需运行 python .claude/skills/paper-workflow-orchestrator/scripts/workflow_guard.py --skill paper-formal-writer,S0-S6 必须通过;状态不确定时用 --status 按其当前产物报告执行。S6 证据 PASS 后依次经过写作计划、章节草稿、章节审计、必要时的排队局部修复、确定性装配、Agent 全局修订、终稿 Markdown 审计、正式 DOCX、S8 格式/渲染门禁。不得把 quickstart、legacy 或机械合并的微单元产物提升为正式文件名。

主要能力:构建证据感知大纲(build_paper_outline.py)、准备自适应写作(prepare_authoring.py --mode auto)、按 authoring_state.json 记录路径撰写且每章须带可移除证据标记、用 validate_authoring.py 审计草稿、装配(assemble_sections.py)后全局重写为 final_paper_source.md、生成为 format_formal_docx.py 的正式 DOCX 并做 check_paper_format.py --render required 校验。审计会拦截过短草稿、缺章节/证据/数值、公式断裂、占位符、重复行文、图表引用错误及内部流程语言。

用法要点:默认交付为竞赛,计划至少 14000 有效字符、正文下限 8000、附录前至少 18 页渲染;这些是可调整的项目默认值而非比赛规则,写作前须核实实际比赛的页数上限与计数规则。短报告需 --delivery short-report --scope-reason "user-requested scope";自定义下限用 --min-pages / --min-body-chars 并说明理由,不得仅为让失败检查变绿而下调。

限制与路由:全局同一阻塞类别重复两次则切换 section;某 section 失败一次即重写;重复同类别两次可由 $paper-micro-unit-generator 仅修复排队位置;第三次同一类别变更尝试则 S7 变为 BLOCKED,报告原因并建议用户选择 Lite,但不自动切换。仅当 authoring_state.status = PASS 后才能执行 DOCX 与 S8;正式模式要求新的 S6、S7 哈希,--allow-draft 只能生成用于版式诊断的 final_paper_draft.docx,不满足 S7/S8,也不覆盖正式 DOCX。写作标准要求 1/1.1/1.1.1 标题与完整 CUMCM 章节,先定义符号再给公式,引用并解释每个图表,仅用当前证据,不得编造运行、数值、来源或验证,正文不写实现语言。官方说明与具体价格、平台支持信息暂未提供。