qiuyongjin/dsh-plugin-development

README excerpt

dsh-plugin-development 一个自包含的插件开发技能(Skill),用于在 deepseek-harness (下文简称 dsh)仓库中 开发、扩展和调试 Cordis 插件。技能本身不绑定任何特定 Agent:支持技能机制的 Agent (Claude Code、Cursor 等)均可加载,也可以当作独立的开发指南直接阅读。 在 dsh 中, 一切皆是 Cordis 插件 :模型适配器、工具注册表、会话日志、agent loop 本身都是插件——不存在需要打补丁的"特权核心",扩展产品的方式就是在其旁挂载 一个新插件。本技能把编写这类插件所需的全部规则封装在自身目录内( SKILL.md 与 references/ 下的五个参考文件),做到自包含:不依赖外部文档即可按规范工作。 何时使用 当任务涉及以下任何内容时,Agent 会自动加载本技能(在支持技能机制的 Agent 中): - 插件开发 :新建或修改 Cordis 插件、bundle、profile 层、cordis.yml 配置行 - 扩展点 :tool 注册( ctx.tools / defineTool )、service 与 ctx. 键、 事件监听、provider / capability 接缝、prompt section、commands - 相关关键词 :插件、plugin、扩展点、extension point、capability、service、 tool registration、cordis.yml、bundle、profile、 ctx.xxx - 修改 agent loop 或注册新的 session 事件之前——确保变更挂接到已文档化的 扩展点上,而不是硬改核心 也可以手动调用:在支持技能命令的 Agent 中输入 /dsh-plugin-development 。 目录结构 核心内容一览 主题 要点 参考 插件形态 函数插件(仅命名导出,无 default)、Service 子类、能力接缝(Definition / Provider / Consumer)、客户端插件 plugin-templates.md 命名与放置 按角色选 packages/ / ; ctx 键单复数区分单一引擎与注册表;角色后缀要诚实 extension-points.md 注册机制 所有注册都是 effect(返回 disposer);依赖用 inject 声明;waterfall 监听器必须调用 next() 委托 extension-points.md 模型可见即记录 一切进入模型请求的内容必须能从会话日志重建,新输入要配套新 session event extension-points.md 配置 schemastery Config 校验、加载时快速失败、无硬编…

Category