comms-prep

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Comms Prep — prepare before drafting

Comms Prep — 起草前做好准备

A communication's success depends on its being appropriate for its audience, meeting their needs, and having a clear measure of success. This skill helps you prepare the information you need to succeed. When a full review is justified, run
/comms-review
once your draft is written; your brief supplies the objective, audience, context, evidence sources, and structure plan if appropriate. This is useful both when you are drafting and for independent review agents.
Be liberal: any time you are writing something for people, think comms-prep.
一项沟通能否成功,取决于它是否适合受众、满足受众需求,并且有清晰的 成功衡量标准。本 skill 帮助你准备所需信息,以便 成功完成沟通。草稿写好后,如果有充分理由进行全面审查,请运行一次
/comms-review
;你的简报会在适当时 提供目标、受众、背景、证据来源和结构方案。 这既适用于你正在起草内容的情况,也适用于独立的审查 Agent。
尽量广泛使用:只要是在为 people 写东西,就考虑使用 comms-prep。

1. Decide whether to reuse or prepare

1. 决定复用还是准备

Adequacy. A brief is adequate when its answers for objective, audience and context, knowledge model, source content, form factor, and style conventions are accurate and complete for the communication.
Reuse. While the conversation and objective remain the same, generally reuse an adequate existing brief. You can amend an existing brief if something has changed and it is no longer adequate. If the form is a back-and-forth communication, it is not necessary to prepare again for each reply.
Scale. Scale the brief to the artifact. For a small artifact it may be four lines answered in seconds: who reads this and when · what do you know that they don't · what must they understand · what would mislead them.
For a routine, low-stakes reply, answer those questions directly, draft, and self-review for the objective, reader understanding, and source meaning. A written brief and
/comms-review
are not required on this path. A reply is low-stakes when a misunderstanding would be cheap to correct in the next exchange: the same test of objective, audience, and cost of failure that decides below whether a full review is justified. Shortness alone does not make a message low-stakes; a short message that reaches a wide audience, fixes a decision, or will be reused is not on this path. Continue below for substantive or consequential communications.
Authoring boundary. Generally run this skill once you have finished working out the actual information you need to communicate and immediately before drafting the substantive communication. When the requested work is itself writing, that boundary is the start of drafting. When underlying work must happen first, stay with that work until those answers exist; the fact that a report will eventually follow does not move the boundary to task start.
Retroactive use. If a draft already exists with no brief, prepare the brief from the draft's intended purpose rather than copying assumptions out of its text. Then make the brief and draft available to
/comms-review
.
Where it lives. The brief is an artifact, not a thought: keep it available with the draft for
/comms-review
reviewers, while keeping it outside the primary reader-facing communication. Keep it in your own scratch space, in context, or as a brief summary directly in chat if appropriate. Do not include the brief with the workspace or files for the audience; this would generally not be appropriate.
充分性。 当简报对沟通的目标、受众与背景、知识 模型、来源内容、表达形式和风格约定的回答准确且完整时,该简报就是充分的。
复用。 只要对话和目标保持不变,通常应复用一份充分的 现有简报。如果情况发生变化,导致现有简报不再充分,可以对其进行修改。如果 沟通属于往复式沟通,则没有必要为 每次回复都重新准备。
按比例调整。 根据交付物调整简报。对于小型交付物,简报可能只需在几秒内 用四行回答:谁在何时阅读 · 你知道而他们不知道什么 · 他们必须理解什么 · 什么会误导他们。
对于例行、低风险的回复,请直接回答这些问题,完成起草,并围绕 目标、读者理解和来源含义进行自我审查。无需编写书面简报,也无需运行
/comms-review
。 如果误解可以在下一次交流中低成本纠正,即可视为低风险回复:这也是下文用于判断 是否需要全面审查的同一项标准,依据是目标、受众和失败成本。内容简短本身并不能让消息成为低风险;如果一条简短消息 会触达广泛受众、确定某项决策或将被重复使用,就不应走这条简化路径。 对于实质性或影响重大的沟通,请继续阅读下文。
撰写边界。 通常,在你已经梳理清楚真正需要传达的信息后,并且就在 实质性沟通起草之前,运行一次本 skill。 如果请求的工作本身就是写作,这个边界就是开始起草的时点。如果还需要先完成前置工作, 请先专注于该工作,直到上述答案已经明确;因为最终会产出一份报告,并不意味着 将这一边界提前到任务开始时。
追溯使用。 如果已有草稿却没有简报,请根据草稿的 预期目的编写简报,而不是从正文中照搬其中的假设。然后将简报和草稿 提供给
/comms-review
。
存放位置。 简报是一项交付物,而不是一个想法:应将其与草稿放在一起,供
/comms-review
审查者使用,同时使其独立于主要的面向受众沟通。可以将 它保存在自己的临时空间中、上下文中,或在合适时直接在聊天中提供一段简明摘要。 不要将简报连同面向受众的工作区或文件一起提供;通常这样做并不合适。

