Codex CLI教程(四) | Superpowers 使用指南

Codex CLI教程(四) | Superpowers 使用指南svg xmlns http www w3 org 2000 svg style display none svg

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
      
     

Superpowers 是一套智能工程工作流系统,帮助你按照正确的顺序完成开发任务,避免流程混乱和返工。

  • 确保流程完整性:按照正确顺序执行工程流程,不跳过关键步骤
  • 提高开发效率:自动处理重复性任务,让你专注于核心工作
  • 保证代码质量:内置测试、审查等质量保障机制
  • 适应不同场景:支持从新手到专家的各种开发场景

触发方式:直接描述你的任务,不需要明确指定技能

工作原理:系统会自动分析你的任务类型,选择合适的技能和流程

示例:你说"我要开发一个新项目",系统会自动:

  1. 通过 using-superpowers(超级技能入口检查)技能判断任务类型
  2. 进入 brainstorming(头脑风暴)技能澄清需求和设计
  3. 生成 spec 文档
  4. 进入 writing-plans(编写实施计划)技能制定计划
  5. 提示你选择执行方式
  6. 自动推进后续流程

触发方式:在提示词中明确指定要使用的技能

工作原理:系统会从你指定的技能开始,然后按该技能的下游链路继续推进

示例:你说"用 brainstorming 分析这个新功能",系统会直接进入 brainstorming(头脑风暴)技能,完成后自动进入 writing-plans(编写实施计划)技能

无论是自动触发还是手动指定,系统都会:

  • 按技能链路自动推进:每个技能都有预设的下游技能,系统会按顺序执行
  • 在关键节点暂停:遇到需要用户决策的地方(如设计方案确认、执行方式选择)会停下来
  • 基于产物继续:如果会话中断,下次会基于已产生的产物(如 spec、plan)继续执行

术语 英文 解释 需求规格文档 Spec 详细描述项目需求、功能规格、技术架构等的文档,是后续开发的基础 实施计划 Plan 将需求拆分为具体可执行任务的文档,包含任务优先级、时间估算、责任分配等 工作树 Worktree Git 的一种功能,允许在一个仓库中同时检出多个分支,便于并行开发 子代理 Subagent Superpowers 中的子流程,负责执行特定任务并进行质量控制 门禁 Gatekeeping 确保代码质量的关键环节,如测试、验证等
技能类型 包含技能 作用 入口技能 using-superpowers(超级技能入口检查) 判断应该从哪个技能开始 起点技能 brainstorming(头脑风暴)、writing-plans(编写实施计划)、systematic-debugging(系统化排障) 开始任务的核心技能 执行前置技能 using-git-worktrees(使用 Git 工作树) 执行前的准备工作 执行技能 subagent-driven-development(子代理驱动开发)、executing-plans(按计划执行)、dispatching-parallel-agents(并行分派代理) 执行具体任务 门禁技能 test-driven-development(测试驱动开发)、verification-before-completion(完成前验证) 保证质量的关键环节 评审技能 requesting-code-review(发起代码评审)、receiving-code-review(处理代码评审意见) 代码质量控制 收尾技能 finishing-a-development-branch(完成开发分支收尾) 完成开发后的处理 元技能 writing-skills(编写技能) 创建或修改技能本身
技能名称 中文翻译 适用场景 作用 产物 using-superpowers 超级技能入口检查 每轮任务开始时 判断应该从哪个技能开始 通常不单独落盘 brainstorming 头脑风暴(需求澄清与方案设计) 新项目、新功能、修改行为 澄清需求、比较方案、确认设计、写 spec spec 文档 writing-plans 编写实施计划 已有需求或 spec,需要拆成执行计划 输出完整的实施计划 plan 文档 systematic-debugging 系统化排障 bug、测试失败、异常行为 找 root cause,先证据后修复 诊断结论、失败用例 using-git-worktrees 使用 Git 工作树 开始正式实现前 创建隔离工作区和分支 worktree、分支 subagent-driven-development 子代理驱动开发 有 plan,且要按 task 高质量推进 用子代理执行任务并做双重 review 代码、测试、review、commit executing-plans 按计划执行 有 plan,但要在当前会话里直接执行 按 plan 逐项落地 代码、测试、阶段结果 dispatching-parallel-agents 并行分派代理 有多个互不依赖的任务 并行分发独立任务 多个子任务结果 test-driven-development 测试驱动开发 写 feature 或 bugfix 之前 先写失败测试,再写实现 测试、最小实现 verification-before-completion 完成前验证 准备宣称完成时 强制 fresh verify 测试/构建/检查证据 requesting-code-review 发起代码评审 一个 task 或阶段完成后 主动发起 review review 结论 receiving-code-review 处理代码评审意见 收到 review 后 验证建议是否成立并决定是否采纳 review 处理结论 finishing-a-development-branch 完成开发分支收尾 实现完成后 给出 merge、PR、保留、丢弃选项 收尾结果 writing-skills 编写技能 创建或修改技能本身时 用近似 TDD 的方式写技能 新技能目录、 SKILL.md

