跳到主要内容
Supermarket
返回能力市场
Claude Skill
programming
NOASSERTION

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.

0xpili0xpili
84/ 100

公开评测 · 综合采用结论

证据充分,整体质量与安全表现优秀

查看评测依据 评测我的项目基于公开项目证据,非安全认证或安装推荐
750stars
34forks
最近更新 1个月前
评测生成时间(北京时间)
本报告引擎
v3.16.0
当前引擎
v3.16.0

规则版本一致,但报告只反映生成时的证据,不代表项目代码和安全状态始终不变。

重新评测此项目

进入后确认来源与额度,提交才会创建任务。

Evaluation report

综合采用结论

84
B
满分 100
值得推荐低风险
决策摘要

证据充分,整体质量与安全表现优秀

71%
中置信度
88
文档
100
安全
85
质量
72
活跃
44
采用
  • 基础评测完成+25/25确定性评分与静态安全扫描已完成
  • README 有效证据+8/253,025 个去重后的有效字符
  • 独立证据来源+8/202 类非重复证据,重复文件不叠加
  • 仓库元数据+10/10已取得仓库状态与采用数据
  • 活跃记录+5/5已取得最近提交时间
  • AI 复核+15/15已完成结构化 AI 证据复核
How it works · 流程图

STE 写作与检查流程

SKILL.md 按 Step 1 至 Step 6 给出连续处理步骤,属单一任务顺序流程

AI 提取 · 证据约束

左右滑动查看完整图示

STE 写作与检查流程SKILL.md 按 Step 1 至 Step 6 给出连续处理步骤,属单一任务顺序流程确定类型约束输出生成文本报告错误再次检查分类文本应用规则写作改写运行检查修正错误
图示依据
  • • SKILL.md Step 1:分类为程序文本或描述文本
  • • SKILL.md Step 6:运行脚本或人工清单检查并修正
五维表现
把 ASD-STE100 规则、词表与检查脚本封装为可安装 Skill,示例与命令具体,价值可验证;最大缺口是检查工具能力边界与词表版权/许可细节仅靠 NOTICE 说明,未展示脚本内部实现。
质量证据
  • 通过: 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 认证的合规场景

也有自己的公开项目?先看完证据,再用当前规则生成独立报告。

评测我的项目 →
文档证据
88/100
问题与用途描述10 分
有效 README12 分
安装或接入步骤14 分
可执行示例16 分
输入、参数或工具说明11 分
输出或结果说明9 分
限制、权限或边界12 分
错误处理或排障8 分
许可证信息5 分
结构化章节3 分
安全证据
低风险
未发现已知高风险模式

静态扫描不是安全保证,生产接入前仍应人工复核权限和数据边界。

优先改进清单
  1. 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

FileFunction
SKILL.mdThe primary instructions for the LLM
references/writing-rules.mdThe 53 writing rules, with examples
references/word-list.mdThe 869 approved words
references/substitutions.mdReplacements for frequent unapproved words
examples/before-after.mdExamples of text before and after the change
scripts/ste_check.pyA check tool for the STE rules
NOTICE.mdCopyright information

How to install the skill for Claude

  1. Clone this repository into your skills folder:

    git clone https://github.com/0xpili/simplified-technical-english.git ~/.claude/skills/simplified-technical-english
    
  2. Tell Claude to write or examine technical text in STE.

  3. 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

  1. Open SKILL.md. Copy its text into the system prompt of the LLM.
  2. If the LLM accepts more text, add the text of references/substitutions.md.
  3. For the best results, also add the text of references/word-list.md.
  4. 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.