• 桌面应用
• 开发者工具
• AI 应用

导读

examples/writing-structured-draft.md是 Codex-X 提示词模板库中"写作辅助"分类下的核心模板之一，它定义了一个擅长整理复杂材料的结构化写作助手角色：将用户提供的笔记、事实、观点、数据和零散片段，组织成重点明确、层次清楚、论证连贯的完整初稿。本文以该模板为骨架，逐条拆解其"内容边界—起草流程—常用结构—表达要求—输出方式"的设计逻辑，并结合 Codex-X 的提示词注入源码（lib.rs）、模板目录管理（catalog.rs）与本地存储实现（store.rs），说明该模板在 Codex-X 中如何被管理、注入和切换。读完你既能理解这套提示词方法论的每一个约束，也能在 Codex-X 中把它投入真实写作流程。

模板定位：它解决什么问题

模板开篇即给出明确的角色声明：

你是擅长整理复杂材料的结构化写作助手。将用户提供的笔记、事实、观点、数据和零散片段组织成一篇重点明确、层次清楚、论证连贯的完整初稿。

这段话定义了三个关键约束：

• 输入是"未经整理的原材料"：笔记、事实、观点、数据、零散片段，而不是已经成文的草稿；
• 输出是"完整初稿"：不是大纲，不是要点罗列，而是可交付、可继续编辑的成文文本；
• 质量目标是三条：重点明确（主题不散）、层次清楚（结构可见）、论证连贯（逻辑不断裂）。

模板同时限定了适用范围：报告、方案、复盘、文章、说明、提案和较长的业务文本。这决定了它优先服务于"长文本、多材料、强逻辑"的场景，而不是短消息、代码注释或口语化对话。这一点也在 Codex-X 的模板目录中得到印证——catalog.rs 为它登记的元数据是：标题"结构化长文起草"、副标题"把零散材料整理为提纲清晰、论证连贯的完整初稿"、分类徽章"写作辅助"，与模板内容完全一致。

内容边界：事实与推断的严格区分

模板用五条规则划定了助手的行为红线，这也是保证初稿"可用而不失真"的关键：

1. 只使用用户材料和明确给出的可靠来源。不调用记忆中的"常识"补全材料缺口；
2. 不虚构数字、引文、人物观点、研究结论、客户反馈或实施结果。这类信息一旦虚构，轻则误导决策，重则造成事实性事故；
3. 区分事实、判断、建议和待验证假设，不把它们混写成确定结论。例如"销售额下降 20%"是事实，"因价格策略失误"是判断，"应调整定价"是建议，三者不能混为一谈；
4. 保留重要限定条件和反例，不为了流畅删除影响结论的信息。流畅度永远让位于完整性；
5. 材料冲突时先保留冲突并标记，不擅自选择有利版本。助手没有裁决权，只能把冲突如实呈现。

这套边界的本质是"组织者而非作者"：助手负责排列结构、提炼重点、补全论证连接，但材料的事实性完全由用户负责。这与 Codex-X 中同系列模板的设计一脉相承——例如 writing-technical-docs.md 同样强调"不虚构 API、参数、默认值、返回结果"，writing-clarity-editor.md 强调"不改变作者核心意思、不增加未经证实事实"，三份写作类模板共享同一套事实底线。

起草流程：从目的到初稿的七步工作流

模板给出的起草流程共七步，每一步都有明确的产出：

值得注意的细节：

• 第一步先于一切。目的、读者、语气、篇幅、行动这五个参数，决定了后面所有取舍的依据——写给决策者的报告和写给执行者的方案，结论位置、证据密度、行动粒度完全不同；
• 第二步只提取"一个"核心命题。这是防止文章散焦的手段：所有段落都必须服务于这一个命题；
• 第四步刻意采用"先提纲后扩写"。提纲承担结构组织，扩写承担论证铺陈，两步分离避免了"边想边写"导致的结构漂移；
• 第六、七步是反向校对。写完不是终点，还要验证"结论是否被证据支撑""建议是否对应问题"，并删除一切无信息量的内容。

常用结构：五种组织模式与选择依据

模板明确强调"按内容选择，而不是机械套用"，并给出五种常见结构模板：

• 问题解决：背景 → 问题 → 原因 → 方案 → 实施 → 风险 → 结论。适用于修复类、改进类内容，因果链条完整，读者可以按序理解"为什么这样做"；
• 分析报告：结论摘要 → 证据 → 分析 → 限制 → 建议。结论先行，适合决策场景——读者哪怕只看结论摘要也能拿到要点，证据与分析支撑可信度，限制部分防止过度解读；
• 项目复盘：目标 → 结果 → 过程 → 偏差 → 根因 → 改进措施。按时间线还原，把"结果"与"目标"对照产生偏差，再向下追根因，避免复盘流于流水账；
• 观点文章：核心观点 → 语境 → 论据 → 反方或限制 → 结论。承认反方与限制是观点类文本可信度的来源，模板要求"保留反例"正是为这种结构服务的；
• 提案方案：目标 → 现状 → 方案 → 成本收益 → 里程碑 → 风险与决策项。以决策为终点，里程碑给出节奏，风险与决策项把"需要谁拍板"显式列出。

这五种模式覆盖了绝大多数业务长文，而模板的约束在于先判断内容类型再选结构——把一份复盘硬套"分析报告"结构，会丢失时间线；把一份提案套"观点文章"结构，则会削弱决策导向。

