@wenaixi/dsh-superpower 7.4.1 → 7.5.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 (72) hide show
  1. package/README.md +110 -105
  2. package/README.zh.md +216 -0
  3. package/lib/catalog.d.ts +8 -2
  4. package/lib/catalog.d.ts.map +1 -1
  5. package/lib/catalog.js +64 -9
  6. package/lib/catalog.js.map +1 -1
  7. package/lib/client.js +68 -21
  8. package/lib/document.d.ts +8 -2
  9. package/lib/document.d.ts.map +1 -1
  10. package/lib/document.js +14 -4
  11. package/lib/document.js.map +1 -1
  12. package/lib/superpowers.d.ts +2 -0
  13. package/lib/superpowers.d.ts.map +1 -1
  14. package/lib/superpowers.js +8 -0
  15. package/lib/superpowers.js.map +1 -1
  16. package/lib/switches.d.ts +2 -10
  17. package/lib/switches.d.ts.map +1 -1
  18. package/lib/switches.js +29 -5
  19. package/lib/switches.js.map +1 -1
  20. package/package.json +3 -3
  21. package/skills/brainstorming/SKILL.md +235 -171
  22. package/skills/brainstorming/spec-document-reviewer-prompt.md +27 -25
  23. package/skills/brainstorming/visual-companion.md +65 -69
  24. package/skills/diagnosing-superpowers/SKILL.md +107 -43
  25. package/skills/diagnosing-superpowers/prompts/analyst-common.md +32 -18
  26. package/skills/diagnosing-superpowers/prompts/cost-and-time.md +25 -9
  27. package/skills/diagnosing-superpowers/prompts/plan-adherence.md +26 -12
  28. package/skills/diagnosing-superpowers/prompts/quality-evidence.md +23 -8
  29. package/skills/diagnosing-superpowers/prompts/repeated-work.md +25 -14
  30. package/skills/diagnosing-superpowers/prompts/request-conflicts.md +18 -9
  31. package/skills/diagnosing-superpowers/prompts/scrub-audit.md +23 -10
  32. package/skills/diagnosing-superpowers/prompts/scrub.md +25 -12
  33. package/skills/diagnosing-superpowers/prompts/similar-session.md +30 -22
  34. package/skills/diagnosing-superpowers/prompts/skill-timeline.md +26 -12
  35. package/skills/diagnosing-superpowers/prompts/stumbles.md +24 -12
  36. package/skills/diagnosing-superpowers/references/context-safety.md +15 -7
  37. package/skills/diagnosing-superpowers/references/github-issues.md +17 -9
  38. package/skills/diagnosing-superpowers/references/redaction-policy.md +27 -15
  39. package/skills/diagnosing-superpowers/references/session-discovery.md +31 -20
  40. package/skills/diagnosing-superpowers/templates/bundle-README.md +66 -40
  41. package/skills/diagnosing-superpowers/templates/case.md +49 -42
  42. package/skills/diagnosing-superpowers/templates/issue.md +32 -26
  43. package/skills/diagnosing-superpowers/templates/report.md +54 -48
  44. package/skills/dispatching-parallel-agents/SKILL.md +92 -90
  45. package/skills/executing-plans/SKILL.md +345 -197
  46. package/skills/finishing-a-development-branch/SKILL.md +107 -82
  47. package/skills/receiving-code-review/SKILL.md +129 -127
  48. package/skills/requesting-code-review/SKILL.md +52 -50
  49. package/skills/requesting-code-review/code-reviewer.md +132 -111
  50. package/skills/subagent-driven-development/SKILL.md +521 -298
  51. package/skills/subagent-driven-development/implementer-prompt.md +138 -117
  52. package/skills/subagent-driven-development/re-review-prompt.md +80 -48
  53. package/skills/subagent-driven-development/task-reviewer-prompt.md +189 -110
  54. package/skills/systematic-debugging/CREATION-LOG.md +85 -85
  55. package/skills/systematic-debugging/SKILL.md +221 -219
  56. package/skills/systematic-debugging/condition-based-waiting.md +48 -49
  57. package/skills/systematic-debugging/defense-in-depth.md +46 -46
  58. package/skills/systematic-debugging/root-cause-tracing.md +63 -63
  59. package/skills/systematic-debugging/test-academic.md +10 -10
  60. package/skills/systematic-debugging/test-pressure-1.md +40 -40
  61. package/skills/systematic-debugging/test-pressure-2.md +58 -58
  62. package/skills/systematic-debugging/test-pressure-3.md +48 -48
  63. package/skills/test-driven-development/SKILL.md +161 -153
  64. package/skills/test-driven-development/writing-good-tests.md +137 -84
  65. package/skills/using-git-worktrees/SKILL.md +74 -72
  66. package/skills/using-superpowers/SKILL.md +40 -39
  67. package/skills/using-superpowers/references/dsh-tools.md +36 -36
  68. package/skills/verification-before-completion/SKILL.md +85 -83
  69. package/skills/writing-plans/SKILL.md +123 -84
  70. package/skills/writing-skills/SKILL.md +419 -417
  71. package/skills/writing-skills/persuasion-principles.md +118 -118
  72. package/skills/writing-skills/testing-skills-with-subagents.md +190 -190
