dsh-skill
DeepSeek Harness (DSH) 插件和扩展的官方开发工具包与智能体技能。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:realchendahuang/dsh-skill#23e75d82f4c5a4ba97b9262d2f22592678992d98Skill 以 dsh-skill 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
为 AI 编程助手（Claude Code、Codex、Antigravity、Cursor 及 DSH 自身）提供权威的 DeepSeek Harness 插件与扩展开发规范。 支持作为 Agent 技能直接发现、作为 Cordis 插件动态挂载，或通过 CLI 一键安装。
无需手动寻找各个 Agent 的技能安装路径，或者从零摸索脚手架，直接使用一键安装：
macOS / Linux / WSL：
curl -fsSL https://raw.githubusercontent.com/realchendahuang/dsh-skill/main/install.sh | bash
Windows (PowerShell)：
irm https://raw.githubusercontent.com/realchendahuang/dsh-skill/main/install.ps1 | iex
自动识别本机环境，一键部署到 DSH、Claude Code、Codex/Cursor 与 Antigravity 技能目录，并自动链接
dsh-skill命令行工具。
# 一键安装技能并链接 CLI 到本机
npx github:realchendahuang/dsh-skill install
# 检查当前各平台的安装状态
npx github:realchendahuang/dsh-skill status
dsh plugin --profile web add git+https://github.com/realchendahuang/dsh-skill.git
安装完成后，直接在任意目录运行 dsh-skill：
# 1. 检查当前各平台的安装状态
dsh-skill status
# 2. 一键初始化一个全新的标准 DSH 插件项目（默认工具插件）
dsh-skill init dsh-my-tools
# 3. 初始化安全门禁钩子插件
dsh-skill init dsh-my-guard --type hook
# 4. 初始化独立 Agent 技能包
dsh-skill init dsh-my-skill --type skill
# 5. 诊断与校验已有插件的规范合规性（8 项硬契约质检）
dsh-skill check .
# 6. 一键更新所有平台的技能包到最新版本
dsh-skill update
graph TD
subgraph Clients["1. AI 编程助手客户端 (Discovery)"]
DSH["DeepSeek Harness (Native)"]
Claude["Claude Code"]
Codex["OpenAI Codex / Cursor"]
AGY["Antigravity / Gemini"]
end
subgraph Skill["2. dsh-plugin-dev 技能库 (Knowledge & SOP)"]
S["SKILL.md (任务路由决策树)"]
R["硬契约参考 (Cordis / Pipeline / Tools / Packaging)"]
P["标准作业程序 (Scaffolding / Isolated Dev / Verification)"]
T["代码脚手架模板 (Tool / Hook / Skill Bundle)"]
end
subgraph Runtime["3. DeepSeek Harness 运行时环境 (Execution)"]
Kernel["Cordis 微内核 (依赖注入 & 作用域管理)"]
Pipe["执行流水线 5 阶段 (Pre / Guard / Exec / Post / Result)"]
Tools["模型工具 (defineTool / 结构化输入输出)"]
Cards["纯函数 UI 卡片 (presentCall / presentResult)"]
Events["流式事件通道 (session/event & assistant/chunk)"]
end
Clients --> S
S --> R
S --> P
S --> T
P --> Kernel
Kernel --> Pipe
Pipe --> Tools
Pipe --> Cards
Kernel --> Events
让编程 Agent 写一个 DSH 插件时，最大的痛点往往是 AI 在缺少工程约束的情况下到处碰运气：
inject 或搞错全局与局部作用域。@deepseek-ai/* 属于运行时注入的内置依赖，直接把 @deepseek-ai/cordis 打包进单文件产物，导致原型链断裂和 Symbol 匹配失效。~/.dsh 目录安装测试，把开发者的主配置搞崩。本仓库把官方源码中的架构契约、执行流水线与隔离开发测试流程，完整沉淀为标准 Agent 技能。装上之后，AI 编程助手将严格按规范输出代码，不再盲猜。
为了满足不同开发者的使用习惯，本项目同时支持两种挂载形态：
将本仓库作为技能包置于各 Agent 客户端的技能目录中，Agent 即可自主调用：
<projectRoot>/.dsh/skills/dsh-plugin-dev 或 ~/.dsh/skills/dsh-plugin-dev~/.claude/skills/dsh-plugin-dev~/.agents/skills/dsh-plugin-dev~/.gemini/config/skills/dsh-plugin-dev本项目本身是一个合法的 Cordis 插件。可以在你的 cordis.yml 中直接声明：
plugins:
"dsh-skill": {}
在容器启动时，它会自动向 DSH 的 ctx.skills 注册表动态挂载 dsh-plugin-dev 技能，供当前会话中的 Agent 动态披露。
dsh-skill/
├── SKILL.md # 核心技能入口（Agent 读取此文件路由全流程）
├── references/ # 官方架构硬契约（基于 DeepSeek Harness 源码提炼）
│ ├── cordis-runtime.md # Cordis 微内核、apply 契约、作用域与生命周期 Disposer
│ ├── tools-contract.md # defineTool 规范、Schema 校验、纯函数 UI 卡片与超时取消
│ ├── execution-pipeline.md # 工具执行 5 阶段（pre-execute、guard、execute、post-execute、result）
│ ├── skills-subsystem.md # 原生 Skills 体系、6 级 Rank 发现优先级与两阶段按需披露机制
│ ├── ui-and-events.md # session/event 实时流式事件、assistant/chunk 与反向驱动
│ └── packaging-rules.md # 外部化铁律、Host/Client 双端规范与 package.json 元数据
├── playbooks/ # Agent 标准作业程序（SOP）
│ ├── 01-scaffolding.md # 从零初始化插件工程脚手架
│ ├── 02-tool-plugin.md # 编写标准模型工具插件
│ ├── 03-hook-plugin.md # 编写权限门禁与安全拦截钩子
│ ├── 04-isolated-dev.md # .dsh-dev 本地隔离调试与冒烟测试
│ └── 05-verification.md # 发版前严格质量质检与依赖排查清单
├── templates/ # 经过验证的最小可用模版代码
│ ├── tool-plugin/ # 基础工具插件骨架
│ ├── hook-plugin/ # 权限拦截门禁骨架
│ └── skill-bundle/ # 标准技能包骨架
├── bin/ # CLI 跨平台一键安装工具
├── CHANGELOG.md # 版本历史与变更记录
├── CONTRIBUTING.md # 社区贡献指南
├── SECURITY.md # 安全政策与漏洞汇报
└── LICENSE # MIT 开源协议
安装后，直接对你的 AI 编程助手输入：
帮我用官方规范开发一个 DSH 工具插件 dsh-curl-tools，提供发送 HTTP GET 请求的工具，并在本地隔离环境中完成测试。
Agent 会自动识别并加载本技能：
package.json 并配置 esbuild 外部化依赖；defineTool 的强类型参数校验与 UI 展示卡片；.dsh-dev/ 隔离环境中启动测试，绝不修改日常配置；MIT License · Copyright (c) 2026 realchendahuang