ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

让AI输出难读的6个习惯清单:asd-ste100-skill扫描检查表,人人可立即上手

让AI输出难读的6个习惯清单:asd-ste100-skill扫描检查表,人人可立即上手 让AI输出难读的6个习惯清单asd-ste100-skill扫描检查表人人可立即上手【免费下载链接】asd-ste100-skillASD-STE100 Simplified Technical English rules, repurposed as a Claude Code skill for rewriting ambiguous agent-facing English.项目地址: https://gitcode.com/gh_mirrors/as/asd-ste100-skillasd-ste100-skill是一个 Claude Code 技能它把航空航天业用来防止误读维修手册的 ASD-STE100 简化技术英语STE标准改造成一份针对AI 输出的扫描检查表逐句找出含糊、绕口、易误读的英文再改写成一个词一个意思的干净句子。本文带你用这份清单自查 6 个让 AI 输出难读的坏习惯零基础即可上手。为什么AI输出会难读传统上技术文档写给人看读者可以问一句你的意思是 X 还是 Y。但 AI agent 解析另一个 agent 的输出、工具描述或错误信息时没有人类在场澄清歧义——它只能按字面猜。✈️ASD-STE100 标准最初诞生于 1986 年欧洲航空业需要一份绝对读不偏的维修文档标准。它的核心思想正是我们缺的一个词只用一个意思主动语态、简单时态一句话只包含一条指令指令句 ≤20 词描述句 ≤25 词asd-ste100-skill 把这些规则从飞机手册移植到了 AI agent 的输出上。完整规则背景见 references/writing-rules.md。6 个坏习惯清单逐句扫描你的AI输出以下 6 个习惯覆盖了机器写出的英文中大部分难读来源。它们都是机械规则——你可以直接指出是哪一个词、哪个标点破坏了规则不需要主观判断。完整版本在 SKILL.md 的 Scan Checklist 一节。1️⃣ 同义词轮换一件事换着叫法同一对象在一篇文档里被叫作 the user、the customer、the client读者无法判断它们是一个东西还是三个。✅修正方法选定一个名字全文只用它。2️⃣ 模糊词堆叠说了等于没说辅助动词和限定词层层加码句子最后什么也没断言it is important to note that this may potentially help to improve。✅修正方法直接陈述结论否则整句删掉。3️⃣ 名词化把动作冻成名词perform an analysis of the log —— 动作被冻结成名词句子变长执行者被藏起来。✅修正方法直接用动词Analyze the log.4️⃣ 营销形容词声称质量而不是展示质量seamless无缝、robust健壮、powerful强大、cutting-edge尖端……这些词不传递任何信息。✅修正方法删掉或者替换成能支撑该说法的具体指标。5️⃣ 长句连缀一句塞进一堆想法用分号、破折号把多个想法串成一整句。STE 干脆全面禁用分号能写的标点里唯独不能写;。✅修正方法一个想法一句话。6️⃣ 软性短语动词两个词拼出的黑话spin up、reach out、dive into、kick off——这两个词各自的意思拼不出组合含义非母语读者和机器翻译都会翻车。✅修正方法换成单个朴素动词start、contact、read、begin。改写前后对比同一句话的两种命运examples/before-after.md 里有更多示例挑两个最典型的改写前改写后This tool will attempt to synchronize state across the various backends that have been configured, and if a conflict is detected it may resolve it automatically depending on the strategy that has been set, or otherwise it will surface the conflict for manual review.The tool synchronizes state across the configured backends. If it finds a conflict, it checks the current strategy. If the strategy allows automatic resolution, the tool resolves the conflict. If not, the tool reports the conflict for manual review.An error may have occurred while processing your request due to a possible mismatch in the expected data format, which could be caused by an outdated client version.The request failed. The data format did not match what the server expected. Check your client version — an outdated client is the most common cause.注意第二例中 may have occurred 这类不确定表述被刻意保留它准确报告了系统自己也不知道出了什么错。⚠️ 这是最容易踩的坑——改写的红线保住不确定性。把 may have failed 改成 failed读起来更干净但从猜测变成了断言这是另一个意思不是简化。asd-ste100-skill 明确禁止把模糊语升级成事实。两种模式严格模式 vs STE风味模式技能先让你选模式再动手改写Strict严格面向流程、错误信息、工具描述、agent 间指令——任何读错会有代价的文本全部规则强制执行。STE-flavoredSTE风味面向 README、PR 描述、说明性文字——保留句子纪律长度上限、主动语态、无短语动词、无分号但放开一词一义的词汇锁定因为散文需要一点词汇弹性。立即上手安装与触发一键安装把仓库克隆到 Claude 技能目录即可git clone https://gitcode.com/gh_mirrors/as/asd-ste100-skill ~/.claude/skills/asd-ste100怎么触发它直接向 Claude 发出消歧类请求例如Disambiguate this tool description给这段工具描述消歧Rewrite this error message so an agent cant misparse itApply ASD-STE100 to this instruction或者粘贴一段文本说disambiguate this给这段消歧、reduce ambiguity in this output。它会输出什么技能会输出一个before/after 对照表标明每句违反了哪条规则违反的规则原句简化后现在完成时We have received your request.We received your request.名词串4词以上the agent task queue priority handlerthe handler that sets task-queue priority表格之后会附一句说明哪些地方故意没有简化以及为什么通常是为了保住必要的精度。如果输入本身已合规它会直接说合规不强行改动。项目文件导航 SKILL.md — 技能核心两种模式、核心改写规则、6 习惯扫描清单、完整工作流程examples/before-after.md — 官方 STE 规则示例 针对 agent 输出的改写实例references/writing-rules.md — ASD-STE100 九大类规则速览与出处README.md — 项目说明、适用边界LICENSE — MIT 许可证适用边界什么别用它✅ 适合agent 间消息、工具/函数描述、错误信息、系统提示词、任何机器或读者无法回头追问的英文文本❌ 不适合创意写作、营销文案——STE 天生就是平的、字面化的风格本身就是目的的文本不适用最后一个诚实的提醒STE 修的是文本的形式不是内容。一段空话改写之后依然是一段空话——只是变得更短、更干净、更难看穿。把这份 6 习惯清单放进你的写作流程下一次 AI 输出难读时先扫描、后改写人人可立即上手。【免费下载链接】asd-ste100-skillASD-STE100 Simplified Technical English rules, repurposed as a Claude Code skill for rewriting ambiguous agent-facing English.项目地址: https://gitcode.com/gh_mirrors/as/asd-ste100-skill创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表