@wenaixi/dsh-superpower 7.0.0 → 7.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/README.md +5 -5
  2. package/lib/catalog.d.ts +98 -0
  3. package/lib/catalog.d.ts.map +1 -0
  4. package/lib/catalog.js +295 -0
  5. package/lib/catalog.js.map +1 -0
  6. package/lib/document.d.ts +61 -0
  7. package/lib/document.d.ts.map +1 -0
  8. package/lib/document.js +268 -0
  9. package/lib/document.js.map +1 -0
  10. package/lib/superpowers.d.ts +6 -0
  11. package/lib/superpowers.d.ts.map +1 -1
  12. package/lib/superpowers.js +27 -250
  13. package/lib/superpowers.js.map +1 -1
  14. package/package.json +2 -2
  15. package/skills/brainstorming/SKILL.md +1 -1
  16. package/skills/brainstorming/scripts/server.cjs +6 -14
  17. package/skills/brainstorming/scripts/start-server.sh +1 -6
  18. package/skills/brainstorming/spec-document-reviewer-prompt.md +1 -1
  19. package/skills/brainstorming/visual-companion.md +5 -31
  20. package/skills/diagnosing-superpowers/SKILL.md +1 -1
  21. package/skills/diagnosing-superpowers/prompts/request-conflicts.md +1 -1
  22. package/skills/diagnosing-superpowers/templates/issue.md +1 -1
  23. package/skills/dispatching-parallel-agents/SKILL.md +4 -4
  24. package/skills/executing-plans/SKILL.md +5 -5
  25. package/skills/finishing-a-development-branch/SKILL.md +5 -5
  26. package/skills/receiving-code-review/SKILL.md +1 -1
  27. package/skills/requesting-code-review/SKILL.md +1 -1
  28. package/skills/requesting-code-review/code-reviewer.md +1 -1
  29. package/skills/subagent-driven-development/SKILL.md +2 -2
  30. package/skills/subagent-driven-development/implementer-prompt.md +1 -1
  31. package/skills/subagent-driven-development/re-review-prompt.md +1 -1
  32. package/skills/subagent-driven-development/scripts/sdd-workspace +2 -2
  33. package/skills/subagent-driven-development/task-reviewer-prompt.md +1 -1
  34. package/skills/systematic-debugging/CREATION-LOG.md +2 -2
  35. package/skills/systematic-debugging/SKILL.md +2 -2
  36. package/skills/systematic-debugging/condition-based-waiting.md +3 -3
  37. package/skills/systematic-debugging/defense-in-depth.md +1 -1
  38. package/skills/systematic-debugging/root-cause-tracing.md +1 -1
  39. package/skills/systematic-debugging/test-pressure-3.md +1 -1
  40. package/skills/test-driven-development/SKILL.md +1 -1
  41. package/skills/test-driven-development/writing-good-tests.md +1 -1
  42. package/skills/using-git-worktrees/SKILL.md +1 -1
  43. package/skills/using-superpowers/SKILL.md +4 -10
  44. package/skills/using-superpowers/references/dsh-tools.md +3 -3
  45. package/skills/verification-before-completion/SKILL.md +1 -1
  46. package/skills/writing-plans/SKILL.md +1 -1
  47. package/skills/writing-skills/SKILL.md +6 -6
  48. package/skills/writing-skills/testing-skills-with-subagents.md +1 -1
  49. package/skills/using-superpowers/references/antigravity-tools.md +0 -23
  50. package/skills/using-superpowers/references/claude-code-tools.md +0 -11
  51. package/skills/using-superpowers/references/codex-tools.md +0 -108
  52. package/skills/using-superpowers/references/gemini-tools.md +0 -63
  53. package/skills/using-superpowers/references/hermes-tools.md +0 -56
  54. package/skills/using-superpowers/references/muse-tools.md +0 -35
  55. package/skills/using-superpowers/references/pi-tools.md +0 -16
  56. package/skills/writing-skills/anthropic-best-practices.md +0 -1146
  57. package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +0 -188
@@ -1 +1 @@
1
- {"version":3,"file":"superpowers.js","sourceRoot":"","sources":["../src/superpowers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"superpowers.js","sourceRoot":"","sources":["../src/superpowers.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wenaixi/dsh-superpower",
3
- "version": "7.0.0",
3
+ "version": "7.1.0",
4
4
  "description": "obra/superpowers 的 DSH 移植版 — 将完整的多智能体开发方法论以原生 DSH 技能开箱即用",
5
5
  "type": "module",
6
6
  "main": "lib/superpowers.js",
@@ -63,4 +63,4 @@
63
63
  "publishConfig": {
64
64
  "access": "public"
65
65
  }
66
- }
66
+ }
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: brainstorming
3
- description: "Superpower Skill(最高优先级):创意工作前必用——创建功能、构建组件、新增能力或变更行为前,先澄清用户意图、需求与设计,再进入实现。"
3
+ description: "Superpower Skill:创意工作前必用——创建功能、构建组件、新增能力或变更行为前,先澄清用户意图、需求与设计,再进入实现。"
4
4
  ---
