dualface/ste-zh

dualface 资料

最近记录的来源活动: 2026年10月11日 05:47

SkillsMP 收录数据更新: 2026年10月17日 00:09

已收集 skills: 1

GitHub 星标: 221
GitHub Forks: 14

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

# ste-zh：简化技术中文规范 **语言 / Language：** 简体中文 | [繁體中文](https://github.com/dualface/ste-zht) 一个面向 AI Agent 的任务汇报规范 skill。借鉴航空与工业界严谨的 **ASD-STE100**（Simplified Technical English，简化技术英语）原则，约束 Agent 用清晰、严密且无歧义的中文汇报工作结果。 Agent 的日常汇报常常过程冗长、推测含糊，或者漏掉关键的验证证据。开启 `ste-zh` 后，Agent 将遵循受控中文规范进行汇报：**关键信息先行、实证说话、状态固定、一目了然**。 > 💡 本 skill 仅规范 Agent 向用户汇报与讨论时的表达方式，绝不影响项目代码、注释、Commit 信息及生成的文件内容。 --- ## 为什么需要 ste-zh？同一个 Bug 修复任务，常见汇报与规范化汇报的差异如下。以下摘录以 [结果汇报示例](examples/result-report.md) 为准，示例中的来源事实见该文件。 **常见 AI 汇报（冗长、推测、不报实证）：** > 「好的，我先看了一下登录相关的代码，发现问题应该是出在 token 刷新的逻辑上，大概是并发的时候两个请求同时去刷新导致的。然后我对 `auth/refresh.ts` 进行了修改，加了一个锁来实现串行化处理，另外顺手把一些日志之类的也优化了一下。测试基本都跑过了，应该没什么问题，不过 iOS 那边因为没有环境暂时没法验证。你看要不要我再把重试逻辑也一起改了？」 **`ste-zh` 规范化汇报（结论先行、实证可查、便于决策）：** > 已完成：登录刷新逻辑的代码修改。iOS 端未验证。 > > **原因**：两个请求同时刷新 token。后完成的刷新使先拿到的 token 失效。 > > **证据**： > > - `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 节](references/terminology.md#4-状态词)。 - **如实写验证**：修复效果、运行行为和检查结果写明检查方法、结果与覆盖范围。进度、建议、需求摘要和待决事项不强加验证状态；其中的实际效果断言仍须写验证。资料内容证据不能代替运行验证。 - **一词一义与主动语态**：规范专用词汇，消除虚化动词与歧义长句，降低阅读心智负担。 - **选项化决策**：遇到需要人工定夺的决策点，自动整理为带推荐倾向的编号选项，用户输入数字即可快速推进。 --- ## 安装 ### 推荐：使用 `skills` CLI 安装 [`skills`](https://github.com/vercel-labs/skills) 是 Vercel Labs 推出的 Agent Skill 管理工具，支持 Claude Code、Cursor、Codex 等主流环境。工具会自动按配置将本技能安装至 `ste` 目录。全局安装（所有项目通用）： ```bash npx skills add dualface/ste-zh -g ``` 安装到当前项目： ```bash npx skills add dualface/ste-zh ``` 仅为指定 Agent 安装（例如 Claude Code）： ```bash npx skills add dualface/ste-zh -g -a claude-code ``` 更新与卸载： ```bash npx skills update ste -g npx skills remove --global ste ``` ### 手动安装将本仓库克隆至 Agent 的 skills 目录下即可。由于本 skill 的标准名称为 `ste`，克隆时请确保目标目录命名为 `ste`： **Claude Code（全局）：** ```bash git clone https://github.com/dualface/ste-zh.git ~/.claude/skills/ste ``` 其他支持 `SKILL.md` 规范的 Agent，参考各自文档将文件放置在对应的 skills 路径下。 --- ## 使用方式在对话中输入以下任意指令，即可启用本 skill： - `/ste` - 「用 STE 规范输出」 - 「按 ASD-STE100 汇报」启用后，当前会话中的所有汇报都将严格按照本规范组织。如需退出，发送「停止 ste」或「stop ste」即可。 > 更高优先级指令和用户明确指定的输出格式优先。同级风格规则冲突且用户未明确指定风格时，按本 skill 写。 ### 注意事项 - **运行机制**：本 skill 靠 Agent 遵守上下文中的指令生效，没有程序强制执行。 - **上下文衰减**：在极长会话或发生上下文压缩（compaction）后，Agent 可能会遗忘指令规范。若发现输出风格退化，随时重新发送 `/ste` 即可恢复。 - **全局常驻**：如希望每个会话默认开启，可将「每个会话开始时加载 ste skill」写入 Agent 的全局规则中（例如 Claude Code 的 `~/.claude/CLAUDE.md` 或 `~/.claude/rules/` 规则文件）。 --- ## 实战配合：与 Kander 协同作者在使用 [Kander](https://github.com/dualface/kander)（多 Agent 看板调度工具）并行调度多个任务时，重度依赖本 skill： - **高效扫视**：看板上多张任务卡并行流转，每张卡的汇报首句给出当前关键信息，便于查看任务进展。 - **完成与验证分开**：代码修改执行完毕、运行检查未执行时，可以写「已完成：代码修改。运行效果未验证。」验收条件来自用户要求、适用的项目要求和任务目标。必需检查未执行或失败时，不得宣称整项任务已完成。已知失败不能改写成「已完成，未验证」。 - **极简决策**：需要人工确认的阻塞点被清晰格式化为编号选项，在 Agent 会话中回复数字即可快速放行。 --- ## 设计背景与 ASD-STE100 的关系 - **关于标准**：[ASD-STE100](https://www.asd-ste100.org/)（Simplified Technical English）由欧洲航空航天与国防工业协会（ASD）维护，原本是针对英文技术维护文档制定的受控语言规范，用于消除歧义与理解偏差。 - **中文改写**：本项目提炼了 ASD-STE100 的核心原则，并结合 AI 交互特点重构为一套中文实用规则体系。条目编号与内容均为独立设计，并非原文直译。 - **独立声明**：本项目为个人开源项目，未收录 ASD-STE100 原文与受控词典，与 ASD 组织无隶属关系。ASD-STE100 与 Simplified Technical English 的权利属于 ASD。如需研读 ASD-STE100 英文原版标准，可在其官网免费申请。 --- ## 核心文件 | 路径 | 说明 | | --------------------------- | --------------------------------------------------------------------------------- | | `SKILL.md` | skill 入口：生效机制、适用范围、25 条核心规则、5 种标准化输出模板及自检清单 | | `references/terminology.md` | 术语字典：ASD-STE100 关键词译法、受控情态词、虚化动词替换表、固定状态词与标点规范 | | `examples/result-report.md` | 单任务结果汇报改写示例（改写前后对比） | | `examples/task-summary.md` | 多任务与迭代需求总结改写示例（改写前后对比） | --- ## 许可证基于 MIT 协议开源。详见 [LICENSE](LICENSE)。 --- ## 作者的其他项目欢迎体验作者 [dualface](https://github.com/dualface) 的其他项目： - [Kander](https://github.com/dualface/kander)：规则驱动的多 Agent 看板调度工具，内置独立审核与自动化交付门禁。 - [Ullage](https://github.com/dualface/ullage-cli)：本地守护进程与 CLI 工具，查看 Claude、ChatGPT、Grok、Cursor 等订阅的用量。 - [QuickTUI](https://quicktui.ai/)：适用于各类编码 Agent 的手机端完整终端，支持自托管直连，单台主机免费。

正在加载仓库 README…

这个仓库中的 skills

职业分类待补全

skill

职业分类

描述

更新

ste

未分类

Make the agent report results to the user by the ASD-STE100 (Simplified Technical English) principles, in Chinese: key information first, one word one meaning, one fact per sentence, fixed status words, honest verification state, short sentences. Once active,…

2026-10-11

已展示 1 / 1 个已收集 Skill。

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/dualface/ste-zh.

dualface/ste-zh

仓库 README

相关分享

这个仓库中的 skills

ste

用 AI 助手安装

仓库 README