场景描述:从零开始开发一个新的 Web 应用,包括前端和后端。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “我要开发一个新的 Web 应用,包含前端和后端” 1. using-superpowers(超级技能入口检查)
2. brainstorming(头脑风暴)
3. writing-plans(编写实施计划)
4. using-git-worktrees(使用 Git 工作树)
5. 选择执行方式
6. 执行开发任务
7. test-driven-development(测试驱动开发)
8. requesting-code-review(发起代码评审)
9. verification-before-completion(完成前验证)
10. finishing-a-development-branch(完成开发分支收尾) 手动指定 “先用 brainstorming 澄清需求、设计架构并生成 spec” 1. brainstorming(头脑风暴)
2. writing-plans(编写实施计划)
3. 选择执行方式
4. using-git-worktrees(使用 Git 工作树)
5. 执行开发任务
6. test-driven-development(测试驱动开发)
7. requesting-code-review(发起代码评审)
8. verification-before-completion(完成前验证)
9. finishing-a-development-branch(完成开发分支收尾) 自定义流程 “开发一个新的 Web 应用,跳过代码审查” 1. using-superpowers(超级技能入口检查)
2. brainstorming(头脑风暴)
3. writing-plans(编写实施计划)
4. using-git-worktrees(使用 Git 工作树)
5. 选择执行方式
6. 执行开发任务
7. test-driven-development(测试驱动开发)
8. verification-before-completion(完成前验证)
9. finishing-a-development-branch(完成开发分支收尾)










































































场景描述:为电商网站添加商品评论功能。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “给这个电商网站添加商品评论功能” 1. using-superpowers(超级技能入口检查)
2. brainstorming(头脑风暴)
3. writing-plans(编写实施计划)
4. using-git-worktrees(使用 Git 工作树)
5. executing-plans(按计划执行)
6. test-driven-development(测试驱动开发)
7. requesting-code-review(发起代码评审)
8. verification-before-completion(完成前验证)
9. finishing-a-development-branch(完成开发分支收尾) 手动指定 “直接实现商品评论功能,不需要创建新分支” 1. using-superpowers(超级技能入口检查)
2. brainstorming(头脑风暴)
3. writing-plans(编写实施计划)
4. 跳过 using-git-worktrees(使用 Git 工作树)
5. executing-plans(按计划执行)
6. test-driven-development(测试驱动开发)
7. requesting-code-review(发起代码评审)
8. verification-before-completion(完成前验证)
9. finishing-a-development-branch(完成开发分支收尾)















































场景描述:修复购物车丢失商品的问题。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “购物车功能在某些情况下会丢失商品,帮我修复” 1. using-superpowers(超级技能入口检查)
2. systematic-debugging(系统化排障)
3. test-driven-development(测试驱动开发)
4. executing-plans(按计划执行)
5. verification-before-completion(完成前验证)
6. finishing-a-development-branch(完成开发分支收尾) 手动指定 “按 systematic-debugging 排查购物车丢失商品的问题” 1. systematic-debugging(系统化排障)
2. test-driven-development(测试驱动开发)
3. executing-plans(按计划执行)
4. verification-before-completion(完成前验证)
5. finishing-a-development-branch(完成开发分支收尾)


























场景描述:将会员系统需求拆分为可执行任务。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “帮我将会员系统需求拆分为可执行任务” 1. using-superpowers(超级技能入口检查)
2. writing-plans(编写实施计划)
3. 选择执行方式
4. using-git-worktrees(使用 Git 工作树)
5. 执行开发任务
6. verification-before-completion(完成前验证)
7. finishing-a-development-branch(完成开发分支收尾) 手动指定 “用 writing-plans 拆分会员系统需求,不需要执行” 1. writing-plans(编写实施计划)
2. 流程结束(因为指定了不需要执行)




















场景描述:同时处理多个独立任务,如优化性能、修复 Bug、更新文档。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “我需要同时处理多个任务:优化网站性能、修复3个小 Bug、更新用户文档” 1. using-superpowers(超级技能入口检查)
2. dispatching-parallel-agents(并行分派代理)
3. verification-before-completion(完成前验证)
4. finishing-a-development-branch(完成开发分支收尾) 手动指定 “用 dispatching-parallel-agents 并行处理这些任务” 1. dispatching-parallel-agents(并行分派代理)
2. verification-before-completion(完成前验证)
3. finishing-a-development-branch(完成开发分支收尾)














