ahang1598 中文论文写作 workflow
本 workflow 用 Makefile 驱动，不靠你自觉记流程。你只做两件事：写正文内容、按 make 的提示补文件。阶段顺序、前置依赖、什么算完成，全部由 make 强制，你不要自己判断走到哪一步。
IRON RULES（最高优先级，共 10 条）
- 只认 make：不自行判断当前阶段，不凭记忆推进。每次不确定就运行
make，它会告诉你现在唯一该做的事。 - 内容写进文件：正文写入
.workflow/paper_draft.md，不在对话里交付正文。文件存在且通过检查才算做完。 - 来源先行：涉及文献、法条、案例、史料、政策、数据、实验、指南、访谈时，先把来源写入
.workflow/source_pool.md，每条含题录、核验状态、核验依据与可访问 URL；只有已核验条目可计数、引用，不凭记忆写事实。 - 文献性判断必须文内引用：综述、研究现状、引言、相关工作、理论框架、法学规范论证，必须显式文内引用，不能只列参考文献。
- Final 不留缺口：Final 模式正文不得残留待补、待核验、mock、模拟数据、PLANNING DATA。
- 正文干净：正文不得残留
**__加粗、_..._斜体、emoji、HTML 上下标、AI 提示词、过程说明、用户指令。 - 学科分流：技术、医学、法学、人文社科实证、人文学科思辨、综述按各自结构写，禁止把文科论文套成理工实验结构。
- 不碰门禁：不修改
scripts/下任何检查脚本、不改阈值、不注释检查、不手动编造.workflow/下的检查报告让流程通过。检查失败就改正文，不是改检查。 - 交付只报三态：完成度以
make status的结论为准，只报PASS/BLOCKED/DRAFT_ONLY，不自我总结“已完成”。 - 不派子Agent：语义写作由你自己完成，不委派其他代理代写正文。
前 7 条脚本会强制拦截，第 8 到 10 条靠你遵守。绕过检查不会让论文变好，只会把问题藏到用户眼前的交付物里。
怎么运行（唯一入口）
在 paper-write-zh 目录下，任何时候运行：
make
make默认等于make deliver，它会沿依赖链自动检查：准备是否就绪 → 正文是否合格 → 按output_target交付。停在哪一步，就按它打印的提示做那一步，做完再运行一次make。不要跳过它直接写下一阶段。
单独运行某阶段检查：
make prepare # 校验 meta.json 与来源池
make write # 校验正文形态（会先要求 prepare 通过）
make deliver # 生成终稿，并按 output_target 决定是否创建、校验飞书（默认目标）
make status # 打印 PASS / BLOCKED / DRAFT_ONLY
交付目标只认 .workflow/meta.json 的 output_target：用户只要 Markdown 时写 markdown_only，需要 Markdown 与飞书时写 markdown_and_lark。不存在命令行跳过变量，make deliver 与 make status 必须读取同一目标，避免元数据与实际交付分叉。
用户明确提出篇幅要求时，把min_chars和max_chars写入.workflow/meta.json，使后续make deliver和make status沿用同一合同。MIN_CHARS、MAX_CHARS只用于同一次make调用的临时覆盖，例如：
make write MIN_CHARS=3000 MAX_CHARS=6000
分阶段运行时不得依赖上一次命令行变量。没有明确篇幅要求时省略meta中的这两个可选字段，由check_draft.py以task_scope为主、paper_type为辅选择宽范围默认值。具体默认范围只能在脚本维护，文档与Makefile不得复制一套阈值形成双重来源。
三阶段与产物
状态即文件。没有 handoff.json，没有你手动维护的 state.json。
| 阶段 | make 目标 | 你要产出的文件 | 通过后脚本生成 |
|---|---|---|---|
| 准备 | prepare |
.workflow/meta.json、（需引用时）.workflow/source_pool.md |
prepare_check.json |
| 写作 | write |
.workflow/paper_draft.md |
draft_check.json |
| 交付 | deliver |
无需手写，Makefile按目标生成终稿并按需建飞书 | paper_final.md、按需生成lark_check.json |
准备阶段要做什么
- 判断并写
.workflow/meta.json，字段取值必须落在枚举内：
{
"mode": "draft|final",
"task_scope": "full_paper|chapter|section|paragraph|revise|check",
"paper_type": "journal|degree|course|conference|review|proposal|other",
"discipline_branch": "technical|medical|law|hss_empirical|hss_humanities|review",
"needs_citation": "yes|no",
"output_target": "markdown_and_lark|markdown_only",
"citation_style": "gbt7714_numeric|author_year|footnote|apa|chicago|mla|template"
}
task_scope=revise用于会改变结构、证据安排、章节职责或内容取舍的实质性修订。进入write前把用户原稿原样保存为.workflow/original_draft.md，并创建.workflow/revision_contract.json：
task_scope=check只检查当前正文写作过程中的来源、引用、格式和确定性门禁，不承担研究价值、研究设计质量、稿件硬伤或投稿可行性评审；后者转/doubao-academic-evaluator。
{
"preserve": ["必须保留的术语、限定语或核心表述"],
"approved_changes": [
{"from": "含张三（2020）的完整原行", "to": "获批的完整新行", "reason": "修改原因", "user_authorized": true}
]
}
脚本自动保护原稿中的编号、括号引用、数字及preserve字面锚点。任何含受保护引用、数字或preserve锚点的完整行只要发生改写，都必须把完整原行和完整新行写入approved_changes并记录理由与用户授权；片段、跨行拼接或不存在的上下文不能授权。该门禁只证明确定性字面信息及其所在行未被静默改写，不证明引用支持关系、因果、机制或方法解释正确，语言收尾后仍须按paper-shape/references/polish.md做语义保真复读。
- 模式：用户说写一篇、初稿、先出完整稿 →
draft；说终稿、投稿前、可提交、最终版 →final，但缺材料时降级为draft或阻塞。 - 学科分支：technical 工程计算机等；medical 医学生物临床；law 法条案例裁判；hss_empirical 政治经济管理社会教育传播的实证研究；hss_humanities 文史哲艺术马理论的思辨研究；review 综述述评。
needs_citation为yes时，必须建来源池。
- 需要引用时，把已核验来源写入
.workflow/source_pool.md，建议表格：
| ID | 来源 | 类型 | 证据层级 | 可支持的事实 | 可写入正文的判断 | 适用位置 | 风险 | 核验状态 | 核验依据 | URL |
|---|---|---|---|---|---|---|---|---|---|---|
核验状态只接受能区分“已核验”与“未核验”的明确值；只有“已核验”条目计入最低来源数并可进入正文与参考文献。中文CNKI文献只有取得知网导出引用原文，或用户提供等价可追溯的完整引用与页面证据，才能标记已核验；仅有页面题名、作者、来源、年份或摘要时仍标记待核验。核验依据填写实际查看的页面、数据库导出、用户材料及页码/段落/记录定位，不能只写“网络检索”或“已确认”。未核验条目可以留在池中继续处理，但不得凑数或支持正文判断。
只拿到题名或元数据的文献只能支持元数据层判断，不能写具体研究结论。中文文献没有可核验页面证据、导出引用或用户回填来源时，不得进入正式参考文献。各学科来源范围：technical 核验基础方法/模型/指标/数据集原始文献与实验材料；medical 核验指南/共识/原始研究与伦理注册样本统计报告规范；law 法条案号判决结果必须有可核验来源；hss_empirical 核验核心文献与数据问卷访谈案例政策；hss_humanities 核验原典/译本/史料/档案版本页码；review 说明检索范围/数据库/检索词/筛选标准。
写作阶段要做什么
先在脑子里定结构再落笔，把正文写入 .workflow/paper_draft.md（单文件，含标题、摘要关键词若需要、正文各章节、表格、图占位、参考文献）。
写完整论文、章节或实质性续写前，读取 ../paper-shape/references/structure.md，按其中工作流把研究问题、材料、方法、主张和结论关系理清，再落正文。正文完成后读取 ../paper-shape/references/polish.md 做中文语言收尾，检查段落思路、句子节奏和信息保真；不借收尾新增材料或改写研究结论。独立提纲和已有文本的单纯润色不进入本 Makefile，交给同级 paper-shape。
下列内容是各学科常见的功能清单，不是必须照搬的目录。章节顺序、合并和省略先服从 ../paper-shape/references/structure.md 推导的论证路径，再服从用户、学校或期刊模板。
- technical：题目、摘要、关键词、引言、相关工作、方法、实验与结果、讨论、结论、参考文献。方法章有数据流与本文决策，实验章有指标基线数据与结果边界。
- medical：按研究类型选 IMRaD 或对应报告规范（CONSORT/STROBE/PRISMA/STARD/CARE/ARRIVE），列出伦理注册样本统计。
- law：问题提出、现行规定及不足、解释路径或案例评析、域外比较、完善建议、结语。区分规范解释、案例评价、制度建议，建议须回到前文问题与证据。
- hss_empirical：问题提出、文献综述、理论框架与假设、数据来源、结果分析、讨论与结论。说明变量材料样本方法边界。
- hss_humanities：问题提出、核心概念与理论视角、文本史料分析、分论点递进、总体判断。必须有中心论点，不堆材料摘录。
- review：研究问题、检索与筛选、主题综述、比较分析、主要争议、研究不足、未来方向、参考文献。按主题与争议组织，不逐年罗列。
写作硬约束（脚本会查）：只用来源池已有事实，不新增作者、年份、题名、法条、案号、实验数值、史实、理论归因；文内引用默认 GB/T 7714 顺序编码 [1]，若体例冻结为作者-年份/脚注/APA 等须全篇一致；结构化内容用表格，表题表注不与下一节标题粘连；图只写正式占位 图X待绘制：图题。内容要求：...，不写“此处插图”。Draft 模式的 mock 数据表注须写 PLANNING DATA - replace before submission；Final 模式不留任何缺口。
交付阶段做什么
正文通过make write后，make deliver按meta.output_target执行。markdown_only只生成终稿并按该目标判三态；markdown_and_lark执行：复制终稿 → 只用标题创建空飞书文档 → 查询并校验实际权限 → 权限合格后写入正文 → 读回XML → 校验正文 → 把权限状态合并进lark_check.json → 打印链接与三态。飞书文档保持学术风格，禁止callout高亮、彩色块、折叠块、大量emoji、装饰性卡片按钮分栏；允许标题、段落、表格、必要列表、公式块或可转LaTeX源、正式图占位。
默认私有路径不得依赖新建文档的默认权限，也不得自动执行高风险权限写入。创建后必须用drive +permission-get-setting查询data.permission_public，只有external_access=false且link_share_entity=closed才通过；否则写失败lark_check.json并判BLOCKED，说明当前文档权限不符合私有合同。收紧权限必须先向用户展示具体文档与目标档位，取得本轮明确确认后另行执行，不能因默认交付要求私有就静默追加--yes。
只有用户明确授权“本次新建文档允许互联网获得链接者阅读”这一具体档位时，才可在本次make命令行显式传入PUBLIC_LARK=1，继承自环境的同名变量无效。该变量授权的唯一写入是external_access=true、link_share_entity=anyone_readable，Makefile可据此为高风险命令追加--yes；写入后仍须只读查询并验证实际档位。其他公开范围或可编辑权限不由该变量代表，必须单独确认。
飞书创建、权限设置/查询、读回或check_lark.py失败时，必须生成status=fail的lark_check.json并立即调用status.py输出三态，不能让Shell错误成为唯一结果。若飞书权限或登录阻塞，终稿paper_final.md仍在，但只能如实报告BLOCKED或DRAFT_ONLY，不得宣称最终完成。
三态交付口径
最终回答的完成状态由 make status 给出，你只如实转述：
- PASS：正文检查通过，且完成
output_target要求的交付；markdown_and_lark还必须通过权限与读回校验。 - BLOCKED：卡在某阶段，说明卡点与
next指令。 - DRAFT_ONLY：正文存在但检查未过或未交付，明确标注这是未验收草稿，禁止说“已完成”“已交付”。
可用脚本（由 Makefile 调用，你一般不用手动跑）
scripts/check_prepare.py：校验meta字段与来源池，只统计核验状态为“已核验”且核验依据、URL齐全的条目。scripts/check_draft.py：正文形态检查，按学科分支切规则；未收到命令行覆盖时，根据task_scope与paper_type选择宽范围篇幅默认值。scripts/check_lark.py：飞书读回XML内容校验；权限由Makefile按同一失败报告结构验证并合并进lark_check.json。scripts/status.py：只读物理产物，输出三态结论。
脚本是强制门卫，论文的学术质量、论证对错、来源真伪仍由 references/ 方法论与人工审查负责，脚本不替代判断。
深入参考（按任务读取）
主入口写作阶段已经指定的../paper-shape/references/structure.md与../paper-shape/references/polish.md分别在规划和语言收尾时必读。其余文件按当前任务读取：中文正文语言和章节落笔的专门细则看references/writing-core/SKILL.md、references/writing-chapters/SKILL.md、references/evidence-driven-writing/SKILL.md；学科范式看references/stem/SKILL.md或references/hss/SKILL.md，HSS任务再按需读取references/hss/section-templates.md、references/hss/citation-policy-examples.md、references/hss/formatting-output.md、references/hss/journal-formats.md、references/hss/review-question-framing.md、references/hss/submission-checklist.md；来源检索和综述合成看references/literature-search/SKILL.md与references/literature-review/SKILL.md。
基于用户已有或prepare阶段已核验来源撰写论文内文献综述、related work或review article属于本线；需要独立执行系统检索、纳排、去重、质量评价和证据综合时转/doubao-literature-research。