clear-writing
Simplified Technical English (ASD-STE100)
来源:正文与附件原样取自 danyuchn/asd-ste100-skill 0.4.0(MIT,作者 Dustin Yuchen Teng);本仓库只改了名字、触发描述和「Documentation in This Workspace」一节指向的采用规则。上游英文正文里的破折号原样保留,不在本仓库的写作规则之内。
Documentation in This Workspace
Use this skill for every documentation task in this workspace. If the project's access point names documentation rules (the slot "文档写作规则"), read those rules. Otherwise read the default documentation rules. Read them before you write or revise documentation. For English, select Strict or STE-flavored from the document type. For Chinese, apply the clarity rules that do not depend on English grammar.
Keep the document owner's required structure, metadata, acceptance process, and delivery report. The default rewrite output format applies to standalone rewrite requests. Other skills retain their task scope and required output format. Preserve meaning when a style rule conflicts with necessary precision.
Background
ASD-STE100 is a controlled-language standard built by the aerospace and defense industry (ASD, the AeroSpace and Defense Industries Association of Europe) to stop maintenance technicians from misreading English instructions. The standard removes the two biggest sources of misreading: words with more than one meaning, and sentences with more than one possible structure.