simplified-technical-english
An Agent Skill that makes an LLM write in ASD-STE100 Simplified Technical English. Rules, approved word list, and a check tool.
- 评测生成时间(北京时间)
- 本报告引擎
- v3.16.0
- 当前引擎
- v3.16.0
规则版本一致,但报告只反映生成时的证据,不代表项目代码和安全状态始终不变。
进入后确认来源与额度,提交才会创建任务。
综合采用结论
证据充分,整体质量与安全表现优秀
- 基础评测完成+25/25确定性评分与静态安全扫描已完成
- README 有效证据+8/253,025 个去重后的有效字符
- 独立证据来源+8/202 类非重复证据,重复文件不叠加
- 仓库元数据+10/10已取得仓库状态与采用数据
- 活跃记录+5/5已取得最近提交时间
- AI 复核+15/15已完成结构化 AI 证据复核
STE 写作与检查流程
SKILL.md 按 Step 1 至 Step 6 给出连续处理步骤,属单一任务顺序流程
左右滑动查看完整图示
- • SKILL.md Step 1:分类为程序文本或描述文本
- • SKILL.md Step 6:运行脚本或人工清单检查并修正
- 通过: Agent Skills 格式校验 1/1 个通过
- 通过: 1 个有效 Skill 含可核实的指令步骤或示例
- SKILL.md Step 3:程序句最多 20 词,描述句最多 25 词,段落最多 6 句
- SKILL.md Step 6:python3 scripts/ste_check.py --mode <procedural|descriptive> <file>
- README Limits:工具不能发现全部错误,不能判断词义是否合规
- README 安装:git clone 到 ~/.claude/skills/simplified-technical-english
- SKILL.md Scope:不适用于营销、诗歌、代码块、引用文本
- 问题与用途描述
- 有效 README
- 安装或接入步骤
- 可执行示例
- 通过: Agent Skills 格式校验 1/1 个通过
- 缺少限制、权限或边界
- 限制声明仅说工具不能发现全部错误,未给出误报率或已知漏检类型
- 词表来自 ASD 词典,许可边界依赖 NOTICE.md,README 未展开
- 未说明脚本对非英语或混合语言文本的行为
- 未提供脚本单元测试或版本兼容性说明
技术文档、手册、程序步骤的 STE 改写、需要受控语言以利翻译的航空航天/国防文本、希望用脚本做初步合规检查的写作者
营销文案或品牌文本改写、代码、命令、文件路径的改写、需要完全符合官方 ASD-STE100 认证的合规场景
也有自己的公开项目?先看完证据,再用当前规则生成独立报告。
评测我的项目 →静态扫描不是安全保证,生产接入前仍应人工复核权限和数据边界。
- 01补充限制、权限或边界
方法、证据与局限展开收起
GitHub Repository API
2 个文件 · 10,023 字符
v3.16.0 · AI 复核已启用(deepseek-flash)
- 静态评测不会安装或执行项目代码
- 安全扫描基于高信号文件与已知模式,不能替代人工审计
- 流行度只反映采用程度,不代表安全或工程质量
30 天热度趋势
README
Simplified Technical English skill
This skill makes an LLM write in Simplified Technical English (STE). STE is a controlled language for technical documentation. The specification ASD-STE100 gives the rules of STE and its dictionary. The aerospace and defense industries use STE for their manuals. Text in STE is clear, short, and easy to translate.
The skill obeys the rules that it gives. This README is in STE.
Example
Text before the change:
Prior to commencing the installation, it should be ensured that all components have been thoroughly inspected for damage.
Text after the change:
Before you start the installation, examine all the components for damage.
Contents of this repository
| File | Function |
|---|---|
SKILL.md | The primary instructions for the LLM |
references/writing-rules.md | The 53 writing rules, with examples |
references/word-list.md | The 869 approved words |
references/substitutions.md | Replacements for frequent unapproved words |
examples/before-after.md | Examples of text before and after the change |
scripts/ste_check.py | A check tool for the STE rules |
NOTICE.md | Copyright information |
How to install the skill for Claude
-
Clone this repository into your skills folder:
git clone https://github.com/0xpili/simplified-technical-english.git ~/.claude/skills/simplified-technical-english -
Tell Claude to write or examine technical text in STE.
-
Claude finds the skill and obeys the rules.
You can also start the skill directly. Type /simplified-technical-english.
How to use the skill with a different LLM
- Open
SKILL.md. Copy its text into the system prompt of the LLM. - If the LLM accepts more text, add the text of
references/substitutions.md. - For the best results, also add the text of
references/word-list.md. - Tell the LLM to write technical text.
How to do a check of a text
Run the check tool on a file or on standard input:
python3 scripts/ste_check.py --mode procedural draft.txt
python3 scripts/ste_check.py --mode descriptive chapter.md
The tool finds these errors:
- Sentences that have too many words
- Paragraphs that have more than six sentences
- Verb forms that are not approved, and the passive voice
- Semicolons, contractions, and unapproved helping verbs
- Words that are not in the approved word list.
The tool uses only Python 3. The tool shows each error and its rule number.
Limits of the skill
The tool cannot find all the errors. The tool cannot know if a word has its approved meaning. A person who knows STE must also examine an important text. This skill is not an official ASD document. This skill cannot make sure that your text obeys the official specification fully.
Source and copyright
The source of this skill is ASD-STE100 Issue 7 (2017).
ASD releases new issues of the specification.
You can get the specification free of charge from https://www.asd-ste100.org.
The dictionary of ASD-STE100 is the property of ASD. Refer to NOTICE.md.
The text of this skill and its scripts have the MIT license. Refer to LICENSE.