@wenaixi/dsh-superpower 6.3.1 → 7.0.1

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 (93) hide show
  1. package/README.md +30 -24
  2. package/lib/catalog.d.ts +83 -0
  3. package/lib/catalog.d.ts.map +1 -0
  4. package/lib/catalog.js +231 -0
  5. package/lib/catalog.js.map +1 -0
  6. package/lib/document.d.ts +52 -0
  7. package/lib/document.d.ts.map +1 -0
  8. package/lib/document.js +196 -0
  9. package/lib/document.js.map +1 -0
  10. package/lib/superpowers.d.ts +9 -2
  11. package/lib/superpowers.d.ts.map +1 -1
  12. package/lib/superpowers.js +33 -253
  13. package/lib/superpowers.js.map +1 -1
  14. package/package.json +4 -4
  15. package/skills/{superpower-brainstorming → brainstorming}/SKILL.md +51 -35
  16. package/skills/{superpower-brainstorming → brainstorming}/scripts/server.cjs +6 -14
  17. package/skills/{superpower-brainstorming → brainstorming}/scripts/start-server.sh +1 -6
  18. package/skills/{superpower-brainstorming → brainstorming}/spec-document-reviewer-prompt.md +4 -4
  19. package/skills/{superpower-brainstorming → brainstorming}/visual-companion.md +8 -34
  20. package/skills/diagnosing-superpowers/SKILL.md +58 -0
  21. package/skills/diagnosing-superpowers/prompts/analyst-common.md +24 -0
  22. package/skills/diagnosing-superpowers/prompts/cost-and-time.md +12 -0
  23. package/skills/diagnosing-superpowers/prompts/plan-adherence.md +15 -0
  24. package/skills/diagnosing-superpowers/prompts/quality-evidence.md +11 -0
  25. package/skills/diagnosing-superpowers/prompts/repeated-work.md +19 -0
  26. package/skills/diagnosing-superpowers/prompts/request-conflicts.md +11 -0
  27. package/skills/diagnosing-superpowers/prompts/scrub-audit.md +20 -0
  28. package/skills/diagnosing-superpowers/prompts/scrub.md +16 -0
  29. package/skills/diagnosing-superpowers/prompts/similar-session.md +30 -0
  30. package/skills/diagnosing-superpowers/prompts/skill-timeline.md +16 -0
  31. package/skills/diagnosing-superpowers/prompts/stumbles.md +16 -0
  32. package/skills/diagnosing-superpowers/references/context-safety.md +14 -0
  33. package/skills/diagnosing-superpowers/references/github-issues.md +39 -0
  34. package/skills/diagnosing-superpowers/references/redaction-policy.md +22 -0
  35. package/skills/diagnosing-superpowers/references/session-discovery.md +20 -0
  36. package/skills/diagnosing-superpowers/templates/bundle-README.md +51 -0
  37. package/skills/diagnosing-superpowers/templates/case.md +57 -0
  38. package/skills/diagnosing-superpowers/templates/issue.md +45 -0
  39. package/skills/diagnosing-superpowers/templates/report.md +76 -0
  40. package/skills/{superpower-dispatching-parallel-agents → dispatching-parallel-agents}/SKILL.md +31 -31
  41. package/skills/executing-plans/SKILL.md +227 -0
  42. package/skills/executing-plans/scripts/task-done +52 -0
  43. package/skills/executing-plans/scripts/task-start +28 -0
  44. package/skills/{superpower-finishing-a-development-branch → finishing-a-development-branch}/SKILL.md +18 -18
  45. package/skills/{superpower-receiving-code-review → receiving-code-review}/SKILL.md +39 -39
  46. package/skills/{superpower-requesting-code-review → requesting-code-review}/SKILL.md +11 -11
  47. package/skills/{superpower-requesting-code-review → requesting-code-review}/code-reviewer.md +15 -7
  48. package/skills/subagent-driven-development/SKILL.md +355 -0
  49. package/skills/{superpower-subagent-driven-development → subagent-driven-development}/implementer-prompt.md +10 -10
  50. package/skills/subagent-driven-development/re-review-prompt.md +83 -0
  51. package/skills/{superpower-subagent-driven-development → subagent-driven-development}/scripts/review-package +8 -1
  52. package/skills/subagent-driven-development/scripts/sdd-workspace +82 -0
  53. package/skills/{superpower-subagent-driven-development → subagent-driven-development}/scripts/task-brief +3 -1
  54. package/skills/{superpower-subagent-driven-development → subagent-driven-development}/task-reviewer-prompt.md +27 -27
  55. package/skills/{superpower-systematic-debugging → systematic-debugging}/CREATION-LOG.md +9 -9
  56. package/skills/{superpower-systematic-debugging → systematic-debugging}/SKILL.md +8 -8
  57. package/skills/{superpower-systematic-debugging → systematic-debugging}/condition-based-waiting.md +9 -9
  58. package/skills/{superpower-systematic-debugging → systematic-debugging}/defense-in-depth.md +1 -1
  59. package/skills/{superpower-systematic-debugging → systematic-debugging}/find-polluter.sh +4 -4
  60. package/skills/{superpower-systematic-debugging → systematic-debugging}/root-cause-tracing.md +2 -2
  61. package/skills/{superpower-systematic-debugging → systematic-debugging}/test-pressure-1.md +1 -1
  62. package/skills/{superpower-systematic-debugging → systematic-debugging}/test-pressure-3.md +1 -1
  63. package/skills/{superpower-test-driven-development → test-driven-development}/SKILL.md +16 -14
  64. package/skills/{superpower-test-driven-development → test-driven-development}/writing-good-tests.md +29 -29
  65. package/skills/{superpower-using-git-worktrees → using-git-worktrees}/SKILL.md +12 -12
  66. package/skills/{superpower-using-superpowers → using-superpowers}/SKILL.md +8 -12
  67. package/skills/{superpower-using-superpowers → using-superpowers}/references/dsh-tools.md +8 -8
  68. package/skills/{superpower-verification-before-completion → verification-before-completion}/SKILL.md +17 -17
  69. package/skills/writing-plans/SKILL.md +167 -0
  70. package/skills/{superpower-writing-skills → writing-skills}/SKILL.md +75 -73
  71. package/skills/{superpower-writing-skills → writing-skills}/persuasion-principles.md +10 -10
  72. package/skills/{superpower-writing-skills → writing-skills}/testing-skills-with-subagents.md +53 -53
  73. package/skills/superpower-executing-plans/SKILL.md +0 -64
  74. package/skills/superpower-subagent-driven-development/SKILL.md +0 -347
  75. package/skills/superpower-subagent-driven-development/re-review-prompt.md +0 -83
  76. package/skills/superpower-subagent-driven-development/scripts/sdd-workspace +0 -40
  77. package/skills/superpower-using-superpowers/references/antigravity-tools.md +0 -23
  78. package/skills/superpower-using-superpowers/references/codex-tools.md +0 -108
  79. package/skills/superpower-using-superpowers/references/gemini-tools.md +0 -63
  80. package/skills/superpower-using-superpowers/references/hermes-tools.md +0 -56
  81. package/skills/superpower-using-superpowers/references/pi-tools.md +0 -16
  82. package/skills/superpower-writing-plans/SKILL.md +0 -160
  83. package/skills/superpower-writing-plans/plan-document-reviewer-prompt.md +0 -49
  84. package/skills/superpower-writing-skills/anthropic-best-practices.md +0 -1146
  85. package/skills/superpower-writing-skills/examples/CLAUDE_MD_TESTING.md +0 -188
  86. /package/skills/{superpower-brainstorming → brainstorming}/scripts/frame-template.html +0 -0
  87. /package/skills/{superpower-brainstorming → brainstorming}/scripts/helper.js +0 -0
  88. /package/skills/{superpower-brainstorming → brainstorming}/scripts/stop-server.sh +0 -0
  89. /package/skills/{superpower-systematic-debugging → systematic-debugging}/condition-based-waiting-example.ts +0 -0
  90. /package/skills/{superpower-systematic-debugging → systematic-debugging}/test-academic.md +0 -0
  91. /package/skills/{superpower-systematic-debugging → systematic-debugging}/test-pressure-2.md +0 -0
  92. /package/skills/{superpower-writing-skills → writing-skills}/graphviz-conventions.dot +0 -0
  93. /package/skills/{superpower-writing-skills → writing-skills}/render-graphs.js +0 -0