@@ -1,187 +1,187 @@
1
- # Skill 设计中的说服原则
1
+ # Persuasion Principles for Skill Design
2
2
 
3
- ## 概述
3
+ ## Overview
4
4
 
5
- 大语言模型与人类一样,会对相同的说服原则做出反应。理解这一心理机制有助于你设计更有效的 Skill —— 目的不是操纵,而是确保关键实践即使在压力下也能被切实执行。
5
+ LLMs respond to the same persuasion principles as humans. Understanding this psychology helps you design more effective skills - not to manipulate, but to ensure critical practices are followed even under pressure.
6
6
 
7
- **研究基础:** Meincke 等人(2025)通过 N=28,000 次 AI 对话测试了 7 项说服原则。运用说服技巧后,依从率提升了一倍以上(33% → 72%,p < .001)。
7
+ **Research foundation:** Meincke et al. (2025) tested 7 persuasion principles with N=28,000 AI conversations. Persuasion techniques more than doubled compliance rates (33% → 72%, p < .001).
8
8
 
9
- ## 七大原则
9
+ ## The Seven Principles
10
10
 
11
- ### 1. 权威(Authority)
12
- **定义:** 对专业能力、资质或官方来源的服从。
11
+ ### 1. Authority
12
+ **What it is:** Deference to expertise, credentials, or official sources.
13
13
 
14
- **在 Skill 中的作用:**
15
- - 祈使性语言:"YOU MUST"、"Never"、"Always"
16
- - 不可协商的表述:"No exceptions"
17
- - 消除决策疲劳与合理化借口
14
+ **How it works in skills:**
15
+ - Imperative language: "YOU MUST", "Never", "Always"
16
+ - Non-negotiable framing: "No exceptions"
17
+ - Eliminates decision fatigue and rationalization
18
18
 
19
- **适用场景:**
20
- - 约束执行类 Skill(TDD、校验要求等)
21
- - 安全攸关的关键实践
22
- - 已确立的最佳实践
19
+ **When to use:**
20
+ - Discipline-enforcing skills (TDD, verification requirements)
21
+ - Safety-critical practices
22
+ - Established best practices
23
23
 
24
- **示例:**
24
+ **Example:**
25
25
  ```markdown
26
26
  [OK] Write code before test? Delete it. Start over. No exceptions.
27
27
  [FAIL] Consider writing tests first when feasible.
28
28
  ```
29
29
 
30
- ### 2. 承诺一致(Commitment)
31
- **定义:** 与既往行为、陈述或公开声明保持一致。
30
+ ### 2. Commitment
31
+ **What it is:** Consistency with prior actions, statements, or public declarations.
32
32
 
33
- **在 Skill 中的作用:**
34
- - 要求显式声明:"Announce skill usage"
35
- - 强制显式选择:"Choose A, B, or C"
36
- - 使用追踪机制:用 todos 管理清单
33
+ **How it works in skills:**
34
+ - Require announcements: "Announce skill usage"
35
+ - Force explicit choices: "Choose A, B, or C"
36
+ - Use tracking: todos for checklists
37
37
 
38
- **适用场景:**
39
- - 确保 Skill 被切实执行
40
- - 多步骤流程
41
- - 责任追溯机制
38
+ **When to use:**
39
+ - Ensuring skills are actually followed
40
+ - Multi-step processes
41
+ - Accountability mechanisms
42
42
 
43
- **示例:**
43
+ **Example:**
44
44
  ```markdown
45
45
  [OK] When you find a skill, you MUST announce: "I'm using [Skill Name]"
46
46
  [FAIL] Consider letting your partner know which skill you're using.
47
47
  ```
48
48
 
49
- ### 3. 稀缺(Scarcity)
50
- **定义:** 由时间限制或资源有限所产生的紧迫感。
49
+ ### 3. Scarcity
50
+ **What it is:** Urgency from time limits or limited availability.
51
51
 
52
- **在 Skill 中的作用:**
53
- - 时限性要求:"Before proceeding"
54
- - 顺序依赖:"Immediately after X"
55
- - 防止拖延
52
+ **How it works in skills:**
53
+ - Time-bound requirements: "Before proceeding"
54
+ - Sequential dependencies: "Immediately after X"
55
+ - Prevents procrastination
56
56
 
57
- **适用场景:**
58
- - 需要立即校验的场景
59
- - 时效性强的工作流
60
- - 防止“稍后再做”
57
+ **When to use:**
58
+ - Immediate verification requirements
59
+ - Time-sensitive workflows
60
+ - Preventing "I'll do it later"
61
61
 
