代理技能以强制ASD-STE100简化技术英语中的文档
✈️ 你的AI像LinkedIn帖子一样写作。让它像波音手册一样写。一个强制大型语言模型(LLM)用ASD-STE100简化技术英语撰写文档的代理技能:这种受控语言自1983年以来被航空航天使用,以防止疲惫的机械师误读指令。AI的草率写作成为副作用。💀 查看它 · 安装 · 规则 · 不只文档 · 收据 · 常见问题解答 在每个说代理技能标准的环境中有效:Claude Code、Cursor、VS Code Copilot、OpenAI Codex、Gemini CLI、Goose、OpenCode,以及大约25个其他。一个文件,无依赖,MIT。🔥 之前/之后 左侧列是未经编辑的Claude输出。右侧列是加载技能后的相同模型。🤖 无技能 ✈️ 有技能 利用sqlpipe的强大架构,用户可以以最小的配置开销无缝同步他们的Postgres表到S3。在开始之前,您应该确保已正确配置您的AWS凭证——这对于避免后续的权限问题至关重要。sqlpipe将您的Postgres表复制到S3。它需要一个配置文件。在您开始之前,请确保您的AWS凭证是正确的。如果不正确,S3会因权限错误拒绝上传。哎呀!建立连接时出错。请确保您的凭证已正确配置并重试,或者如果问题仍然存在,请联系管理员。连接到数据库失败:用户app的密码不正确。将DB_PASSWORD设置为正确的值,然后再次连接。我们发现了一个可能影响某些用户访问服务能力的问题。我们对由此造成的不便表示诚挚的歉意。在14:02至14:31 UTC之间,12%的请求失败。14:00的部署移除了缓存预热步骤。我们在14:27时恢复了它。 ┌── 测量:6个Claude模型 × 8个任务 × 2个条件,96次运行 ──┐ │ 每100字的STE违规行为▼ 72.9%(每个模型都赢了)│ │ 所有6个模型的输出令牌▼ │ │ 平均句子长度11.2 → 9.7个单词 │ │ “无缝地”幸存0 │ └─────────────────────────────────────────────────────────────────┘ 更多重写示例在examples/before-after.md中:自述文件、错误消息、事件报告、发布说明。📦 安装 npx skills add AminBlg/SimpleEnglish 就是这样。技能CLI检测您的代理(Claude Code、Cursor、Codex、Copilot、Gemini CLI等),并为您选择的代理安装。安装前试用:npx skills use AminBlg/SimpleEnglish@simple-english 没有SKILL.md支持?将prompts/system-prompt.md粘贴到您的系统提示、AGENTS.md或.cursorrules中。对于预算紧张的情况,还有一个约60个令牌的版本。然后请求任何技术写作,或者说:“用简化英语重写这个”。🖱️ 没有终端?(claude.ai、ChatGPT、Gemini)Claude.ai(付费计划)本质上支持技能:下载技能文件:打开SKILL.md并保存(Ctrl+S / Cmd+S)。在claude.ai中,转到设置→功能并启用代码执行。转到设置→自定义→技能→上传并上传保存的SKILL.md。切换技能开关。完成。当您请求技术写作时,Claude会应用它。ChatGPT:没有技能支持,因此使用提示版本。从prompts/system-prompt.md复制块到设置→个性化→自定义指令中,或到项目或自定义GPT的指令中。Gemini:创建一个Gem,并将相同的块粘贴到它的指令中。任何其他聊天机器人:将prompts/system-prompt.md附加或粘贴到聊天中,并说“将此应用于您为我写的所有内容”。📏 规则 53条编号规则,9个部分,由1983年编写的那些在句子模糊时读者会死亡的人撰写。进行大量工作的规则:规则 杀死的东西 🪦 每条指令最多20个单词,每条描述最多25个单词 运行冗长的句子 1个词=1个意思,整个文档检查/验证/确认/验证轮盘 简单时态仅限于“已更新”→“我们更新” 不使用“-ing”动词形式“使它容易...” 句子 主动语态“值得注意的是” 不再使用should/would/may/might 冒险。(可以,必须生存) 条件 在命令之前 行尾“...如果标志已设置”读者执行也太晚。 每个句子一个指令 半夜2点没人能遵循的步骤 保留冠词,保留“that” 电报风格。STE简短,而不是简洁 具有软件示例的完整释义集:SKILL.md。是的,这个自述文件打破了一半的这些规则。市场营销明确不在STE范围内。该技能知道这一点,并保持在文档内。😌 🧰 不仅仅是文档 该技能还为以下情况提供了适应方案(use-cases.md):🚨 错误消息:发生了什么→为什么→该做什么,按此顺序📟 运行手册:STE的主场;运行手册即维护手册🧯 事件报告:简单过去杀死“我们已经发现一个可能影响的问”📣 发布说明:将重大更改作为警告:命令优先,风险其次 🤖 您的AGENTS.md / 提示:系统提示是不能提问读者的程序。模型读取“应该”。
本站免费、广告极少。如果觉得有帮助,可以请我们喝杯咖啡 —— 任何金额都对持续运营有实际帮助。
☕请我喝杯咖啡