1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ste-zh |
| 作者/维护者 | dualface(独立开发者) |
| 来源链接 | https://github.com/dualface/ste-zh |
| 许可证 | MIT |
| GitHub Stars / Forks | 817 / 39(GitHub API,2026-11-01 读取) |
| 最新版本 | 未打版本标签;主分支最近一次提交 2026-10-31 |
| 安装方式 | 把技能目录复制进 ~/.claude/skills/,用 /ste 或「用 STE 规范输出」激活 |
数据来源:上述数字取自 GitHub API;功能与评分依据来自仓库文档与 SKILL.md。
2. 功能介绍与亮点
一句话:它把航空与工业界的 ASD-STE100 写作原则改写成一套中文汇报规范,给 agent 的输出立规矩,而不是教人写文章。
- 结论先行:第一句就是结论,背景和过程往后放。
- 一句一事、一词一义:一条事实只写一句;同一个词只表达一个意思。
- 状态词固定:「已完成 / 未完成 / 未验证」分开写,不混用「应该」「大概」。
- 实证可查:说「已验证」要给出证据位置,说「没验证」也要明说。
- 按需开启:只在用户显式激活后生效,不激活时对日常对话零影响。
- 术语统一:附一份术语表,固定关键词的译法。
3. 适用场景
所属分类:内容创作与知识管理。
- 与 agent 协作时,汇报总是很长、结论埋在最后的中文用户;
- 团队需要统一的任务汇报与验收格式;
- 输出会被机器翻译,或转给不了解上下文的人看;
- 排查、验收这类必须写清「证据在哪、哪一步没验证」的场合。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 技能目录安装,/ste 触发 |
| Codex | 需适配 | SKILL.md 是通用格式,斜杠命令要按平台自定 |
| OpenClaw | 需适配 | 同上,需要平台支持技能目录 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
大多数「写作类」技能在改文本,它改的是 agent 的汇报习惯:先给结论、一句一事、状态词不混用、说验证就给出证据位置。对每天要看十几条 agent 汇报的人来说,省下的不是字数,是判断成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 817 stars、39 forks;建仓不到一个月,issue 里已有真实功能请求 |
| 可用性 | 9 | 复制技能目录即用,零依赖;README、术语表与示例齐全,近一个月持续更新 |
| 安全性 | 9 | 纯提示词,不执行代码、不联网、不需要任何凭据 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 无任何命令执行,只约束输出文字 |
| ② 联网外发 | 无联网行为 |
| ③ 凭据 | 不需要 API key 或账号 |
| ④ 可疑指令 | 未见注入;反而明确写了「不得自动激活」 |
| ⑤ 作者信誉 | 独立开发者,公开仓库与示例,issue 有真实反馈 |
| ⑥ License | MIT,全文可查 |
| ⑦ 维护时间 | 2026-10-31 仍在更新 |
扣分点:无。纯文本规范,风险面接近零。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| SimpleEnglish | 按 ASD-STE100 原则改写英文 | 只管英文文本;ste-zh 是中文版规则,且约束的是 agent 的汇报行为 |
| Humanizer / avoid-ai-writing | 去掉文本里的 AI 味 | 处理的是既有文本;ste-zh 管的是每次回复的结构与状态词 |
| doc-coauthoring | 与人协作写文档 | 产出文档;ste-zh 不产出内容,只规定怎么汇报 |
核心差异:同类多在「改写文本」,ste-zh 在「约束输出」——结论顺序、状态词、证据位置都是固定的。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。GitHub 有 1 条开放 issue(希望增加严格与宽松两档)和 1 条已关闭的繁体中文用词修正,反馈集中在规则粒度(来源:GitHub issues,2026-11-01)。
9. 其他补充
- 简繁两个版本分仓维护(
ste-zh与ste-zht)。 - 术语表单独成文件,激活时要求先读,避免同一个词在不同回复里译法漂移。
10. 安装使用方式
git clone https://github.com/dualface/ste-zh
mkdir -p ~/.claude/skills
cp -r ste-zh ~/.claude/skills/
在会话里输入 /ste,或说「用 STE 规范输出」激活;说「停止 ste」关闭。只对当前会话生效。
11. 注意事项
- 不激活不生效,适合按需开启,不会改变日常对话。
- 只影响 agent 对用户的回复,不改代码、注释、commit 信息与写入的文件。
- 与用户指定的输出格式冲突时,用户格式优先。