一款基于Oh My Pi的Agentic工作流扩展，通过斜杠命令实现功能规划、子智能体编排、质量门禁和版本发布，让AI编码助手具备完整的软件交付能力。

Supipowers：为Oh My Pi打造的智能体工作流扩展工具\n\n## 项目定位：AI编码助手的"超能力"扩展\n\nSupipowers是一款专为Oh My Pi（OMP）编码助手设计的工作流扩展工具。它通过一套斜杠命令系统，让AI助手具备了完整的软件交付能力——从需求规划到代码审查，从质量门禁到版本发布，全流程无需离开AI会话即可完成。\n\n项目的核心理念是"无上下文切换"：传统的AI辅助开发往往需要在IDE、终端、浏览器之间来回跳转，而Supipowers将所有关键工作流整合到AI会话中，通过原生扩展API直接驱动，无需子进程，保持开发流畅性。\n\n## 安装与配置\n\nSupipowers提供了一键式交互安装器：\n\nbash\nbunx supipowers\n\n\n安装器会自动检测系统中的Pi（/.pi）和OMP（/.omp），当两者都存在时会提供多选菜单让用户选择安装目标。它还会清理旧版的外部context-mode MCP注册信息，并可选安装LSP服务器、mcpc、Playwright CLI等工具。\n\n安装完成后，用户可以随时通过/supi:update升级到最新版本，或使用/supi:doctor诊断扩展健康状况。\n\n## 核心命令体系\n\nSupipowers提供了20+个斜杠命令，覆盖软件开发生命周期的各个阶段：\n\n### 工作流管理\n\n| 命令 | 功能 |\n|------|------|\n| /supi | 交互式菜单，显示所有命令和项目状态 |\n| /supi:plan | 协作式规划，结构化任务分解 |\n| /supi:review | AI代码审查，带验证的发现文档 |\n| /supi:checks | 运行确定性质量门禁 |\n| /supi:qa | E2E测试流水线（基于Playwright） |\n| /supi:fix-pr | 评估并修复PR审查意见 |\n| /supi:release | 版本升级、发布说明、发布 |\n| /supi:commit | AI驱动的提交，生成规范提交信息 |\n\n### 配置与管理\n\n| 命令 | 功能 |\n|------|------|\n| /supi:model | 为不同动作配置模型分配 |\n| /supi:context | 显示当前上下文窗口使用情况 |\n| /supi:optimize-context | 分析并建议减少上下文占用 |\n| /supi:mcp | 管理MCP服务器（连接、断开、迁移） |\n| /supi:config | 交互式设置TUI |\n| /supi:status | 显示项目计划和配置摘要 |\n| /supi:doctor | 诊断扩展健康状况 |\n| /supi:agents | 管理审查智能体 |\n\n## 核心功能详解\n\n### 智能规划工作流（/supi:plan）\n\n规划命令引导AI经历完整的规划阶段：范围界定→任务分解→估算→验证。规划结果保存到.omp/supipowers/plans/目录，并呈现审批UI。审批通过后，任务在同一会话中执行。\n\n这种设计确保了AI不会"边想边做"，而是先形成完整的执行计划，经过人类确认后再行动，避免了方向性错误。\n\n### 确定性质量门禁（/supi:checks）\n\n质量门禁系统提供六种可独立配置的检测项：\n\n- LSP诊断：语言服务器诊断信息\n- Lint检查：代码风格检查（如eslint、biome）\n- 类型检查：类型系统验证（如tsc）\n- 格式检查：格式化验证\n- 测试套件：测试运行器\n- 构建验证：构建流程检查\n\n在Monorepo中，/supi:checks默认运行所有目标（根目标+每个工作区目标），也可通过--target <package>指定特定包。\n\n### AI代码审查（/supi:review）\n\n审查命令运行程序化的AI审查流水线，支持三种深度模式：\n\n- 快速（quick）：基础检查\n- 深度（deep）：详细分析\n- 多智能体（multi-agent）：多个审查智能体并行\n\n审查使用无头智能体会话和结构化JSON验证，始终验证发现项后才呈现给用户。验证后的发现写入会话的findings.md文档，然后提供三个后续选项：立即修复、仅记录、讨论后再修复。\n\n### 审查智能体系统\n\nSupipowers支持从两个作用域加载审查智能体：\n\n- 全局默认和自定义智能体：位于~/.omp/supipowers/review-agents/\n- 项目配置：位于.omp/supipowers/review-agents/config.yml\n\n合并优先级为项目覆盖全局：如果项目配置提到某个智能体名称，它会遮蔽同名的全局智能体。项目条目设置enabled: false则会禁用该全局智能体。\n\n### PR修复工作流（/supi:fix-pr）\n\n该命令获取PR审查意见，批判性评估每条意见，检查涟漪效应，然后修复或拒绝并提供证据。机器人审查者会被自动检测并过滤。\n\n### 版本发布自动化（/supi:release）\n\n发布命令在运行时自动检测可发布目标：\n\n- 单包仓库保持经典根包流程\n- Bun、npm、pnpm、Yarn工作区从工作区元数据发现可发布包\n\n当只有一个可发布目标时自动选择，否则显示选择器列出所有可发布包（变更的包优先）。发布说明范围限定于所选目标的可发布路径，遵循files白名单或回退到包目录。\n\n支持三种内置发布渠道：GitHub Release（通过gh CLI）、GitLab Release（通过glab CLI）、Gitea Release（通过tea CLI），也支持自定义渠道。\n\n## 上下文保护与优化\n\nSupipowers始终通过原生ctx_*工具和路由钩子启用内置上下文保护：\n\n- 搜索/查找和网页获取类操作被重定向到沙盒执行或索引存储\n- 超大工具结果在到达对话前被压缩\n- 提供/supi:context查看当前上下文窗口使用情况\n- 提供/supi:optimize-context分析加载的提示/上下文使用并建议减少占用\n\n这种设计确保了长会话不会因为上下文膨胀而变得低效。\n\n## 模型分配策略\n\n每个动作可以分配不同的模型和思考级别。/supi:model打开TUI选择器，由OMP的模型注册表支持。这意味着：\n\n- 规划阶段可以使用更强的模型进行深度思考\n- 代码审查可以使用专门的代码模型\n- 简单任务可以使用更快更便宜的模型\n\n## 技能系统\n\nSupipowers内置了运行时加载的提示技能，这些技能在常规会话中也可供智能体使用：\n\n| 技能 | 用途 |\n|------|------|\n| planning | /supi:plan |\n| code-review | 手动提示/可复用审查指导 |\n| qa-strategy | /supi:qa |\n| fix-pr | /supi:fix-pr |\n| debugging | 智能体会话 |\n| tdd | 智能体会话 |\n| verification | 智能体会话 |\n| receiving-code-review | 智能体会话 |\n| release | /supi:release |\n| context-mode | 上下文窗口指导 |\n| creating-supi-agents | 智能体创建指导 |\n\n## 与同类工具的对比\n\nSupipowers与obra/superpowers有相似的目标，但在实现上有明显差异：\n\n| 特性 | Supipowers | obra/superpowers |\n|------|------------|------------------|\n| OMP原生斜杠命令 | ✅ | ❌ |\n| 自动技能激活 | ❌ | ✅ |\n| 规划审批UI | ✅ | ❌ |\n| 并行智能体执行 | ✅ | ✅ |\n| 代码审查工作流 | ✅ | ✅ |\n| TDD/调试/验证技能 | ✅ | ✅ |\n| 浏览器QA/Playwright | ✅ | ❌ |\n| PR审查意见修复 | ✅ | ❌ |\n| 发布自动化 | ✅ | ❌ |\n| 提交工作流 | ✅ | ❌ |\n| 上下文窗口优化 | ✅ | ❌ |\n| MCP服务器管理 | ✅ | ❌ |\n\nSupipowers更侧重于与OMP的深度集成和完整的交付工作流，而obra/superpowers更强调自动技能激活和Git工作流。\n\n## 技术架构\n\nSupipowers基于Bun运行时构建，使用TypeScript开发。测试使用Bun内置的bun:test运行器，与src目录一一对应。\n\n对等依赖（@oh-my-pi/pi-coding-agent、@oh-my-pi/pi-ai、@oh-my-pi/pi-tui、@sinclair/typebox）由OMP宿主提供，仅在开发时作为devDependencies用于类型检查。\n\n## 适用场景\n\nSupipowers特别适合以下场景：\n\n### 专业开发者\n\n希望将AI助手从"代码补全工具"升级为"完整开发伙伴"，通过结构化工作流提升代码质量和交付效率。\n\n### 团队负责人\n\n需要在团队中建立一致的代码审查和质量门禁标准，通过AI辅助确保规范执行。\n\n### 开源维护者\n\n处理大量PR审查和版本发布工作，希望通过自动化减少重复劳动。\n\n### Monorepo项目\n\n管理复杂的多包项目，需要跨包的质量门禁和发布协调。\n\n## 结语\n\nSupipowers代表了AI辅助开发的演进方向：从单一功能的代码补全，到覆盖完整软件交付生命周期的智能工作流。通过与Oh My Pi的深度集成，它将AI助手的"超能力"以结构化、可配置、可扩展的方式呈现给开发者。\n\n对于追求高效、规范、可重复软件交付流程的团队而言，Supipowers提供了一个值得探索的解决方案。

Supipowers：为Oh My Pi打造的智能体工作流扩展工具\n\n项目定位：AI编码助手的"超能力"扩展\n\nSupipowers是一款专为Oh My Pi（OMP）编码助手设计的工作流扩展工具。它通过一套斜杠命令系统，让AI助手具备了完整的软件交付能力——从需求规划到代码审查，从质量门禁到版本发布，全流程无需离开AI会话即可完成。\n\n项目的核心理念是"无上下文切换"：传统的AI辅助开发往往需要在IDE、终端、浏览器之间来回跳转，而Supipowers将所有关键工作流整合到AI会话中，通过原生扩展API直接驱动，无需子进程，保持开发流畅性。\n\n安装与配置\n\nSupipowers提供了一键式交互安装器：\n\nbash\nbunx supipowers\n\n\n安装器会自动检测系统中的Pi（/.pi）和OMP（/.omp），当两者都存在时会提供多选菜单让用户选择安装目标。它还会清理旧版的外部context-mode MCP注册信息，并可选安装LSP服务器、mcpc、Playwright CLI等工具。\n\n安装完成后，用户可以随时通过/supi:update升级到最新版本，或使用/supi:doctor诊断扩展健康状况。\n\n核心命令体系\n\nSupipowers提供了20+个斜杠命令，覆盖软件开发生命周期的各个阶段：\n\n工作流管理\n\n| 命令 | 功能 |\n|------|------|\n| /supi | 交互式菜单，显示所有命令和项目状态 |\n| /supi:plan | 协作式规划，结构化任务分解 |\n| /supi:review | AI代码审查，带验证的发现文档 |\n| /supi:checks | 运行确定性质量门禁 |\n| /supi:qa | E2E测试流水线（基于Playwright） |\n| /supi:fix-pr | 评估并修复PR审查意见 |\n| /supi:release | 版本升级、发布说明、发布 |\n| /supi:commit | AI驱动的提交，生成规范提交信息 |\n\n配置与管理\n\n| 命令 | 功能 |\n|------|------|\n| /supi:model | 为不同动作配置模型分配 |\n| /supi:context | 显示当前上下文窗口使用情况 |\n| /supi:optimize-context | 分析并建议减少上下文占用 |\n| /supi:mcp | 管理MCP服务器（连接、断开、迁移） |\n| /supi:config | 交互式设置TUI |\n| /supi:status | 显示项目计划和配置摘要 |\n| /supi:doctor | 诊断扩展健康状况 |\n| /supi:agents | 管理审查智能体 |\n\n核心功能详解\n\n智能规划工作流（/supi:plan）\n\n规划命令引导AI经历完整的规划阶段：范围界定→任务分解→估算→验证。规划结果保存到.omp/supipowers/plans/目录，并呈现审批UI。审批通过后，任务在同一会话中执行。\n\n这种设计确保了AI不会"边想边做"，而是先形成完整的执行计划，经过人类确认后再行动，避免了方向性错误。\n\n确定性质量门禁（/supi:checks）\n\n质量门禁系统提供六种可独立配置的检测项：\n\n- LSP诊断：语言服务器诊断信息\n- Lint检查：代码风格检查（如eslint、biome）\n- 类型检查：类型系统验证（如tsc）\n- 格式检查：格式化验证\n- 测试套件：测试运行器\n- 构建验证：构建流程检查\n\n在Monorepo中，/supi:checks默认运行所有目标（根目标+每个工作区目标），也可通过--target <package>指定特定包。\n\nAI代码审查（/supi:review）\n\n审查命令运行程序化的AI审查流水线，支持三种深度模式：\n\n- 快速（quick）：基础检查\n- 深度（deep）：详细分析\n- 多智能体（multi-agent）：多个审查智能体并行\n\n审查使用无头智能体会话和结构化JSON验证，始终验证发现项后才呈现给用户。验证后的发现写入会话的findings.md文档，然后提供三个后续选项：立即修复、仅记录、讨论后再修复。\n\n审查智能体系统\n\nSupipowers支持从两个作用域加载审查智能体：\n\n- 全局默认和自定义智能体：位于~/.omp/supipowers/review-agents/\n- 项目配置：位于.omp/supipowers/review-agents/config.yml\n\n合并优先级为项目覆盖全局：如果项目配置提到某个智能体名称，它会遮蔽同名的全局智能体。项目条目设置enabled: false则会禁用该全局智能体。\n\nPR修复工作流（/supi:fix-pr）\n\n该命令获取PR审查意见，批判性评估每条意见，检查涟漪效应，然后修复或拒绝并提供证据。机器人审查者会被自动检测并过滤。\n\n版本发布自动化（/supi:release）\n\n发布命令在运行时自动检测可发布目标：\n\n- 单包仓库保持经典根包流程\n- Bun、npm、pnpm、Yarn工作区从工作区元数据发现可发布包\n\n当只有一个可发布目标时自动选择，否则显示选择器列出所有可发布包（变更的包优先）。发布说明范围限定于所选目标的可发布路径，遵循files白名单或回退到包目录。\n\n支持三种内置发布渠道：GitHub Release（通过gh CLI）、GitLab Release（通过glab CLI）、Gitea Release（通过tea CLI），也支持自定义渠道。\n\n上下文保护与优化\n\nSupipowers始终通过原生ctx_*工具和路由钩子启用内置上下文保护：\n\n- 搜索/查找和网页获取类操作被重定向到沙盒执行或索引存储\n- 超大工具结果在到达对话前被压缩\n- 提供/supi:context查看当前上下文窗口使用情况\n- 提供/supi:optimize-context分析加载的提示/上下文使用并建议减少占用\n\n这种设计确保了长会话不会因为上下文膨胀而变得低效。\n\n模型分配策略\n\n每个动作可以分配不同的模型和思考级别。/supi:model打开TUI选择器，由OMP的模型注册表支持。这意味着：\n\n- 规划阶段可以使用更强的模型进行深度思考\n- 代码审查可以使用专门的代码模型\n- 简单任务可以使用更快更便宜的模型\n\n技能系统\n\nSupipowers内置了运行时加载的提示技能，这些技能在常规会话中也可供智能体使用：\n\n| 技能 | 用途 |\n|------|------|\n| planning | /supi:plan |\n| code-review | 手动提示/可复用审查指导 |\n| qa-strategy | /supi:qa |\n| fix-pr | /supi:fix-pr |\n| debugging | 智能体会话 |\n| tdd | 智能体会话 |\n| verification | 智能体会话 |\n| receiving-code-review | 智能体会话 |\n| release | /supi:release |\n| context-mode | 上下文窗口指导 |\n| creating-supi-agents | 智能体创建指导 |\n\n与同类工具的对比\n\nSupipowers与obra/superpowers有相似的目标，但在实现上有明显差异：\n\n| 特性 | Supipowers | obra/superpowers |\n|------|------------|------------------|\n| OMP原生斜杠命令 | ✅ | ❌ |\n| 自动技能激活 | ❌ | ✅ |\n| 规划审批UI | ✅ | ❌ |\n| 并行智能体执行 | ✅ | ✅ |\n| 代码审查工作流 | ✅ | ✅ |\n| TDD/调试/验证技能 | ✅ | ✅ |\n| 浏览器QA/Playwright | ✅ | ❌ |\n| PR审查意见修复 | ✅ | ❌ |\n| 发布自动化 | ✅ | ❌ |\n| 提交工作流 | ✅ | ❌ |\n| 上下文窗口优化 | ✅ | ❌ |\n| MCP服务器管理 | ✅ | ❌ |\n\nSupipowers更侧重于与OMP的深度集成和完整的交付工作流，而obra/superpowers更强调自动技能激活和Git工作流。\n\n技术架构\n\nSupipowers基于Bun运行时构建，使用TypeScript开发。测试使用Bun内置的bun:test运行器，与src目录一一对应。\n\n对等依赖（@oh-my-pi/pi-coding-agent、@oh-my-pi/pi-ai、@oh-my-pi/pi-tui、@sinclair/typebox）由OMP宿主提供，仅在开发时作为devDependencies用于类型检查。\n\n适用场景\n\nSupipowers特别适合以下场景：\n\n专业开发者\n\n希望将AI助手从"代码补全工具"升级为"完整开发伙伴"，通过结构化工作流提升代码质量和交付效率。\n\n团队负责人\n\n需要在团队中建立一致的代码审查和质量门禁标准，通过AI辅助确保规范执行。\n\n开源维护者\n\n处理大量PR审查和版本发布工作，希望通过自动化减少重复劳动。\n\nMonorepo项目\n\n管理复杂的多包项目，需要跨包的质量门禁和发布协调。\n\n结语\n\nSupipowers代表了AI辅助开发的演进方向：从单一功能的代码补全，到覆盖完整软件交付生命周期的智能工作流。通过与Oh My Pi的深度集成，它将AI助手的"超能力"以结构化、可配置、可扩展的方式呈现给开发者。\n\n对于追求高效、规范、可重复软件交付流程的团队而言，Supipowers提供了一个值得探索的解决方案。