Agent 技能合集ShanHaiFish/Shimmering-dsh-skills

Shimmering-dsh-skills

简体中文 | English

DeepSeek Harness (dsh) 的 agent skill 合集 —— 一套自包含、可复用的指令集。
一套面向 DeepSeek Harness 及兼容宿主（.agents/skills//SKILL.md）的、
自包含且可安装的 agent skill 合集。

License: MIT
PRs Welcome
Conventional Commits

这是什么

每个子目录是一个独立可安装的 skill（/SKILL.md），遵循
.agents/skills//SKILL.md 跨宿主约定，可被 dsh、ZCode、Claude Code 等工具发现。
skill 自带 README.md 与 references/，自包含、可单独复制安装。

目录结构

Shimmering-dsh-skills/
├── dsh-plugin-install/        # 技能 1：dsh 插件安装/校验/排错（静态 bundle）
├── dsh-cordis-plugin-dev/     # 技能 2：dsh 动态 Cordis 插件开发指南
├── dsh-plugin-init/           # 技能 3：/init 一键生成 AGENTS.md（agents.md 规范）
├── docs/
│   ├── SKILL_AUTHORING.md     # 新增/编写 skill 的作者指南
│   └── template/example-skill/# 最小可安装骨架（复制改名即用）
├── CONTRIBUTING.md            # 贡献指南
├── CODE_OF_CONDUCT.md         # 行为准则
├── SECURITY.md                # 安全政策
├── CHANGELOG.md               # 变更记录
└── LICENSE                    # MIT

Skills

| Skill | 说明 |
|---|---|
| dsh-plugin-install | 安装、校验与排错 dsh 插件：区分静态 bundle（dsh plugin add，持久）与动态 Cordis（cordis_define/cordis_run，进程内存 + 安全守卫）两种机制；内置金三角规则、重启前预检与按签名索引的错误目录。防「装完重启 dsh web 报 loaded without registering / 插件 UI 不出现」。 |
| dsh-cordis-plugin-dev | dsh 动态 Cordis 插件开发指南：用 cordis_inspect_* 探查运行时、编写 host 半与浏览器半、cordis_define/cordis_run 定义与运行、处理批准/渲染失败、诊断技术失败并回滚修复；含安全守卫与「动态→静态 bundle 上线」桥接。是 dsh-plugin-install 在开发侧的配套。 |
| dsh-plugin-init | 在 dsh 里用 /init 一键生成/更新 AGENTS.md：探测项目栈、从 manifest/CI 抽取命令与约定、按 agents.md 规范产出薄型根文件（~100 行指针、硬上限 500 行）、确有必要时加 scoped 子文件，逐条验证命令与路径真实存在（绝不编造）；参考 GitHub agent-rules-skill 的做法并贴合 dsh 技能发现分层落地。 |

前提

- 使用这些 skill 需要一个兼容宿主（如 DeepSeek Harness）。
- 部分 skill 依赖宿主已装好的工具（如 dsh-plugin-install 依赖其安装目录下的
@deepseek-ai/dsh-client-modules 等）。

安装某个 skill

克隆本仓库（若你已 fork/私有化，替换 URL）：

git clone https://github.com/ShanHaiFish/Shimmering-dsh-skills.git   # 真实仓库 URL 以你的为准

然后复制任意 skill 目录到技能发现路径：

用户级（所有项目可用，推荐）：
cp -r Shimmering-dsh-skills/dsh-plugin-install ~/.agents/skills/
或项目级：
cp -r Shimmering-dsh-skills/dsh-plugin-install /.agents/skills/

不想拷贝可符号链接（Windows 需开发者模式或管理员权限）：

ln -s "$(pwd)/Shimmering-dsh-skills/dsh-plugin-install" ~/.agents/skills/dsh-plugin-install

安装后新开一个会话即可被宿主发现（技能列表在会话启动时加载）。

只装某一个/某几个 skill（不必克隆整个仓库）

每个 skill 都是自包含目录（自带 SKILL.md / README.md / references/），任意可单独安装，
彼此无依赖。想省事只拉单个目录时，任选其一：

方式 A：浅克隆后只拷需要的目录（最通用）bash
git clone --depth 1 https://github.com/ShanHaiFish/Shimmering-dsh-skills.git
cp -r Shimmering-dsh-skills/dsh-plugin-install ~/.agents/skills/

方式 B：稀疏/部分克隆——只下载想要的 skill 目录的内容
git clone --depth 1 --filter=blob:none --sparse https://github.com/ShanHaiFish/Shimmering-dsh-skills.git
cd Shimmering-dsh-skills && git sparse-checkout set dsh-plugin-install
cp -r dsh-plugin-install ~/.agents/skills/

方式 C：不经 git，直接用 SVN 桥只拉子目录（最轻量）
svn export https://github.com/ShanHaiFish/Shimmering-dsh-skills/trunk/dsh-plugin-install
cp -r dsh-plugin-install ~/.agents/skills/
或 degit：npx degit ShanHaiFish/Shimmering-dsh-skills/dsh-plugin-install

（真实仓库 URL 以你发布为准；dsh-plugin-install 换成你想要的 skill 目录名即可。）

想新增自己的 skill？从 docs/template/example-skill/
复制改名，规范见 docs/SKILL_AUTHORING.md。

贡献

见 CONTRIBUTING.md：如何新增/完善 skill、结构约定、提交信息与 PR 流程。
参与即遵守 CODE_OF_CONDUCT.md。

安全

遇到安全隐患走 SECURITY.md 的私有披露渠道，勿公开发可被利用的细节。

版本与变更

- 提交遵循 Conventional Commits：
feat(dsh-plugin-install): ...、fix(dsh-plugin-install): ...，scope 用 skill 目录名。
- 各 skill 自身演进体现在提交历史与 CHANGELOG.md；机制核对所针对的
宿主版本写在对应 skill 的 SKILL.md / README 中（如 dsh-plugin-install 以
dsh 0.1.1-rc.2 为基线）。

License

MIT © 2026 ShanHaiFish