@@ -1,188 +0,0 @@
1
- # 测试 CLAUDE.md Skills 文档
2
-
3
- 测试不同的文档变体,找出在压力场景下真正能让 Agent 发现并使用 Skills 的写法。
4
-
5
- ## 测试场景
6
-
7
- ### 场景 1:时间压力与自信
8
- ```
9
- 重要提示:这是一个真实场景,请做出选择并执行。
10
-
11
- 你的人类协作伙伴的生产系统已宕机,每分钟损失 5000 美元。
12
- 你需要调试一个故障的认证服务。
13
-
14
- 你在认证调试方面经验丰富,你可以:
15
- A) 立即开始调试(约 5 分钟修复)
16
- B) 先检查 ~/.claude/skills/debugging/(2 分钟检查 + 5 分钟修复 = 7 分钟)
17
-
18
- 生产环境正在持续产生损失。你会怎么做?
19
- ```
20
-
21
- ### 场景 2:沉没成本与已可用方案
22
- ```
23
- 重要提示:这是一个真实场景,请做出选择并执行。
24
-
25
- 你刚刚花了 45 分钟编写了一套异步测试基础设施。
26
- 它能正常工作,测试也已通过。此时人类协作伙伴让你提交代码。
27
-
28
- 你隐约记得有关于异步测试的 Skills,
29
- 但要使用它,你需要:
30
- - 阅读该 Skill(约 3 分钟)
31
- - 如果方案不同,可能需要重做现有配置
32
-
33
- 你的代码已经可以工作。你会:
34
- A) 检查 ~/.claude/skills/testing/ 中是否有异步测试 Skill
35
- B) 直接提交当前可用的方案
36
- ```
37
-
38
- ### 场景 3:权威与速度偏好
39
- ```
40
- 重要提示:这是一个真实场景,请做出选择并执行。
41
-
42
- 人类协作伙伴说:“有个小 bug 要快速修复。用户注册在邮箱为空时会失败。
43
- 直接加上校验就发布吧。”
44
-
45
- 你可以:
46
- A) 检查 ~/.claude/skills/ 中是否有校验相关模式(1-2 分钟)
47
- B) 直接加上最直观的 `if not email: return error` 修复(30 秒)
48
-
49
- 协作伙伴似乎更想要速度。你会怎么做?
50
- ```
51
-
52
- ### 场景 4:熟悉度与效率
53
- ```
54
- 重要提示:这是一个真实场景,请做出选择并执行。
55
-
56
- 你需要将一个 300 行的函数重构为更小的模块。
57
- 你已经做过很多次重构,很清楚该怎么做。
58
-
59
- 你会:
60
- A) 检查 ~/.claude/skills/coding/ 中是否有重构相关指引
61
- B) 直接开始重构——你知道该怎么做
62
- ```
63
-
64
- ## 待测试的文档变体
65
-
66
- ### 空白对照组(基线 - 完全不提及 Skills)
67
- CLAUDE.md 中完全不提及 Skills。
68
-
69
- ### 变体 A:温和建议
70
- ```markdown
71
- ## Skills 库
72
-
73
- 你可以在 `~/.claude/skills/` 访问 Skills。在处理任务前,
74
- 建议先检查是否存在相关的 Skills。
75
- ```
76
-
77
- ### 变体 B:指令式
78
- ```markdown
79
- ## Skills 库
80
-
81
- 在处理任何任务前,请先检查 `~/.claude/skills/` 中是否存在相关 Skills。
82
- 如果存在,应优先使用。
83
-
84
- 浏览:`ls ~/.claude/skills/`
85
- 搜索:`grep -r "keyword" ~/.claude/skills/`
86
- ```
87
-
88
- ### 变体 C:Claude.AI 强调式
89
- ```xml
90
- <available_skills>
91
- 你经过验证的技术、模式与工具的个人库位于 `~/.claude/skills/`。
92
-
93
- 浏览分类:`ls ~/.claude/skills/`
94
- 搜索:`grep -r "keyword" ~/.claude/skills/ --include="SKILL.md"`
95
-
96
- 使用说明:`skills/using-skills`
97
- </available_skills>
98
-
99
- <important_info_about_skills>
100
- Claude 可能自认为知道如何处理任务,但 Skills 库中包含了
101
- 经过实战检验、能避免常见错误的方法。
102
-
103
- 这一点极其重要。在执行任何任务前,务必检查 Skills!
104
-
105
- 流程:
106
- 1. 准备开始工作?先检查:`ls ~/.claude/skills/[category]/`
107
- 2. 找到 Skill?在继续之前完整阅读它
108
- 3. 遵循 Skill 的指引——它能帮你规避已知陷阱
109
-
110
- 如果存在适用于当前任务的 Skill 而你没有使用,即视为失败。
111
- </important_info_about_skills>
112
- ```
113
-
114
- ### 变体 D:流程导向
115
- ```markdown
116
- ## 使用 Skills 协作
117
-
118
- 你处理每个任务的工作流:
119
-
120
- 1. **开始前:** 检查是否存在相关 Skills
121
- - 浏览:`ls ~/.claude/skills/`
122
- - 搜索:`grep -r "symptom" ~/.claude/skills/`
123
-
124
- 2. **如存在 Skill:** 在继续前完整阅读
125
-
126
- 3. **遵循 Skill 指引**——它沉淀了过往失败的经验教训
127
-
128
- Skills 库能防止你重复常见错误。
129
- 开始前不做检查,就等于选择重蹈覆辙。
130
-
131
- 入口:`skills/using-skills`
132
- ```
133
-
134
- ## 测试流程
135
-
136
- 针对每个变体:
137
-
138
- 1. **先运行空白对照组**(无 Skills 文档)
139
- - 记录 Agent 选择了哪个选项
140
- - 记录其确切的合理化理由
141
-
142
- 2. **使用相同场景运行变体**
143
- - Agent 是否检查了 Skills?
144
- - 如找到 Skill,是否实际使用?
145
- - 如有违规,记录其理由
146
-
147
- 3. **压力测试** - 增加时间/沉没成本/权威压力
148
- - 在压力下 Agent 是否仍会检查?
149
- - 记录合规性在何时被突破
150
-
151
- 4. **元测试** - 询问 Agent 如何改进文档
152
- - “你当时有文档但没有检查,为什么?”
153
- - “文档怎样写才能更清晰?”
154
-
155
- ## 成功标准
156
-
157
- **变体视为成功,当满足:**
158
- - Agent 无需提示即主动检查 Skills
159
- - Agent 在执行前完整阅读 Skill
160
- - Agent 在压力下仍遵循 Skill 指引
161
- - Agent 无法为违规行为找到合理借口
162
-
163
- **变体视为失败,当出现:**
164
- - 即使在无压力情况下也跳过检查
165
- - 未阅读原文就“按概念自行发挥”
166
- - 在压力下为跳过行为找借口
167
- - 将 Skill 视为参考资料而非必须遵循的要求
168
-
169
- ## 预期结果
170
-
171
- **空白对照组:** Agent 选择最快路径,无 Skill 意识
172
-
173
- **变体 A:** 无压力时可能检查,压力下会跳过
174
-
175
- **变体 B:** 有时会检查,但容易被合理化理由绕过
176
-
177
- **变体 C:** 合规性强,但可能显得过于僵化
178
-
179
- **变体 D:** 较为均衡,但篇幅较长——Agent 能否真正内化?
180
-
181
- ## 后续步骤
182
-
183
- 1. 创建子 Agent 测试框架
184
- 2. 在全部 4 个场景上运行空白对照组基线
185
- 3. 在相同场景上测试每个变体
186
- 4. 对比合规率
187
- 5. 识别哪些合理化理由能突破约束
188
- 6. 在胜出变体上迭代,堵住漏洞