Front Matter Writer（兼容性路由）是一款面向综述论文写作流程的技能，用于生成论文级前置内容外壳，并保持既定的输出契约与审批门控。
用途
该技能专注于撰写综述论文的五类前置部分：摘要（Abstract）、引言（Introduction）、相关工作（Related Work）、讨论（Discussion）与结论（Conclusion）。其触发词包括 front matter writer、introduction writer、related work writer、abstract writer、discussion writer、conclusion writer，以及中文的“引言”“相关工作”“摘要”“讨论”“结论”。技能目标是在维持当前输出契约与审批门控的前提下，产出论文级内容外壳。
主要能力
技能采用 reference-first 与脚本兼容相结合的模式。写作指导存放在 references/ 目录中，结构化作业契约位于 assets/front_matter_contract.json，脚本使用的 hook 库位于 assets/front_matter_templates.json。scripts/run.py 负责审批检查、元数据解析、确定性 hook 选择、文件生成与上下文 sidecar 写入。
加载顺序方面，技能要求始终读取 references/overview.md；按任务读取的参考文件包括：针对 sections/abstract.md 读取 references/abstract_archetypes.md；在调整章节简报投影到引言/相关工作时读取 references/context_projection.md；针对引言正文读取 references/introduction_jobs.md；针对相关工作正文读取 references/related_work_positioning.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。
使用方式
必需输入为：DECISIONS.md（含 Approve C2）、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（包含基础模板库、选定的领域 overlay 及其仓库相对 SHA-256 哈希）。
输出形状规则保持稳定：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>。全部选项包括 --workspace <dir>、--unit-id <id>、--inputs <path1;path2>、--outputs <path1;path2>、--checkpoint <C*>。
脚本边界
scripts/run.py 作为确定性助手，用于审批门控强制执行、前置文件发现/路径选择、元数据提取、基于 assets/front_matter_contract.json 与 assets/front_matter_templates.json 的渲染，以及报告与上下文 sidecar 的写入。脚本不应被视为长文写作指导的主要场所。
适用场景
该技能适用于研究综述的自动化或半自动化写作流程，尤其是需要按既定合约生成摘要、引言、相关工作、讨论与结论，并保持引用密度与论文语气的场景。它也适用于需要审批门控（Approve C2）约束的前置内容生成流程。
限制
当前模式为 reference-first 与脚本兼容。如果 DECISIONS.md 缺少 Approve C2，脚本将写入 checkpoint 块并退出。如果 citations/ref.bib 或 outline/outline.yml 缺失，需要先恢复这些输入再重试。故障排查建议包括：当前置内容听起来像叙述时，重新加载 references/forbidden_stems.md 与 references/examples_bad.md；当相关工作变成综述列表时，重新加载 references/related_work_positioning.md；如果资产与参考文件出现漂移，应修复该技能包内的资产/路由，而不是再次扩展 SKILL.md。
关于收费、价格、平台或效果等具体信息，资料暂未提供。