front-matter-writer

前置部分撰写器（兼容性路由器）

触发条件与路由

• 触发条件：前置部分撰写器、引言撰写器、相关工作撰写器、摘要撰写器、讨论撰写器、结论撰写器、引言、相关工作、摘要、讨论、结论。

目的：生成论文级框架，同时保留当前输出约定和审批关卡。

加载顺序

始终读取：

• references/overview.md

按任务读取：

• sections/abstract.md：读取 references/abstract_archetypes.md
• 调整章节简介在引言 / 相关工作上下文中的呈现方式时：读取 references/context_projection.md
• 引言正文文件：读取 references/introduction_jobs.md
• 相关工作正文文件：读取 references/related_work_positioning.md
• sections/discussion.md 和 sections/conclusion.md：读取 references/discussion_conclusion_patterns.md
• 修改任何面向读者的文本之前：读取 references/forbidden_stems.md
• 仅用于校准：读取 references/examples_good.md 和 references/examples_bad.md

机器可读资源：

• assets/front_matter_context.schema.json
• assets/front_matter_context_schema.json（与清单命名对齐的兼容别名）
• assets/front_matter_contract.json
• assets/front_matter_templates.json
• assets/front_matter_context_projection.json

输入

必需：

• 含有 Approve C2 的 DECISIONS.md
• outline/outline.yml
• outline/mapping.tsv
• citations/ref.bib

可选但有用：

• GOAL.md
• queries.md
• papers/retrieval_report.md
• papers/core_set.csv
• outline/coverage_report.md
• outline/writer_context_packs.jsonl

输出

保持当前输出约定：

• sections/abstract.md
• 前置部分 H2 正文对应的 sections/S<sec_id>.md
• sections/discussion.md
• sections/conclusion.md
• output/FRONT_MATTER_REPORT.md
• output/FRONT_MATTER_CONTEXT.json，其中包含基础模板库、任何选定的领域覆盖层，以及各自相对于仓库的 SHA-256 哈希值

兼容模式

当前模式以参考文档为先，并兼容脚本：

• 撰写指南位于 references/
• 结构化任务约定位于 assets/front_matter_contract.json
• 脚本使用的钩子库位于 assets/front_matter_templates.json
• scripts/run.py 仍负责审批检查、元数据解析、确定性钩子选择、文件生成和上下文附属文件写入

这意味着：

• 保留当前文件结构和审批行为
• 将资源文件视为章节任务、钩子库和渲染护栏的有效语义来源
• 避免将文本策略移回 SKILL.md

脚本边界

将 scripts/run.py 用作以下任务的确定性辅助工具：

• 强制执行审批关卡
• 发现前置部分文件 / 选择路径
• 提取元数据
• 根据 assets/front_matter_contract.json + assets/front_matter_templates.json 进行渲染
• 写入报告和上下文附属文件

不要将脚本视为长篇撰写指南的主要载体。

输出格式规则

保持以下内容稳定：

• sections/abstract.md 以 ## Abstract 或 ## 摘要 开头
• 引言 / 相关工作对应的 sections/S<sec_id>.md 文件仅包含正文
• sections/discussion.md 包含 ## Discussion
• sections/conclusion.md 包含 ## Conclusion
• 方法说明在普通行文中仅出现一次，不得写成流水线 / 流程叙述

快速开始

• uv run python .codex/skills/front-matter-writer/scripts/run.py --workspace <workspace>

故障排查

• 如果前置部分读起来像是在讲述流程，请重新加载 references/forbidden_stems.md 和 references/examples_bad.md。
• 如果相关工作变成了综述清单，请重新加载 references/related_work_positioning.md。
• 如果资源文件与参考文档不一致，请在此技能包内修复资源文件 / 路由，而不是再次扩展 SKILL.md。

执行说明

在兼容模式下运行此技能时，scripts/run.py 当前会直接读取以下输入：

• DECISIONS.md，用于 Approve C2
• outline/outline.yml，用于解析 Introduction / Related Work 章节 ID
• outline/mapping.tsv，用于了解前置部分引文位置的上下文
• citations/ref.bib，用于确定引文键的适用范围
• GOAL.md、queries.md、papers/retrieval_report.md、papers/core_set.csv、outline/coverage_report.md 和 outline/writer_context_packs.jsonl，作为可选上下文来源

脚本

快速开始

• uv run python .codex/skills/front-matter-writer/scripts/run.py --workspace <workspace>

所有选项

• --workspace <dir>
• --unit-id <id>
• --inputs <path1;path2>
• --outputs <path1;path2>
• --checkpoint <C*>

示例

• uv run python .codex/skills/front-matter-writer/scripts/run.py --workspace <workspace>

故障排查

• 如果 DECISIONS.md 中缺少 Approve C2，脚本会写入检查点区块并退出。
• 如果缺少 citations/ref.bib 或 outline/outline.yml，请恢复这些输入后再重新运行。
• 如果前置部分显得过于模板化，请先检查 hook banks / section job graph，再修改脚本。