关于 clear-writing
这项写作技能通过清晰结构、常用词和简洁句子,让说明更易理解。适用于需要易读文本且要保留事实、不确定性和作者语气的场景;严格遵循 ASD-STE100 时须查阅官方资料。
主要功能
- 01识别读者的问题
- 02先说明核心观点
- 03优先使用常见词和主动语态
- 04统一术语用法
- 05精简句子与段落
- 06区分风格草稿与合规验证
适用场景
- 01改写晦涩的说明文字
- 02理清操作说明和流程
- 03撰写借鉴 ASD-STE100 的草稿
- 04核对严格 STE 写作要求
MCP 相关
输入未说明 MCP 集成方式。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ashryaagr/ karpathy-output-style --skill clear-writing安装后在 Claude Code 中输入/clear-writing确认已加载。
附带文件references/asd-ste100.md
详细介绍
清晰写作
清楚地解释主题,让读者无需费力解读文字就能理解。 遵循 Karpathy 的建议,达到“80% 接近 ASD-STE100”。 这句话描述的是一种风格偏好,而不是合规评分。
请阅读标准参考资料,了解准确的标准、示例,以及对推文所附图片的修正。 基准为 ASD-STE100 简化技术英语,第 9 版(2025-01-15)。
默认:易读,借鉴 STE 风格
- 明确读者的问题,以及回答问题所需的事实。
- 先讲主要观点,再按有用的顺序展开说明。
- 使用常见词语、具体主语和主动动词。定义必要的术语。
- 每个概念只使用一个名称。删除装饰性的同义词和套话。
- 描述性句子尽量不超过 25 个词,指令句不超过 20 个词。 每段只讨论一个主题;超过六个句子的段落应拆分。
- 每个句子只给出一条指令。先说明前提条件,再说明操作。 将过长的名词组拆分为短语,清楚表达各部分之间的关系。
- 删除不必要的词语,然后通读全文,检查含义。保留事实、不确定性、单位、例外情况和用户的语气。自然的表达有助于理解时,应予以保留。
返回用户要求的文本。只有在有帮助或用户提出要求时,才补充修改说明。
用户要求严格遵循 ASD-STE100 时
请阅读所请求版本的官方副本中相关的写作规则和词典。否则,使用第 9 版,并先检查官方网站是否有更新。 根据用户的专业领域或经批准的术语表,识别技术名词和动词。 根据词语经批准的含义、词性和允许形式进行检查。 根据内容属于程序性还是描述性,应用相应规则,包括该标准的词数计算规则。使用参考资料中的规则索引查找相关章节。
如果无法获取官方规则、词典或必需术语,请提供明确标注为借鉴 STE 风格的草稿,并说明哪些内容尚未核实。严格核验时,请索取缺失的参考资料。不要仅凭短句、模型记忆或所附图片声称符合标准。对于严格遵循标准的草稿,请报告所用版本和已完成的检查;明确区分起草与合规核验。
示例
修改前:“操作员务必确保阀门在操作前已关闭。”
修改后:“开始操作前,请关闭阀门。”
这展示了该风格,并不表示整份文档都符合标准。
评论
支持 Markdown