SuperAPI AI 工具集

simplified-technical-english

写作与研究

查看项目

更新于 10-16 01:12

技能介绍

用途:按 ASD-STE100 Issue 9 受控语言规则编写和审校技术文本,用于技术文档、代码注释、操作步骤和软件文本。项目术语与技术准确性优先于一般语言偏好。

主要能力:提供核心写作规则、程序、描述与注释、安全说明、代码注释与软件文本、情态动词及最终检查清单;可加载写作规则参考做精确规则映射或详细审校,词汇细节重要时加载词典参考。

使用方式:先确定读者、任务与所需结果,将文本分类为程序、描述、注释或安全说明,识别已批准的项目术语与标识符,每个概念只用一个术语,写出最小完整陈述,再应用规则并逐句复查。完成标准为保留技术含义、术语一致、无未解决歧义,并包含必要条件、动作、结果与风险。

规则要点:用常见具体词;主动语态,仅当施动者未知时用被动;每个动作用明确动词;多词名词不超过三个词;不用缩写、分号与未批准短语动词;程序句最多 20 词且每句一条指令,描述与注释句最多 25 词;安全说明用项目风险标签,警告用于伤亡风险,小心用于损坏风险。

源码核验:不要把完整源 PDF 载入上下文;从官方 Issue 9 请求页获取,保存为 assets/ASD-STE100-ISSUE-9.pdf,设置 ASD_STE100_PDF 指向该路径。需要精确核验时运行有界搜索脚本,只读返回摘录与引用页,单次问题最多提取相邻三页。命令:uv run scripts/search_issue_9.py "Rule 5.3";uv run scripts/search_issue_9.py --word "may";uv run scripts/search_issue_9.py --pdf ./assets/ASD-STE100-ISSUE-9.pdf "Rule 5.3"。

限制:未做完整审校不得声称完全符合 ASD-STE100,不得声称获得认证或 ASD 认可。其他收费、平台与效果信息暂未提供。