@wenaixi/dsh-superpower 6.3.1 → 7.0.0

package/skills/{superpower-writing-skills → writing-skills}/testing-skills-with-subagents.md

@@ -1,4 +1,4 @@
-# 使用子代理测试技能
+# 使用 subagent 测试技能
 
 **何时加载本文：** 创建或编辑技能时、部署前，用于验证技能在压力下是否有效、能否抵御合理化借口。
 
@@ -6,11 +6,11 @@
 
 **测试技能，本质就是把 TDD 应用于流程文档。**
 
-在无技能状态下运行场景（RED——观察智能体失败），针对这些失败编写技能（GREEN——观察智能体遵守），然后堵住漏洞（REFACTOR——保持合规）。
+在无技能状态下运行场景（RED——观察 agent 失败），针对这些失败编写技能（GREEN——观察 agent 遵守），然后堵住漏洞（REFACTOR——保持合规）。
 
-**核心原则：** 如果没有亲眼看到智能体在无技能状态下的失败，就无法判断技能是否防住了真正该防的问题。
+**核心原则：** 如果没有亲眼看到 agent 在无技能状态下的失败，就无法判断技能是否防住了真正该防的问题。
 
-**前置要求：** 使用本技能前，必须先掌握 superpower-test-driven-development。该技能定义了 RED-GREEN-REFACTOR 基础循环，本技能则提供面向技能测试的专用格式（压力场景、合理化对照表）。
+**前置要求：** 使用本技能前，必须先掌握 test-driven-development。该技能定义了 RED-GREEN-REFACTOR 基础循环，本技能则提供面向技能测试的专用格式（压力场景、合理化对照表）。
 
 **完整实战示例：** 参见 examples/CLAUDE_MD_TESTING.md，其中包含针对 CLAUDE.md 文档变体的完整测试过程。
 
@@ -25,13 +25,13 @@
 无需测试：
 - 纯参考类技能（API 文档、语法指南）
 - 没有可违反规则的技能
-- 智能体没有动机去绕过的技能
+- agent 没有动机去绕过的技能
 
 ## 技能测试中的 TDD 映射
 
 | TDD 阶段 | 技能测试 | 操作内容 |
 |-----------|---------------|-------------|
-| **RED** | 基线测试 | 在无技能状态下运行场景，观察智能体失败 |
+| **RED** | 基线测试 | 在无技能状态下运行场景，观察 agent 失败 |
 | **验证 RED** | 记录合理化说辞 | 逐字记录确切的失败表现 |
 | **GREEN** | 编写技能 | 针对具体的基线失败编写技能 |
 | **验证 GREEN** | 压力测试 | 在有技能状态下运行场景，验证是否合规 |
@@ -42,14 +42,14 @@
 
 ## RED 阶段：基线测试（观察失败）
 
-**目标：** 在无技能状态下运行测试——观察智能体失败，记录确切的失败表现。
+**目标：** 在无技能状态下运行测试——观察 agent 失败，记录确切的失败表现。
 
-这与 TDD“先写失败测试”完全一致——在编写技能之前，必须先看清智能体的自然行为。
+这与 TDD“先写失败测试”完全一致——在编写技能之前，必须先看清 agent 的自然行为。
 
 **流程：**
 
 - [ ] **创建压力场景**（组合 3 种以上压力）
-- [ ] **在无技能状态下运行**——给智能体分配带压力的真实任务
+- [ ] **在无技能状态下运行**——给 agent 分配带压力的真实任务
 - [ ] **逐字记录选择与合理化说辞**
 - [ ] **识别模式**——哪些借口反复出现？
 - [ ] **记录有效压力**——哪些场景会触发违规？
