mcpField
C
clear-writing

clear-writing

github.com/ashryaagr其他5039 次安装4 周前更新
代码仓库

关于 clear-writing

这项写作技能通过清晰结构、常用词和简洁句子,让说明更易理解。适用于需要易读文本且要保留事实、不确定性和作者语气的场景;严格遵循 ASD-STE100 时须查阅官方资料。

主要功能

  1. 01识别读者的问题
  2. 02先说明核心观点
  3. 03优先使用常见词和主动语态
  4. 04统一术语用法
  5. 05精简句子与段落
  6. 06区分风格草稿与合规验证

适用场景

  1. 01改写晦涩的说明文字
  2. 02理清操作说明和流程
  3. 03撰写借鉴 ASD-STE100 的草稿
  4. 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 风格

  1. 明确读者的问题,以及回答问题所需的事实。
  2. 先讲主要观点,再按有用的顺序展开说明。
  3. 使用常见词语、具体主语和主动动词。定义必要的术语。
  4. 每个概念只使用一个名称。删除装饰性的同义词和套话。
  5. 描述性句子尽量不超过 25 个词,指令句不超过 20 个词。 每段只讨论一个主题;超过六个句子的段落应拆分。
  6. 每个句子只给出一条指令。先说明前提条件,再说明操作。 将过长的名词组拆分为短语,清楚表达各部分之间的关系。
  7. 删除不必要的词语,然后通读全文,检查含义。保留事实、不确定性、单位、例外情况和用户的语气。自然的表达有助于理解时,应予以保留。

返回用户要求的文本。只有在有帮助或用户提出要求时,才补充修改说明。

用户要求严格遵循 ASD-STE100 时

请阅读所请求版本的官方副本中相关的写作规则和词典。否则,使用第 9 版,并先检查官方网站是否有更新。 根据用户的专业领域或经批准的术语表,识别技术名词和动词。 根据词语经批准的含义、词性和允许形式进行检查。 根据内容属于程序性还是描述性,应用相应规则,包括该标准的词数计算规则。使用参考资料中的规则索引查找相关章节。

如果无法获取官方规则、词典或必需术语,请提供明确标注为借鉴 STE 风格的草稿,并说明哪些内容尚未核实。严格核验时,请索取缺失的参考资料。不要仅凭短句、模型记忆或所附图片声称符合标准。对于严格遵循标准的草稿,请报告所用版本和已完成的检查;明确区分起草与合规核验。

示例

修改前:“操作员务必确保阀门在操作前已关闭。”

修改后:“开始操作前,请关闭阀门。”

这展示了该风格,并不表示整份文档都符合标准。

评论

支持 Markdown