62
- **示例:**
62
+ **Example:**
63
63
  ```markdown
64
64
  [OK] After completing a task, IMMEDIATELY request code review before proceeding.
65
65
  [FAIL] You can review code when convenient.
66
66
  ```
67
67
 
68
- ### 4. 社会认同(Social Proof)
69
- **定义:** 遵从他人的行为或被视为常规的做法。
68
+ ### 4. Social Proof
69
+ **What it is:** Conformity to what others do or what's considered normal.
70
70
 
71
- **在 Skill 中的作用:**
72
- - 普适性表述:"Every time"、"Always"
73
- - 失败模式:"没有 Y 的 X = 失败"
74
- - 建立行为规范
71
+ **How it works in skills:**
72
+ - Universal patterns: "Every time", "Always"
73
+ - Failure modes: "X without Y = failure"
74
+ - Establishes norms
75
75
 
76
- **适用场景:**
77
- - 记录通用实践
78
- - 警示常见失败原因
79
- - 强化标准规范
76
+ **When to use:**
77
+ - Documenting universal practices
78
+ - Warning about common failures
79
+ - Reinforcing standards
80
80
 
81
- **示例:**
81
+ **Example:**
82
82
  ```markdown
83
83
  [OK] Checklists without todo tracking = steps get skipped. Every time.
84
84
  [FAIL] Some people find a todo list helpful for checklists.
85
85
  ```
86
86
 
87
- ### 5. 归属感(Unity)
88
- **定义:** 共享身份、“我们”意识、群体归属感。
87
+ ### 5. Unity
88
+ **What it is:** Shared identity, "we-ness", in-group belonging.
89
89
 
90
- **在 Skill 中的作用:**
91
- - 协作性表述:"our codebase"、"we're colleagues"
92
- - 共同目标:"we both want quality"
90
+ **How it works in skills:**
91
+ - Collaborative language: "our codebase", "we're colleagues"
92
+ - Shared goals: "we both want quality"
93
93
 
94
- **适用场景:**
95
- - 协作类工作流
96
- - 建立团队文化
97
- - 非层级化的实践
94
+ **When to use:**
95
+ - Collaborative workflows
96
+ - Establishing team culture
97
+ - Non-hierarchical practices
98
98
 
99
- **示例:**
99
+ **Example:**
100
100
  ```markdown
101
101
  [OK] We're colleagues working together. I need your honest technical judgment.
102
102
  [FAIL] You should probably tell me if I'm wrong.
103
103
  ```
104
104
 
105
- ### 6. 互惠(Reciprocity)
106
- **定义:** 对已获利益产生回报的义务感。
105
+ ### 6. Reciprocity
106
+ **What it is:** Obligation to return benefits received.
107
107
 
108
- **作用方式:**
109
- - 需谨慎使用 —— 容易显得带有操纵性
110
- - 在 Skill 中很少需要
108
+ **How it works:**
109
+ - Use sparingly - can feel manipulative
110
+ - Rarely needed in skills
111
111
 
112
- **应避免的场景:**
113
- - 几乎所有情况(其他原则通常更有效)
112
+ **When to avoid:**
113
+ - Almost always (other principles more effective)
114
114
 
115
- ### 7. 喜好(Liking)
116
- **定义:** 更倾向于与自己喜欢的人合作。
115
+ ### 7. Liking
116
+ **What it is:** Preference for cooperating with those we like.
117
117
 
118
- **作用方式:**
119
- - **不要用于提升依从性**
120
- - 与坦诚反馈的文化相冲突
121
- - 会导致迎合行为
118
+ **How it works:**
119
+ - **DON'T USE for compliance**
120
+ - Conflicts with honest feedback culture
121
+ - Creates sycophancy
122
122
 
123
- **应避免的场景:**
124
- - 所有需要强制执行纪律的场景
123
+ **When to avoid:**
124
+ - Always for discipline enforcement
125
125
 
126
- ## 按 Skill 类型组合原则
126
+ ## Principle Combinations by Skill Type
127
127
 
128
- | Skill 类型 | 适用原则 | 规避原则 |
128
+ | Skill Type | Use | Avoid |
129
129
  |------------|-----|-------|
130
- | 约束执行类 | 权威 + 承诺一致 + 社会认同 | 喜好、互惠 |
131
- | 指导/技巧类 | 适度权威 + 归属感 | 过度权威 |
132
- | 协作类 | 归属感 + 承诺一致 | 权威、喜好 |
133
- | 参考资料类 | 仅需清晰表达 | 全部说服原则 |
130
+ | Discipline-enforcing | Authority + Commitment + Social Proof | Liking, Reciprocity |
131
+ | Guidance/technique | Moderate Authority + Unity | Heavy authority |
132
+ | Collaborative | Unity + Commitment | Authority, Liking |
133
+ | Reference | Clarity only | All persuasion |
134
134
 
