清晰输出 是做什么的?
帮助读者准确理解、检查证据,并以更少的精力决定如何处理。识别读者需要理解或验证的内容,然后润色措辞之前先选择呈现形式。考虑阅读、探索和检查输出所花费的时间。此技能适用于当前任务;除非用户要求,否则不要使其成为永久对话模式。
先选择语言,再考虑措辞
- 遵循用户明确的语言和输出格式要求。
- 编辑现有工件时,除非要求翻译,否则保持其语言不变。关于编辑的说明可以使用对话所使用的语言。
- 否则,遵循当前对话。遵循用户自身请求中清晰的语言切换。引用的材料、日志、代码、工具结果以及本技能的语言本身不会切换响应语言。
- 保留混合语言的技术术语和原样内容。不要仅仅因为本技能支持中文,就将英文调试对话翻译成中文。
- 如果用户请求 JSON、代码块或特定模板,请遵守该约定。不要添加技能声明或状态前缀。
保持原意
对于重写,以源文本和明确提供的上下文作为事实边界。保留:
- 参与者、对象、范围、条件、例外和顺序,包括必须同时发生的动作;
- 值、单位、界限、近似值、日期、标识符和因果关系;
- 事实、假设、建议、义务、许可和能力之间的区别。
不要将 may 变成 will,should 变成 must,about 5 seconds 变成 5 seconds,或者将尽快变成捏造的截止日期。不要在没有依据的情况下选择对模糊界限或代词的某种解释。保持模糊性可见,或明确指出缺少哪些信息。重写后的文本可能需要更长以保留这些区别。
对于新的解释,相关的背景和示例很有用。将假设与既定事实分开;必要时标记假设示例。不要在没有证据的情况下暗示某个操作或测试已经执行。
当将代码、命令、路径、字段名、日志、错误字符串和固定引用带入输出时,精确保留它们。如果任务明确要求编辑其中某项,则在其范围内执行该编辑;散文规则不能验证额外的编辑。
选择能产生实际效果的表现形式
当读者必须在头脑中重建关系、比较多个维度、跟踪变化状态或探索变量时,主动考虑使用可视化形式。如果可视化能显著减轻读者的工作,则在授权任务内创建它,无需等待单独请求图表。当简短的文本答案已能满足任务时,保持使用散文。
| 读者需要做什么 | 有用的起始形式 |
|---|---|
| 获取事实、简短答案或忠实的句子编辑 | 文本 |
| 根据相同标准比较选项 | 表格 |
| 跟踪分支、依赖关系、参与者或消息顺序 | 流程图、依赖图或时序图 |
| 理解空间布局或可见特征 | 带注释的图像或示意图 |
| 在提供的数值数据中发现模式 | 带有标签、单位和适当刻度的图表 |
| 探索输入如何改变结果 | 带有效控件的可工作交互式说明 |
| 跟随移动、演变或分阶段的教学序列 | 可行且有用时的动画或解释性视频 |
这些是起始点,并非视频总是最优的排名。一个小的自定义工件可能值得为一个问题而创建。优先选择能够充分减少读者工作量的形式,以证明生成时间、导航和交互的合理性。尊重对纯文本、JSON、现有文件格式或无工件的明确请求。
交付所选的形式,而不仅仅是提供制作的提议。使用可用的渲染功能并检查结果;测试相关的交互。如果渲染或媒体工具不可用,请提供可用的受支持替代方案,并准确说明产生了什么。图表源码、故事板和渲染后的视频是不同的交付物。不要仅仅因为可视化有帮助而要求特定供应商、发布、上传或使用付费服务。
在可视化编码中也保持原意:标记分支和箭头含义,保持并发动作的并发性,标记假设和缺失数据,并保持单位和刻度真实。一个精美的图表不能暗示未经支持的因果关系或已完成的测试。使标签清晰可读;不要仅仅依赖颜色。当输出约定允许时,提供简短的要点或文本等效内容,而无需以多种形式重复整个解释。
对于图表、交互式说明或动画,阅读 references/output-forms.md 以获取选择和验证指导。
使结构适合任务
- 解释: 首先回答主要问题,然后给出理解该问题所需的推理。保留有用的示例、因果联系和细微差别。
- 调试: 区分观察、假设、验证和下一步行动。说明某项检查确定了什么以及哪里仍存在不确定性。当缺失的事实会改变行动时,提出一个真实的问题。
- 流程: 将必要条件放在受影响的动作之前。当顺序重要时使用编号步骤。将人类操作与系统自动行为分开。将同时发生或不可分离的动作放在一起。当识别缺失的操作信息时,检查所指的是哪个对象或行为者,以及数量、单位、测量参考和开始/停止条件。询问使用指令所需的信息;不要自己提供缺失的事实。
- 重写或审查: 仅改进请求的范围。如果某段文字已经有效,则保留它。仅在请求时,或当未解决的歧义需要读者注意时,才提供更改说明。
偏好短小明确的句子、具体的动词和为相同概念使用稳定的名称。保留不同概念之间的区别。不要对技术术语的部分应用词汇黑名单,例如闭环控制或request validation。
句子长度、被动语态、同义词和礼貌是上下文选择,而非自动错误。英语可能需要被动结构或完成时态。当行为者已经明确时,中文可能需要省略主语。当它们携带信息时,保留可能、建议、约、may和approximately。
返回前检查
将重写版本与源文本进行比较,检查更改的事实、丢失的条件、变化的模态、捏造的精确性和受损的原样内容。对于可视化或工件,在其标签、边、状态和计算中检查相同的事实。检查语言和格式是否仍然匹配任务,以及声称的交付物是否实际存在。然后删除不增加信息的重复内容。
风格检查不能证明语义等价。报告一个具体的未解决问题,而不是声明文本已认证或完全验证。
对于涉及模态、语言混合或缺失事实的棘手重写,阅读 references/edge-cases.md。
对于大量重写、明确的验证请求或提供的项目术语表,在可选的本地检查器能够捕获具体错误时使用它。阅读 references/checks.md 以了解其输入和限制。从任务中选择 en、zh 或 mixed,而不是从引用的文本中选择。仅对忠实重写提供源文本,并且仅在任务要求时编码精确的原样内容或 JSON 约束。简单的答案不需要脚本。
将检查器的结果视为有范围限制的证据:修复违反的明确约定,对照源文本检查含义变化,并且仅在使用风格建议有助于改善时才使用它们。保留授权的编辑。不要为了消除每个警告而重写,也不要把空的发现列表当作等价证明。在修正后,重新检查受影响的约束;如果歧义仍然存在,报告它而不是反复重写。将诊断信息排除在请求的 JSON/仅代码响应之外。
当用户询问此技能的版本或更新时,阅读 references/updates.md。正常的写作任务不会触发网络更新检查或更改已安装的技能。