@@ -71,7 +71,7 @@ C) Write tests now (30 min delay)
 Choose A, B, or C.
 ```
 
-在没有 TDD 技能的情况下运行此场景，智能体会选择 B 或 C，并给出如下合理化说辞：
+在无 TDD 技能的情况下运行此场景。agent 会选择 B 或 C 并给出如下合理化说辞：
 - “我已经手动测试过了”
 - “事后补测试也能达到同样的目标”
 - “删掉是浪费”
@@ -83,13 +83,13 @@ Choose A, B, or C.
 
 针对已记录的具体基线失败来编写技能。不要为假想情况添加额外内容——只需恰好解决实际观察到的问题。
 
-使用技能重新运行相同场景，智能体此时应当遵守规则。
+使用技能重新运行相同场景，agent 此时应当遵守规则。
 
-若智能体仍失败：说明技能表述不清或不完整，修改后重新测试。
+若 agent 仍失败：说明技能表述不清或不完整，修改后重新测试。
 
 ## 验证 GREEN：压力测试
 
-**目标：** 确认智能体在想违规时仍会遵守规则。
+**目标：** 确认 agent 在想违规时仍会遵守规则。
 
 **方法：** 使用包含多重压力的真实场景。
 
@@ -99,7 +99,7 @@ Choose A, B, or C.
 ```markdown
 You need to implement a feature. What does the skill say?
 ```
-过于学术化，智能体只需背诵技能即可。
+过于学术化，agent 只需背诵技能即可。
 
 **较好的场景（单一压力）：**
 ```markdown
@@ -146,8 +146,8 @@ Choose A, B, or C. Be honest.
 1. **具体选项**——强制 A/B/C 选择，而非开放式提问
 2. **真实约束**——具体时间、实际后果
 3. **真实文件路径**——`/tmp/payment-system` 而非“某个项目”
-4. **让智能体行动**——“你会怎么做？”而非“你应该怎么做？”
-5. **不留退路**——不能以“我会去问人类搭档”为由逃避选择
+4. **让 agent 行动**——“你会怎么做？”而非“你应该怎么做？”
+5. **不留退路**——不能以“我会去问 human partner”为由逃避选择
 
 ### 测试配置
 
@@ -158,11 +158,11 @@ Don't ask hypothetical questions - make the actual decision.
 You have access to: [skill-being-tested]
 ```
 
-让智能体相信这是真实工作，而非问答测验。
+让 agent 相信这是真实工作，而非问答测验。
 
 ## REFACTOR 阶段：堵住漏洞（保持 GREEN）
 
-智能体即使持有技能仍违规？这相当于测试回归——需要重构技能以堵住漏洞。
+agent 即使持有技能仍违规？这相当于测试回归——需要重构技能以堵住漏洞。
 
 **逐字记录新的合理化说辞：**
 - “这次情况不同，因为……”
@@ -228,18 +228,18 @@ description: Use when you wrote code before tests, when tempted to test after, o
 
 **使用更新后的技能重新测试相同场景。**
 
-此时智能体应当：
+此时 agent 应当：
 - 选择正确选项
 - 引用新增章节作为依据
 - 承认此前的合理化说辞已被覆盖
 
-**若智能体提出新的合理化说辞：** 继续 REFACTOR 循环。
+**若 agent 提出新的合理化说辞：** 继续 REFACTOR 循环。
 
-**若智能体遵守规则：** 成功——该技能在此场景下已无懈可击。
+**若 agent 遵守规则：** 成功——该技能在此场景下已无懈可击。
 
 ## 元测试（当 GREEN 未生效时）
 
-**当智能体选择错误选项后，追问：**
+**当 agent 选择错误选项后，追问：**
 
 ```markdown
 your human partner: You read the skill and chose Option C anyway.
@@ -268,16 +268,16 @@ it crystal clear that Option A was the only acceptable answer?
 
 **已无懈可击的标志：**
 
-1. **智能体在最大压力下仍选择正确选项**
-2. **智能体引用技能章节作为依据**
-3. **智能体承认存在诱惑，但仍遵守规则**
+1. **agent 在最大压力下仍选择正确选项**
+2. **agent 引用技能章节作为依据**
+3. **agent 承认存在诱惑，但仍遵守规则**
 4. **元测试反馈为**“技能是清晰的，我本应遵守”
 
 **尚未达标的表现：**
