ste

GitHub

用于将文本重写为符合ASD-STE100标准的简化技术英语。需显式调用,严格限制句子长度、动词形式及词汇,区分程序性与描述性文本,确保技术文档的清晰与规范。

.opencode/skills/ste/SKILL.md penpot/penpot

触发场景

用户明确输入 /ste 用户明确要求使用 ste skill

安装

npx skills add penpot/penpot --skill ste -g -y
更多选项

非标准路径

npx skills add https://github.com/penpot/penpot/tree/develop/.opencode/skills/ste -g -y

不安装直接使用

npx skills use penpot/penpot@ste

指定 Agent (Claude Code)

npx skills add penpot/penpot --skill ste -a claude-code -g -y

安装 repo 全部 skill

npx skills add penpot/penpot --all -g -y

预览 repo 内 skill

npx skills add penpot/penpot --list

SKILL.md

Frontmatter
{
    "name": "ste",
    "description": "Write or rewrite text in ASD-STE100 Simplified Technical English. ONLY use this skill when the user explicitly invokes it by name — i.e. they type \"\/ste\" or literally write \"use the ste skill\" \/ \"apply ASD-STE100\". Do NOT trigger it on paraphrased intent such as \"simplify this\", \"make it clearer\", \"write technical documentation\", or \"shorter sentences please\" — the user has deliberately scoped this skill to explicit invocation only. For those requests, respond normally without loading this skill unless they name it."
}

ASD-STE100 Simplified Technical English

Apply the ASD-STE100 standard to all prose you produce in this task. Do not announce that you use STE, do not name the standard, and do not explain the style unless the user asks. If the user later asks you to "write more naturally," ask one short question to confirm they want to leave STE before you drop it.

Compliance note (for you, not for output): the official specification and its dictionary are copyright ASD. This skill encodes paraphrased rules and a publicly sourced word list. For certified aerospace/defense deliverables, tell the user that full compliance requires the free official specification (asd-ste100.org) and a human sign-off. Never claim certified compliance.

Step 0 — Classify the text

Before writing a single sentence, decide: is this procedural text (instructions someone follows) or descriptive text (explanation, background, description)? Every limit below depends on this. Mixed documents get classified section by section.

Core rules

Sentences

  • Procedural: maximum 20 words per sentence.
  • Descriptive: maximum 25 words per sentence.
  • Maximum 6 sentences per paragraph. One topic per paragraph.
  • One instruction per sentence. Two actions in one sentence only if they occur at the same time.
  • Put a condition BEFORE its command: "If the pressure decreases, close the valve."
  • Do not omit articles, subjects, or verbs to save words. "Ensure file exists" is wrong; "Make sure that the file exists" is correct. Keep the word "that" after verbs like "make sure."
  • Numbers, units with numbers, abbreviations, quoted strings, code identifiers, and proper nouns each count as one word.

Verbs

  • Allowed forms only: infinitive, imperative, simple present, simple past, simple future, and past participle used as an adjective.
  • Never use present perfect or continuous forms. "We have received" → "We received." "is being tested" → a simple form.
  • Never use an -ing form as a verb. An -ing word is allowed only inside a technical name ("the mounting bracket," "logging").
  • Active voice. Passive is allowed only in descriptive text when the agent is unknown or unimportant.
  • Instructions use the imperative: "Open the panel," not "You must open the panel" or "The panel should be opened."
  • Express actions as verbs, not nouns: "compress the file," not "perform compression of the file."
  • Modals: use can (possibility), will (future), must (requirement). Do not use should, would, could, may, might. A hedge becomes a fact or a "can": "an explosion can occur."
  • No phrasal verbs: "go down" → "decrease," "set up" → "install," "carry out" → "do."

Words

  • One word, one meaning, one part of speech, used consistently. Never rotate synonyms: pick one name for a thing and repeat it.
  • Before drafting, replace unapproved vocabulary. Read references/word-substitutions.md and apply it; it is the working dictionary for this skill.
  • Domain-specific nouns (part names, tool names, product names, UI labels) and domain verbs (drill, ream, boot, compile) are your technical nouns/verbs — keep them as-is, use each consistently, and do not verb a noun or noun a verb.
  • Noun clusters: maximum 3 words ("overhead panel light" is the limit). Longer clusters get decomposed with prepositions or hyphenated on first use: "main-gear-door retraction-winch handle."
  • American English spelling.
  • No Latin abbreviations: "e.g." → "for example," "i.e." → "that is," delete "etc."

Punctuation

  • No semicolons — write two sentences.
  • Parentheses only for references, abbreviations, and item numbers.
  • Hyphenate words that act as one unit; a hyphenated word counts as one word.
  • No contractions.

Warnings, cautions, notes

  • WARNING = risk of injury or death. CAUTION = risk of damage. NOTE = information only, never an instruction.
  • Start a warning or caution with the command or condition, then give the risk: "WARNING: Do not touch the terminal. The terminal has a dangerous voltage."
  • Notes obey the 25-word descriptive limit.

Step 2 — Self-check pass

After drafting, scan your text once for each of these and fix every hit before you respond:

  1. Any sentence over the 20/25-word limit for its type
  2. Contractions, semicolons
  3. "should," "would," "could," "may," "might"
  4. "has been," "have been," "had been," "is being," "was being"
  5. -ing words used as verbs
  6. Missing articles (a/an/the/this) before nouns
  7. Synonym rotation (the same object under two names)
  8. Any word in the unapproved column of references/word-substitutions.md
  9. Warnings that state the risk before the command

Reference files

  • references/word-substitutions.md — unapproved → approved word mappings and one-meaning rulings. Read it before drafting; it is short.
  • references/examples.md — worked before/after rewrites (procedural, descriptive, warnings, common mistakes). Read it when rewriting existing text or when unsure how a rule applies.

What NOT to touch

Code blocks, command strings, file paths, error messages, quoted UI text, and proper nouns stay exactly as written. STE applies to the prose around them.

版本历史

  • 2dcf1a8 当前 2026-08-20 19:20

同 Skill 集合

.opencode/skills/bat-cat/SKILL.md
.opencode/skills/code-review-and-quality/SKILL.md
.opencode/skills/code-review/SKILL.md
.opencode/skills/create-commit/SKILL.md
.opencode/skills/create-issue/SKILL.md
.opencode/skills/create-pr/SKILL.md
.opencode/skills/fd-find/SKILL.md
.opencode/skills/jq-json-processor/SKILL.md
.opencode/skills/nrepl-eval/SKILL.md
.opencode/skills/plan-review/SKILL.md
.opencode/skills/planner/SKILL.md
.opencode/skills/refine-prompt/SKILL.md
.opencode/skills/ripgrep/SKILL.md
.opencode/skills/security-and-hardening/SKILL.md
.opencode/skills/taiga/SKILL.md
.opencode/skills/testing/SKILL.md
.opencode/skills/update-changelog/SKILL.md

元信息

文件数
0
版本
2ce202c
Hash
258ef722
收录时间
2026-08-20 19:20

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-09-16 20:40
浙ICP备14020137号-1