为什么 AI 的技术文档这么难读以及解法
文章分析了 AI（如 Codex）生成的中文技术文档难以阅读的原因：代词指代不清、动词名词化、条件省略等造成歧义，而文档被 Coding Agent 执行时歧义会变成错误假设。作者借鉴航空维修手册的 ASD-STE100 简化技术英语规范，做了中文适配，总结出 46 条规则（28 条硬规则、18 条软规则），并提炼为十句写作审美，如复杂胜于晦涩、名字胜于代词、动词胜于名词等。作者开发了 hai-simplified-technical Skill，包含规则文件、检查脚本和交付模板，供 Agent 生成和优化技术文档，实际使用后文档阅读体验显著提升。