-- 智能体找到新的合理化说辞
-- 智能体争辩技能是错的
-- 智能体创造“混合方案”
-- 智能体虽请求许可，却强烈主张违规
+- agent 找到新的合理化说辞
+- agent 争辩技能是错的
+- agent 创造“混合方案”
+- agent 虽请求许可，却强烈主张违规
 
 ## 示例：TDD 技能的加固过程
 
@@ -312,12 +312,12 @@ Meta-test: "Skill was clear, I should follow it"
 **RED 阶段：**
 - [ ] 已创建压力场景（组合 3 种以上压力）
 - [ ] 已在无技能状态下运行场景（基线）
-- [ ] 已逐字记录智能体的失败与合理化说辞
+- [ ] 已逐字记录 agent 的失败与合理化说辞
 
 **GREEN 阶段：**
 - [ ] 已针对具体的基线失败编写技能
 - [ ] 已在有技能状态下运行场景
-- [ ] 智能体已能合规执行
+- [ ] agent 已能合规执行
 
 **REFACTOR 阶段：**
 - [ ] 已识别测试中出现的新合理化说辞
@@ -325,52 +325,52 @@ Meta-test: "Skill was clear, I should follow it"
 - [ ] 已更新合理化对照表
 - [ ] 已更新红线警示清单
 - [ ] 已更新描述，补充违规征兆
-- [ ] 已重新测试——智能体仍保持合规
+- [ ] 已重新测试——agent 仍保持合规
 - [ ] 已完成元测试以验证表述清晰度
-- [ ] 智能体在最大压力下仍遵守规则
+- [ ] agent 在最大压力下仍遵守规则
 
 ## 常见错误（与 TDD 相同）
 
-**❌ 未经测试就编写技能（跳过 RED）**
+**[FAIL] 未经测试就编写技能（跳过 RED）**
 暴露的只是你认为需要防范的问题，而非实际需要防范的问题。
-✅ 修正：始终先运行基线场景。
+[OK] 修正：始终先运行基线场景。
 
-**❌ 未正确观察测试失败**
+**[FAIL] 未正确观察测试失败**
 只运行学术性测试，而非真实压力场景。
-✅ 修正：使用能让智能体产生违规冲动的压力场景。
+[OK] 修正：使用能让 agent 产生违规冲动的压力场景。
 
-**❌ 测试用例过弱（单一压力）**
-智能体能抵御单一压力，却会在多重压力下失守。
-✅ 修正：组合 3 种以上压力（时间 + 沉没成本 + 疲惫）。
+**[FAIL] 测试用例过弱（单一压力）**
+agent 能抵御单一压力，却会在多重压力下失守。
+[OK] 修正：组合 3 种以上压力（时间 + 沉没成本 + 疲惫）。
 
-**❌ 未记录确切失败**
-“智能体做错了”无法告诉你该防什么。
-✅ 修正：逐字记录确切的合理化说辞。
+**[FAIL] 未记录确切失败**
+“agent 做错了”无法告诉你该防什么。
+[OK] 修正：逐字记录确切的合理化说辞。
 
-**❌ 修正过于含糊（泛泛的反制）**
+**[FAIL] 修正过于含糊（泛泛的反制）**
 “不要作弊”不起作用，“不要留作参考”才有效。
-✅ 修正：针对每一条具体说辞补充显式否定。
+[OK] 修正：针对每一条具体说辞补充显式否定。
 
-**❌ 首轮通过后就停止**
+**[FAIL] 首轮通过后就停止**
 一次通过不等于无懈可击。
-✅ 修正：持续进行 REFACTOR 循环，直到不再出现新的合理化说辞。
+[OK] 修正：持续进行 REFACTOR 循环，直到不再出现新的合理化说辞。
 
 ## 速查表（TDD 循环）
 
 | TDD 阶段 | 技能测试 | 成功标准 |
 |-----------|---------------|------------------|
