ccf-paper-to-exemplar

论文到范例

系列文件约定

开始文件工作前，复用规范路径和一个任务／产物工作目录；默认使用项目根目录下的 ccfa-workfiles/<purpose>/<artifact-id>/。原位更新，保留输入文件，并使用 UTF-8，同时检查中文文本。关于命名、所有权和任务创建文件的清理，请遵循 artifact-contracts.md；交接时沿用这些路径。

协作约定

开始专家工作前，先阅读并遵循 ccf-humanization，然后阅读并遵循 ccf-common。每次交接时，复用其中适用的现行规则，或刷新缺失／已变更的规则。即使没有散文内容，也必须完成这两项预检；仅在相关时才启用详细编辑、实验和维护模式。

在一名负责人统筹下整合必要的专家贡献；复用有效的前置条件，并验证受影响的结果。遵循协作路线，避免重复报告。

范围与共享控制项

从提供的论文 PDF 中提炼可复用的写作模式，同时保留来源归属和科学含义。此技能负责范例卡片；论文撰写由 ccf-paper-writer 负责，视觉重构由 ccf-visual-composer 负责，科学审查由 ccf-paper-reviewer 负责。

遵循 ../ccf-common/references/handoff-modes.md、../ccf-common/references/task-modes.md 和 ../ccf-common/references/artifact-contracts.md。写入前，先确认现有卡片／资料库和缓存路径。若要求不创建新文件，则应编辑指定的现有卡片，或在上下文中返回分析结果。仅进行转换并不意味着可以修改全局资料库／默认设置。

工作流

1. 确认 PDF 路径、源版本、所需写作模式、可选的投稿 venue，以及获授权的目标位置。如果已完成的卡片和提取内容与相同来源及所需范围相符，则复用它们；如果源版本有更新，则需检查受影响的分析。
2. 如果需要提取，运行 scripts/convert.py，并显式指定 --output-dir、--full-text 和 --full-text-dir，将其指向选定的工作缓存。新项目的共享默认路径为 ccfa-workfiles/exemplars/<source-id>/，提取内容存放在 cache/ 中；保留既有路径。转换器会保留现有卡片，只创建缺失的骨架。--full-text-dir 是可选项；省略时会保留旧版输出布局。提取需要 Python 和 pymupdf；复用有效的现有卡片则不需要。
3. 检查提取是否成功，以及页码标记是否存在。按连贯章节分析相关全文；更新本地卡片时，使用搜索和指定范围。若公式、图表或阅读顺序会影响理解，则检查 PDF 的实际页面。不得用仅基于摘要的分析替代全文范例，也不得将空提取视为已完成。
4. 梳理来源的叙事、摘要／引言／方法／证据的写作手法、引用模式和可复用技巧。不要强行以局限性作为结尾。使用 ../ccf-paper-writer/references/prose-quality-guardrails.md 排除防御性写作习惯、人为标签、公式堆砌、无依据的夸大和机械化行文。
5. 使用 scripts/convert.py 生成的章节标题和既有卡片的标题，在原卡片中填写或修订内容：Story Pattern、Abstract Moves、Introduction Moves、Method Moves、Evidence Moves、Citation Patterns、Reusable Techniques 和 Do-Not-Copy Boundary。记录标题、经核实的 venue／年份、来源身份／版本，以及相关的页码／章节定位。若用户要求语言适配，则在 Reusable Techniques 中记录相关的标点、句子节奏或过渡惯例，并注明来源位置及其适用场景。无需新建风格档案文件，也无需达到语料配额。仅当来源提供了实质性示例时，才添加 Excluded Anti-Patterns。写作手法应与来源主张和独特措辞分开。
6. 如果用户要求登记到素材库，则使用 ../ccf-paper-writer/references/exemplars/cards/ 或用户现有的素材库，并更新 ../ccf-paper-writer/references/exemplars/index.md，避免重复条目。保留无关卡片；文件名相同本身不足以证明来源相同。原始提取内容应保存在工作缓存中，不要放入可复用的卡片库。
7. 仅当用户要求设为默认选项时，才更新 ../ccf-paper-writer/references/custom-format/default-user-format.md。若只要求适配 venue，可通过索引选择已有的相关卡片，而无需再提取其他 PDF。只有在 venue 分类不明确时，才加载 ../ccf-paper-writer/references/venue-guides/index.md。
8. 确认已完成的卡片中没有 [ANALYZE] 或 [MANUAL] 占位符，来源引用准确，输出／缓存路径整齐。返回规范卡片路径和有用的写作模式；仅在实际完成登记／默认设置更改时报告这些更改。不要复述完整 PDF 提取内容，也不要添加通用的后续操作菜单。

写作者交接

传递所选卡片路径、来源身份和相关写作手法。由写作者判断当前任务是否需要风格参考；段落编辑并不意味着要自动加载默认或 venue 卡片包。对于全文写作或明确要求风格适配的任务，应从 ../ccf-paper-writer/references/exemplars/index.md 中选择，并仅加载匹配的章节／卡片。保留用户现有的默认设置，但不要将其视为每次写作请求都必须阅读的内容。