{"id":"fe3e36d8-eee6-4fd8-98cf-cc64605982c4","slug":"dsh-skill","kind":"skill","name":"dsh-skill","summary":"Official plugin & skill development kit for DeepSeek Harness (DSH). Grounded in core runtime contracts for Claude Code, Codex, Antigravity, and DSH.","owner":"realchendahuang","repoUrl":"https://github.com/realchendahuang/dsh-skill","license":"MIT","licenseTier":"permissive","trust":"community","stars":25,"match":null,"fewStars":false,"format":"skill","createdAt":null,"addedAt":"2026-10-14T06:06:27.852Z","logoUrl":"https://avatars.githubusercontent.com/u/166703864?u=7d40a4255813e7f85abec8d376c72c8246889b7a&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools"],"tags":["antigravity","claude-code","codex","cordis","deepseek","deepseek-harness","dsh"],"runtime":"node","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T06:45:08.761Z","sample":false,"url":"https://conduits.dev/tools/dsh-skill","language":"JavaScript","transports":["stdio"],"install":{"npm":"dsh-skill"},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# dsh-skill · DeepSeek Harness 官方规范开发技能库\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![GitHub release](https://img.shields.io/github/v/release/realchendahuang/dsh-skill?color=brightgreen&label=release)](https://github.com/realchendahuang/dsh-skill/releases)\n[![CI Status](https://img.shields.io/github/actions/workflow/status/realchendahuang/dsh-skill/ci.yml?branch=main&label=CI)](https://github.com/realchendahuang/dsh-skill/actions)\n[![Runtime](https://img.shields.io/badge/Runtime-DeepSeek%20Harness-brightgreen.svg)](https://github.com/deepseek-ai/deepseek-harness)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/realchendahuang/dsh-skill/pulls)\n[![GitHub stars](https://img.shields.io/github/stars/realchendahuang/dsh-skill?style=social)](https://github.com/realchendahuang/dsh-skill)\n[![GitHub forks](https://img.shields.io/github/forks/realchendahuang/dsh-skill?style=social)](https://github.com/realchendahuang/dsh-skill/network/members)\n[![GitHub issues](https://img.shields.io/github/issues/realchendahuang/dsh-skill)](https://github.com/realchendahuang/dsh-skill/issues)\n[![Code of Conduct](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)\n[![Follow @realchendahuang](https://img.shields.io/badge/Follow-%40realchendahuang-1DA1F2?logo=x&logoColor=white)](https://x.com/realchendahuang)\n\n> **为 AI 编程助手（Claude Code、Codex、Antigravity、Cursor 及 DSH 自身）提供权威的 DeepSeek Harness 插件与扩展开发规范。**\n> 支持作为 Agent 技能直接发现、作为 Cordis 插件动态挂载，或通过 CLI 一键安装。\n\n[English](README.en.md) | [中文](README.md)\n\n---\n\n## 快速安装与上手\n\n无需手动寻找各个 Agent 的技能安装路径，或者从零摸索脚手架，直接使用一键安装：\n\n### 方式一：终端一行脚本静默直装（推荐，全自动部署与配置 CLI）\n\n**macOS / Linux / WSL：**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/realchendahuang/dsh-skill/main/install.sh | bash\n```\n\n**Windows (PowerShell)：**\n```powershell\nirm https://raw.githubusercontent.com/realchendahuang/dsh-skill/main/install.ps1 | iex\n```\n> 自动识别本机环境，一键部署到 DSH、Claude Code、Codex/Cursor 与 Antigravity 技能目录，并自动链接 `dsh-skill` 命令行工具。\n\n### 方式二：通过 NPX 运行\n```bash\n# 一键安装技能并链接 CLI 到本机\nnpx github:realchendahuang/dsh-skill install\n\n# 检查当前各平台的安装状态\nnpx github:realchendahuang/dsh-skill status\n```\n\n### 方式三：DSH 原生插件机制（Cordis 动态挂载）\n```bash\ndsh plugin --profile web add git+https://github.com/realchendahuang/dsh-skill.git\n```\n\n---\n\n## CLI 工具箱用法\n\n安装完成后，直接在任意目录运行 `dsh-skill`：\n\n```bash\n# 1. 检查当前各平台的安装状态\ndsh-skill status\n\n# 2. 一键初始化一个全新的标准 DSH 插件项目（默认工具插件）\ndsh-skill init dsh-my-tools\n\n# 3. 初始化安全门禁钩子插件\ndsh-skill init dsh-my-guard --type hook\n\n# 4. 初始化独立 Agent 技能包\ndsh-skill init dsh-my-skill --type skill\n\n# 5. 诊断与校验已有插件的规范合规性（8 项硬契约质检）\ndsh-skill check .\n\n# 6. 一键更新所有平台的技能包到最新版本\ndsh-skill update\n```\n\n---\n\n## 系统架构与工作流全景\n\n```mermaid\ngraph TD\n    subgraph Clients[\"1. AI 编程助手客户端 (Discovery)\"]\n        DSH[\"DeepSeek Harness (Native)\"]\n        Claude[\"Claude Code\"]\n        Codex[\"OpenAI Codex / Cursor\"]\n        AGY[\"Antigravity / Gemini\"]\n    end\n\n    subgraph Skill[\"2. dsh-plugin-dev 技能库 (Knowledge & SOP)\"]\n        S[\"SKILL.md (任务路由决策树)\"]\n        R[\"硬契约参考 (Cordis / Pipeline / Tools / Packaging)\"]\n        P[\"标准作业程序 (Scaffolding / Isolated Dev / Verification)\"]\n        T[\"代码脚手架模板 (Tool / Hook / Skill Bundle)\"]\n    end\n\n    subgraph Runtime[\"3. DeepSeek Harness 运行时环境 (Execution)\"]\n        Kernel[\"Cordis 微内核 (依赖注入 & 作用域管理)\"]\n        Pipe[\"执行流水线 5 阶段 (Pre / Guard / Exec / Post / Result)\"]\n        Tools[\"模型工具 (defineTool / 结构化输入输出)\"]\n        Cards[\"纯函数 UI 卡片 (presentCall / presentResult)\"]\n        Events[\"流式事件通道 (session/event & assistant/chunk)\"]\n    end\n\n    Clients --> S\n    S --> R\n    S --> P\n    S --> T\n    P --> Kernel\n    Kernel --> Pipe\n    Pipe --> Tools\n    Pipe --> Cards\n    Kernel --> Events\n```\n\n---\n\n## 为什么需要这个 Skill？\n\n让编程 Agent 写一个 DSH 插件时，最大的痛点往往是 **AI 在缺少工程约束的情况下到处碰运气**：\n\n- **微内核与注入机制盲猜**：不知道底层基于 Cordis 容器，漏写 `inject` 或搞错全局与局部作用域。\n- **打包配置翻车**：不知道 `@deepseek-ai/*` 属于运行时注入的内置依赖，直接把 `@deepseek-ai/cordis` 打包进单文件产物，导致原型链断裂和 Symbol 匹配失效。\n- **宿主环境污染**：直接向日常使用的 `~/.dsh` 目录安装测试，把开发者的主配置搞崩。\n- **输出与卡片混淆**：把面向模型的自然语言和 UI 客户端卡片混写在工具主体中，无法在流式生成和会话日志中干净回放。\n\n**本仓库把官方源码中的架构契约、执行流水线与隔离开发测试流程，完整沉淀为标准 Agent 技能。装上之后，AI 编程助手将严格按规范输出代码，不再盲猜。**\n\n---\n\n## 运行形态：双模支持（Skill + Plugin）\n\n为了满足不同开发者的使用习惯，本项目同时支持两种挂载形态：\n\n### 形态 1：作为标准 Agent Skill（跨客户端通用）\n将本仓库作为技能包置于各 Agent 客户端的技能目录中，Agent 即可自主调用：\n- DSH 原生：`<projectRoot>/.dsh/skills/dsh-plugin-dev` 或 `~/.dsh/skills/dsh-plugin-dev`\n- Claude Code：`~/.claude/skills/dsh-plugin-dev`\n- Codex：`~/.agents/skills/dsh-plugin-dev`\n- Google Antigravity：`~/.gemini/config/skills/dsh-plugin-dev`\n\n### 形态 2：作为 DSH Cordis 插件（运行时动态注入）\n本项目本身是一个合法的 Cordis 插件。可以在你的 `cordis.yml` 中直接声明：\n```yaml\nplugins:\n  \"dsh-skill\": {}\n```\n在容器启动时，它会自动向 DSH 的 `ctx.skills` 注册表动态挂载 `dsh-plugin-dev` 技能，供当前会话中的 Agent 动态披露。\n\n---\n\n## 包含的官方规范与资产全景\n\n```text\ndsh-skill/\n├── SKILL.md                 # 核心技能入口（Agent 读取此文件路由全流程）\n├── references/              # 官方架构硬契约（基于 DeepSeek Harness 源码提炼）\n│   ├── cordis-runtime.md    # Cordis 微内核、apply 契约、作用域与生命周期 Disposer\n│   ├── tools-contract.md    # defineTool 规范、Schema 校验、纯函数 UI 卡片与超时取消\n│   ├── execution-pipeline.md # 工具执行 5 阶段（pre-execute、guard、execute、post-execute、result）\n│   ├── skills-subsystem.md  # 原生 Skills 体系、6 级 Rank 发现优先级与两阶段按需披露机制\n│   ├── ui-and-events.md     # session/event 实时流式事件、assistant/chunk 与反向驱动\n│   └── packaging-rules.md   # 外部化铁律、Host/Client 双端规范与 package.json 元数据\n├── playbooks/               # Agent 标准作业程序（SOP）\n│   ├── 01-scaffolding.md    # 从零初始化插件工程脚手架\n│   ├── 02-tool-plugin.md    # 编写标准模型工具插件\n│   ├── 03-hook-plugin.md    # 编写权限门禁与安全拦截钩子\n│   ├── 04-isolated-dev.md   # .dsh-dev 本地隔离调试与冒烟测试\n│   └── 05-verification.md   # 发版前严格质量质检与依赖排查清单\n├── templates/               # 经过验证的最小可用模版代码\n│   ├── tool-plugin/         # 基础工具插件骨架\n│   ├── hook-plugin/         # 权限拦截门禁骨架\n│   └── skill-bundle/        # 标准技能包骨架\n├── bin/                     # CLI 跨平台一键安装工具\n├── CHANGELOG.md             # 版本历史与变更记录\n├── CONTRIBUTING.md          # 社区贡献指南\n├── SECURITY.md              # 安全政策与漏洞汇报\n└── LICENSE                  # MIT 开源协议\n```\n\n---\n\n## 体验示例\n\n安装后，直接对你的 AI 编程助手输入：\n\n```text\n帮我用官方规范开发一个 DSH 工具插件 dsh-curl-tools，提供发送 HTTP GET 请求的工具，并在本地隔离环境中完成测试。\n```\n\nAgent 会自动识别并加载本技能：\n1. 建立符合规范的 `package.json` 并配置 esbuild 外部化依赖；\n2. 编写基于 `defineTool` 的强类型参数校验与 UI 展示卡片；\n3. 在 `.dsh-dev/` 隔离环境中启动测试，绝不修改日常配置；\n4. 运行类型检查与产物审查后向你交付。\n\n---\n\n## 相关生态与版本历史\n\n- [版本发布历史 (Changelog)](CHANGELOG.md)\n- [DeepSeek Harness 官方仓库](https://github.com/deepseek-ai/deepseek-harness)\n- [dsh-guide (一条消息的旅行 · 交互式源码解析)](https://chendahuang.com/dsh)\n\n---\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=realchendahuang/dsh-skill&type=Date)](https://star-history.com/#realchendahuang/dsh-skill&Date)\n\n---\n\n## License\n\n[MIT License](LICENSE) · Copyright (c) 2026 [realchendahuang](https://github.com/realchendahuang)\n"}