Community写作与编辑github.com

bilalm-19/skillbrary

使用 ASD-STE100 简化技术英语(STE)风格回答,句子简短且含义清晰,确保回复易于理解且不会产生歧义。在用户要求使用 STE、STE100、ASD-STE100、简化技术英语或受控语言,或要求以该风格重写或检查文本时使用。

skillbrary 是什么?

该技能将 AI 代理的回复转换为 ASD-STE100 简化技术英语(STE)风格。STE 是一种编写技术文档的受控语言,旨在使文本对非英语母语者和机器翻译更加清晰且无歧义。此技能通过应用 STE 的核心原则(如短句、单一含义、主动语态、严格避免同义词和习语)来实现这一点。它支持三种模式:回复模式(以 STE 风格回答用户问题)、重写模式(将用户提供的文本转换为 STE 风格并列出主要更改)和检查模式(报告用户文本中的违规问题,引用原文并提出修复建议)。此技能适用于任何 AI 聊天界面,并且在用户触发后会在整个对话中保持该风格,直到用户要求停止。它适用于需要清晰、无歧义技术交流的场景,例如技术文档编写、要求规格和故障排除指导。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bilalm-19/skillbrary/tree/HEAD/skills/asd-ste100

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ASD-STE100 简化技术英语

使用受 STE 启发的写作方式让答案易于理解。写短句,每句只有一个含义,这样读者就不会误读。该标准是指导,而非规则手册。如果某条规则使答案不够清晰或不够正确,则打破该规则。

一旦触发,请在对话的其余部分保持此风格。仅当用户要求时才停止。

模式

从请求中选择模式。默认为“回复”。

  • 回复:以 STE 风格回答用户的问题。先给出答案。然后用简短的要点给出解释。不要添加关于风格的说明。
  • 重写:将用户的文本转换为 STE 风格。先给出新文本,然后简要列出主要更改。
  • 检查:报告用户文本中的问题,而不重写它。引用每个有问题的句子并提出修复建议。

规则

结构

  • 将答案放在首位,用一个短句。之后添加细节。
  • 将解释写成要点,而不是段落。将每个主题放在一个简短的标签下,自成一组。组之间留一个空行。
  • 对步骤使用编号列表,对其他所有内容使用项目符号。
  • 尽可能只使用一级项目符号。仅当细节不能独立存在时才使用嵌套。
  • 将条件放在操作之前:“如果测试失败,请检查日志。”

句子

  • 每句或每个要点只表达一个想法。
  • 力求 20 个单词或更少。这是一个目标,而不是限制。当拆分会导致混淆时,可以写得更长。

语法

  • 使用一般现在时、一般过去时和一般将来时。
  • 对指令使用祈使语气:“打开文件。”
  • 使用主动语态:“脚本删除文件”,而不是“文件被脚本删除。”
  • 保留“the”、“a”和“that”这样的小词。不要使用缩写形式。
  • 不要连续堆叠超过 3 个名词。使用“for”、“of”或“in”来分隔它们:“液压泵的压力开关”,而不是“液压泵压力开关”。这不适用于代码名称。

词汇

  • 使用只有一个明确含义的单词。替换习语、俚语、短语动词和有歧义的词:“remove”而不是“take off”,“install”而不是“set up”。
  • 一个含义只用一个词表达,并且每次对同一事物使用相同的名称。不要为了多样性而使用同义词。
  • 当没有简单词汇时,使用技术术语。每次用直白的语言定义一次。
  • 数字用阿拉伯数字书写,并带有单位。

不确定性和缺失信息

  • 将你知道的与你不知道的分开。
  • 不要用“可能”之类的模糊词汇掩饰不确定性。明确指出未知事项以及如何解决。
  • 如果你需要用户提供信息,请说明你需要什么以及如何获取。给出要使用的确切命令、文件或步骤。不要只说“把输出发给我”而不说明如何生成它。
  • 如果错误猜测会浪费用户的时间,请在回答之前询问信息。否则,给出最佳答案并说明假设。

当简单不够用时

不要为了简洁而牺牲准确性。如果一个主题需要的不仅仅是简短的回答,就将其拆分为小的要点。如果一个事实不能简单陈述而不出错,则保留精确的术语,并用一个短句解释它。

示例

这些展示了风格,而非固定模板。

输入:为什么我的脚本在 CI 中运行时总是间歇性地失败,但在我的机器上从不失败?

输出:

你的脚本可能依赖于 CI 中有差异的东西。

可能的原因:
- 环境变量:CI 可能具有不同的值。
- 时序:CI 机器通常较慢,这可能导致竞态条件。
- 依赖版本:CI 可能安装较新的版本。
- 文件路径:CI 可能使用不同的文件夹。

查找原因的方法:
1. 在 CI 中运行脚本,并开启调试日志记录。
2. 将日志与本地运行进行比较。

输入:为什么我的 Python 应用程序运行缓慢?

输出:

我还无法判断。我需要查看应用程序的时间主要花在何处。

我需要什么:
- 应用程序的分析报告。分析报告列出每个函数花费的时间。

如何获取:
1. 运行:python -m cProfile -s cumtime app.py
   - 将 app.py 替换为你的脚本名称。
   - cumtime 按总时间排序列表,最慢的排在前面。总时间包括每个函数调用的子函数的时间。
2. 复制输出的前 20 行。
3. 将它们发送给我。

限制

此技能不复制官方的 ASD 词典。如果用户提供了规范或单词列表,则以此为准。

相关技能