插件使用技巧：以 superpowers 为例增强任务拆解、反思和复盘

superpowers 插件结构：

┌────────────────────────────────────────────────────┐
│                   superpowers                       │
│                                                     │
│  ┌──────────────────────────────────────────────┐  │
│  │  Hook 层（自动注入工作节奏）                    │  │
│  │                                               │  │
│  │  PreTaskExecution  → 任务拆解检查             │  │
│  │  PostTaskExecution → 执行反思                 │  │
│  │  SessionEnd        → 会话复盘                 │  │
│  └──────────────────────────────────────────────┘  │
│                                                     │
│  ┌──────────────────────────────────────────────┐  │
│  │  Skill 层（可复用的工作方法）                   │  │
│  │                                               │  │
│  │  task-breakdown   → 任务拆解方法论            │  │
│  │  reflection       → 执行后反思               │  │
│  │  retrospective    → 会话级复盘               │  │
│  │  decision-log     → 决策记录                 │  │
│  └──────────────────────────────────────────────┘  │
│                                                     │
│  ┌──────────────────────────────────────────────┐  │
│  │  Agent 层（专门的子 Agent）                    │  │
│  │                                               │  │
│  │  reflect-agent    → 反思分析 Agent            │  │
│  │  planner-agent    → 任务规划 Agent            │  │
│  └──────────────────────────────────────────────┘  │
│                                                     │
│  plugin.json  → 元数据、权限、依赖                  │
└────────────────────────────────────────────────────┘

# plugin-evaluation-checklist.yaml
# 在安装任何插件前，先过一遍这个清单

evaluation:
  pre_install:
    - question: "插件解决了什么具体问题？"
      required: true
      note: "如果说不清问题，就不需要插件"
    
    - question: "这个问题能靠 Skill 或项目规则解决吗？"
      required: true
      note: "如果能，就不需要插件的复杂性"
    
    - question: "插件的权限范围是什么？"
      required: true
      note: "检查是否有不必要的权限（如不需要网络但申请了 network access）"
    
    - question: "插件是否开源？代码可审查吗？"
      required: true
      note: "不开源的插件不应该在生产环境使用"
    
    - question: "插件的维护活跃度如何？"
      required: false
      note: "最后更新超过 3 个月的插件可能有兼容性风险"
    
    - question: "插件和其他已安装的插件有冲突吗？"
      required: true
      note: "两个插件都注入 PreTaskExecution Hook 可能会冲突"
  
  post_install:
    - question: "插件的功能可以验证吗？"
      note: "执行一个简单任务，观察插件的注入效果"
    
    - question: "插件增加了多少 Token 开销？"
      note: "对比安装前后的 Token 使用量"
    
    - question: "插件的 Hook 是否影响了已有工作流？"
      note: "检查是否有意外行为"

# plugin-permission-audit.yaml
superpowers_audit:
  
  # 插件声明的权限
  declared_permissions:
    - "hook:PreTaskExecution"    # 任务执行前注入
    - "hook:PostTaskExecution"   # 任务执行后注入
    - "hook:SessionEnd"          # 会话结束注入
    - "agent:reflect-agent"      # 子 Agent 定义
    - "agent:planner-agent"      # 子 Agent 定义
  
  # 权限评估
  assessment:
    hooks:
      risk: "LOW"
      reason: "Hook 只注入文本提示，不执行文件操作或命令"
    
    agents:
      risk: "MEDIUM"
      reason: "子 Agent 可以调用工具，需要确认其工具范围"
    
    file_access:
      risk: "NONE"
      reason: "插件不直接读写文件"
    
    network_access:
      risk: "NONE"
      reason: "插件不需要网络访问"
  
  # 最终结论
  verdict: "APPROVE"
  notes: "权限范围合理，Hook 只做提示注入，无副作用风险"

# superpowers-task-breakdown.yaml
hook:
  type: "PreTaskExecution"
  trigger: "task.estimated_complexity >= 'MEDIUM'"
  
  prompt_injection: |
    ## 任务拆解检查
    
    在开始执行之前，请先完成以下拆解步骤：
    
    1. **目标澄清**：用一句话描述"做完这件事后，什么是不同的？"
    2. **步骤分解**：把任务拆成 3-7 个独立步骤，每个步骤可以独立验证
    3. **风险预判**：每个步骤可能的失败点是什么？
    4. **验证标准**：每个步骤完成的标志是什么？
    
    请以以下格式输出拆解结果：
    
    ```
    目标：[一句话]
    
    步骤：
    1. [步骤名] → 验证标准：[什么算完成] → 风险：[可能出错的地方]
    2. ...
    
    依赖关系：[步骤之间的先后依赖]
    ```
    
    拆解完成后再开始执行。

# superpowers-reflection.yaml
hook:
  type: "PostTaskExecution"
  trigger: "task.completed OR task.failed"
  
  prompt_injection: |
    ## 执行反思
    
    任务执行完毕后，请反思以下问题：
    
    1. **结果评估**：任务完成了吗？完成度是多少？
    2. **方法评估**：执行过程中有没有走弯路？有没有更好的方式？
    3. **意外发现**：过程中有没有发现之前不知道的信息？
    4. **可复用性**：这次的解法能复用到其他类似任务吗？
    
    如果任务失败了，额外反思：
    - 失败的根本原因是什么？（不是表面原因）
    - 如果重新来一次，你会怎么做？
    - 需要什么额外信息才能成功？
    
    把反思结果记录到 `.agent-logs/reflection-{date}.md`。

# superpowers-retrospective.yaml
hook:
  type: "SessionEnd"
  
  prompt_injection: |
    ## 会话复盘
    
    本次会话即将结束。请总结以下内容：
    
    ### 完成的任务
    - [列出完成的任务和关键成果]
    
    ### 未完成的任务
    - [列出未完成的任务和原因]
    
    ### 学到的经验
    - [列出本次会话新发现的项目知识、技术细节或工作模式]
    
    ### 建议的后续行动
    - [列出下次会话应该优先处理的事项]
    
    把复盘结果保存到 `.agent-logs/retro-{date}.md`。