5
5
 
6
6
  # 将想法头脑风暴为设计
@@ -106,8 +106,7 @@ const SUPERPOWERS_VERSION = readSuperpowersVersion();
106
106
  const SUPERPOWERS_BRAND_IMAGE_URL = 'https://primeradiant.com/brand/superpowers-visual-brainstorming-logo.png';
107
107
  const TELEMETRY_DISABLE_ENV_VARS = [
108
108
  'SUPERPOWERS_DISABLE_TELEMETRY',
109
- 'DISABLE_TELEMETRY',
110
- 'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC'
109
+ 'DISABLE_TELEMETRY'
111
110
  ];
112
111
  const SUPERPOWERS_TELEMETRY_DISABLED = TELEMETRY_DISABLE_ENV_VARS.some(name => isTruthyEnv(process.env[name]));
113
112
  let ownerPid = process.env.BRAINSTORM_OWNER_PID ? Number(process.env.BRAINSTORM_OWNER_PID) : null;
@@ -207,18 +206,11 @@ const helperInjection = '<script>\n' + helperScript + '\n</script>';
207
206
 
208
207
  function readSuperpowersVersion() {
209
208
  const root = path.join(__dirname, '../../..');
210
- const manifests = [
211
- path.join(root, 'package.json'),
212
- path.join(root, '.codex-plugin/plugin.json')
213
- ];
214
-
215
- for (const manifest of manifests) {
216
- try {
217
- const data = JSON.parse(fs.readFileSync(manifest, 'utf-8'));
218
- if (data.version) return String(data.version);
219
- } catch (e) {
220
- // Packaged Codex plugins omit package.json; try the next manifest.
221
- }
209
+ try {
210
+ const data = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8'));
211
+ if (data.version) return String(data.version);
212
+ } catch (e) {
213
+ // DSH bundle reads version directly from root package.json
222
214
  }
223
215
 
224
216
  return 'unknown';
@@ -15,7 +15,7 @@
15
15
  # --open Auto-open the browser on the first screen (use only
16
16
  # after the user approves the visual companion).
17
17
  # --foreground Run server in the current terminal (no backgrounding).
18
- # --background Force background mode (overrides Codex auto-foreground).
18
+ # --background Force background mode.
19
19
 
20
20
  SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
21
21
 
@@ -94,11 +94,6 @@ is_windows_like_shell() {
94
94
  return 1
95
95
  }
96
96
 
97
- # Some environments reap detached/background processes. Auto-foreground when detected.
98
- if [[ -n "${CODEX_CI:-}" && "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
99
- FOREGROUND="true"
100
- fi
101
-
102
97
  # Windows/Git Bash reaps nohup background processes. Auto-foreground when detected.
103
98
  if [[ "$FOREGROUND" != "true" && "$FORCE_BACKGROUND" != "true" ]]; then
104
99
  if is_windows_like_shell; then
@@ -1,4 +1,4 @@
1
- # Spec 文档审查提示词模板
1
+ # Spec 文档 reviewer prompt 模板
2
2
 
3
3
  在派发 Spec 文档审查 subagent 时使用本模板。
4
4
 
@@ -33,8 +33,8 @@
33
33
  ## 启动会话
34
34
 
35
35
  ```bash
36
- # Start AFTER the user approves the companion. --open auto-opens their browser on
37
- # the first screen; --project-dir persists mockups and enables same-port restart.
36
+ # 在用户批准 companion 后启动。--open 会在首屏自动打开其浏览器;
37
+ # --project-dir 持久化原型并支持同端口重启。
38
38
  bash scripts/start-server.sh --project-dir /path/to/project --open
39
39
 
40
40
  # Returns: {"type":"server-started","port":52341,
@@ -51,40 +51,14 @@ bash scripts/start-server.sh --project-dir /path/to/project --open
51
51
 
52
52
  **注意:** 将项目根目录作为 `--project-dir` 传入,这样原型会持久化到 `.superpowers/brainstorm/` 并在服务器重启后依然保留。若不传,文件会写入 `/tmp` 并被清理。如果 `.gitignore` 中尚未包含 `.superpowers/`,请提醒用户添加。
53
53
 
54
- **按平台启动服务器:**
54
+ **在 DSH 中启动服务器:**
55
55
 
56
- **Claude Code:**
57
56
  ```bash
58
- # Default mode works — the script backgrounds the server itself.
59
- bash scripts/start-server.sh --project-dir /path/to/project --open
60
- ```
61
-
62
- 在 Windows 上,脚本会自动检测并切换到前台模式(会阻塞工具调用)。请在 Bash 工具调用上使用 `run_in_background: true`,使服务器在对话轮次之间保持运行,然后在下一轮读取 `$STATE_DIR/server-info` 以获取 URL 和端口。
63
-
64
- **Codex:**
65
- ```bash
66
- # Codex reaps background processes. The script auto-detects CODEX_CI and
67
- # switches to foreground mode. Run it normally — no extra flags needed.
68
- bash scripts/start-server.sh --project-dir /path/to/project --open
69
- ```
70
-
71
- **Gemini CLI:**
72
- ```bash
73
- # Use --foreground and set is_background: true on your shell tool call
74
- # so the process survives across turns
75
- bash scripts/start-server.sh --project-dir /path/to/project --open --foreground
76
- ```
77
-
78
- **Copilot CLI:**
79
- ```bash
80
- # Start it with Copilot CLI's non-blocking/background shell mechanism so the
81
- # server survives across turns. Keep --foreground so the harness, not the
82
- # script, owns backgrounding. The launcher is a .sh, so invoke it via bash
83
- # (on Windows, call Git Bash's bash.exe from the PowerShell tool).
57
+ # 在 DSH 中使用 pwsh(Windows 首选)或 bash 工具,传入 run_in_background: true
84
58
  bash scripts/start-server.sh --project-dir /path/to/project --open --foreground
85
59
  ```
86
60
 
87
- **其他环境:** 服务器必须在后台持续运行并跨越对话轮次。如果你的环境会回收 detached 进程,请使用 `--foreground` 并通过平台提供的后台执行机制来启动命令。
61
+ 服务器必须在后台持续运行并跨越 turn。在 DSH 工具调用中使用 `run_in_background: true`,然后在下一轮读取 `$STATE_DIR/server-info` 以获取 URL 和端口。
88
62
 
89
63
  如果 URL 在你的浏览器中无法访问(在远程/容器化环境中很常见),请绑定非回环地址:
90
64
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: diagnosing-superpowers
3
- description: "Superpower Skill(最高优先级):当 superpowers 会话出错、human partner 想查原因(重复工作、忽略计划、技能未触发、耗时过长、成本过高、结果不佳)或想为维护者建缺陷报告时,适用当前或历史会话。"
3
+ description: "Superpower Skill:当 superpowers 会话出错、human partner 想查原因(重复工作、忽略计划、技能未触发、耗时过长、成本过高、结果不佳)或想为维护者建缺陷报告时,适用当前或历史会话。"
4
4
  ---
5
5
 
6
6
  # 诊断 superpowers
@@ -5,7 +5,7 @@
5
5
  1. 列出每条人类 prompt 及其行与回合。对每条,提取其包含的指令(祈使句、约束、"don't"、"always"、"never"、"only"、范围陈述)。
6
6
  2. 报告:
7
7
  - 两条无法同时遵守的人类指令(两处都引用并附行),以及助手做了什么;
8
- - 与会话中加载的指令文件(CLAUDE.md、AGENTS.md、GEMINI.md 或 harness 等价物;路径在 case 文件中)冲突的人类指令,两处都引用;
8
+ - 与会话中加载的指令文件(AGENTS.md、CLAUDE.md 等;路径在 case 文件中)冲突的人类指令,两处都引用;
9
9
  - 人类指令要求跳过、忽略或覆盖某步骤、技能或规则,以及之后发生了什么;
10
10
  - 助手请求澄清的指令及回答(当回答改变了范围时)。
11
11
  3. 不要评判你的 human partner 是否正确。报告冲突与助手的解决方式。
@@ -7,7 +7,7 @@
7
7
  | 字段 | 值 | 来源 / 支撑证据 |
8
8
  |-------|-------|-------------------------------|
9
9
  | superpowers 版本 | <version>(<sha 或 "not a checkout">) | <历史证据 / 未验证快照 / 当前观察 / 未知>;<位置> |
10
- | harness(Claude Code、Cursor 等) | <harness> | <标签>;<位置> |
10
+ | harness (DSH) | <harness> | <标签>;<位置> |
11
11
  | harness 版本 | <version> | <标签>;<位置> |
12
12
  | 你的模型 + 版本 | <所见 model ids> | <标签>;<位置> |
13
13
  | 已安装的全部插件 | <列表> | <标签>;<位置> |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: dispatching-parallel-agents
3
- description: "Superpower Skill(最高优先级):面向 2 个以上无共享状态、无前后依赖的独立任务,并行委派多个 subagent 协同处理的高效分发模式。"
3
+ description: "Superpower Skill:面向 2 个以上无共享状态、无前后依赖的独立任务,并行委派多个 subagent 协同处理的高效分发模式。"
4
4
  ---
5
5
 
6
6
  # 并行分发 agent
@@ -71,7 +71,7 @@ digraph when_to_use {
71
71
  Subagent (general-purpose): "Fix agent-tool-abort.test.ts failures"
72
72
  Subagent (general-purpose): "Fix batch-completion-behavior.test.ts failures"
73
73
  Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
74
- # All three run concurrently.
74
+ # 全部三个并发执行。
75
75
  ```
76
76
 
77
77
  在同一条回复中发起多次分发调用 = 并行执行。每条回复只发一次 = 串行执行。
@@ -84,9 +84,9 @@ Subagent (general-purpose): "Fix tool-approval-race-conditions.test.ts failures"
84
84
  - 运行完整测试套件
85
85
  - 整合所有变更
86
86
 
87
- ## agent 提示词结构
87
+ ## agent prompt 结构
88
88
 
89
- 优秀的 agent 提示词应具备:
89
+ 优秀的 agent prompt应具备:
90
90
  1. **聚焦** - 一个清晰的问题域
91
91
  2. **自包含** - 包含理解问题所需的全部上下文
92
92
  3. **输出明确** - agent 应该返回什么?
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: executing-plans
3
- description: "Superpower Skill(最高优先级):当你在本会话中亲自作为实现者执行实施计划时使用——human partner 选择了内联执行,或环境不提供 subagent 工具。"
3
+ description: "Superpower Skill:当你在本会话中亲自作为实现者执行实施计划时使用——human partner 选择了内联执行,或环境不提供 subagent 工具。"
4
4
  ---
5
5
 
6
6
  # 执行计划
@@ -79,7 +79,7 @@ digraph process {
79
79
 
80
80
  workspace 与 ledger 与 subagent-driven-development 共用——同一个目录、同一种格式——所以一份计划可以在执行中途换执行者,新执行者从同一份 ledger 接着往下做。
81
81
 
82
- - 每份计划拥有一个 workspace:技能开始时运行 `../subagent-driven-development/scripts/sdd-workspace PLAN_FILE`——它会打印本计划的 git 忽略目录(`<repo-root>/.superpowers/sdd/<plan-basename>/`),该目录是这份计划所有产物的家:ledger、brief、review package。别的计划的目录永远不归你读写。
82
+ - 每份计划拥有一个 workspace:技能开始时运行 `bash ../subagent-driven-development/scripts/sdd-workspace PLAN_FILE`——它会打印本计划的 git 忽略目录(`<repo-root>/.superpowers/sdd/<plan-basename>/`),该目录是这份计划所有产物的家:ledger、brief、review package。别的计划的目录永远不归你读写。
83
83
  - 在本计划的 `<workspace>/progress.md` 检查 ledger。如果它的第一行点名的是你的计划文件,那么带 `Task <N>: complete` 行的任务就是已完成的——不要重做;从第一个没有该行的任务继续。即使你的上下文已不记得做过,它们的提交也确实存在于 git 中:压缩之后,宁可相信 ledger 与 `git log`,也不要相信自己的回忆。第一行点名了另一份计划文件的 ledger,是别的计划的进度:别动它,另起一份全新的。
84
84
  - 创建 ledger,第一行写身份:`# SDD ledger — plan: <plan file path>`。
85
85
  - `git clean -fdx` 会摧毁 workspace(它是 git 忽略的临时区);真要发生,从 `git log` 恢复。
@@ -96,7 +96,7 @@ workspace 与 ledger 与 subagent-driven-development 共用——同一个目录
96
96
 
97
97
  ### 1. 接手任务
98
98
 
99
- - 运行本技能的 `scripts/task-start PLAN_FILE N`。它在一次调用中打印 brief 路径与 BASE(该任务评审区间的起点提交)。每个任务都要读 brief,包括你在准备阶段记得的那些:你记得的是摘要,brief 里才是精确的取值、签名与测试用例。
99
+ - 运行本技能的 `bash scripts/task-start PLAN_FILE N`。它在一次调用中打印 brief 路径与 BASE(该任务评审区间的起点提交)。每个任务都要读 brief,包括你在准备阶段记得的那些:你记得的是摘要,brief 里才是精确的取值、签名与测试用例。
100
100
  - 把该任务的 todo 标为 in_progress。
101
101
 
102
102
  每一次工具调用都是一轮重新读取你全部上下文的过程。记账要搭着干活一起走——追加 ledger 与提交放在同一次调用里,绝不单独花一次调用。
@@ -126,7 +126,7 @@ workspace 与 ledger 与 subagent-driven-development 共用——同一个目录
126
126
 
127
127
  ### 4. 完成任务
128
128
 
129
- 运行本技能的 `scripts/task-done PLAN_FILE N BASE -- <测试命令>`,测试命令用 brief 为整个任务点名的那条。它会运行测试,把完整输出留在 workspace,打印尾部,并且——只在测试通过时——把完成行追加到 ledger:
129
+ 运行本技能的 `bash scripts/task-done PLAN_FILE N BASE -- <测试命令>`,测试命令用 brief 为整个任务点名的那条。它会运行测试,把完整输出留在 workspace,打印尾部,并且——只在测试通过时——把完成行追加到 ledger:
130
130
 
131
131
  `Task <N>: complete (commits <base7>..<head7>, tests: <command> → <result>)`
132
132
 
@@ -134,7 +134,7 @@ workspace 与 ledger 与 subagent-driven-development 共用——同一个目录
134
134
 
135
135
  ## 最终评审
136
136
 
137
- 运行 `../subagent-driven-development/scripts/review-package PLAN_FILE MERGE_BASE HEAD`(MERGE_BASE = 分支起点的提交,例如 `git merge-base main HEAD`),并从它打印出的文件出发评审。
137
+ 运行 `bash ../subagent-driven-development/scripts/review-package PLAN_FILE MERGE_BASE HEAD`(MERGE_BASE = 分支起点的提交,例如 `git merge-base main HEAD`),并从它打印出的文件出发评审。
138
138
 
139
139
  **有 subagent 工具时:** 用可用的最强模型派发 reviewer——全分支评审是一项判断题——使用 requesting-code-review 的 [code-reviewer.md](../requesting-code-review/code-reviewer.md),并把包路径、计划与规格路径、计划的 Review Focus 段(若存在)逐字交给它(该段列出计划的测试未覆盖的输入类别与失败模式——reviewer 要逐条刻意检查),再加一个指向 ledger 中 `Ruling:` 行的提示,让它能权衡你所做的决定。明确指定模型;省略模型会继承本会话的模型,而它未必是最强的。这是整轮执行唯一买到的一份全新上下文。不要跳过它,也不要用你自己读 diff 来代替它。
140
140
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: finishing-a-development-branch
3
- description: "Superpower Skill(最高优先级):实现完成且全部测试通过后,用于决定分支集成方式,支持本地合并、创建 PR 或保留分支等完整收尾流程。"
3
+ description: "Superpower Skill:实现完成且全部测试通过后,用于决定分支集成方式,支持本地合并、创建 PR 或保留分支等完整收尾流程。"
4
4
  ---
5
5
 
6
6
  # 完成开发分支
@@ -30,8 +30,8 @@ description: "Superpower Skill(最高优先级):实现完成且全部测
30
30
  ```bash
31
31
  GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P)
32
32
  GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P)
33
- # Capture now, while still inside the workspace — Step 5 changes directory
34
- # before cleanup (Step 6) needs this value
33
+ # 此时仍在工作区内,立即捕获此值——步骤 5 会切换目录,
34
+ # 而后清理阶段(步骤 6)需要该值
35
35
  WORKTREE_PATH=$(git rev-parse --show-toplevel)
36
36
  ```
37
37
 
@@ -45,7 +45,7 @@ WORKTREE_PATH=$(git rev-parse --show-toplevel)
45
45
 
46
46
  ## 步骤 3:确定基线分支
47
47
 
48
- 基线分支即本次工作分叉时的来源分支——通常在计划、对话记录或分支的上游中已注明。若尚未明确,请询问:“该分支是从 <你的最佳推测> 分叉出来的,这样对吗?” 合并前务必确认:合错基线分支的回滚成本很高。
48
+ 基线分支即本次工作 fork 时的来源分支——通常在计划、对话记录或分支的上游中已注明。若尚未明确,请询问:“该分支是从 <你的最佳推测> fork 出来的,这样对吗?” 合并前务必确认:合错基线分支的回滚成本很高。
49
49
 
50
50
  ## 步骤 4:提供选项
51
51
 
@@ -198,5 +198,5 @@ worktree 移除被拒绝——以下文件尚未提交:
198
198
  | “这个 worktree 看起来废弃了——顺手一起清理” | 仅清理位于 `.worktrees/` 或 `worktrees/` 下的 worktree,其余均归宿主环境所有。 |
199
199
  | “移除被拒——用 `--force` 收个尾就行” | 拒绝意味着文件仅存在于该 worktree,`--force` 会永久销毁它们,请向 human partner 展示并征询意见。 |
200
200
  | “合并后失败大概是偶发问题” | 合并结果失败则立即中止,保留分支与 worktree 以便排查。 |
201
- | “基线分支显然是 main” | 请确认分叉点或主动询问,合错基线的回滚成本很高。 |
201
+ | “基线分支显然是 main” | 请确认fork 点或主动询问,合错基线的回滚成本很高。 |
202
202
  | “推送被拒——强制推送就能解决” | 推送被拒说明远端已有更新,请先排查;仅在 human partner 明确要求时才执行强制推送。 |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: receiving-code-review
3
- description: "Superpower Skill(最高优先级):收到代码评审意见时使用,实施建议前需技术验证与澄清,适用于反馈模糊或存疑场景,强调严谨核实而非盲从。"
3
+ description: "Superpower Skill:收到代码评审意见时使用,实施建议前需技术验证与澄清,适用于反馈模糊或存疑场景,强调严谨核实而非盲从。"
4
4
  ---
5
5
 
6
6
  # 接收代码评审
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: requesting-code-review
3
- description: "Superpower Skill(最高优先级):在任务完成、重大功能实现或准备合并到主分支时发起,用于校验实现是否符合需求与质量标准,建议定期执行。"
3
+ description: "Superpower Skill:在任务完成、重大功能实现或准备合并到主分支时发起,用于校验实现是否符合需求与质量标准,建议定期执行。"
4
4
  ---
5
5
 
6
6
  # 请求代码评审
@@ -1,4 +1,4 @@
1
- # 代码评审提示词模板
1
+ # code reviewer prompt 模板
2
2
 
3
3
  在派发代码评审 subagent 时使用此模板。
4
4
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: subagent-driven-development
3
- description: "Superpower Skill(最高优先级):在当前会话内执行包含独立任务的实现计划时使用,基于 subagent 分发与逐任务评审保障质量。"
3
+ description: "Superpower Skill:在当前会话内执行包含独立任务的实现计划时使用,基于 subagent 分发与逐任务评审保障质量。"
4
4
  ---
5
5
 
6
6
  # subagent 驱动开发
@@ -170,7 +170,7 @@ digraph process {
170
170
 
171
171
  你粘贴到分发提示中的一切——以及 subagent 返回的一切——都会在会话剩余时间内常驻上下文,并在后续每一轮被重新读取。请以文件形式移交产物。
172
172
 
173
- **等待已分发的 subagent 时:** 切勿以短超时轮询等待接口,也不要陷入无声的无限等待。当你有本地工作可做时——更新 ledger、打包下一份评审、阅读报告——持续推进;子代结果会自行到达。当你真正空闲时,以有界时长等待(平台允许时每次 5 至 10 分钟),并在每段间隔发布一行状态、核对存活的子代:列出它们,并追查任何已完成却未上报的子代。有界等待几乎保留了长等待的全部效率,同时保证卡住或丢失的子代能在数分钟内被发现,而非等到会话结束。
173
+ **等待已分发的 subagent 时:** 切勿以短超时 poll等待接口,也不要陷入无声的无限等待。当你有本地工作可做时——更新 ledger、打包下一份评审、阅读报告——持续推进;子代结果会自行到达。当你真正空闲时,以有界时长等待(平台允许时每次 5 至 10 分钟),并在每段间隔发布一行状态、核对存活的子代:列出它们,并追查任何已完成却未上报的子代。有界等待几乎保留了长等待的全部效率,同时保证卡住或丢失的子代能在数分钟内被发现,而非等到会话结束。
174
174
 
175
175
  ### 1. 分发实现者
176
176
 
@@ -1,4 +1,4 @@
1
- # 实现者 subagent 提示词模板
1
+ # implementer subagent prompt 模板
2
2
 
3
3
  在分发实现者 subagent 时使用此模板。
4
4
 
@@ -1,4 +1,4 @@
1
- # 定点复审提示词模板
1
+ # re-review prompt 模板
2
2
 
3
3
  在派发修复轮次后的复审时使用此模板。re-reviewer 负责核实上一轮的问题是否已修复,并检查修复 diff 是否引入新的破坏性变更。这不是一次全新的评审——完整评审已经完成。
4
4
 
@@ -18,8 +18,8 @@
18
18
  # legacy workspace adopts instead of detecting; acceptable, marker-less
19
19
  # workspaces age out as plans finish.
20
20
  #
21
- # The workspace lives in the working tree (not under .git/) because Claude Code
22
- # treats .git/ as a protected path and denies agent writes there — which blocks
21
+ # The workspace lives in the working tree (not under .git/) because subagent
22
+ # sandbox policies treat .git/ as a protected path and deny writes there — which blocks
23
23
  # an implementer subagent from writing its report file. A self-ignoring
24
24
  # .gitignore at .superpowers/sdd/ keeps every plan's workspace out of
25
25
  # `git status` and out of accidental commits without modifying any tracked file.
@@ -1,4 +1,4 @@
1
- # 任务 reviewer 提示词模板
1
+ # task reviewer prompt 模板
2
2
 
3
3
  在派发任务评审 subagent 时使用本模板。reviewer 只读取一次任务的 diff,并返回两项裁决:规格符合度与代码质量。
4
4
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## 来源材料
6
6
 
7
- 从 `~/.claude/CLAUDE.md` 提取的调试框架:
7
+ 从早期版本的 `CLAUDE.md` 用户指令中提取的调试框架:
8
8
  - 四阶段系统化流程(调查 → 模式分析 → 假设 → 实现)
9
9
  - 核心原则:始终定位根因,绝不只修复表象
10
10
  - 规则设计用于抵御时间压力与自我合理化
@@ -99,7 +99,7 @@
99
99
 
100
100
  ## 关键洞察
101
101
 
102
- **最重要的加固点:** 反模式章节展示了在当下看似合理的捷径。当 Claude 产生“我就加这一个快速修复”的念头时,看到该模式被明确列为错误,会产生认知阻力。
102
+ **最重要的加固点:** 反模式章节展示了在当下看似合理的捷径。当 agent 产生“我就加这一个快速修复”的念头时,看到该模式被明确列为错误,会产生认知阻力。
103
103
 
104
104
  ## 使用示例
105
105
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: systematic-debugging
3
- description: "Superpower Skill(最高优先级):遇到缺陷、测试失败或异常行为时使用,要求先完成根因分析再提出修复,确保系统化调试。"
3
+ description: "Superpower Skill:遇到缺陷、测试失败或异常行为时使用,要求先完成根因分析再提出修复,确保系统化调试。"
4
4
  ---
5
5
 
6
6
  # 系统化调试
@@ -280,4 +280,4 @@ description: "Superpower Skill(最高优先级):遇到缺陷、测试失
280
280
 
281
281
  - **`root-cause-tracing.md`** - 沿调用栈回溯追踪,直至找到最初触发点
282
282
  - **`defense-in-depth.md`** - 找到根因后在多层添加校验
283
- - **`condition-based-waiting.md`** - 用条件轮询替代固定时延等待
283
+ - **`condition-based-waiting.md`** - 用条件poll替代固定时延等待
@@ -57,7 +57,7 @@ expect(result).toBeDefined();
57
57
 
58
58
  ## 实现
59
59
 
60
- 通用轮询函数:
60
+ 通用poll函数:
61
61
 
62
62
  ```typescript
63
63
  async function waitFor<T>(
@@ -84,8 +84,8 @@ async function waitFor<T>(
84
84
 
85
85
  ## 常见错误
86
86
 
87
- **[FAIL] 轮询过快:** `setTimeout(check, 1)` - 浪费 CPU
88
- **[OK] 修正:** 每 10ms 轮询一次
87
+ **[FAIL] poll过快:** `setTimeout(check, 1)` - 浪费 CPU
88
+ **[OK] 修正:** 每 10ms poll一次
89
89
 
90
90
  **[FAIL] 无超时:** 条件始终不满足时会无限循环
91
91
  **[OK] 修正:** 始终设置超时,并给出清晰的错误信息
@@ -54,7 +54,7 @@ function initializeWorkspace(projectDir: string, sessionId: string) {
54
54
 
55
55
  ```typescript
56
56
  async function gitInit(directory: string) {
57
- // In tests, refuse git init outside temp directories
57
+ // 在测试中,拒绝在临时目录之外执行 git init
58
58
  if (process.env.NODE_ENV === 'test') {
59
59
  const normalized = normalize(resolve(directory));
60
60
  const tmpDir = normalize(resolve(tmpdir()));
@@ -68,7 +68,7 @@ Project.create('name', context.tempDir); // Accessed before beforeEach!
68
68
  当无法手动追溯时,添加插桩:
69
69
 
70
70
  ```typescript
71
- // Before the problematic operation
71
+ // 在执行问题操作之前
72
72
  async function gitInit(directory: string) {
73
73
  const stack = new Error().stack;
74
74
  console.error('DEBUG git init:', {
@@ -21,7 +21,7 @@
21
21
 
22
22
  **技术负责人:**“调查要花多久?”
23
23
 
24
- **你:**“大概需要 30-45 分钟来梳理中间件并弄清令牌生命周期。”
24
+ **你:**“大概需要 30-45 分钟来梳理中间件并弄清令牌lifecycle。”
25
25
 
26
26
  **技术负责人:**“这次会议已经超时 20 分钟了。[资深工程师]对这块非常熟悉。我们直接实施修复吧。”
27
27
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: test-driven-development
3
- description: "Superpower Skill(最高优先级):实现新功能或修复缺陷时,编写实现代码前先写测试的测试驱动开发完整指南与流程约束规范。"
3
+ description: "Superpower Skill:实现新功能或修复缺陷时,编写实现代码前先写测试的测试驱动开发完整指南与流程约束规范。"
4
4
  ---
5
5
 
6
6
  # 测试驱动开发(TDD)
@@ -80,7 +80,7 @@ vi.mock('MCPServerManager');
80
80
 
81
81
  **完整镜像真实数据。** 按真实存在的完整结构来 mock——包含所有已文档化的字段——而不仅仅是你测试中读取的字段。部分 mock 会在下游代码读取缺失字段时静默失败:测试通过,而集成已损坏。
82
82
 
83
- **生产类只承载生产方法。** 仅测试需要的清理逻辑应放在测试工具中,绝不要以 `destroy()` 的形式出现在生产类上。自问:这个方法是否只被测试调用?这个类是否拥有该资源的生命周期?答案有误 → 放到测试工具里。
83
+ **生产类只承载生产方法。** 仅测试需要的清理逻辑应放在测试工具中,绝不要以 `destroy()` 的形式出现在生产类上。自问:这个方法是否只被测试调用?这个类是否拥有该资源的lifecycle?答案有误 → 放到测试工具里。
84
84
 
85
85
  **复杂 mock 不如真实组件。** 当 mock 的搭建超过测试逻辑本身、mock 缺少真实组件拥有的方法、或测试因 mock 变更而崩溃时,改用基于真实组件的集成测试。**你的 human partner 的提问:**“这里真的需要用 mock 吗?”
86
86
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: using-git-worktrees
3
- description: "Superpower Skill(最高优先级):适用于需与当前 worktree 隔离的功能开发或执行实现计划前,通过原生工具优先、git worktree 兜底的方式确保独立 worktree 就绪。"
3
+ description: "Superpower Skill:适用于需与当前 worktree 隔离的功能开发或执行实现计划前,通过原生工具优先、git worktree 兜底的方式确保独立 worktree 就绪。"
4
4
  ---
5
5
 
6
6
  # 使用 Git Worktree
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: using-superpowers
3
- description: "Superpower Skill(最高优先级):适用于任何对话开始前,建立技能查找与调用规范,要求在任何回复前优先调用相关技能,包括澄清问题。"
3
+ description: "Superpower Skill:适用于任何对话开始前,建立技能查找与调用规范,要求在任何回复前优先调用相关技能,包括澄清问题。"
4
4
  ---
5
5
 
6
6
  <SUBAGENT-STOP>
@@ -51,16 +51,10 @@ description: "Superpower Skill(最高优先级):适用于任何对话开
51
51
 
52
52
  ## 平台适配
53
53
 
54
- 如果你的执行环境出现在此列表中,请先阅读对应的参考文件获取专项说明:
54
+ 本套件专为 **DSH (DeepSeek Harness)** 原生环境设计,仅支持 DSH 平台:
55
55
 
56
- - DSH (DeepSeek Harness): `references/dsh-tools.md` — **请优先阅读。** 将 Bash→pwsh/bash、Read/Write/Edit→fs、Glob/Grep→fs-search、Task/Subagent→subagent/workflow、TodoWrite→todo、AskUserQuestion→ask-user、Skill→skill 进行映射。本套件中的所有技能均假定使用 DSH 工具。
57
- - Claude Code: `references/claude-code-tools.md`
58
- - Codex: `references/codex-tools.md`
59
- - Pi: `references/pi-tools.md`
60
- - Antigravity: `references/antigravity-tools.md`
61
- - Hermes Agent: `references/hermes-tools.md`
62
- - Muse: `references/muse-tools.md`
56
+ - DSH 工具规范:`references/dsh-tools.md` — 本套件中的所有技能均假定使用 DSH 工具(Bash→pwsh/bash、Read/Write/Edit→fs、Glob/Grep→fs-search、Task/Subagent→subagent/workflow、TodoWrite→todo、AskUserQuestion→ask-user、Skill→skill)。
63
57
 
64
58
  ## 用户指令
65
59
 
66
- 用户指令(CLAUDE.md、AGENTS.md、GEMINI.md 等,以及直接请求)的优先级高于技能,技能又高于默认行为。仅当 human partner 明确指示时,才可跳过技能工作流或指令。
60
+ 用户指令(AGENTS.md、CLAUDE.md 等,以及直接请求)的优先级高于技能,技能又高于默认行为。仅当 human partner 明确指示时,才可跳过技能工作流或指令。
@@ -1,11 +1,11 @@
1
1
  # DSH Tools Reference for Superpowers
2
2
 
3
- > 面向模型的 DSH 工具速查。Superpowers 原版文案中的 Claude Code / Codex 工具名在此映射为 DSH 等价物。
4
- > 当 skill 指示使用某一工具时,按下表替换即可。
3
+ > 面向模型的 DSH 工具速查。Superpowers 技能在 DSH 平台环境下的原生工具等价物与行为规范。
4
+ > 当 skill 指示执行特定工具动作时,按本表原生 DSH 工具执行。
5
5
 
6
6
  ## 核心映射
7
7
 
8
- | 原版提及 | DSH 等价 | 备注 |
8
+ | 技能动作 | DSH 等价 | 备注 |
9
9
  |---|---|---|
10
10
  | `Bash` / `bash` | `pwsh`(首选,Windows 友好)或 `bash` | 长耗时命令用 `run_in_background: true`,通过 `job_output` / `job_list` 收敛 |
11
11
  | `Read` / `Write` / `Edit` | `fs` 工具的 `read` / `write` / `edit` | `read` 前无需 `fs/observed` 校验,`write/edit` 自动触发 `fs/observed` 失效 |
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: verification-before-completion
3
- description: "Superpower Skill(最高优先级):在声称完成、修复或通过前强制执行校验,用于提交或创建 PR 前必须运行验证命令并确认输出,始终以证据为准而非断言。"
3
+ description: "Superpower Skill:在声称完成、修复或通过前强制执行校验,用于提交或创建 PR 前必须运行验证命令并确认输出,始终以证据为准而非断言。"
4
4
  ---
5
5
 
6
6
  # 完成前的校验
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: writing-plans
3
- description: "Superpower Skill(最高优先级):当已具备清晰的需求规格或多步骤 task description 且尚未开始编码时使用,用于把需求拆解为结构清晰、粒度可控、可直接执行、可测试与可验证的完整实施计划。"
3
+ description: "Superpower Skill:当已具备清晰的需求规格或多步骤 task description 且尚未开始编码时使用,用于把需求拆解为结构清晰、粒度可控、可直接执行、可测试与可验证的完整实施计划。"
4
4
  ---
5
5
 
6
6
  # 编写计划