Superpowers:using-superpowers技能使用规则

0 阅读4分钟

graphviz-diagram.svg

一、 节点类型解析

  1. 双圆形节点:流程起点和终点
  • User message received:接收到用户提问,是常规对话的起点
  • About to EnterPlanMode?:准备进入规划模式,是复杂任务的起点
  • Respond (including clarifications):回复用户,是所有流程的最终结束点
  1. 菱形节点:判断分支点
  • Already brainstormed?:检查是否已经完成思路梳理-Might any skill apply?:判断是否有匹配的技能可以调用
  • Has checklist?:确认该技能是否有对应的执行清单
  1. 矩形节点:具体执行动作
  • Invoke brainstorming skill:调用头脑风暴技能梳理任务
  • Invoke Skill tool:启动匹配到的技能工具
  • Announce: 'Using [skill] to [purpose]':向用户告知当前使用的技能和要达成的目标
  • Create TodoWrite todo per item:将清单拆解为具体待办事项
  • Follow skill exactly:严格按照技能标准流程执行

二、 完整流程逻辑

  1. 常规对话流程用户发送消息后,直接进入技能匹配判断。如果完全没有适配技能,直接回复用户;只要有一丝适配可能性,就调用对应技能,告知用户后,按照技能流程执行,最终回复用户。
  2. 规划模式流程准备进入规划模式后,先检查是否完成头脑风暴,如果没有就先进行思路梳理,完成后进入技能匹配,后续流程和常规对话保持一致。

三、 设计亮点

这个流程图确保了智能体不会遗漏任何可能适配的技能,同时通过规划模式前置头脑风暴,保证复杂任务执行前思路清晰,并且通过清单拆解让执行过程标准化、可追溯。

1️⃣ 两个入口点的定位

节点名称角色触发场景
User message received通用入口收到任何用户消息时
About to EnterPlanMode?特殊入口即将进入计划模式时

2️⃣ 流程路径对比

路径 1:通用消息路径

Plain Text

User message received → Might any skill apply? → (根据结果继续)

路径 2:计划模式路径

Plain Text

About to EnterPlanMode? → Already brainstormed? → (是/否) → Might any skill apply? → (根据结果继续)

3️⃣ 关键区别

方面User message received 路径About to EnterPlanMode? 路径
触发条件任何用户消息即将进入计划模式
特殊处理直接检查技能先检查是否已头脑风暴
流程目标处理一般任务确保计划模式前的准备工作
优先级通用场景特定场景(计划模式)

4️⃣ 为什么需要两个入口点?

原因 1:计划模式的特殊性

  • 计划模式需要先进行头脑风暴
  • 确保在进入计划模式前,已经完成了必要的需求理解和方案设计

原因 2:流程完整性

  • 覆盖了两种主要场景:一般消息处理和计划模式准备
  • 确保无论哪种场景,都能正确触发技能使用流程

原因 3:用户体验

  • 对于计划模式,自动检查头脑风暴状态,避免重复工作
  • 对于一般消息,直接进入技能检查,提高响应速度

5️⃣ 最终汇合点

两个路径最终都会汇合到 Might any skill apply? 节点,然后遵循相同的技能使用流程:

  1. 检查技能适用性
  2. 调用技能
  3. 宣布使用技能
  4. 处理检查清单
  5. 严格遵循技能
  6. 响应

实例说明

场景 1:一般用户消息

Plain Text

用户:"帮我修复这个 bug"
→ User message received
→ Might any skill apply? (是,debugging)
→ Invoke Skill tool (debugging)
→ 宣布:"使用 debugging 技能来定位和修复这个 bug"
→ 遵循 debugging 技能流程
→ 响应

场景 2:计划模式

Plain Text

用户:"让我们制定一个计划来构建登录功能"
→ About to EnterPlanMode? (是)
→ Already brainstormed? (否)
→ Invoke brainstorming skill
→ Might any skill apply? (是,writing-plans)
→ Invoke Skill tool (writing-plans)
→ 宣布:"使用 writing-plans 技能来制定登录功能的实施计划"
→ 遵循 writing-plans 技能流程
→ 响应

总结

User message received 和 About to EnterPlanMode? 是流程图中的两个独立入口点,分别处理:

  • 通用场景:直接检查技能适用性
  • 计划模式场景:先确保头脑风暴完成,再检查技能

它们最终汇合到同一个技能检查节点,确保无论哪种场景,都能遵循统一的技能使用流程。这种设计既保证了流程的完整性,又针对不同场景进行了优化。