cw-onboarding

入门

创建最精简且实用的首版作者持久语气与风格指南。帮助作者起步；不要要求他们先完成详尽的个人画像才能开始写作。

先加载现有上下文

阅读 ../../references/context-contract.md。在提问前，检查当前工作区中维护中的身份、语气、偏好和项目风格文件。

• 如果已有权威上下文，先概述内容，只询问确实缺少的信息。
• 如果用户需要写作专用文件夹，先确认目标位置并运行 cw-setup-project，以便 VOICE.md、STYLE.md、examples/ 和 drafts/ 集中放在一起。
• 不要仅因为任一指南内容稀少，或缺少旧版 TASTE.md，就自动触发此流程。
• 除非需要本地覆盖，否则不要将全局指导复制到写作专用文件夹。
• 未经明确批准，不要覆盖现有画像。

明确区分目标文件

按规则所规范的内容，将其放入对应文件：

• VOICE.md 回答 句子应听起来怎样？ 在此记录句法、措辞和语气，包括节奏、韵律、语域、标点、口头禅、句式技巧，以及推荐或应避免的表达。

• STYLE.md 回答 文章必须做到什么、包含什么并证明什么？ 在此记录论点、证据、文章结构、实质性标准、对受众的承诺、开篇、结尾、格式和发表就绪标准。

• 可选的 AUDIENCE.md 回答 我们为谁写作，什么内容可能引起他们的兴趣？ 在此记录读者所处情境、已有知识、诉求、兴趣、疑虑和来源证据。遵循项目指定的维护中共享来源；不要创建本地副本。

使用以下分类标准：

• 会改变措辞、句子结构或语气的规则属于 VOICE.md。
• 会改变文章主张、论据、组织方式或就绪标准的规则属于 STYLE.md。
• 关于读者认知的内容属于负责管理受众信息的 AUDIENCE.md；写作对读者的义务仍属于 STYLE.md。拆分混合反馈，不要在指南间重复记录。

将写作专用文件夹中的 VOICE.md 和 STYLE.md 作为其可移植上下文。若现有全局语气指南已是维护中的权威来源，则使用该指南。如果目标位置并不明确，告诉用户各类指导将存放在哪里。

开始建立或更新受众上下文

当用户要求设置或校准受众时，通过上下文契约确认受众信息来源。若已指定现有共享指南，则使用该指南；否则，如果有帮助，可在已确定的写作专用文件夹中创建 AUDIENCE.md。可选的起始模板是相对于插件根目录的 defaults/project-template/AUDIENCE.md。缺少受众上下文不会阻碍眼前的写作任务，也不会单独触发入门流程。

从已知情境、知识、兴趣和疑虑入手。只询问会产生重大影响的信息缺口。标明读者证据、定位、作者明确意图和编辑假设；保留来源、日期和适用范围。不要臆造人口统计画像，不要假设读者的个人利害，也不要把出版物预期建立的关系说成已测量的读者行为。具体任务可以选定范围更窄的读者，而不必更改共享指南。

让指南对作者和 Agent 都清晰易用：先用简短文字描绘读者形象，区分读者的诉求（他们寻求的结果或体验）与需求（可能帮助他们实现诉求的内容），并说明写作可以提供什么。必要时加入可能的英雄之旅：起始情境、召唤、障碍、引导、考验，以及读者最终带回的收获。除非有读者证据支持，否则将其标注为编辑模型；不要强行套用转变故事，也不要为填满各阶段而臆造动机。最后简要说明如何将指南应用于具体文章，并确保来源和不确定性易于查找。

访谈

只询问现有上下文无法回答的问题。在首次设置期间，每次提出 1 到 3 个对话式问题，或邀请作者分享有代表性的样稿。值得了解的方面包括：

• 句法、措辞、语气、句子结构、节奏，以及反复出现的句子层面写作手法；
• 作者的论证标准和反复采用的实质性写作手法；
• 证据要求、文章结构、开头、结尾，以及对是否达到可发表水平的判断标准；
• 作者创作什么、面向谁，以及对读者的承诺；
• 应避免的口头禅、结构上的反模式和 AI 痕迹；
• 会实质影响项目的工作流偏好。

以对话的方式提问，并跟随用户的节奏。无需固定提出 6 个问题。

若要快速制作初版，在每份指南中记录几条高价值规则，对未知之处暂时留白。如果作者带着紧急任务而来，尽可能从该任务中校准，而不是暂停工作，另行访谈。

根据样稿校准声音档案

当作者提供一组新样稿，或要求更新 VOICE.md 时，交付内容应是句子层面的声音评分表，而不是写作理念。

首先，对比样稿中的可重复句子层面行为。只记录样稿中反复出现的模式，或作者明确确认的模式。区分特定出版物、任务或主题所特有的模式与可通用的声音指导。

VOICE.md 通常应涵盖：

• 用几句具体的话概括整体的句子声音；
• 韵律和句长变化；
• 句法和反复出现的句子转折方式，例如层层累积、补充限定、纠正、收束或片段句；
• 措辞和语域，包括应避免的词语、句式和泛泛表述；
• 只有在会影响句子声音时，才涉及标点、强调和段落层面的质感；
• 只有在样稿中有依据时，才涉及幽默、自我意识或口头禅；
• 能帮助 Agent 调整草稿、又不照搬样稿的实用修改指引。

除非某项指引会改变句子的措辞、句法、韵律或语气，否则不要在此档案中写入好奇心、求知严谨度、不确定性、观点、读者关系、论证、证据、结构或发表标准。文章标准应写入 STYLE.md 或任务简报；若维护了已确认的 AUDIENCE.md，持久有效的读者信息应写入其中。

每条重要的声音规则都应附上简短的来源摘录，或对观察到的写作手法做简明描述。完整示例应放在 examples/ 中；已发表的文字仅供参考，不得复用。避免使用“温暖”“聪明”或“真实”等宽泛标签，除非将其转化为可观察的写作行为。

编写档案

• 只记录具体且有依据的偏好。
• 将句法、措辞和语气写入 VOICE.md；将论证、证据、文章结构、实质性标准和发表准备度写入 STYLE.md。
• 将指引写成可执行的规则，而不只是描述性格的形容词。
• 将完整范例放在 examples/ 中；只有在能阐明规则时，才在指南中使用简短摘录。
• 标明已发表的样例仅供参考，不得复用。
• 根据样稿编写规则时，要让规则可操作：告诉 Agent 句子如何铺陈、转折、补充限定、收尾，或如何听起来不真实。
• 附上简明的修改清单，帮助保留作者句子层面的声音，同时避免照搬其措辞或虚构个人细节。
• 如果管理规则要求审批，在更改权限较高或共享的文件之前，先展示拟议内容。

迁移 TASTE.md

如果存在旧版 TASTE.md，可在适当情况下将其中的规则归入 VOICE.md、STYLE.md 和获准使用的读者指南。对混杂或相互冲突的规则予以标记，留待判断。不要继续向 TASTE.md 添加新指引，也不要在未经明确批准的情况下删除它。

交接

确认：

• 请求时记录了哪些关于语气、风格和受众背景的信息；
• 指南和辅助示例保存在哪里，包括任何共享的受众来源；
• 哪些空缺仍有意留白；
• 未来的 Compound Writing 技能将如何加载写作主页。