前言¶
在 DSH 里写技术文档或给智能体定回复风格时,常见做法是在单次对话里重复说明「用简单句、主动语态、控制句长」。这类约束很难跨会话保持一致,也不方便在生成文档时统一套用同一套规范。
下面介绍维护者 yang1604454533-netizen 的 dsh-ASD-100(GitHub:yang1604454533-netizen/dsh-ASD-100)。它在 DSH 侧以插件形式工作:开启后,会在每一次请求的系统提示中追加 ASD-STE100 简化技术英语(Simplified Technical English)写作规则,使回复与文档输出尽量符合 STE 写法。社区目录 SkillHub 将其归类为「模型推理」,当前版本为 0.1.0(MIT 许可证)。
这是什么¶
dsh-ASD-100 是一个 DSH 插件,核心目标是强制(在模式开启时)所有回复与文档输出遵循 ASD-STE100 简化英语规则,而不是仅在个别 prompt 里临时提醒。
规则来源有三层优先级(实现见仓库 lib/index.js):
- 若存在
~/.agents/skills/simple-english/SKILL.md,使用该副本(可自行编辑规则)。 - 否则使用插件自带的
skills/simple-english/(源自simple-englishagent skill,MIT,对应 ASD-STE100 Issue 9,技能版本 2.1.1)。 - 若以上均不存在,则回退到内置的九行规则集。
插件仅依赖 Node 内置模块,无 npm 依赖;运行环境要求 Node.js >= 18。
核心功能¶
模式开启时,插件向每次请求的系统提示追加一段「常驻」说明,概括 STE 写作约束,包括但不限于:
- 过程句不超过 20 词,描述句不超过 25 词。
- 一句一个指令;主动语态;简单时态。
- 条件写在命令之前;一词一义。
- 不用分号、不用长破折号、不用缩写。
- 先回答问题,正文仅用散文体(prose)。
开关状态由单一标志文件表示,所有会话共享,修改后立即生效。
命令与状态¶
在对话中使用以下命令(README 中 /asd-100 可作为别名):
/asd100 on # 开启 STE 输出模式
/asd100 off # 关闭
/asd100 # 查看当前开/关状态
默认状态文件路径:
~/.dsh/dsh-asd-100/.active
插件在每次请求时读取该文件。若要在聊天外关闭模式,删除 .active 文件即可。
安装与 bundle 配置¶
仓库通过 cordis.patch.yml 作为 bundle patch 加载插件(见 package.json 中 dsh.bundle.patch)。已抓取资料中未给出统一的 CLI 安装命令行原文;在 SkillHub 目录页标注为可安装插件时,应以目录页与 GitHub README 当前说明为准,安装前请阅读源码与 MIT 许可证。
可选配置写在加载插件的 bundle patch 中,例如:
- insert:
- id: dsh-asd-100
name: dsh-asd-100
config:
skillDir: /path/to/simple-english # 默认:~/.agents/skills/simple-english,其次为插件内置 skills
stateFile: /path/to/.active # 默认:~/.dsh/dsh-asd-100/.active
skillDir 决定规则文本从何处读取;stateFile 可自定义开关标志路径。
典型用法¶
- 完成插件接入 DSH bundle 后,在会话中执行
/asd100 on。 - 继续正常提问或让智能体生成技术说明;系统提示中会附带 STE 规则段。
- 需要恢复默认写作风格时执行
/asd100 off,或删除状态文件。 - 若团队有定制 STE 细则,在
~/.agents/skills/simple-english/SKILL.md维护副本即可覆盖插件内置规则。
本地开发与自测(来自 README):
node --test test/ste.test.mjs
适用场景与注意¶
适合谁
- 需要在 DSH 中长期输出符合 ASD-STE100 风格的技术英文文档、操作说明或对外材料。
- 希望规则与开关全局一致,而不是每个项目重复写 system prompt。
注意
- 插件在当前 DSH 进程权限下运行;安装或启用前应自行审查
lib/index.js及skills/内容。 - DSH 生态强调「一切皆插件」;SkillHub(https://www.skillhub.cn/plugins/yang1604454533-netizen/dsh-ASD-100)为社区目录,与 DeepSeek / 幻方无官方从属关系。
- 目录页简介中出现的
/ste与 README 文档中的/asd100命令命名不一致;以 GitHub README 为准使用/asd100(及/asd-100别名)。
结尾¶
dsh-ASD-100 把 ASD-STE100 简化英语规则做成可开关的全局模式,适合在 DSH 里稳定约束英文技术写作。进一步了解与获取源码:
- SkillHub:https://www.skillhub.cn/plugins/yang1604454533-netizen/dsh-ASD-100
- GitHub:https://github.com/yang1604454533-netizen/dsh-ASD-100