dsh-plugin-buildlisted
Install: claude install-skill taxueseek/plugin-fast-adapt
# 造插件车道
两件事:没有插件时造一个能跑的起点;写完之后过一道体检门,别带着契约错误去装。以下命令都相对工具根目录执行,工具根即本文件真实路径往上两级、含 `scripts/` 的那一层。脚本用自身文件的绝对路径定位,不必先 cd,从任何目录直接 `node <工具根>/scripts/<脚本>.mjs` 同样可行。本目录常以软链别名加载,shell 的 `cd ../..` 会按软链走错地方,确实要 cd 时用 `cd "$(realpath <本文件所在目录>)/../.."`。
## 一条命令生成可运行插件
```sh
node scripts/scaffold.mjs <namespace>/<name> --form tool|hook|service|config|llm-adapter [--out <目录>] [--harness <版本>] [--no-smoke]
```
它只做确定性的事,不碰裁量:
- **五件套生成**:`package.json`(免构建纯 ESM 不变量:`type: module`、main 与 exports 双指 `lib/index.js`、files 含挂载层)、按形态的完整入口实现(tool 用 raw JSON Schema 注册、hook 走 waterfall 并显式 `next()`、service 继承宿主 Service 并注册服务名、config 导出真 Schemastery Schema、llm-adapter 继承宿主 LlmAdapter 并注册路由;入口里的能力是能跑通的起点实现,换成你的即可)、`cordis.patch.yml` 最小挂载条目(没有它装了不生效,`env-doctor` 的 activation 查的就是这层)、`dsh-plugin.naming.json`、README 加 `.gitignore`
- **命名投影**:loader id、service、tool、command、skill、event、route 全部按上游 naming-conventions 的 collision-resistant 规则从 coordinate 推导,生成物已过上游 validate-names 的 `--strict` 校验(0 错误 0 警告)
- **当场验证(两层,缺一层报一层)**:tool/hook 走零依赖内存冒烟;五形态都走真基类装载,本机装了宿主时用真实 `@deepseek-ai/*` 基类 import 入口,验基类 API 用对没对(Service 继承与 `super(ctx, name)`、Schema 真校验、LlmAdapter 继承与路由注册)。本机没装宿主时如实跳过,不伪造通过
目标目录非空即拒绝(不动用户文件);非法 coordinate 在写盘前拒绝。生成物保证「能装载、契约成立、能力可跑」,完整契约仍以真源文档为准:
| 需求 | 去 where |
| --- | --- |
| 五形态完整契约(execute 义务、waterfall 语义、Schema 规则、协议义务清单) | [原仓库 plugin-write skill](https://github.com/oh-my-dsh/dsh-plugin-upgrade-skill/tree/main/skills/plugin-write) 的五份 form reference |
| 公共命名规范与注册表冲突检查 | plugi