🦸 dsh-superpowers-zh
简体中文 | [English](#english)
  
> 一句话:把 20 个开箱即用的中文 AI 编程 skills 装进 DeepSeek Harness,agent 按需自动调用(移植自 superpowers-zh)。
移植自 superpowers-zh(MIT,上游 obra/superpowers 的中文增强版)。上游 npm 包 109 个文件全部搬入,其中 107 个逐字保留(SHA-256 钉在 [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)),只做了让 dsh 能加载它的最小包装改动。
✨ 功能
- 🧪 测试驱动开发 ——
test-driven-development、systematic-debugging等核心工作流技能 - 🈶 中文专属技能 ——
chinese-code-review、chinese-commit-conventions、chinese-documentation、chinese-git-workflow - 📋 规划与执行 ——
writing-plans、executing-plans、subagent-driven-development、dispatching-parallel-agents - 🔍 代码审查 ——
requesting-code-review、receiving-code-review - 🧩 扩展能力 ——
mcp-builder、workflow-runner、brainstorming、writing-skills等 - 🎯 自动发现 —— 安装后 skills 出现在 dsh 的 catalog,agent 按
description自动匹配调用,无需手动引用
📸 效果
安装并启动 dsh 后,20 个 skills 会出现在 agent 的可用技能目录里(示意):
<available_skills>
<skill name="test-driven-development">在实现任何功能或修复 bug 时使用,在编写实现代码之前</skill>
<skill name="systematic-debugging">遇到任何 bug、测试失败或异常行为时使用,在提出修复方案之前执行</skill>
<skill name="chinese-code-review">中文 review 沟通参考——话术模板、分级标注…</skill>
…共 20 个
</available_skills>agent 遇到对应场景会自动 read 并执行 SKILL.md 里的完整流程。
📦 安装
本插件尚未发布到 npm,用 GitHub 或本地路径安装:
dsh plugin --profile <你的 profile> add github:GongYuanCaiJi/dsh-superpowers-zh若 pnpm 拦下构建脚本,在 profile 的 pnpm-workspace.yaml 里把本包加进 allowBuilds(安装时的 prepare 只做结构自检,无编译步骤)。
从本地目录安装:
git clone https://github.com/GongYuanCaiJi/dsh-superpowers-zh.git
cd dsh-superpowers-zh && npm install
dsh plugin --profile <你的 profile> add .🚀 使用
不需要手动引用任何 skill。启动 dsh 后直接说你的需求,agent 会按场景调用对应技能:
> 帮我用 TDD 实现一个函数
> 我的测试一直挂,帮我系统排查
> 帮我审查刚改的代码想确认 skills 是否已加载,直接问 agent「你有哪些 skills」。
🔧 本移植版与上游的差异
1. skills/、hooks/、bin/、docs/ 等 107 个文件逐字复制,SHA-256 钉在 THIRD_PARTY_NOTICES.md 2. 新增 index.js:把 skills/ 注册进 dsh skills registry(与 dsh-lens 相同的 runtime provider 机制) 3. 新增 cordis.patch.yml + package.json 的 dsh.bundle:dsh 插件加载入口 4. package.json:main 改指 index.js;scripts 依移植产线规范增删(site/site:deploy/version 引用未随 npm 包发布的文件,删除);description 与 repository 改指本 repo 5. LICENSE:上游 copyright 行逐字保留,另加 (dsh port) 移植者行 6. 上游 README.md → docs/UPSTREAM-README.md(逐字保留;原版 23 工具安装说明在那里)
❓ 常见问题
为什么是中文? 上游 superpowers-zh 本身就是 obra/superpowers 的完整汉化, 本移植版不重复翻译,只保留上游原文。
和 obra/superpowers 什么关系? 本包是 superpowers-zh(上游 25 万+ star 项目的中文增强版)的 dsh 移植,skills 内容与上游逐字一致。
想看给其他工具(Claude Code / Cursor 等)的安装说明? 见 [docs/UPSTREAM-README.md](./docs/UPSTREAM-README.md)。
📄 License
MIT。上游版权归 jnMetaCode(superpowers-zh)与 obra/superpowers 所有,移植版权归 GongYuanCaiJi(dsh port)。详见 [LICENSE](./LICENSE)。
如果你觉得这个技能包有用,请也给上游点个 star ⭐: superpowers-zh · obra/superpowers
---
English
dsh-superpowers-zh
[简体中文](#-dsh-superpowers-zh) | English
  
> One line: 20 ready-to-use Chinese AI-coding skills for DeepSeek Harness, auto-discovered by the agent (port of superpowers-zh).
A port of superpowers-zh (MIT), the Chinese-enhanced edition of obra/superpowers. All 109 files of the upstream npm package are carried over; 107 are byte-for-byte identical (SHA-256 pinned in [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md)), with only the minimal packaging changes needed for dsh to load them.
✨ Features
- 🧪 Core workflows —
test-driven-development,systematic-debugging,verification-before-completion - 🈶 Chinese-native skills —
chinese-code-review,chinese-commit-conventions,chinese-documentation,chinese-git-workflow - 📋 Planning & execution —
writing-plans,executing-plans,subagent-driven-development,dispatching-parallel-agents - 🔍 Code review —
requesting-code-review,receiving-code-review - 🧩 Extensions —
mcp-builder,workflow-runner,brainstorming,writing-skillsand more - 🎯 Auto-discovery — skills appear in the dsh catalog; the agent matches them by
descriptionon demand
📸 Preview
After install, all 20 skills show up in the agent's available-skills catalog and are loaded on demand by reading their SKILL.md.
📦 Install
Not published to npm yet — install from GitHub or a local path:
dsh plugin --profile <your-profile> add github:GongYuanCaiJi/dsh-superpowers-zhIf pnpm blocks build scripts, add this package to allowBuilds in the profile's pnpm-workspace.yaml (its prepare only runs a no-build structure self-check).
From a local checkout:
git clone https://github.com/GongYuanCaiJi/dsh-superpowers-zh.git
cd dsh-superpowers-zh && npm install
dsh plugin --profile <your-profile> add .🚀 Usage
No manual skill reference needed. Just describe your task; the agent invokes the matching skill automatically. Ask the agent "what skills do you have" to confirm the catalog is loaded.
🔧 What changed vs upstream
1. 107 files (skills/, hooks/, bin/, docs/, …) copied verbatim — SHA-256 pinned in THIRD_PARTY_NOTICES.md 2. New index.js: registers skills/ into the dsh skills registry (same runtime-provider mechanism as dsh-lens) 3. New cordis.patch.yml + dsh.bundle in package.json: the dsh plugin loading entry 4. package.json: main now points to index.js; scripts adjusted per port-line conventions (site/site:deploy/version reference files not shipped in the npm tarball); description/repository point to this repo 5. LICENSE: upstream copyright line kept verbatim, plus a (dsh port) line 6. Upstream README.md → docs/UPSTREAM-README.md (verbatim; the original 23-tool install docs live there)
❓ FAQ
Why Chinese? The upstream superpowers-zh is already a full localization of obra/superpowers; this port keeps the upstream text as-is and does not re-translate.
How is this related to obra/superpowers? This package is the dsh port of superpowers-zh, the Chinese-enhanced edition of the 250k+ star original. Skill contents are byte-identical to upstream.
Looking for install docs for other tools (Claude Code / Cursor / …)? See [docs/UPSTREAM-README.md](./docs/UPSTREAM-README.md).
📄 License
MIT. Upstream copyright jnMetaCode (superpowers-zh) and obra/superpowers; port copyright GongYuanCaiJi (dsh port). See [LICENSE](./LICENSE).
If you find this useful, please star the upstream too ⭐: superpowers-zh · obra/superpowers