2. Write the communications brief

2. 编写沟通简报

Write a short brief. Read Write the communications brief when creating or materially amending one: it holds the six lines to answer (objective, audience and context, knowledge model, source meaning to preserve, form factor, style and conventions), the structure plan for multi-section and long documents, and the check to run before drafting. Then decide on review:
编写一份简短简报。在创建或 实质修改简报时,请阅读编写沟通简报:其中列出了需要回答的六个方面(目标、受众与背景、 知识模型、需要保留的来源含义、表达形式、风格与约定),说明了适用于多章节和长文档的 结构方案,并给出了起草前需要进行的检查。然后决定是否审查:

Add a reminder to call
/comms-review

添加调用
/comms-review
的提醒

Decide whether the communication is substantive enough to justify running
/comms-review
once it is complete.
/comms-review
uses an audience-review loop to check that the communication meets its objective and avoids common failure modes. Judge whether that work is proportionate by considering the objective, audience, and cost of failure. In most circumstances, a few rounds of review cost less than repeated back-and-forth with a confused human. They almost certainly cost less than misleading a wide audience.
If a full review is justified, add a note to the end of the brief instructing the drafting agent to invoke
/comms-review
when the draft is complete.
判断沟通是否足够实质化,以至于值得在完成后运行一次
/comms-review
。
/comms-review
使用面向受众的审查循环,检查沟通是否实现了 其目标并避免常见失误。判断这项工作是否投入适度时,应考虑 目标、受众和失败成本。在大多数情况下,进行几轮审查的成本低于 让困惑的人反复来回沟通的成本,而几乎肯定低于 误导广泛受众的成本。
如果需要全面审查,请在简报末尾添加一条备注,指示起草 Agent 在草稿完成后 调用
/comms-review
。

3. Unresolved questions

3. 未解决的问题

If a question arises during comms prep and you don't know the answer, ask the user when you can get a reply this turn. Otherwise, note the issue in the brief, and use an appropriate escalation path if this significantly affects the quality of the communication. Even when you can ask, sometimes neither of you knows the answer (for example, some information the absent author hasn't provided). Use your best judgement together, and document ambiguity. Do not overstate your certainty or confidence level. Never make stuff up. If some particular part of the communication is not possible, say so, but deliver any unaffected or unrelated remaining parts.
如果在沟通准备过程中出现了一个你不知道答案的问题,并且本轮可以得到用户回复,请询问用户。 否则,在简报中记录该问题;如果它显著影响沟通质量,请采用适当的 升级处理路径。有时即使可以询问,你和用户也都不知道答案(例如,缺席的作者没有提供某些 信息)。请结合最佳判断作出处理,并记录其中的模糊之处。不要夸大 确定性或信心水平。绝不编造内容。如果沟通的某个特定部分无法完成,请明确说明,但仍应交付其他不受影响的部分。

4. Writing the communication

4. 撰写沟通内容

Once you have a good communication brief, use it to go and write a good communication. Say what you mean, as simply as benefits your objective. Avoid mannered prose and metaphor unless it carries key meaning that serves the objective and audience.
Follow the style conventions and skills the brief names.
拥有好的沟通简报后,请据此写出一份好的沟通内容。清晰表达你的意思, 并以最有助于实现目标的方式保持简洁。除非矫饰的文字和隐喻能承载服务于目标与受众的 关键含义,否则应避免使用。
遵循简报中指定的风格约定和 skill。