尧图网站建设 
如何用asd-ste100-skill写出AI Agent无法误读的工具描述与系统提示词多Agent通信完整指南【免费下载链接】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搬到 AI Agent 场景它逐句检查你的工具描述、系统提示词、错误消息和多Agent通信指令把含糊、绕口的英文改写成 AI 无法误读的短句并在输出中给出违规规则 → 原文 → 改写的对照表。如果你的多个 Agent 靠英文字符串互相传递指令误读一次就可能让下游任务走偏。这篇文章教你从安装到实战的完整流程。为什么 AI Agent 会误读英文文本ASD-STE100 诞生于 1986 年起因很真实欧洲航空公司的维修手册读错一句后果可能是灾难。这套标准专治两类误读来源一词多义如 close the valve 既可读成关闭阀门也可读成阀门附近一句多义一个句子里塞了多个从句读者没法确定主语和动作而下游 Agent 解析另一个 Agent 的输出时处境和维修技师几乎一模一样——没有追问通道没法反问你是想表达 X 还是 Y。正如 README.md 开头所说同样保住技师不读错扭矩参数的那套规则也能保住下游 Agent 不误读工具描述。一键安装把技能放进 Claude Code仓库是只读的安装只需把它克隆到 Claude Code 的技能目录git clone https://gitcode.com/gh_mirrors/as/asd-ste100-skill ~/.claude/skills/asd-ste100装好后无需额外配置。技能的触发词定义在 SKILL.md 的description字段中直接向 Claude 发出这类请求即可激活Disambiguate this tool description Rewrite this error message so an agent cant misparse it Apply ASD-STE100 to this instruction两种改写模式先选 Strict 还是 STE-flavored技能要求在改写前先选定模式见 SKILL.md 的 Two Modes 一节模式适用场景规则强度Strict严格工具描述、错误消息、Agent 间指令、安全文本全部规则强制含硬性长度上限和一词一义STE-flavoredREADME、PR 描述、变更日志、解释性文字结构规则全开短句、主动语态、无短语动词词汇规则仅作参考选择建议凡是读错就有代价的文本工具描述、系统提示词、Agent 通信一律用 Strict普通文档和说明文字用 STE-flavored否则 prose 会被改得像换了一个作者。6 种最高频的 AI Agent 误读模式SKILL.md 的 Scan Checklist 列出了 6 个机器写作英语的常见病每个都能精确指到某个单词或标点无需主观判断同义词轮换——同一个东西一会儿叫 the user一会儿叫 the customer读者分不清是一个还是三个。修法全篇只用一个名字。模糊词堆叠——it is important to note that this may potentially help堆到最后什么都没断言。修法直接下结论或删掉。名词化——perform an analysis of 把动作冻成名词。修法换回动词 analyze。营销形容词——seamless、robust、powerful、blazing-fast。修法删掉或换成支撑这个说法的具体数字。长句连缀——用分号、破折号把好几个想法串在一起。修法一个句子只装一个想法。软短语动词——spin up、kick off、dive into。两个词的组合含义无法从字面预测。修法换成单个朴素动词start、begin、read。结构规则速查表写不可误读文本的硬性约束以下规则全部来自 SKILL.md 的 Structural rules 表格是写工具描述和系统提示词时可直接照做的约束规则要这样做不要这样做主动语态The agent deletes the file.The file is deleted (by the agent).不用短语动词Remove the panel. / Start the job.Take off the panel. / Spin up the job.一句一指令Open the file. Read line 3.Open the file and read line 3, then check if it matches.句子长度指令 ≤20 词描述 ≤25 词长复合句、层层从句禁用分号拆成独立句子任何位置出现分号名词堆叠≤3 个名词连用fuel pump valve4 个以上名词连堆保留情态词The requestmay havefailed. 保持原样把可能升级成确实改变断言强度段落限制一段一主题≤6 句多主题混写其中保留情态词Keep modality最值得新手注意模糊词携带的是作者的置信度置信度本身就是内容。把 may have failed 改成 failed 看似精简其实是换了一个断言——这是 SKILL.md 流程一节中点名的最常见的改写翻车方式。实战对照一段真实风格的工具描述如何被改写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.违规标记一句话塞了两条指令同步 解决/上报冲突两处现在完成时have been configured、has been set55 词远超描述的 25 词上限。改写后The tool tries to synchronize state across the configured backends. If it finds a conflict, it reads the configured strategy. If the strategy allows automatic resolution, the tool may resolve the conflict without a user. If the tool does not resolve the conflict, it reports the conflict for manual review.注意细节will attempt to 和 may resolve 是模糊限定词而非违规改写后原样保留——工具没承诺必然成功改写后也不许承诺。写多Agent通信指令把警告变成可执行动作Agent 间指令是误读成本最高的场景。examples/before-after.md 的 Example C 展示了完整套路改写前42 词、三个事实挤在一句话里Once the upstream job has completed and assuming no errors were raised, the downstream agent should proceed to consume the output artifact, though it is worth noting that partial artifacts are sometimes produced under timeout conditions.改写后每句一条指令边界条件显式化Wait for the upstream job to finish with no errors. Then read the output artifact. Warning: a timeout can produce a partial artifact. Check that the artifact is complete before you use it.这个例子还示范了技能的一个诚实设计最后一句检查产物完整是新增内容原文只警告了部分产物没说要做什么技能会明确标注这是补充而非改写而不是悄悄塞进去。系统提示词写作中这种警告必须配动作的写法非常值得借鉴。技能不会做什么边界须知为避免误用SKILL.md 的 Will not 一节明确划界不复制 ASD 官方约 900 词词典。标准可免费下载但不允许再分发本项目不在授权范围内所以只应用选最朴素、最常用的词并保持一致这一原则不逐词比对词典详见 SKILL.md 的 Source and Scope不改创意文案和营销文。STE 天生平实直白语气和修辞是重点的文本别用不为压缩而丢精度。宁可保留长表达并标记取舍也不悄悄删掉安全条件或范围限定不保证航空气防级合规。这是受 STE 启发的一般性清晰化工具不是认证文档工具治形式不治内容。空话改写后仍是干净的短句空话——没内容就直说别润色延伸阅读项目内的参考资料文件内容SKILL.md技能完整定义双模式、结构/词汇规则表、6 项扫描清单、改写流程、输出格式、边界references/writing-rules.mdASD-STE100 标准背景、9 大规则类别摘要与来源引用examples/before-after.md官方 STE 规则示例 4 个 Agent 场景改写实例工具描述、错误消息、Agent 间指令、README 散文README.md项目介绍、安装步骤与用法LICENSEMIT 许可总结三步写出不可误读的 Agent 文本先定模式工具描述、系统提示词、Agent 间指令 → Strict普通文档 → STE-flavored过一遍 6 项扫描清单同义词轮换、模糊词堆叠、名词化、营销形容词、长句连缀、软短语动词逐句对照结构规则表改写一句一指令、指令 ≤20 词、主动语态、分号清零并且永远保留模糊词的强度装好 asd-ste100-skill 之后把任何一段 Agent 要消费的英文丢给它说一声disambiguate this你就会得到一份逐句标注违规规则的 Before/After 对照表——这正是让多Agent通信不再靠运气的方法。【免费下载链接】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），仅供参考 如何用asd-ste100-skill写出AI Agent无法误读的工具描述与系统提示词：多Agent通信完整指南
如何用asd-ste100-skill写出AI Agent无法误读的工具描述与系统提示词多Agent通信完整指南【免费下载链接】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搬到 AI Agent 场景它逐句检查你的工具描述、系统提示词、错误消息和多Agent通信指令把含糊、绕口的英文改写成 AI 无法误读的短句并在输出中给出违规规则 → 原文 → 改写的对照表。如果你的多个 Agent 靠英文字符串互相传递指令误读一次就可能让下游任务走偏。这篇文章教你从安装到实战的完整流程。为什么 AI Agent 会误读英文文本ASD-STE100 诞生于 1986 年起因很真实欧洲航空公司的维修手册读错一句后果可能是灾难。这套标准专治两类误读来源一词多义如 close the valve 既可读成关闭阀门也可读成阀门附近一句多义一个句子里塞了多个从句读者没法确定主语和动作而下游 Agent 解析另一个 Agent 的输出时处境和维修技师几乎一模一样——没有追问通道没法反问你是想表达 X 还是 Y。正如 README.md 开头所说同样保住技师不读错扭矩参数的那套规则也能保住下游 Agent 不误读工具描述。一键安装把技能放进 Claude Code仓库是只读的安装只需把它克隆到 Claude Code 的技能目录git clone https://gitcode.com/gh_mirrors/as/asd-ste100-skill ~/.claude/skills/asd-ste100装好后无需额外配置。技能的触发词定义在 SKILL.md 的description字段中直接向 Claude 发出这类请求即可激活Disambiguate this tool description Rewrite this error message so an agent cant misparse it Apply ASD-STE100 to this instruction两种改写模式先选 Strict 还是 STE-flavored技能要求在改写前先选定模式见 SKILL.md 的 Two Modes 一节模式适用场景规则强度Strict严格工具描述、错误消息、Agent 间指令、安全文本全部规则强制含硬性长度上限和一词一义STE-flavoredREADME、PR 描述、变更日志、解释性文字结构规则全开短句、主动语态、无短语动词词汇规则仅作参考选择建议凡是读错就有代价的文本工具描述、系统提示词、Agent 通信一律用 Strict普通文档和说明文字用 STE-flavored否则 prose 会被改得像换了一个作者。6 种最高频的 AI Agent 误读模式SKILL.md 的 Scan Checklist 列出了 6 个机器写作英语的常见病每个都能精确指到某个单词或标点无需主观判断同义词轮换——同一个东西一会儿叫 the user一会儿叫 the customer读者分不清是一个还是三个。修法全篇只用一个名字。模糊词堆叠——it is important to note that this may potentially help堆到最后什么都没断言。修法直接下结论或删掉。名词化——perform an analysis of 把动作冻成名词。修法换回动词 analyze。营销形容词——seamless、robust、powerful、blazing-fast。修法删掉或换成支撑这个说法的具体数字。长句连缀——用分号、破折号把好几个想法串在一起。修法一个句子只装一个想法。软短语动词——spin up、kick off、dive into。两个词的组合含义无法从字面预测。修法换成单个朴素动词start、begin、read。结构规则速查表写不可误读文本的硬性约束以下规则全部来自 SKILL.md 的 Structural rules 表格是写工具描述和系统提示词时可直接照做的约束规则要这样做不要这样做主动语态The agent deletes the file.The file is deleted (by the agent).不用短语动词Remove the panel. / Start the job.Take off the panel. / Spin up the job.一句一指令Open the file. Read line 3.Open the file and read line 3, then check if it matches.句子长度指令 ≤20 词描述 ≤25 词长复合句、层层从句禁用分号拆成独立句子任何位置出现分号名词堆叠≤3 个名词连用fuel pump valve4 个以上名词连堆保留情态词The requestmay havefailed. 保持原样把可能升级成确实改变断言强度段落限制一段一主题≤6 句多主题混写其中保留情态词Keep modality最值得新手注意模糊词携带的是作者的置信度置信度本身就是内容。把 may have failed 改成 failed 看似精简其实是换了一个断言——这是 SKILL.md 流程一节中点名的最常见的改写翻车方式。实战对照一段真实风格的工具描述如何被改写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.违规标记一句话塞了两条指令同步 解决/上报冲突两处现在完成时have been configured、has been set55 词远超描述的 25 词上限。改写后The tool tries to synchronize state across the configured backends. If it finds a conflict, it reads the configured strategy. If the strategy allows automatic resolution, the tool may resolve the conflict without a user. If the tool does not resolve the conflict, it reports the conflict for manual review.注意细节will attempt to 和 may resolve 是模糊限定词而非违规改写后原样保留——工具没承诺必然成功改写后也不许承诺。写多Agent通信指令把警告变成可执行动作Agent 间指令是误读成本最高的场景。examples/before-after.md 的 Example C 展示了完整套路改写前42 词、三个事实挤在一句话里Once the upstream job has completed and assuming no errors were raised, the downstream agent should proceed to consume the output artifact, though it is worth noting that partial artifacts are sometimes produced under timeout conditions.改写后每句一条指令边界条件显式化Wait for the upstream job to finish with no errors. Then read the output artifact. Warning: a timeout can produce a partial artifact. Check that the artifact is complete before you use it.这个例子还示范了技能的一个诚实设计最后一句检查产物完整是新增内容原文只警告了部分产物没说要做什么技能会明确标注这是补充而非改写而不是悄悄塞进去。系统提示词写作中这种警告必须配动作的写法非常值得借鉴。技能不会做什么边界须知为避免误用SKILL.md 的 Will not 一节明确划界不复制 ASD 官方约 900 词词典。标准可免费下载但不允许再分发本项目不在授权范围内所以只应用选最朴素、最常用的词并保持一致这一原则不逐词比对词典详见 SKILL.md 的 Source and Scope不改创意文案和营销文。STE 天生平实直白语气和修辞是重点的文本别用不为压缩而丢精度。宁可保留长表达并标记取舍也不悄悄删掉安全条件或范围限定不保证航空气防级合规。这是受 STE 启发的一般性清晰化工具不是认证文档工具治形式不治内容。空话改写后仍是干净的短句空话——没内容就直说别润色延伸阅读项目内的参考资料文件内容SKILL.md技能完整定义双模式、结构/词汇规则表、6 项扫描清单、改写流程、输出格式、边界references/writing-rules.mdASD-STE100 标准背景、9 大规则类别摘要与来源引用examples/before-after.md官方 STE 规则示例 4 个 Agent 场景改写实例工具描述、错误消息、Agent 间指令、README 散文README.md项目介绍、安装步骤与用法LICENSEMIT 许可总结三步写出不可误读的 Agent 文本先定模式工具描述、系统提示词、Agent 间指令 → Strict普通文档 → STE-flavored过一遍 6 项扫描清单同义词轮换、模糊词堆叠、名词化、营销形容词、长句连缀、软短语动词逐句对照结构规则表改写一句一指令、指令 ≤20 词、主动语态、分号清零并且永远保留模糊词的强度装好 asd-ste100-skill 之后把任何一段 Agent 要消费的英文丢给它说一声disambiguate this你就会得到一份逐句标注违规规则的 Before/After 对照表——这正是让多Agent通信不再靠运气的方法。【免费下载链接】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），仅供参考