Skip to content

dsh-superpowers

Verified

@firefly0621/dsh-superpowers · v0.1.0-rc.42 · MIT

obra/superpowers skills provider plus system-prompt bootstrap for DeepSeek Harness

Install

dsh plugin add @firefly0621/dsh-superpowers

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Readme


description: "obra/superpowers skills provider 与 DeepSeek Harness 的系统提示词引导。" kind: "package-bundle"

@firefly0621/dsh-superpowers

English | 中文

概述

把 obra/superpowers 工作流内核及其融合扩展作为一个 skill 目录,加一套常驻的 skill-first 引导,接入 DeepSeek Harness profile。适用于需要按意图、计划、测试、调试、评审、验证的可重复顺序推进的产品会话。本包为 opt-in,不自带 harness peer。

目录

包身份

可安装的 DeepSeek Harness 插件组合包:把 obra/superpowers 接入产品会话——35 个 skill 按 core / advanced / product / authoring 四个 bundle 分层,已适配 dsh 工具 + 等价于 SessionStart 的引导注入。默认 profile 只加载 19 个 core skill(diagnosing-superpowers 在深 dsh 移植前不进目录)。

发布名:@firefly0621/dsh-superpowers(版本跟随 harness 家族,当前为 0.1.0-rc.42)。本 fork 包的源码真源:github.com/oThTJx/dsh-superpowers。本包为显式 opt-in,不属于官方 main 的 dsh-base 组合。

还原的能力

