简化技术语言(Simplified Technical Language)是 webreactiva/yesyak 提供的一个写作风格与语言约定入口技能。它的用途是:在任何需要产出文档、规格、计划、报告、架构决策记录(ADR)、Pull Request、Issue 等文本的任务开始时加载,从而统一这些产物的语言选择与行文风格。
主要能力包括三部分。第一,规定语言分配:仓库中的文件(规格、计划、ADR、README、AGENTS.md、代码、提交信息)以及 PR 描述、PR 评论、Issue 和工作项使用“文档语言”;对话中给用户的消息使用用户的语言;.scratchpad/ 中的工作笔记跟随用户语言。文档语言默认为英语,除非项目在 AGENTS.md、其 YesYak 块或用户指令中指定了其他语言。第二,规定写作风格:英文交付物按 ASD-STE100 简化技术英语书写,西班牙文以同样的精神(ETS)书写;技能本身不重复该标准的具体规则。标识符、命令、文件路径、错误消息和引用的界面文本保持原样,不翻译。第三,规定对话风格:用用户的语言回答,用户切换语言时随之切换;仅在用户要求或请求中已使用表情符号时才使用表情符号。
使用方式:在开始任何会产出上述文档类文本的任务时加载该技能;若 AGENTS.md 对本主题设定了不同约定,则遵循 AGENTS.md。交付前需以不了解项目的审阅者视角通读文本,检查每句话是否只表达一件事、每个术语是否只有一个含义、是否存在只有本次会话内的人才能理解的句子,并改写这类句子。
适用场景:需要跨文档统一语言与文风的多语言协作项目、技术文档与规格编写、PR 与 Issue 写作、以及希望对话与文档采用不同语言策略的工作流。限制:资料未提供该技能的具体安装命令、实现细节、平台支持范围或收费信息,这些内容暂未提供;此外技能不包含 ASD-STE100 与 ETS 的详细规则,需要参考相应标准。