ste-zh — 让 AI Agent 用清晰无歧义的中文汇报工作结果

ste-zh 是开发者 dualface 发布的一套开源中文汇报规范，以 MIT 协议托管在 GitHub，用来约束 AI Agent 在向用户汇报与讨论工作时的表达方式。它借鉴航空与工业界长期使用的 ASD-STE100（简化技术英语）原则，把受控写作的思路搬到中文对话里，核心口号是关键信息先行、实证说话、状态固定、一目了然。规范只管 Agent 怎么向你说话，不影响项目代码、注释、提交信息以及 Agent 生成的文件内容本身。项目同时声明未收录 ASD-STE100 原文与受控词典，条目为独立设计，与 ASD 组织无隶属关系。这套 Skill工具面向的是已经能干活、但汇报总让人不放心的 Agent。

场景痛点

用 AI 编程助手干活，最磨人的损耗往往不在写代码，而在听它汇报。一句”我先看了一下，应该是配置的问题””测试基本跑过了，应该没问题，你看要不要合一下”，背后是状态含糊、证据缺失，把判断又踢回给你。任务跑了半天，你还得逐句追问到底做了什么、验证过没有。这类 AI应用层面的沟通成本，有时比工具本身的能力短板更消耗人。

主要功能特点

关键信息先行：首句按回复类型写。结果写状态与完成范围，进度写当前动作，需求总结写总结范围。普通解释或建议不强套模板。
状态固定：工作状态与验证状态分别表述，且各自限定范围。「已完成」不自动表示「已验证」。完整定义见术语表第 4 节。
如实写验证：修复效果、运行行为和检查结果写明检查方法、结果与覆盖范围。进度、建议、需求摘要和待决事项不强加验证状态；其中的实际效果断言仍须写验证。资料内容证据不能代替运行验证。
一词一义与主动语态：规范专用词汇，消除虚化动词与歧义长句，降低阅读心智负担。
选项化决策：遇到需要人工定夺的决策点，自动整理为带推荐倾向的编号选项，用户输入数字即可快速推进。

关键信息先行

规范要求每段回复的第一句话先端出最重要的信息，并按回复类型分开写：交付结果时首句直接写状态与完成范围，汇报进度时首句写当前动作，总结需求时首句写覆盖了哪些内容。普通解释或建议不强套模板，避免所有回复都长成一个样子。读者不用翻完整段，看首句就能决定要不要继续读，这和效率工具讲究的先给结论是同一个思路。

工作状态与验证状态分开

规范把”活干完了”和”活验过了”拆成两句话分别表述，各自限定范围。Agent 改完代码只能写”已完成：代码修改”，运行效果有没有跑过检查必须单独标注，”已完成”不自动等于”已验证”。状态词被固定成一套受控词汇，不能今天写”搞定了”、明天写”差不多了”。这条规则堵死把没验证的事包装成完成的捷径。

如实写清验证证据

凡是修复效果、运行行为、检查结果，规范都要求写明三件事：用什么方法检查、结果如何、覆盖了哪些范围。翻文档查到的资料不能代替运行验证；已知失败也不许改写成”已完成，未验证”带过。示例里有单任务汇报的改写前后对比，”测试基本跑过了”被逐句拆成方法、结果与覆盖范围，和做开源项目时社区评审要看复现步骤是同一个道理。

一词一义与主动语态

规范维护一份术语字典，给高频词定死含义，同一个词在回复里不能前后指不同东西。字典还配受控情态词表与虚化动词替换表，专门收拾”看一下、处理一下”这类虚词。句子要求主动语态，谁改了文件、跑了命令，主语必须清楚。用词收窄之后，长句子不再需要读者猜后半句，数字生活里被 AI 啰嗦耗掉的时间多来自这种漂移。

选项化决策

遇到需要人来拍板的决策点，Agent 不再把问题抛回聊天框让你自由发挥，而是自动整理成编号选项，每个选项附上推荐倾向和理由，你回一个数字就能推进。日常解释和技术说明不强套这套模板。这把”你看要不要……”变成”选 1、2 还是 3″，决策成本从读一段长文压缩到扫三行字，也是工具推荐内容里少见的交互设计。

安装与启用方式

推荐用 skills CLI 安装：全局执行 npx skills add dualface/ste-zh -g，项目内安装去掉 -g；手动装则克隆到 ~/.claude/skills/ste，目录必须命名为 ste。对话里说 /ste 即可启用，说「停止 ste」退出。它没有独立官网，内容托管在 GitHub，是一份靠上下文指令生效的开源软件。

与多 Agent 看板实战配合

作者另一项目 Kander 是多 Agent 看板调度工具，并行调度时重度依赖 ste-zh：每张任务卡只看首句就能扫视，代码改完但检查没跑时，卡片上写「已完成：代码修改。运行效果未验证。」。核心文件有 25 条规则、5 种模板与自检清单，外加术语字典和示例，适合每天在多个开发者工具间切换、不想被含糊汇报带偏的人。

项目地址

GitHub 访问

下载地址

https://pan.quark.cn/s/ae78c09ce42e

https://www.guangyapan.com/s/1964934954946461752_aeWhI5wocgzRgCO6 （光鸭新用户注册福利：永久免费空间：所有新用户注册即可解锁 2TB 永久免费存储空间，无需额外任务或付费）

ste-zh — 让 AI Agent 用清晰无歧义的中文汇报工作结果

场景痛点