表达要求：让初稿直接可读、可交付

模板对文字本身提出五条要求，全部指向"可交付性"：

• 先说结论和关键信息，再补背景。反"铺垫式"写作，保证读者第一屏就能抓住重点；
• 使用具体名词和动词，减少"赋能、抓手、闭环"等空泛表达。空泛词是信息密度的敌人，模板甚至直接点名这类流行语；
• 不连续使用含义相近的小标题，不把一句话拆成一个章节。防止"为结构而结构"，章节必须是真实信息的容器；
• 数据要说明口径、时间范围和比较基准。例如"增长 30%"必须说明是环比还是同比、统计区间、对比对象，否则数字不可验证；
• 建议要有负责人、动作、条件或验证标准中的至少一项。没有责任人的建议无法落地，没有验证标准的改进无法闭环；
• 语气应与用途一致：报告克制，方案明确，文章自然，复盘诚实。

这一条可以与前文"起草流程"的第 6、7 步互相配合：表达要求管住"句子层面"的质量，流程步骤管住"结构层面"的质量。

输出方式：三种交付形态

模板对最终交付做了分级处理，而不是一刀切要求"永远输出完整初稿"：

• 信息充分时：直接输出完整初稿；
• 信息零散但可合理组织时：先给一份短提纲，再给完整初稿——提纲让用户有机会在扩写前修正方向，避免"全文写完后发现结构错了"的返工成本；
• 只有缺失信息会实质改变结论时：才在末尾列出不超过 5 个"待确认问题"。

注意两个边界条件："只列真正影响结论的问题"和"不超过 5 个"，避免把输出变成无休止的追问清单。这与内容边界中的"区分事实与待验证假设"呼应——待确认问题就是"假设"的显式化出口。

在 Codex-X 中启用与落地：模板如何注入 Codex

理解了模板内容，再看它在 Codex-X 中如何被管理和注入。这是本模板从"提示词文本"变为"可运行工具"的关键一环。

模板来源与同步

writing-structured-draft.md属于 Codex-X 模板库中的"GitHub 在线同步"类模板（区别于 5 套离线内置模板）。按 README.md 的说明：安装包离线自带 5 套模板，软件启动后会从 GitHubexamples/目录同步软件开发与写作辅助模板，本模板就在其中，同步成功后会被缓存到本地，临时离线仍可继续使用。模板目录解析逻辑位于 catalog.rs：远程模板按文件名生成 jsDelivr 与 GitHub 两路内容源，写入builtin_prompt_cache表，并带有checked_at检查时间与sync_issue同步异常字段（见 types.rs）。

两种注入模式

Codex-X 对任意提示词提供两种启用方式（见 lib.rs 的enable_prompt_content_inner，lib.rs）：

• 替换模式（Replace）：把config.toml中的model_instructions_file指向模板文件（如./writing-structured-draft.md），同时写入模板内容，并清空AGENTS.md中旧的管理区块；
• 追加模式（Append）：保留用户原有的提示词，只把本模板作为一段受管内容追加到AGENTS.md中，模板文件名会被映射为builtin:{id}形式的模板键（见 mod.rs）。

追加模式尤其适合"已经有了个人规则、只想叠加写作助手角色"的用户——Codex-X 只管理自己写入的区块，禁用时也只移除这一部分，绝不触碰用户原有内容。

AGENTS.md 受管区块机制

追加模式的实现位于 managed_agents.rs：模板内容会被包裹在一对显式标记中间，即constants.rs中定义的 AGENTS_MANAGED_BEGIN / AGENTS_MANAGED_END / AGENTS_TEMPLATE_PREFIX：

<!-- CODEX-X:INSTRUCTIONS:BEGIN --> <!-- CODEX-X:TEMPLATE: writing-structured-draft.md --> （模板内容） <!-- CODEX-X:INSTRUCTIONS:END -->

写入时会先检查标记是否完整、是否重复，若 BEGIN/END 不配对会直接报错并拒绝写入（见 managed_agents.rs），避免破坏用户已有的AGENTS.md。同时，每次启用操作都会在写入前自动备份（create_backup），一旦后续配置校验失败会回滚所有文件变更。

本地存储与自定义

所有启用过的提示词都会进入 SQLite 的prompts表（字段为id/title/filename/content，见 store.rs 与 types.rs）。你也可以把本模板导入后另存为自定义提示词：文件名会经过规范化处理（如normalize_prompt_filename将标题转成小写连字符的.md文件名，见 store.rs），内容会做统一的 CRLF→LF 归一化（canonical_prompt_content），保证同一提示词在不同编辑器中不会因换行符差异产生重复记录。

小结

writing-structured-draft.md是一份把"结构化写作方法论"完整编码进系统提示词的模板：内容边界守住事实底线，七步流程保证产出顺序，五种结构提供组织范式，表达要求提升交付质量，分级输出控制沟通成本。而在 Codex-X 中，它并不是一份孤立的 Markdown 文件，而是可以被分类管理、在线同步、一键启用/禁用、按追加或替换模式注入 Codex 的模板组件——理解模板内容，再结合 lib.rs、managed_agents.rs、store.rs 的注入与存储链路，你就能完全掌控这类写作提示词从"模板库"到"Codex 实际生效"的完整路径。

• 桌面应用
• 开发者工具
• AI 应用