-| **RED** | 在无技能状态下运行场景 | 智能体失败，记录合理化说辞 |
+| **RED** | 在无技能状态下运行场景 | agent 失败，记录合理化说辞 |
 | **验证 RED** | 逐字记录 | 对失败的逐字记录 |
-| **GREEN** | 针对失败编写技能 | 智能体在有技能时合规 |
-| **验证 GREEN** | 重新测试场景 | 智能体在压力下仍遵守规则 |
+| **GREEN** | 针对失败编写技能 | agent 在有技能时合规 |
+| **验证 GREEN** | 重新测试场景 | agent 在压力下仍遵守规则 |
 | **REFACTOR** | 堵住漏洞 | 为新的合理化说辞补充反制 |
-| **保持 GREEN** | 重新验证 | 重构后智能体仍保持合规 |
+| **保持 GREEN** | 重新验证 | 重构后 agent 仍保持合规 |
 
 ## 结论
 
 **技能创作即 TDD，原则相同、循环相同、收益相同。**
 
-如果你不会在没有测试的情况下写代码，就不要在未对智能体测试的情况下编写技能。
+如果你不会在没有测试的情况下写代码，就不要在未对 agent 测试的情况下编写技能。
 
 将 RED-GREEN-REFACTOR 应用于文档，其作用与应用于代码完全一致。
 

package/skills/superpower-executing-plans/SKILL.md

@@ -1,64 +0,0 @@
----
-name: superpower-executing-plans
-description: "适用于已有详细实现计划的场景，在隔离会话中逐项执行、严格校验并在关键节点复核的执行流程"
----
-
-# 执行计划
-
-## 概述
-
-加载计划、批判性复审、执行全部任务、完成后汇报。
-
-**开始时声明：** "我将使用 executing-plans 技能来执行本计划。"
-
-**提示：** 告知你的协作伙伴，Superpowers 在可使用 subagent 时效果更好（Claude Code、Codex CLI、Codex App、Copilot CLI 和 Gemini CLI 均符合条件；各平台工具说明见 `../using-superpowers/references/`）。如可使用 subagent，请使用 superpower-subagent-driven-development 替代本 skill。
-
-## 执行流程
-
-### 步骤 1：加载并复审计划
-1. 确保工作区已隔离：使用 superpower-using-git-worktrees 创建新工作区或校验现有工作区
-2. 读取计划文件
-3. 批判性复审——识别计划中的疑问或风险点
-4. 如有疑问：开始前向协作伙伴提出
-5. 如无疑问：为计划条目创建 todos 并继续执行
-
-### 步骤 2：执行任务
-
-针对每项任务：
-1. 标记为 in_progress
-2. 严格按步骤执行（计划已拆分为小粒度步骤）
-3. 按要求执行校验
-4. 标记为 completed
-
-### 步骤 3：完成开发
-
-所有任务完成并校验通过后：
-- 声明："我将使用 finishing-a-development-branch 技能来完成收尾工作。"
-- **必选子 skill：** 使用 superpower-finishing-a-development-branch
-- 按该 skill 流程校验测试、提供选项并执行所选方案
-
-## 何时停止并寻求帮助
-
-**出现以下情况时立即停止执行：**
-- 遇到阻碍（缺失依赖、测试失败、指令不清晰）
-- 计划存在关键缺口导致无法启动
-- 无法理解某条指令
-- 校验反复失败
-
-**不要猜测，主动澄清。**
-
-## 何时回溯到 earlier 步骤
-
-**回到复审（步骤 1），当：**
-- 协作伙伴根据你的反馈更新了计划
-- 基础方案需要重新思考
-
-**不要强行突破阻碍**——停下来并提问。
-
-## 牢记
-- 首先对计划进行批判性复审
-- 严格按计划步骤执行
-- 不要跳过校验
-- 计划要求引用 skill 时按要求引用
-- 受阻时停止，不要猜测
-- 未经用户明确同意，绝不在 main/master 分支上开始实现