用途:为操作员和流程性文本套用源自 ASD-STE100 的简化技术英语语域,适合运行手册、安装步骤、错误与警告、命令与技能说明、检查清单等。不适用于文档字符串、ADR、设计理由、书籍与博客内容、提交信息正文及本仓库自身的说明性文档。
主要能力:采用四条限制——流程句 20 词、描述句 25 词、每段 6 句、名词簇 3 词;另加每句一条指令、流程用主动语态、仅简单时态、不用缩写、不用分号、美式拼写。提供三项需计数的代码检查与四项正则检查。
使用方式:运行 cd plugins/scribe && PYTHONPATH=src uv run python -m scribe.ste FILE.md,输出格式为 file:line: [rule/confidence] detail,命令可读文件即退出 0,检查仅供参考,名词簇规则不得用于合并门禁;加 --no-noun-clusters 只看两条计数规则。正则检查需先屏蔽代码、表格与 frontmatter。
限制:这是 STE 衍生的写作辅助,不是 ASD-STE100 实现,输出不得称为 STE 合规;受控词典不可再分发,词汇检查不在范围内。名词簇发现为低置信度,不应据此改写。61% 句子无法分类,检查偏于少报,干净运行证据较弱。