135
- ## 为何有效:背后的心理学
135
+ ## Why This Works: The Psychology
136
136
 
137
- **清晰的底线规则能减少合理化借口:**
138
- - "YOU MUST" 消除了决策疲劳
139
- - 绝对化的表述消除了“这是不是例外?”的疑问
140
- - 显式的反合理化话术能精准堵住特定漏洞
137
+ **Bright-line rules reduce rationalization:**
138
+ - "YOU MUST" removes decision fatigue
139
+ - Absolute language eliminates "is this an exception?" questions
140
+ - Explicit anti-rationalization counters close specific loopholes
141
141
 
142
- **执行意图能形成自动化行为:**
143
- - 清晰的触发条件 + 必要行动 = 自动执行
144
- - "当 X 时,做 Y" 比 "一般情况下做 Y" 更有效
145
- - 降低了依从所需的认知负荷
142
+ **Implementation intentions create automatic behavior:**
143
+ - Clear triggers + required actions = automatic execution
144
+ - "When X, do Y" more effective than "generally do Y"
145
+ - Reduces cognitive load on compliance
146
146
 
147
- **大语言模型具有类人性(Parahuman):**
148
- - 训练数据中已包含这些模式的人类文本
149
- - 权威性语言在训练数据中通常先于依从行为出现
150
- - 承诺序列(声明 → 行动)被频繁建模
151
- - 社会认同模式(大家都做 X)确立了行为规范
147
+ **LLMs are parahuman:**
148
+ - Trained on human text containing these patterns
149
+ - Authority language precedes compliance in training data
150
+ - Commitment sequences (statement → action) frequently modeled
151
+ - Social proof patterns (everyone does X) establish norms
152
152
 
153
- ## 伦理使用
153
+ ## Ethical Use
154
154
 
155
- **正当用途:**
156
- - 确保关键实践被切实执行
157
- - 编写高效的文档
158
- - 预防可预见的失败
155
+ **Legitimate:**
156
+ - Ensuring critical practices are followed
157
+ - Creating effective documentation
158
+ - Preventing predictable failures
159
159
 
160
- **不正当用途:**
161
- - 为个人私利进行操纵
162
- - 制造虚假的紧迫感
163
- - 基于愧疚感迫使服从
160
+ **Illegitimate:**
161
+ - Manipulating for personal gain
162
+ - Creating false urgency
163
+ - Guilt-based compliance
164
164
 
165
- **检验标准:** 如果用户完全理解该技巧,它是否仍符合其真实利益?
165
+ **The test:** Would this technique serve the user's genuine interests if they fully understood it?
166
166
 
167
- ## 研究引用
167
+ ## Research Citations
168
168
 
169
169
  **Cialdini, R. B. (2021).** *Influence: The Psychology of Persuasion (New and Expanded).* Harper Business.
170
- - 七大说服原则
171
- - 影响力研究的实证基础
170
+ - Seven principles of persuasion
171
+ - Empirical foundation for influence research
172
172
 
173
173
  **Meincke, L., Shapiro, D., Duckworth, A. L., Mollick, E., Mollick, L., & Cialdini, R. (2025).** Call Me A Jerk: Persuading AI to Comply with Objectionable Requests. University of Pennsylvania.
174
- - 通过 N=28,000 次大语言模型对话测试了 7 项原则
175
- - 运用说服技巧后依从率从 33% 提升至 72%
176
- - 权威、承诺一致、稀缺最为有效
177
- - 验证了大语言模型行为的类人性模型
174
+ - Tested 7 principles with N=28,000 LLM conversations
175
+ - Compliance increased 33% → 72% with persuasion techniques
176
+ - Authority, commitment, scarcity most effective
177
+ - Validates parahuman model of LLM behavior
178
178
 
179
- ## 快速参考
179
+ ## Quick Reference
180
180
 
181
- 设计 Skill 时,请自问:
181
+ When designing a skill, ask:
182
182
 
183
- 1. **属于什么类型?**(约束执行类、指导类还是参考资料类)
184
- 2. **想改变什么行为?**
185
- 3. **适用哪项原则?**(约束类通常为权威 + 承诺一致)
186
- 4. **是否叠加过多?**(不要同时使用全部七项)
187
- 5. **是否符合伦理?**(是否服务于用户的真实利益?)
183
+ 1. **What type is it?** (Discipline vs. guidance vs. reference)
184
+ 2. **What behavior am I trying to change?**
185
+ 3. **Which principle(s) apply?** (Usually authority + commitment for discipline)
186
+ 4. **Am I combining too many?** (Don't use all seven)
187
+ 5. **Is this ethical?** (Serves user's genuine interests?)