SimpleEnglish (ASD-STE100)
强制 AI 按 ASD-STE100 简化技术英语(航空航天维修手册标准,53 条规则)写技术文档:短句、一词一义、主动语态、条件前置,附带可复现的跨模型评测套件,AI 味作为副作用被杀死。
仓库:AminBlg/SimpleEnglish
热度证据:HN 帖『Agent Skill to Force Docs in ASD-STE100 Simplified Technical English』362 分/122 评论(2026-07-30)
五维评分
热度4/5
质量5/5
创新5/5
易用4/5
文档5/5
优秀点拆解
- 把「写清楚」变成可测试规格:SKILL.md 完整收录 53 条编号规则(20/25 词句长、禁 should/would/may、条件前置等),每条配软件场景 Before/After,规则编号让检查成为确定性行为
- TDD 式效果验证:ste_lint.py 确定性正则违规计数器 + run_bench.py 跨 6 个 Claude 模型 × 8 任务 × 2 条件共 96 次生成的基准,实测违规下降 72.9%,盲判评委 38/48 胜,含诚实声明与复现命令
- 分类先行 + 双模式决策门:每段文本先分 procedural(20 词/祈使)与 descriptive(25 词/简单时态),再选 pragmatic/strict 档,53 条规则被收敛成四条可用路径,普通用户无负担
- 自检写入流程:交付前四查(拆长句、搜缩略/完成时/should/-ing/分号、if-when 条件前置、动词一致性)明说不可省略,另有 11 项分级 checklist;并警告 agent 别凭记忆编造规则号(实测会幻觉)
- 边界诚实 + 五载体分发:明确拒绝营销文案(STE 故意删说服力)、声明非官方无合规保证;同时交付 SKILL.md / system prompt / output style / 60-token 短版 / 无终端上传版,覆盖全生态
可复用的设计模式
- 外部权威标准改写模式:把工业标准改写成编号规则目录 + 软件示例,版权内容不复制只提取可执行机制,自建 slop 替换表
- skill 开发 TDD:确定性 linter(带自测 fixture)→ 跨模型矩阵基准 → 盲判双顺序评委 → 原始数据入库,量化声称必须可复现
- 分类决策门:复杂规则集先做互斥分类(procedural/descriptive),后续规则全部依赖该分类;再设 pragmatic/strict 双档降门槛
- 多载体裁剪:同一套规则按载体容量分层(完整 SKILL.md / 中等 system prompt / 60-token 极简版 / 常开 output style)
适用场景
README、API 指南、技术文档的写作与去 AI 味改写错误消息与 CLI 输出(先事实后修复指令)、runbook/SOP、incident report 与 status pagerelease notes 与 breaking changes 公告(警告模式:命令在前风险在后)AGENTS.md / 系统提示词编写(模型读 should 当可选,STE 禁 should)面向非母语读者或需要本地化翻译的文档预处理
边界与注意:不适用营销文案、博客、品牌文案(STE 故意删除说服力,skill 会拒绝);正式 STE 合规认证仍需官方词典,strict 模式只是接近合规;linter 是正则,测不了被动语态与词性误用;53 条规则有学习曲线,规则编号反直觉需对照本文件
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/simple-english-skill.md