超能力智能体预设dsh-mixxed/dsh-preset-superpowers

Superpowers Agent Preset (DSH)

本仓库为 superpowers 的 DSH agent 预设版本（DSH = DeepSeek Harness）。

具备 obra/superpowers 全部能力的 DeepSeek Harness agent 预设，基于 DSH 官方 standard 预设构建，并适配 Windows / Linux 双平台。

English docs: README.md

安装 / 使用方式

将本仓库克隆到 DSH 的 agent-presets 目录下的 superpowers 文件夹即可（DSH 会按目录名挂载该预设）：

Linux / macOS

git clone git@github.com:dragons96/dsh-superpowers.git ~/.dsh/.agent-presets/superpowers

Windows（PowerShell）

git clone git@github.com:dragons96/dsh-superpowers.git $HOME\.dsh\.agent-presets\superpowers

如果 superpowers 目录已存在（例如 DSH 初始化时自动创建），可先删除或备份再克隆：

rm -rf ~/.dsh/.agent-presets/superpowers   # 或 Windows: Remove-Item -Recurse $HOME\.dsh\.agent-presets\superpowers
git clone git@github.com:dragons96/dsh-superpowers.git ~/.dsh/.agent-presets/superpowers

若环境变量 DSH_HOME 已设置，请将上面的 ~/.dsh 替换为 $DSH_HOME。

克隆完成后，在 DSH GUI / CLI 中即可选择名为 Superpowers 的 agent preset 使用。

升级

本仓库以 git 管理，升级只需拉取最新内容：

git -C ~/.dsh/.agent-presets/superpowers pull

卸载

直接删除该目录即可：

rm -rf ~/.dsh/.agent-presets/superpowers   # 或 Windows: Remove-Item -Recurse $HOME\.dsh\.agent-presets\superpowers

包含内容

全部 14 项 superpowers 技能（位于 skills/，由 agent.cordis.yml 中的 skill-filesystem 行以 customSkillDirs 注册）：

| 技能 | 用途 |
| --- | --- |
| using-superpowers | 技能使用总纲（会话起点；核心规则同时内嵌在 persona 中） |
| brainstorming | 任何创造性工作前的需求/设计探讨（spike / bounded / architectural 三路径） |
| writing-plans | 将 spec 写成可执行的分步实现计划 |
| test-driven-development | 先写失败测试，再写最小实现（RED-GREEN-REFACTOR） |
| subagent-driven-development | 每任务派发全新实现子代理 + 任务评审 + 全分支终审 |
| executing-plans | 在独立会话中按检查点执行计划 |
| dispatching-parallel-agents | 多个独立问题时并行派发子代理 |
| systematic-debugging | 先找根因再修，禁止症状修复（四阶段法） |
| verification-before-completion | 完成声明前必须运行验证命令（证据先于断言） |
| requesting-code-review / receiving-code-review | 代码评审的发起与接收 |
| using-git-worktrees | 隔离工作区（原生工具优先，git worktree 兜底） |
| finishing-a-development-branch | 收尾：验证测试 → 检测环境 → 呈现合并/PR/保留选项 |
| writing-skills | 以 TDD 方式编写与测试新技能 |

Windows / Linux 适配

- Shell：Linux 用 bash 工具（技能中的 bash 片段直接可用）；Windows 用 pwsh 工具（技能中的 bash 片段需译为 PowerShell，git 命令两平台一致）。两条行在 agent.cordis.yml 中按平台互斥启用。
- 辅助脚本双形态：
- skills/subagent-driven-development/scripts/：sdd-workspace / task-brief / review-package 各有 .sh（Linux / Git Bash）与 .ps1（Windows PowerShell，已实测）两个版本，参数与输出一致。
- skills/brainstorming/scripts/：start-server.sh / stop-server.sh 与 start-server.ps1 / stop-server.ps1（Visual Companion 服务器，自动打开用户默认浏览器）。
- 工具映射：skills/using-superpowers/references/dsh-tools.md 把技能里的动作（"dispatch a subagent"、"create a todo" 等）映射到本 harness 的具体工具。
- 其余技能正文保持上游原文（平台无关的 markdown）；using-superpowers 的 Platform Adaptation 列表已加入 DSH 条目。

与上游的差异（DSH 无 hook 机制）

superpowers 插件在 Claude Code 里通过 SessionStart hook 把 using-superpowers 全文注入上下文；DSH 没有 hook 系统，因此：

1. using-superpowers 的核心规则（1% 规则、先技能后行动、技能优先级、跨平台规则、工具映射指引）直接写入 agent.cordis.yml 的 persona 段落，等价于每次会话启动即生效；
2. 技能本体仍在技能目录中按需加载（skill 工具），并保留完整参考文件（codex / gemini / pi / hermes / antigravity 的映射表原样保留）。

维护

- 预设根目录：${DSH_HOME:-$HOME/.dsh}/.agent-presets/superpowers/
- 升级技能：重新从上游仓库复制 skills/（注意保留 dsh-tools.md 与 .ps1 适配文件）。
- 校验：dsh-agent-presets 的 standingKeyFor('superpowers') 挂载校验通过即为可用。