ableclaw/ablemind-dsh-plugin-skill

develop-dsh-plugin

一个用于构建树外 DeepSeek Harness (dsh) 插件的 agent 技能。

dsh 没有可供打补丁的特权核心：产品的每一部分都是插件，你通过在其他包旁边挂载一个包来扩展它。本技能将这种架构转化为一套可执行的工作流——先研究现有接口面，通过设计门禁，经由有文档记录的接缝挂载，针对真实组合进行验证，并干净地卸载。

以 SKILL.md 包的形式编写，因此它可在任何扫描技能目录的 agent 运行时中工作
（Claude Code、dsh 自带的 skill-filesystem，以及类似者）。

它做什么

工作流共七步，每一步都有明确的停止条件：

1. 设计前先研究 —— 检查官方包、社区插件，以及目标项目已安装的组合。当已安装的东西已经拥有该接口面时，不要创建插件。
2. 通过设计门禁 —— 用一句话说明能力所有者、接缝、Host/Client、模型可见性、持久性，以及卸载边界。
3. 脚手架 —— 从捆绑模板生成一个最小的可构建 Host 插件。
4. 在接缝内实现 —— 具名的 name/inject/Config/apply 导出，服务优先于导入，fiber 拥有的可逆效果，配置错误要大声失败。
5. 验证真实插件 —— 八个逐级升级的证据层级，最终落在真实的 Loader 组合、真实会话和卸载检查上。
6. 打包并发布 —— 导出、固定运行时依赖、打包文件、bundle 引用。
7. 如实报告 —— 确切的命令和真实证据；绝不凭源码检查就声称完成。

布局

SKILL.md                              主工作流
references/
package-contract.md                 包形态、清单、导出、bundle
seam-router.md                      某项能力应归属哪个接缝
validation-and-casebook.md          证据层级；真实缺口 vs. 运行痕迹
assets/minimal-host-plugin/           仅 Host 的起始模板
scripts/
scaffold_plugin.py                  从模板生成插件
audit_plugin.py                     确定性的包形态审计
test_scripts.py                     上述两个脚本的测试
agents/openai.yaml                    agent 接口面元数据

安装

克隆到你的 agent 所扫描的任一技能根目录，保持目录名为 develop-dsh-plugin：

Claude Code（用户范围）
git clone https://github.com/ableclaw/ablemind-dsh-plugin-skill.git \
~/.claude/skills/develop-dsh-plugin

dsh —— 用户范围，或将 Config.customSkillDirs 指向父目录
git clone https://github.com/ableclaw/ablemind-dsh-plugin-skill.git \
~/.dsh/skills/develop-dsh-plugin

dsh 的 skill-filesystem 不扫描嵌套目录树，因此请逐个链接或克隆每个技能目录。

在不使用本技能的情况下使用这些脚本
两个脚本都是独立的 Python 3 脚本，无依赖。请从你目标运行时中获取这两个脚本的确切版本。

scaffold — 先检查 dry run；它会拒绝覆盖非空目录
python3 scripts/scaffold_plugin.py ./dsh-plugin-example \
--package-name dsh-plugin-example \
--dsh-version "$TARGET_DSH_VERSION" \
--cordis-version "$TARGET_CORDIS_VERSION" \
--dry-run

audit — 在构建后运行
python3 scripts/audit_plugin.py  \
--dsh-version "$TARGET_DSH_VERSION" \
--require-built

审计涵盖 manifest、导出、固定运行时依赖、脚本、打包文件、bundle 引用，以及常见的函数插件导出错误。它无法证明服务激活、重复挂载、模型行为、replay、UI 行为或清理——这些需要 skill 中的真实组合步骤。

范围

涵盖源码包：使用 Cordis 服务、类型化事件、模型工具、会话注入、slots、主题、bundles、patches、打包、加载、replay 和销毁的 Host 或 Client 插件。

不涵盖由 cordis_inspect_* / cordis_define / cordis_run 驱动的临时运行时定义的 Cordis 插件——那些属于不同的工作流，不应作为包进行脚手架搭建。

该 skill 指示 agent 读取目标仓库自身的 AGENTS.md / CLAUDE.md，并将其视为本地契约。它刻意不在不同 checkout 之间移植命令或依赖版本。SKILL.md 中有一行指明了此内容提取自的内部仓库；这是一个路由提示，在其他地方无害。

来源

提取自 AbleMind 的 dsh 产品化工作区，在那里它是树外插件工作的唯一事实来源。上游 dsh 不接受外部 pull request；受支持的贡献路径是在官方仓库旁边发布插件，而这正是此 skill 所构建的用途。

许可证

MIT。参见 LICENSE。