用途:该技能用于起草、改写或审校产品与技术类 UX 文案,帮助读者以温暖、务实的语气、用尽量少的文字理解并采取行动。它是对 Microsoft 写作风格的独立表达、仅供参考的解读。
主要能力:保护事实,保留产品行为、名称、UI 标签、命令、代码、版本与限制;不承诺源材料未支持的修复、结果、安全属性或可用性;未经授权不改动法律与安全措辞;暴露缺失的上下文而非用泛泛安慰填补。
写作原则:先确定读者意图与当前状态,把结果、行动或问题放在最前,只补充完成下一步所需的上下文;复杂对比用并列结构的列表或表格;结尾给出下一步行动、结果或恢复路径,而非复述。使用“你”称呼读者,在提升流畅度时使用自然缩写;选常见词与直接动词,保留精确术语并在首次出现时解释;优先主动语态,由应用、服务或功能作主语;段落简短,语气冷静、以解决方案为导向,在安全、支付、失败与数据丢失场景更克制;面向全球读者使用字面语言与明确句式。
产品帮助与 UI 内容:步骤以动作开头,评论放在步骤之外;标签以动词开头并预示结果;与可见 UI 措辞和大小写一致;错误说明未发生什么、保留已知的安心事实并给出具体恢复动作;由产品为产品故障负责,不指责用户;仅在界面上下文补足语法时使用片段。
避免:正式疏离、企业式自夸与仪式化开场;不必要的术语、缩写、名词堆叠与抽象框架;指责性语言;日常命令中的“请”、难度评判与空洞鼓励;长插入语与多从句长句;紧张情境下的玩笑、兴奋或感叹号;无证据的支持、安全或恢复承诺。
最终检查:确认重点在前、读者知道该做什么、标签与产品一致、句子可干净翻译、错误含诚实恢复;删除“即将帮助你”而非真正帮助的句子。仅在来源、归属、许可或维护问题时可读 references/provenance.md。限制:资料未提供具体安装命令、平台、收费或价格信息。