502399493zjw-lgtm/dsh-plugin-best-practices-skill

README 摘要

DSH Plugin Best Practices Skill 一套供 AI Coding Agent 构建、验证和交付外部 DeepSeek Harness（DSH）插件的工程规范与可执行工具箱。任何能读取 Markdown、运行 Node.js 与 Shell 的 Agent 都可以使用；Codex 还可自动发现该 Skill。 当前基线：DSH 0.1.0-rc.8 、Cordis 4.0.1 、Node.js ^22.19.0 =24.0.0 、pnpm 11.7.0 。本项目不是 DeepSeek 官方项目。 本仓库自身是 Agent Skill ，不是可用 dsh plugin add 安装的 DSH Bundle。它指导 Agent 生成真正声明 dsh.bundle 的插件； dsh-plugin Topic 表示主题相关性，不改变本仓库的 artifact 类型，也不代表本 Skill 符合只收可安装 Bundle 的社区插件目录门禁。 三个核心价值 1. 开发流程标准化 把插件开发统一为独立项目、稳定 main 、按需 branch/worktree、目标版本、测试、构建、打包、发布、发现与退役。初始化、包校验、stock smoke、发布前预检、registry 字节复核、敏感扫描和资源清理都有固定脚本可复用，Agent 不必每次重新猜 manifest、Browser loader 或清理规则，也不会为了开发插件直接修改 DSH 核心。 2. 验收流程全面化 验收覆盖单元/组合测试、构建、实际 tarball、stock DSH rc.8 安装与 provenance。对于前端插件，还会把加载、空态、成功、错误、恢复和关键交互转成 DOM/接口机器断言，并按需用最终 GIF 做独立视觉审查，而不是只确认“页面能打开”或“截图看起来没问题”。 3. 对外展示视频化 有用户可见界面或交互价值的插件在 GitHub 交付时同步一段 展示 GIF/短动画 ，让用户安装前就能理解插件解决什么问题、装好后大体是什么样，以及最典型的操作路径。 作为“安装后预览”的展示 GIF，默认应从目标插件 tarball 已安装到隔离 stock DSH rc.8 后的实际页面录制。外部 Provider 或演示数据可以按场景使用 mock，但必须明确标注，不能把 mock DSH 或源码页面冒充安装效果。展示 GIF 可以与验收 GIF 复用；Host-only 或无视觉价值的改动不强制制作。 展示 GIF 还可以与 DSH Market 展示插件 GitHub 图片的能力结合：市场直接呈现插件的安装后预览，形成类似 App Store 的“先看效果，再决定是否安装”体验。 现场预览、自动 smoke 和展示 GIF 各自解决不同问题：现场预览用于自由探索，…

分类