用途
paper-writing-contract-planner 是写作阶段的推荐起点技能，用于在正式撰写正文前建立论文的写作契约：一份关于“这篇论文是什么、每个章节必须做什么、哪些主张被允许、每条主张需要什么证据、后续写作技能应如何执行草稿”的持久约定。它规划的是“论文公式”，不是散文本身。
主要能力
- 锁定目标投稿 venue、论文原型和定位
- 选择章节顺序与段落角色
- 把主张映射到所需证据槽位
- 为图、表、标题和结果段落分配职责
- 定义相关工作边界与限制政策
- 选择样例模式与写作风格规则
- 定义写作层权限：布局、流畅度、论证、技术一致性、风格一致性、venue 适配和最终润色
- 禁止无支持的主张、语气或结果表述
- 创建或更新 paper/.agent/writing-contract.md
不适用情形
本技能不用于撰写完整论文正文。契约存在后，应使用 paper-writing-assistant 撰写。创建或更新契约后，应使用 paper-writing-memory-manager，使章节状态、依赖关系、风格规则和未决写作线程反映新约定。若主要贡献仍未确定，应先用 paper-positioning-planner。若主要任务是主张/证据清单，应使用 paper-evidence-board。若缺失证据需要可运行的实验计划，应使用 experiment-design-planner。
在写作流程中的位置
典型序列为：paper-positioning-planner（决定论文卖点，若未定）→ paper-writing-contract-planner（锁定原型、章节顺序、证据槽位，从此开始）→ paper-writing-memory-manager（初始化章节台账与依赖）→ paper-writing-assistant（逐节起草）→ paper-draft-consistency-editor（投稿前对齐所有章节）。只有当论文原型、主要主张和 venue 已定时，才可跳过 paper-positioning-planner；投稿前至少运行一次 paper-draft-consistency-editor。
技能目录结构
<installed-skill-dir>/ 下包含 SKILL.md、references/（contract-schema.md、update-protocol.md）和 templates/（writing-contract.md）。
渐进加载
始终阅读 references/contract-schema.md 和 templates/writing-contract.md。更新已有契约或草稿/结果变化时，阅读 references/update-protocol.md。在契约需要特定原型的证据槽位时，若可用则阅读 paper-writing-assistant/references/evidence-recipes.md。当 venue/主题风格或样例模式重要时，阅读 paper-writing-assistant/references/style-selection.md 和 paper-writing-assistant/references/exemplar-index.md。当契约需要关于核心想法、可读性、证据完整性或图表解读的质量门时，阅读 paper-writing-assistant/references/paper-quality-heuristics.md。当契约改变章节顺序、段落角色、主张强度、写作层、风格规则、记号规则或禁用主张时，通过 paper-writing-memory-manager 读取或更新 paper/.agent/writing-memory/。若存在，阅读 paper/.agent/writing-style.md、paper/.agent/notation-contract.md 和 paper/.agent/writing-memory/style-and-terminology.md。若存在，阅读 paper-positioning-planner 的输出。
核心原则
- 写作契约是约束文件，不是正文草稿。
- 选择一个主原型，最多一个次原型。
- 每条主要主张需要章节位置、证据槽位和允许的措辞强度。
- 每个章节需要有职责，每个重要段落需要有角色。
- 每个主要图表在润色标题前需要有论文职责。
- 缺失证据应成为显式占位符、行动、收窄的主张或被禁止的主张。
- 契约应识别论文的主导卖点（洞见、性能或能力），并让每个章节支持该卖点。
- 契约应让证据完整性风险可见：影响比较的计算、数据、训练时长、调参预算、硬件、提示、评估和选择规则应放入证据槽位。
- 契约应足够紧凑，在起草中保持有用。
- 后续写作应遵循契约，除非新证据先改变契约。
- 后续写作应声明当前写作层，并保护分配给该层的不变量。
使用方式（步骤）
- 收集输入：查找 paper 根目录、已有 paper/.agent/writing-contract.md、草稿文件（main.tex、paper.tex、sections/*.tex）、项目记忆（memory/claim-board.md 等）、paper 本地状态、定位报告、结果报告、图表映射、审稿人风险和文献笔记。若用户仅提供想法，生成草稿契约并将不确定字段标记为 TBD 或 needs-decision。
- 决定契约模式：create（无契约或重新定位）、update（有新结果、新 venue、新主张或草稿变化后修订）、audit（检查契约是否匹配当前草稿与证据）。未指定时，无契约默认 create，有契约默认 update。
- 选择原型与结构：阅读 contract-schema.md，选择主原型（method、theory-guided method、empirical study、benchmark/dataset、systems/tooling、analysis/diagnostic、application、negative result/limitation 或 hybrid）、目标 venue 与受众、主导贡献类型（insight、performance 或 capability）、章节顺序、每节职责，以及引言、方法/设置、实验/结果、相关工作和限制的段落角色。若原型不确定，写下竞争选项与所需证据，但仍为契约选定临时主原型。
- 把主张映射到证据槽位：对每条主要和次要主张记录 Claim ID、主张措辞、允许强度、论文位置、所需证据槽位、当前证据状态、缺失证据行动、禁止的过度主张。证据槽位状态包括 filled、user-stated、planned、running、provisional、missing、contradicted 或 not-needed。若某证据槽位是所选原型的阻塞项，将对应主张标记为 blocked 或收窄。
- 定义写作规则：标题方向、摘要动作、引言段落配方、可读性门（逻辑强度、可辩护性、降低困惑时间、信息密度）、主要图表职责、结果部分顺序、相关工作边界、限制政策、临时结果政策、写作层政策、允许与禁止语气、术语/方法名/数据集名/基线名一致性、可借用的样例模式。不要包含长样例引用。
- 撰写或更新契约：使用 templates/writing-contract.md，保存到 paper/.agent/writing-contract.md；若无 paper/ 目录且当前目录即论文仓库，保存到 .agent/writing-contract.md。更新时保留有用的稳定决策，添加紧凑变更说明而非重写历史。
- 路由后续任务：未决项分别路由到 paper-writing-assistant、paper-writing-memory-manager、paper-evidence-board、experiment-design-planner、baseline-selection-audit、figure-results-review、table-results-review、paper-positioning-planner 或 paper-reviewer-simulator。
最终检查
定稿前确认：选定了唯一主原型；记录了唯一主导贡献类型或明确标记未决；章节顺序与段落角色明确；主要主张有证据槽位和允许强度；证据完整性字段覆盖影响比较的计算、数据、调参、硬件、评估和选择规则；缺失的阻塞证据产生行动或收窄主张；图表职责在正文润色前定义；相关工作与限制边界明确；列出无支持主张与禁用语气；写作层权限与受保护不变量足够明确，供后续编辑使用；输出路径与下一步写作动作清晰。
适用场景
适用于论文定位已明确、准备进入写作阶段的 ML 科研项目，尤其是需要统一全文结构、主张强度与证据对应关系、并协调多技能协作写作流程的场景。
限制
本技能不撰写正文；不负责确定论文主要贡献（需 paper-positioning-planner）；不负责生成实验计划或证据清单；具体收费、平台支持、运行环境等事实暂未提供。