superpowers

pi-superpowers

中文版

A Pi platform port of the Superpowers workflow skill library, with Chinese trigger support

pi-superpowers ports 14 professional workflow skills from obra/superpowers to the Pi programming assistant platform, adding:

• 🇨🇳 Chinese trigger words: Every skill supports bilingual (Chinese/English) triggers — Chinese queries automatically match the corresponding skill
• 🔌 Bootstrap extension: Skill usage rules are automatically injected into context at the start of every session
• 🔧 Tool mapping: Automatically maps original Claude Code tools (Skill, TodoWrite, Task) to Pi equivalents
• 🤖 dispatch_agent tool: Simulates Claude Code's Task sub-agent with context isolation via pi --no-session --print subprocess
• ⚡ Prompt templates: 3 slash commands (/brainstorm, etc.)

---

Table of Contents

• Skill Overview
• Typical Workflows
• Prompt Template Commands
• Tool Mapping Reference
• dispatch_agent Tool
• Bootstrap Injection Mechanism
• Known Limitations
• Installation

---

Skill Overview

After installation, 14 skills are available. Skill descriptions include both Chinese and English keywords — Pi automatically loads the matching skill when a relevant request is received.

You can also force-load any skill with the /skill:<name> command.

Development Workflow Skills

Skill	Trigger Scenario	Chinese Keyword Examples
brainstorming	Requirements analysis and design before implementing a new feature/component	头脑风暴、做一个新功能、从哪里开始、需求分析
writing-plans	Breaking down requirements into fine-grained implementation steps	写计划、制定开发计划、拆分任务、做规划
subagent-driven-development	Executing multiple independent tasks according to an implementation plan	执行计划、开始实现、逐任务执行
executing-plans	Batch-executing an existing written plan	按计划实现、批次执行任务
test-driven-development	Before implementing any feature or fixing a bug	TDD、测试驱动开发、先写测试、测试优先
using-git-worktrees	When isolation from the current workspace is needed	git worktree、隔离开发、新分支开发
dispatching-parallel-agents	Facing 2+ independent tasks that can run in parallel	并行处理、多任务并发、同时修复多个问题
verification-before-completion	Just before declaring a task complete	验证完成、声明完成前、提交前验证

Quality Assurance Skills

Skill	Trigger Scenario	Chinese Keyword Examples
systematic-debugging	Encountering a bug, test failure, or unexpected behavior	调试、找 bug、修复问题、测试失败、根本原因分析
requesting-code-review	Code review before completing a task or merging	代码审查、code review、审查代码、提交前审查
receiving-code-review	Handling review feedback after receiving it	处理审查意见、回应评审、技术反驳
finishing-a-development-branch	Implementation complete, tests passing, ready to integrate	完成分支、提 PR、合并代码、结束开发

Meta Skills

Skill	Trigger Scenario	Chinese Keyword Examples
using-superpowers	At the start of every conversation (auto-injected by the Bootstrap extension)	Auto-triggered, no manual action needed
writing-skills	Creating or modifying skill files	写 skill、创建新技能、设计工作流技能

---

Typical Workflows

1. Full Feature Development Flow

You:  Help me build a user permissions management module
       └→ AI auto-loads brainstorming skill, begins requirements analysis
          ↓ Explores requirements, proposes multiple approaches, awaits confirmation
You:  OK, let's go with that approach
       └→ AI auto-loads writing-plans skill, breaks down implementation steps
          ↓ Generates a plan with 2–5 minute granularity per step
You:  Start implementing
       └→ AI auto-loads subagent-driven-development / executing-plans skill
          ↓ Implements task by task in TDD cycles (tests first, then implement, review, then continue)
You:  Everything is done
       └→ AI auto-loads verification-before-completion skill, runs verification commands
          ↓ After confirmation, loads finishing-a-development-branch to decide merge strategy

2. Bug Debugging Flow

You:  Tests are failing — TypeError: Cannot read property 'id' of undefined
       └→ AI auto-loads systematic-debugging skill
          ↓ Systematic root-cause analysis: confirm symptoms → isolate scope → find minimal repro → fix
          ↓ Must write a failing test that reproduces the bug before applying the fix (TDD)

3. Force-Loading with Slash Commands

When auto-triggering is unreliable, use /skill: commands to force-load a skill: