dualface/ste-zh

Agent skill: 按 ASD-STE100 (Simplified Technical English) 原则用中文向用户汇报结果

ste‑zh – 中文技术报告规范 Skill

它是什么

一个 Agent skill，指导大型语言模型（LLM）代理（Claude、Cursor、Codex 等）以受控、无歧义的中文风格撰写状态报告。它将航空航天行业标准 ASD‑STE100（简化技术英语）适配到普通话，强制采用“关键信息优先、基于证据、固定状态”的格式。

为什么重要

AI 代理在修复错误或交付功能时，常常产生冗长、推测性或内容不完整的更新。ste‑zh 强制代理做到：
1. 先说明结果（例如：已完成…）、
2. 引用具体证据（文件/行号、测试结果）、
3. 区分完成与验证，以及
4. 将待定决策以编号选项形式呈现。
这可以减少误解、加快人工审查，并使多代理工作流（例如使用作者的 Kander 看板）更易于扫描。

核心功能

关键信息优先 – 第一句话总是声明报告类型（结果、进度、摘要等）。
固定状态词汇 – 在 references/terminology.md 中定义的有限状态词（已完成、已验证、未验证等）。
基于证据 – 每项主张都必须有可验证的产物（代码行、测试用例、命令输出）支持。
主动语态与一词一义 – 消除模糊动词和含糊表达。
决策选项 – 当需要人工输入时，技能自动格式化为带推荐选项的编号列表。

安装

优先：使用 Vercel‑Labs skills CLI，该 CLI 以规范名称 ste 注册技能。

npx skills add dualface/ste-zh -g          # 全局安装
npx skills add dualface/ste-zh            # 项目本地安装
npx skills add dualface/ste-zh -g -a claude-code  # 为特定代理安装

手动：将仓库克隆到代理的 skills 目录，并将文件夹命名为 ste（例如 ~/.claude/skills/ste）。

使用方法

在与受支持代理的任何对话中，输入以下触发命令之一：
- /ste
- “用 STE 规范输出”
- “按 ASD‑STE100 汇报”
代理将按照 STE‑ZH 规则格式化所有后续回复，直到您发送 stop ste（或类似的停止命令）为止。
如果代理的输出偏离（例如在长上下文之后），请重新发送触发命令以重新激活该风格。

典型工作流程

代理执行任务（错误修复、重构等）。

您要求报告 – 代理以 STE‑ZH 格式的块回复：

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

原因：两个请求同时刷新 token，后完成的刷新使先拿到的 token 失效。

证据：
- auth/refresh.ts:42 — 刷新前不检查是否已有刷新在进行。
…

您做出决定 – 回复选项编号（例如 1）。
代理根据您的选择继续。

谁适合

依赖 LLM 代理进行代码审查、调试或文档编写，并需要简洁、可验证更新的团队。
使用像 Kander 这样的多代理编排工具的用户，其看板上会显示许多任务，快速扫描至关重要。
希望每次都不用编写自定义提示词而获得一致中文报告风格的任何开发者。

许可证

MIT（参见 LICENSE）。

作者的相关项目

Kander – 一个规则驱动的多代理看板调度器。
Ullage‑cli – 用于跟踪 Claude、ChatGPT、Grok、Cursor 等使用情况的本地守护进程/CLI。
QuickTUI – 用于编码代理的移动优先终端 UI。

以上所有信息均直接取自仓库的 README。