Superpowers 行为 dsh 实现
skills/*/SKILL.md 技能库 ctx.skills 提供方 superpowers(打包的 skills/ 目录,已适配 dsh)
SessionStart 注入 using-superpowers system-prompt/assemble 段 skill:superpowers,同一套 <EXTREMELY_IMPORTANT> 框架(每个非 subagent 请求);using-superpowers 在 skill 目录中为仅用户
平台 references/*-tools.md 该段内附加 skills/using-superpowers/references/dsh-tools.md
子代理跳过(SUBAGENT-STOP) session.header.origin === 'subagent' 时不注入完整 using-superpowers 引导;改为注入短 skill:superpowers-worker preamble
按需加载其他 skill 现有 dsh-tool-skill 目录 + skill 工具

skill 正文以 dsh 适配后的形式随包发布在 skills/ 下(无 vendored 源码、无 git submodule):外 harness 工具名与平台引用已改写为 dsh 等价物,superpowers: 前缀已移除。发布 tarball 包含 skills/、assets/NOTICE.md,以及离线评分脚本 scripts/score-skill-first.mjs。NOTICE 记录 obra/superpowers @ 2ce8aa15 v7.0.1、mattpocock/skills @ 5beb35b0、addyosmani/agent-skills @ aeac41d4,以及 bmad-code-org/BMAD-METHOD @ 61e01f82 与商标声明。

能力重叠时融合进一个归属 skill。上游来源中有不值得单独开 skill 目录的内容时,以引用包形式挂在归属者下面,只在走到需要它的那一步才加载。因此目录仍保持 35 个 skill,而融合进来的行为可以继续增长。

Bundle

本包按四个 bundle 发布。core 始终加载,其余通过 bundles 配置显式开启。

Bundle 默认 Skills 用途
core 是 19 日常编码工作流:brainstorming、规划、执行、TDD、调试、评审、验证、收尾、领域/设计、安全、来源、约束
advanced 否 6 子代理驱动执行与并行派发、context engineering、prototype、wizard、grilling
product 否 8 多干系人产品工作:想法、PRFAQ、PRD、spec、UX、复盘、纠偏、多角色辩论
authoring 否 2 writing-skills 与 dsh-harness-contributor,面向 skill 与仓库维护者

即使 bundles 只写可选 bundle,core 也会自动包含。裸安装看到 19 个 skill;完整安装看到 35 个。using-superpowers、handoff、wait-what 保持仅用户,因此默认 core 的模型可见目录是 16 个。

Matt skills 与融合扩展

Superpowers 仍是工作流内核(brainstorming → writing-plans → TDD / 调试 / 评审 / 验证)。从 mattpocock/skills、addyosmani/agent-skills 与 BMAD-METHOD 选取的实践以一个融合目录交付:每个 skill 至多声明一个 bundle 标签,该标签是本提供方发布的唯一目录元数据。

session skill(grilling、handoff、wait-what)不会出现在模型的 <available_skills> 目录中,模型侧 skill 工具也会拒绝加载。用户在用户消息里用空白边界的 /name token 调用(例如 /grilling);由 dsh-tool-skill 注入 skill 正文。using-superpowers 同样是 disable-model-invocation: true,但其常驻正文来自系统提示词引导,而非该手势(用户仍可用 /using-superpowers 重载正文,但不含 adapter)。

吸收了合并内容的 obra skill(obra 同步时需保留):brainstorming(Architectural 内联 grilling;Not Doing;Always/Ask/Never;拒绝 aim-past-100)、using-superpowers(≤5 行意图分叉;反堆叠;tiny-edit;实现优先级;contextual gates)、test-driven-development、systematic-debugging、requesting-code-review(Standards ∥ Spec + 清单 + review lenses + doubt pass)、executing-plans(切片纪律 + impact map)、refactoring(clarity + structural 双模式)、source-driven-development(research 模式)、codebase-design、writing-plans、handoff、verification-before-completion。

实现与质量扩展:executing-plans 负责 task loop、切片纪律与 impact map;refactoring 负责 clarity / structural 双模式;source-driven-development 负责 API 事实与 research 模式;requesting-code-review 负责事后评审与飞行中 doubt pass;subagent-driven-development 负责逐任务派发与并行派发引用。dsh-harness-contributor 与 explaining-changes 分别在 authoring / advanced bundle,不进入默认 core。

bundle 仅为目录元数据,不是路由器。本提供方在插件内私有解析 invocation / bundle frontmatter(仅改插件;不改上游 harness 包)。

融合地图

每个技能只拥有一种能力,凡是覆盖这种能力的选定来源都往它的正文里供料。两个来源重叠时,本包保留一个技能并合并双方贡献——绝不为一件事并排发布两个同级技能,也不会因为某个来源先改版就丢掉另一个已选来源的行为;未选用的能力在欠账表中标为不在范围。

技能 融合进来的来源 它负责什么
brainstorming obra 主轴 · BMAD 产品方案 · agent-skills 反模式 意图 → 获批设计,按规模的门禁
writing-plans obra 计划格式 · agent-skills 任务拆解 · Matt spec-to-tickets 获批 spec → 有序计划
test-driven-development obra 铁律 · agent-skills 触发面 RED-GREEN-REFACTOR 循环
subagent-driven-development obra 控制器 · dsh settlement 等待 · 并行派发 每任务派发、复核与并行调查
executing-plans obra 内联执行 · agent-skills 切片规则 · dsh 脚本接线 内联执行、切片纪律、impact map
systematic-debugging obra 四阶段 · agent-skills 错误恢复 · 可观测性/性能 先根因后修复
refactoring agent-skills clarity 正文 · dsh 结构扩展 · agent-skills 弃用/迁移 clarity / structural 双模式与退役
requesting-code-review obra Standards ∥ Spec · agent-skills 质量正文 · BMAD review lenses · 飞行中 doubt pass 发起评审、透镜与处置
verification-before-completion obra 门禁 · agent-skills 浏览器与 CI 证据 宣称完成前的证据
finishing-a-development-branch obra 收尾 · agent-skills 发布、git、CI/CD · Matt PR 正文 集成、发布、回滚
codebase-design Matt 深模块 · agent-skills 接口契约 · BMAD architecture spine 模块、接口与架构决策
domain-modeling Matt 术语表 · agent-skills ADR 与文档 模型与决策记录
grilling Matt 设计树 · agent-skills 访谈 · BMAD advanced elicitation 用户显式要求的访谈
forge-idea BMAD 蒸馏 · agent-skills 创意打磨 想法判定
security-and-hardening agent-skills 控制项 · dsh 不可信输出立场 威胁建模与边界
source-driven-development agent-skills API 事实 · research 模式 · BMAD deep recon 有据可依的 API 事实与引用调研
constraint-driven-development agent-skills 项目质量下限
context-engineering agent-skills 层级 · dsh 预算模型 · BMAD project context 上下文预算、打包与项目指令
ux-spec BMAD 双主轴 · agent-skills 前端验收与工程 UX 验收与实现契约

这张地图是清单,不是锁:一个技能可以新增来源,但绝不按来源拆成多个同级技能,已合并的段落也不会被「最后改版的那一家」覆盖。

引用包

以下能力挂在归属 skill 下,而不是新增 skill 目录。归属者只在需要该分支的那一步链接引用包,因此模型只在真正走到那里时支付这部分上下文。

归属 引用 融合内容
systematic-debugging references/observability-and-performance.md 生产可观测性 · 性能回归工作流
refactoring references/clarity.md 行为不变的清晰度整理
refactoring references/structural.md 反复修复后的结构性改动
refactoring references/deprecation-and-migration.md 弃用决策 · strangler/adapter/flag · expand → contract
executing-plans references/slice-discipline.md 切片循环 · 切片策略 · 范围纪律
executing-plans references/impact-analysis.md 跨边界改动前的短影响图
ux-spec references/frontend-engineering.md 组件与状态归属 · 设计系统遵循 · 可访问性 · 响应式 UI
context-engineering references/project-context.md AGENTS.md 建立/采纳/刷新/审计 · 面向 agent 的写作
codebase-design references/architecture-spine.md 架构不变量 · 稳定 AD ID · 评审门;正文含 TypeScript 入口点约束
writing-plans references/spec-to-tickets.md spec 驱动流程 · tracer-bullet 票据 · wayfinding · triage
requesting-code-review references/review-lenses.md 对抗式 · 边界用例 · 验证缺口 · claims/deletion 检查 · walkthrough
requesting-code-review references/doubt-driven-review.md 决策锁定前的飞行中对抗式复核
subagent-driven-development references/parallel-dispatch.md 独立并行调查与 prompt 结构
writing-skills references/skill-evals.md baseline/variant/quality/trigger 评测 · toolsmith 流程
source-driven-development references/research-mode.md 开放式引用调研 · 调研预算
source-driven-development references/deep-recon.md 决策级调研 · 研究防火墙 · claim 出处
test-driven-development references/retrofitting-tests.md 为既有行为补端到端/API 测试
grilling references/advanced-elicitation.md pre-mortem · red team · first principles · questionnaire
prd references/product-brief.md discovery · coaching/fast 路径 · 合身的产品 brief
retrospective references/evidence-review.md 证据清单 · 范围归因 · 验收判定 · 后续跟进
constraint-driven-development references/floor-guard.md diff 范围下限守卫 · 五种降低门槛的动作 · exit 0/1/2
security-and-hardening references/hardening-patterns.md OWASP 模式 · 输入校验 · 破坏性路径 · 依赖审计 · 限流 · 密钥 · 数据分级 · LLM 输出处理
explaining-changes references/walkthrough.md intent → broad strokes → slices → periphery
finishing-a-development-branch references/ci-and-delivery.md 流水线顺序 · 预览环境 · 分阶段发布 · 依赖自动化
finishing-a-development-branch references/pr-description.md Summary · Evidence · Test plan · Merge danger
brainstorming references/technique-catalog.md 工作模式 · 发散透镜 · 收敛测试

引用包属于归属者的契约:tests/superpowers.spec.ts 会检查上表每个融合包带着定义性钉点发布,检查每个引用文件都由归属者正文链接,并检查 skills/ 下所有相对 Markdown 链接可解析。引用包不是第二个路由器,也不会出现在 <available_skills> 中。

安装进 dsh profile

需要 DeepSeek Harness peer(@deepseek-ai/dsh-skill 等),通常来自官方 CLI / dsh-base 栈。源码工作区的 workspace:* peer 指向匹配的 DSH 发布版;打包清单会替换成该精确版本。DSH 在安装与 profile 启动时检查这些 peer 范围,不兼容且没有精确版本豁免的组合会被拒绝——见版本兼容性。

dsh plugin --profile web add @firefly0621/dsh-superpowers

源码树中:

pnpm dsh plugin --profile web add @firefly0621/dsh-superpowers

然后启动 dsh --profile web(或 pnpm dsh web)。若本 fork 的 dsh-base 已挂载 id: superpowers,不要再重复安装——先禁用 base 行,或使用不含该行的 profile。

本地 / 发布前自检

pnpm run build:lib:host
pnpm --filter @firefly0621/dsh-superpowers pack
pnpm dsh plugin --profile superpowers-demo add ./firefly0621-dsh-superpowers-0.1.0-rc.42.tgz

(pnpm pack 默认把 tarball 写到仓库根目录。包本身没有 build script;由 host lib 构建产出 lib/。)

在本 monorepo 中启用(不经过 npm)

本包在 harness 源码树中为 opt-in。挂载随包 overlay patch(或 dsh plugin add):

pnpm dsh web --patch packages/skill/superpowers/cordis.patch.yml
pnpm dsh --profile headless --patch packages/skill/superpowers/cordis.patch.yml "task"

已在 base 中挂载 id: superpowers 的 fork 树无需再加一层;若要省略,在该行上设置 disabled: true。

配置

字段 默认 含义
skillsRoot 打包的 skills/ 目录 绝对 skill 根目录;相对路径会在 apply 时失败
bootstrap true 父会话贡献 using-superpowers(+ dsh 适配)为 skill:superpowers;子代理会话贡献短 worker preamble 为 skill:superpowers-worker
bundles ['core'] 要暴露的 bundle:core 始终包含;可加 advanced、product、authoring

完整安装示例:

- id: superpowers
  name: '@firefly0621/dsh-superpowers'
  config:
    bundles: [core, advanced, product, authoring]

更新 Superpowers

不再保留 vendored 子模块。要移植更新的上游:对每个源做 内容基线 → 目标 的 diff,再逐条走过下方 同步欠账,然后手工重放 dsh 适配。禁止只用 assets/NOTICE.md 的审阅钉点当唯一 diff 基线——那些钉点记录最近审阅,并不表示 skills/ 已等价于该树。

适配规则:替换外 harness 工具名与平台引用、移除 superpowers: skill 名前缀、行为内容保持 verbatim(仅下表允许的 dsh 例外)、并蒸馏 Matt / agent-skills / BMAD ADD(禁止倾倒 BMAD _bmad 运行时、memlog、HTML seals 或商标人设)。

自 v7.0.1 同步起,subagent-driven-development 与 writing-skills 把长篇指导放进 references/,用到哪一步就从磁盘读哪个文件,让被压缩(compaction)的会话只需重载一节而不必丢掉整个正文。重移植时请保持这个布局:把规则再写回正文会让它失效。同一次同步还删掉了 executing-plans 的示例工作流(同样为了压缩截断),并把 brainstorming 重建到 v7.0.1 文本(其中已包含 961a26d):首条消息 → 对话 → 复述 → 确定规模,每个规模都写设计文档(小改动写短版),且未经同意绝不跳过门禁。面向 architectural 澄清的 dsh 决策支持格式内联保留,并明确声明它对「每条消息一个问题」的例外;旧的三路径路由器及其独立门禁表已删除,同一个门只陈述一次。所有随包 SKILL.md 都保持在上游 20,000 字节压缩线以内,并由包测试强制。

融合,而非移植。 多个上游共同喂养一个技能,各司其职:obra 提供行为主轴,agent-skills 提供 ADD 与 OPTIMIZE 合并,Matt 提供具名扩展,BMAD 提供产品发现蒸馏。上游改版时禁止用它一家新写的版本覆盖已合并的段落——要把合并重放到新主轴上,保住每个选定来源的贡献(例如 brainstorming 在 v7 重建后仍保留 Not Doing / Always·Ask·Never;test-driven-development 在 obra 的 description 里保留了 agent-skills 的触发面)。当贡献是独立能力而不是替换段落时,在归属者下新增引用包;不要为它另开一个同级 skill 目录。选定范围之外的能力在欠账表中显式标为不在范围,而不是静默算作已移植。

允许的 dsh 非 verbatim 例外:

例外 原因
去掉 superpowers: / 外 skill 名前缀 dsh 目录使用裸名
外 harness 工具 → dsh(subagent / subagent_fork、todo_write、dsh-tools.md) 平台适配
writing-plans handoff 标签 Native → Inline 避免 “native harness” 歧义;仍表示同会话 executing-plans
sdd-workspace:拒绝无 marker 的既有目录(不收养) 相对 obra 刻意收紧所有权;见脚本头注释
捆绑脚本经 bash … 调用 打包解压可能剥掉 Unix 可执行位
保留目录 Do not use 否定句 / description 契约 融合路由门禁

内容基线与同步欠账

源 内容基线(已落入 skills/) NOTICE 审阅钉 开放欠账
obra/superpowers 主轴至 v7.0.1(2ce8aa15),brainstorming 跟随 v7.0.1 文本(其中已包含 961a26d):首条消息 → 对话 → 复述 → 确定规模,每个规模都写设计文档,未经同意绝不跳过,单张红旗表,无三路径路由器;subagent-driven-development / writing-skills 拆入 references/、executing-plans 示例工作流为压缩截断删除、保留内联 task loop(含 scripts/task-start / task-done);review-lens 与 walkthrough 蒸馏落入既有归属者;随包脚本带上基线之后的任务 ID、未闭合围栏、Windows 路径与相对 --project-dir 修复 2ce8aa15(v7.0.1)加上基线之后的 f75c01f、750ba92、3735a50、bb3a5aa、fa50d83、8b0eefc,并重新表达 369bd87;961a26d、2b2ef34、c7730f7、6ff820e 已包含在 2ce8aa15 中,699edc6 删除的测试 harness 在基线中不存在 (无)(限选定的 obra 主轴);diagnosing-superpowers 与跨 harness 参考资料留在已知限制
mattpocock/skills GLOSSARY-FORMAT 与 domain-modeling/handoff/grilling/wizard 对齐 49dd158d1;已删除 resolving-merge-conflicts;于 5beb35b0 复查(仅 chief-of-staff,未 ship);to-spec / to-tickets / wayfinder / triage 蒸馏进 writing-plans;writing-for-agents 进 context-engineering 5beb35b0 (无)(限选定能力);未选用的 Matt skill(例如 ask-matt、teach、retro、in-progress 与 misc 集)不在范围内
addyosmani/agent-skills 蒸馏 ADD;context-engineering OPTIMIZE;security-and-hardening + references/hardening-patterns.md;constraint-driven-development + 恢复的 references/floor-guard.md;于 aeac41d4 复查(落地 zod 链序修正、融合 TDD 触发面);可观测性/性能、弃用/迁移、前端工程、CI/交付与 API/接口材料蒸馏进既有归属者 aeac41d4 已交付 ADD (无)
BMAD-METHOD 功能名下的产品 ADD 蒸馏(无 _bmad 运行时);于 61e01f82 复查;correct-course 与 spec-kernel 跟随 v7 PO 的 replan.md / spec.md 契约;PRD Essential Spine、分级 PRFAQ 判定、DESIGN.md/EXPERIENCE.md、retrospective 处置、架构主轴、项目上下文、deep recon、review lenses、advanced elicitation、e2e 测试生成、skill 评测、产品 brief 与证据式 retrospective 蒸馏进既有归属者 61e01f82 已交付 ADD (无) — v7 用 PO 的 replan/spec 参考取代 bmad-correct-course/bmad-spec;人设/运行时与未选用的 build/review/customize skill 不在范围内

融合门禁清单(合入前/后必过):

  1. 目录长度保持 35;每个 skill 至多一个 bundle 标签,默认 core 目录为 19 个,且没有 skill 声明已移除的 tier 标签;无第二 meta-router;无 bmad-* skill 目录名。
  2. 任何 obra 主轴覆盖后,重断言 OPTIMIZE 合并(brainstorming Scheme B / Not Doing / Always·Ask·Never;TDD;review Standards ∥ Spec;grilling 仅用户;executing 切片/impact;refactoring clarity/structural 钉句)。
  3. agent-skills 同名重叠(refactoring、test-driven-development)就地 OPTIMIZE——不新增 peer 目录;被合并的能力以 owner 下的引用包保留。
  4. 当 obra 改变 skill 路由语义时(例如 executing-plans inline 相对 subagent-driven-development),同步更新 SEMANTIC_DESCRIPTION_GROUPS / NEGATIVE_BOUNDARY_BANNED。
  5. 重新阅读上游时 bump NOTICE 审阅钉;内容落地或欠账变化时更新 内容基线 / 欠账表;保留 ADD 的 Do not use when… 与 BMAD 出口态钉。
  6. 运行 pnpm exec vitest run packages/skill/superpowers/tests/superpowers.spec.ts。
  7. 确认 executing-plans 附带 scripts/task-start 与 scripts/task-done,且 SKILL 正文调用它们(测试失败 ≠ 不记账)。
  8. 保持每个引用包由归属者链接,且所有相对 Markdown 链接可解析;包测试中的 fusion reference packs 同时检查这两点。
  9. 保持 bundle 分配诚实:日常编码能力放 core;产品管理、技能编写与可选纪律放各自 bundle。

obra 同步时需保留: Matt 新增的 skill 目录(domain-modeling、codebase-design、prototype、wizard、grilling、handoff、wait-what 及 companion);agent-skills / BMAD ADD 目录(constraint-driven-development、source-driven-development、context-engineering、security-and-hardening、forge-idea、party-mode、spec-kernel、correct-course、prd、prfaq、ux-spec、retrospective);合并后的归属者(executing-plans 切片/impact 引用、refactoring clarity/structural/deprecation 引用、requesting-code-review review-lens/doubt 引用、subagent-driven-development parallel-dispatch 引用、source-driven-development research 引用);frontmatter 中的 bundle 分配;brainstorming、using-superpowers(意图分叉、反堆叠、tiny-edit、实现优先级、contextual gates)、test-driven-development、systematic-debugging、requesting-code-review、codebase-design、writing-plans、handoff、verification-before-completion 中的合并段落;src/index.ts 中的私有 invocation 与 bundle 解析;assets/NOTICE.md 中的审阅钉块。

CI 门禁(不只依赖 README): tests/superpowers.spec.ts 的 skill composition contracts 断言 bundle 是唯一目录元数据标签,并在 ADD 齐备后锁定 19 个 skill 的 core bundle。bundle 测试断言默认 core 目录与可选 bundle。fusion reference packs 断言上表每个融合包带着定义性钉点发布。独立门禁还断言每个引用文件都由归属者链接、每个随包 Markdown 文件的代码围栏成对,以及 skills/ 下所有相对 Markdown 链接可解析。catalog description contracts 断言语义 description 组(fail)、positive 段 negative boundary 防路由污染(fail),以及扩展 skill 间的 positive trigger 重叠(仅 warn)。tests/scripts.spec.ts 在一次性仓库中执行随包 SDD 脚本。门禁 skill 含纪律扩展集与 process spine(brainstorming、systematic-debugging、verification-before-completion、writing-plans、executing-plans、requesting-code-review、subagent-driven-development、test-driven-development)。ADD 不加入那些语义/重叠表;打包目录上的 pairwise Jaccard 描述碰撞仅 warn(提升为 fail 延后)。obra 再移植时丢掉带 bundle 的目录、重新引入 tier 标签、错分 bundle,或留下坏引用指针,都会使该包测试失败。仓库的 per-file 100% 覆盖率门禁同样适用于 src/index.ts。

版本兼容性

本 bundle 在 peerDependencies 中声明 @deepseek-ai/dsh-*。DSH 在安装与 profile 启动时用运行时版本检查这些范围;不兼容的组合会被拒绝,除非 profile 授予精确的 package@version × dsh-version 豁免。源码工作区的 workspace:* peer 指向匹配的 DSH 发布版;打包清单会替换成该精确版本。范围语义、version-exemptions / allow-version 与崩溃、数据丢失风险见插件管理器兼容性参考。

Model Experience

System-prompt bootstrap

What the model sees

每个非 subagent 请求上,system-prompt/assemble 前置段 skill:superpowers,文本为 buildBootstrapPreamble(...):下方 framing、随包 using-superpowers SKILL.md 的正文(省略 frontmatter),以及 skills/using-superpowers/references/dsh-tools.md。无 agent 的组装省略该段。session.header.origin === 'subagent' 改用 buildWorkerPreamble() 的 skill:superpowers-worker。引导随系统提示每轮重装,不是一次性用户消息,因此不会被 compaction 丢掉。当 base 组合与某个 agent preset 同时挂载本插件时,前导不会重复:最接近该 agent 作用域的挂载贡献唯一的 section。

Verbatim parent framing
<EXTREMELY_IMPORTANT>
You have superpowers.

## Standing order (before any tool call)

1. Call the dsh `skill` tool with the exact catalog name **before** clarifying, exploring, reading files, or acting — unless every tiny-edit condition in `using-superpowers` holds.
2. Anti-stack: load **one** process skill first; add supporting skills only when that skill delegates them or the user requires them. "Not an automatic workflow" means do not stack — not "skip `skill`".
3. Independent domains in one turn: issue multiple `subagent` / `subagent_fork` calls in the **same** assistant message.
4. After dispatch: finish only local work that does **not** need child results, then **end this turn**. Parent↔child talk uses adjacent `send_message` (Steer; tool returns delivery ack only — replies and `subagent-settled` arrive via inbox). Do **not** loop `list_agents` or status-ping `send_message` ("how is it going?") to wait.

**Below is the full content of your `using-superpowers` skill — your introduction to using skills.
For all other skills, call the dsh `skill` tool with the exact catalog name.**

[full using-superpowers SKILL.md body — frontmatter omitted]

## DeepSeek Harness platform adaptation

Your harness is DeepSeek Harness. Follow this adaptation (same role as Superpowers `references/*-tools.md`):

[full dsh-tools.md]
</EXTREMELY_IMPORTANT>
Verbatim worker preamble
<EXTREMELY_IMPORTANT>
You are a Superpowers **worker** subagent.

1. Execute the dispatch brief. Do not invent a second process workflow or re-route the parent task.
2. `using-superpowers` / skill-first orchestration belongs to the **parent**. SUBAGENT-STOP means ignore that standing skill — **not** "refuse every catalog skill".
3. Call `skill` only when the brief names a skill, or a catalog entry is clearly required to finish the brief.
4. Do the assigned work yourself unless the brief says otherwise. Prefer finishing over polling parent state.
5. You may `send_message` your direct parent (and the parent may message you): delivery ack only; put self-contained findings in the message body. Settlement is separate and unconditional.
</EXTREMELY_IMPORTANT>

Token effect

每个非 subagent 请求携带一段较长的系统提示段;skill 目录开销由 dsh-tool-skill 负责。

KV Cache effect

在固定 skillsRoot 与 bootstrap 开关下为稳定前缀:段文本在插件 apply 时加载一次并复用。bootstrap 保持开启且随包 preamble 不变时,渲染文本逐字节稳定,warm 前缀缓存可复用。更改 skillsRoot 或关闭 bootstrap 会改变组装结果。

Skill catalog and skill tool

What the model sees

经 @deepseek-ai/dsh-tool-skill 间接呈现:目录中的 Superpowers skill 摘要,以及通过 skill 加载的正文。

Token effect

随 skill 数量与目录描述上限变化。打包目录共 35 个 skill;默认 core 目录 19 个,其中 16 个模型可见。可选 bundle 另含 16 个 skill,其中 15 个模型可见(grilling 仅用户)。引用包不增加目录条目。

KV Cache effect

与 skill 消费方相同:初始目录接在可复用前缀后;替换目录追加。

Known Limitations and Deferred Work

  • 不发布运行时 invariant companion; skill 是不可变打包文件,引导是 system-prompt/assemble 监听,没有可独立观察的持久事件流。离线 turn 评分见 scripts/score-skill-first.mjs(每 turn 首个 tool/call 是否为 skill,以及派发 subagent / subagent_fork 之后同 turn 的 list_agents 次数);它不在运行时强制行为。
  • 不是上游 hook 二进制 — 引导是 Cordis system-prompt/assemble 监听,不是 hooks/session-start。
  • complete persona 会替换所有 section — 组合中注册了 complete persona(agent preset)的 agent,其所有 prompt section(含 skill:superpowers 与 skill:superpowers-worker)都会被抑制。
  • 随包 preamble 须避免 {{...}} 提示变量语法 — loadBootstrapPreamble 在插件 apply 时拒绝完整 {{name}} 组(对齐 skill-always-apply);自定义 skillsRoot 若引入此类语法会在首轮前失败。
  • 跨 harness 参考内容已移除 — 外平台工具对照、Anthropic 专属写作指南、以及特定 harness 的测试示例均省略;dsh-tools.md 是唯一平台适配,且必须写到足以支撑 SDD 的等待/续聊/模型路由。
  • 上游同步为手工 — 无 vendored 子模块;移植即对照记录的各源 commit diff 后重放 dsh 适配。本地 superpowers/ 检出仅供对照,请放在本仓库之外。
  • diagnosing-superpowers 不进目录 — obra v6.4.1+ 提供依赖外 harness 会话转录路径与大量 prompt/template 树的会话诊断 skill;浅移植会误导。深 dsh 适配是独立功能,不是开放同步欠账。打包目录长度为 35;默认 core 为 19。
  • 可选 bundle 需显式开启 — advanced、product、authoring 随包发布但不默认加载。需要产品发现或技能编写的 profile 必须在 config 中加 bundle 名;插件不会按任务自动推断。
  • BMAD 产品技能保持蒸馏态 — prd、prfaq、party-mode、retrospective、correct-course、spec-kernel 承载当前 v7 工作流的精简蒸馏,不承载 BMAD 的人设/运行时层。correct-course 与 spec-kernel 跟随 v7 PO 的 replan/spec 契约;PRD 保留 Essential Spine 的承重字段,PRFAQ 保留分级判定与 distillate,retrospective 把单条 finding 的处置与 epic 判定分开。未选用的上游能力(build/code-review/customize/bmod 运行时)不在范围内,而不是静默丢弃。
  • using-superpowers 是常驻成本 — 它的正文会注入每个非 subagent 回合;打包正文约为 obra 的 2.4 倍,现在只带一张合并后的红旗/推诿表(替代原来的两张),外加 dsh 的优先级与 tiny-edit 规则。为守住 8,000 字节 bootstrap 预算,表格经过合并与精简。注入前会剥离 frontmatter。tests/superpowers.spec.ts 里有二十余条钉点守着这次改动,继续精简需要单独一次有度量的改动,而不是顺手砍。
  • SDD 脚本从工作目录解析仓库 — 请从目标仓库根目录运行,或传 -C DIR。在 skill 目录下运行会把 ledger 与 brief 写进错误仓库。
  • 引用包是按需加载的磁盘载荷 — 它们不增加目录条目,也不产生常驻提示成本,但会随 tarball 发布,并且只在归属者在相关步骤链接时读取。挂在错误步骤上的引用包是死重;链接完整性门禁能抓坏路径,抓不到错误路由。
  • peer 来自 DeepSeek Harness — 本组合包不内嵌 @deepseek-ai/dsh-*;请安装到已有 CLI/base 栈的 profile。
  • fork 产品 base 可能挂载发布 scope — 部分 fork 的 dsh-base 组合依赖 @firefly0621/dsh-superpowers,使产品默认与 npm 身份保持同一包;本 monorepo 仅通过 overlay patch 或 dsh plugin add 挂载。拆分私有 workspace 名与发布名仍暂缓。
  • 描述碰撞检查先警告 — 打包目录 pairwise Jaccard ≥ 0.55 只记警告;在融合目录稳定后再提升为失败。

开发备注

本包持有 skill 发现、bundle 过滤、invocation 元数据与系统提示词引导。@deepseek-ai/dsh-skill、dsh-skill-filesystem 与 dsh-tool-skill 仍归上游且未修改。