用途
清晰技术英语用于把技术概念讲清楚,让读者第一遍阅读就能理解,同时不牺牲技术准确性。当一段解释令人困惑、术语过多、含糊或是难以跟上时使用它;用户要求澄清时也可使用。
主要能力
在撰写解释时,该技能要求:
- 先说明该事物做什么以及为什么重要。
- 每句话只表达一个主要观点。
- 优先使用常见、具体的词。遇到正确的技术术语时保留它,并在首次使用时给出定义。
- 首次使用缩写时将其展开。
- 优先使用主动语态,并指明动作的执行者:说明每个动作由哪个组件完成。
- 直接陈述因果关系。
- 按事情实际发生的顺序排列步骤。
- 区分已确认的行为、假设和建议。
- 当概念抽象时,使用一个简短示例。
- 步骤或并列项使用列表;当观点之间彼此依赖时使用散文。
- 删除填充内容、含糊的程度加强词和装饰性术语。
- 不为了缩短而降低解释的准确性。如果某个细节不确定,说明哪些内容未知以及什么可以验证它。
使用方式
在完成解释前,检查结果:确认每个代词都有明确的指代对象,每个技术术语都已定义或为目标读者所熟悉,每个步骤都说明发生了什么变化以及为什么。
适用场景
适用于需要解释技术概念的场合,尤其是当现有解释混乱、术语堆砌、含糊或难以跟进时,或用户主动要求澄清时。
限制
该技能遵循清晰技术沟通的一般目标,但不提供正式的 ASD-STE100 合规认证。
关于该技能的收费、价格、平台支持情况,资料中暂未提供。