场景描述:处理团队成员的代码审查意见。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “帮我处理这些代码审查意见” 1. using-superpowers(超级技能入口检查)
2. receiving-code-review(处理代码评审意见)
3. executing-plans(按计划执行)
4. verification-before-completion(完成前验证)
5. finishing-a-development-branch(完成开发分支收尾) 手动指定 “按 receiving-code-review 处理这些代码审查意见” 1. receiving-code-review(处理代码评审意见)
2. executing-plans(按计划执行)
3. verification-before-completion(完成前验证)
4. finishing-a-development-branch(完成开发分支收尾)




















场景描述:确保功能开发完成后的质量。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “帮我验证这个功能是否完成” 1. using-superpowers(超级技能入口检查)
2. verification-before-completion(完成前验证)
3. finishing-a-development-branch(完成开发分支收尾) 手动指定 “完成前必须走 verification-before-completion” 1. verification-before-completion(完成前验证)
2. finishing-a-development-branch(完成开发分支收尾)








场景描述:决定如何处理开发分支。

推荐提示词与流程

提示词类型 示例提示词 流程路径 自动驱动 “帮我处理这个开发分支” 1. using-superpowers(超级技能入口检查)
2. finishing-a-development-branch(完成开发分支收尾) 手动指定 “按 finishing-a-development-branch 收尾” 1. finishing-a-development-branch(完成开发分支收尾)


场景描述:为 Superpowers 创建新技能。

推荐提示词与流程

提示词类型 示例提示词 流程路径 手动指定 “用 writing-skills 创建一个新技能,用于自动化数据库迁移” 1. writing-skills(编写技能)
2. verification-before-completion(完成前验证)


阶段 常见产物 管理建议 设计阶段 spec 文档 保存在项目根目录的 docs/specs/ 文件夹 计划阶段 plan 文档 保存在项目根目录的 docs/plans/ 文件夹 执行准备阶段 worktree、分支 合理命名分支,保持 worktree 整洁 实现阶段 代码、测试、commit 遵循 commit 规范,编写清晰的 commit message review 阶段 review 结论、review 处理结果 记录在 PR 或代码评审工具中 验证阶段 fresh verify 证据 保存测试报告和构建日志 收尾阶段 merge / PR / 保留 / 丢弃结果 记录在版本控制系统中 技能开发阶段 新技能目录、 SKILL.md 保存在技能库中,遵循技能开发规范
问题 答案 系统会自动完成所有任务吗? 不会。系统会在关键节点停下来等你确认,如设计方案、执行方式选择等。 手动指定技能后,系统会继续自动推进吗? 会。很多技能会继续按自己的下游链路走,但门禁型技能只约束当前阶段。 所有技能都会产生文件吗? 不是。有些技能主要是流程引导,不会产生独立文件,如 using-superpowers(超级技能入口检查)。 如何选择合适的执行方式? 子代理驱动开发适合需要高质量执行的任务,直接执行适合简单快速的任务。 什么时候需要使用并行分派代理? 当你有多个互不依赖的任务,希望同时处理以提高效率时。 流程中的步骤是否都必须执行? 不一定。系统会根据任务类型和上下文自动调整流程,你也可以在提示词中明确跳过某些步骤。 如何定制流程? 你可以在提示词中明确指定要执行或跳过的步骤,例如:“开发这个功能,跳过代码审查”。

(1)Superpowers 的核心价值

  • 确保流程完整性:按照正确顺序执行工程流程,不跳过关键步骤
  • 提高开发效率:自动处理重复性任务,让你专注于核心工作
  • 保证代码质量:内置测试、审查等质量保障机制
  • 适应不同场景:支持从新手到专家的各种开发场景

(2)如何选择使用模式

  • 自动驱动模式:适合新手用户,或者当你想让系统帮你规划整个流程时
  • 手动指定模式:适合有经验的用户,或者当你想从特定环节开始时
  • 自定义流程:适合需要灵活调整流程的场景,通过提示词指定跳过某些步骤

(3)**实践

  • 对于复杂项目,使用自动驱动模式,让系统帮你规划完整流程
  • 对于特定环节,使用手动指定模式,直接切入核心工作
  • 合理利用并行任务处理,提高多任务效率
  • 始终使用完成前验证,确保代码质量
  • 及时处理分支收尾,保持代码库整洁

随着使用经验的积累,你会越来越熟练地运用 Superpowers,让开发过程更加顺畅和高效!

小讯
上一篇 2026-04-15 13:39
下一篇 2026-04-15 13:37

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/264477.html