基于 ASD-STE100，我现在已将 https://github.com/dualface/ste-zh 配置为一个技能，让所有智能体在启动时读取。虽然会占用一些上下文窗口，但现在向智能体提问时，得到的回答清晰有条理，大大减轻了心智负担。

dualface/ste-zh

来源: https://github.com/dualface/ste-zh

ste-zh:简化技术中文规范

语言: 简体中文 | 繁體中文 (https://github.com/dualface/ste-zht)

一个面向 AI 智能体的任务汇报规范技能。借鉴航空与工业界严谨的 ASD-STE100(简化技术英语)原则,约束智能体用清晰、严密且无歧义的中文汇报工作结果。

智能体的日常汇报常常过程冗长、推测含糊,或者漏掉关键的验证证据。开启 ste-zh 后,智能体将遵循受控中文规范进行汇报:关键信息先行、实证说话、状态固定、一目了然。

💡 本技能仅规范智能体向用户汇报与讨论时的表达方式,绝不影响项目代码、注释、提交信息及生成的文件内容。

为什么需要 ste-zh?

同一个缺陷修复任务,常见汇报与规范化汇报的差异如下。以下摘录以 结果汇报示例 为准,示例中的来源事实见该文件。

常见 AI 汇报(冗长、推测、不报实证):

「好的,我先看了一下登录相关的代码,发现问题应该是出在令牌刷新的逻辑上,大概是并发的时候两个请求同时去刷新导致的。然后我对 auth/refresh.ts 进行了修改,加了一个锁来实现串行化处理,另外顺手把一些日志之类的也优化了一下。测试基本都跑过了,应该没什么问题,不过 iOS 那边因为没有环境暂时没法验证。你看要不要我再把重试逻辑也一起改了?」

ste-zh 规范化汇报(结论先行、实证可查、便于决策):

已完成:登录刷新逻辑的代码修改。iOS 端未验证。

原因:两个请求同时刷新令牌。后完成的刷新使先拿到的令牌失效。

证据:

• auth/refresh.ts:42 — 刷新前不检查是否已有刷新在进行。

改动

• auth/refresh.ts:同一时间只发一个刷新请求。其他请求等待这次刷新的结果。
• auth/logger.ts:删除 3 处重复日志。这项改动不在原范围内。

验证

• 已验证:npm test auth — 48 项通过,0 项失败。包含新增并发刷新测试 auth/refresh.test.ts:88。
• 未验证:iOS 端 — 本机没有 iOS 构建环境。

待确认

• 是否保留 auth/logger.ts 的改动:
  1. 撤回(推荐)— 本次提交只含登录修复。
  2. 保留 — 日志清理和登录修复一起提交。

核心特性

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

安装

推荐:使用 skills 命令行工具安装

skills (https://github.com/vercel-labs/skills) 是 Vercel Labs 推出的智能体技能管理工具,支持 Claude Code、Cursor、Codex 等主流环境。工具会自动按配置将本技能安装至 ste 目录。

全局安装(所有项目通用):

bash npx skills add dualface/ste-zh -g

安装到当前项目:

bash npx skills add dualface/ste-zh

仅为指定智能体安装(例如 Claude Code):

bash npx skills add dualface/ste-zh -g -a claude-code

更新与卸载:

bash npx skills update ste -g npx skills remove --global ste

手动安装

将本仓库克隆至智能体的技能目录下即可。由于本技能的标准名称为 ste,克隆时请确保目标目录命名为 ste:

Claude Code(全局):

bash git clone https://github.com/dualface/ste-zh.git ~/.claude/skills/ste

其他支持 SKILL.md 规范的智能体,参考各自文档将文件放置在对应的技能路径下。

使用方式

在对话中输入以下任意指令,即可启用本技能:

• /ste
• 「用 STE 规范输出」
• 「按 ASD-STE100 汇报」

启用后,当前会话中的所有汇报都将严格按照本规范组织。如需退出,发送「停止 ste」或「stop ste」即可。

更高优先级指令和用户明确指定的输出格式优先。同级风格规则冲突且用户未明确指定风格时,按本技能写。

注意事项

• 运行机制:本技能靠智能体遵守上下文中的指令生效,没有程序强制执行。
• 上下文衰减:在极长会话或发生上下文压缩后,智能体可能会遗忘指令规范。若发现输出风格退化,随时重新发送 /ste 即可恢复。
• 全局常驻:如希望每个会话默认开启,可将「每个会话开始时加载 ste 技能」写入智能体的全局规则中(例如 Claude Code 的 ~/.claude/CLAUDE.md 或 ~/.claude/rules/ 规则文件)。

实战配合:与 Kander 协同

作者在使用 Kander (https://github.com/dualface/kander)(多智能体看板调度工具)并行调度多个任务时,重度依赖本技能:

• 高效扫视:看板上多张任务卡并行流转,每张卡的汇报首句给出当前关键信息,便于查看任务进展。
• 完成与验证分开:代码修改执行完毕、运行检查未执行时,可以写「已完成:代码修改。运行效果未验证。」验收条件来自用户要求、适用的项目要求和任务目标。必需检查未执行或失败时,不得宣称整项任务已完成。已知失败不能改写成「已完成,未验证」。
• 极简决策:需要人工确认的阻塞点被清晰格式化为编号选项,在智能体会话中回复数字即可快速放行。

设计背景与 ASD-STE100 的关系

• 关于标准:ASD-STE100 (https://www.asd-ste100.org/)(简化技术英语)由欧洲航空航天与国防工业协会(ASD)维护,原本是针对英文技术维护文档制定的受控语言规范,用于消除歧义与理解偏差。
• 中文改写:本项目提炼了 ASD-STE100 的核心原则,并结合 AI 交互特点重构为一套中文实用规则体系。条目编号与内容均为独立设计,并非原文直译。
• 独立声明:本项目为个人开源项目,未收录 ASD-STE100 原文与受控词典,与 ASD 组织无隶属关系。ASD-STE100 与简化技术英语的权利属于 ASD。如需研读 ASD-STE100 英文原版标准,可在其官网免费申请。

核心文件

许可证

基于 MIT 协议开源。详见 LICENSE。

作者的其他项目

欢迎体验作者 dualface (https://github.com/dualface) 的其他项目:

• Kander (https://github.com/dualface/kander):规则驱动的多智能体看板调度工具,内置独立审核与自动化交付门禁。
• Ullage (https://github.com/dualface/ullage-cli):本地守护进程与命令行工具,查看 Claude、ChatGPT、Grok、Cursor 等订阅的用量。
• QuickTUI (https://quicktui.ai/):适用于各类编码智能体的手机端完整终端,支持自托管直连,单台主机免费。