superpowers

pi-superpowers

A translation of the README to Chinese is available too.

English

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

• 🇨🇳 Bilingual Trigger Words: Each skill supports bilingual triggers (Chinese and English); Chinese questions automatically match the corresponding skill.
• 🔌 Bootstrap Extension: Automatically injects skill usage rules into the context at the start of every session.
• 🔧 Tool Mapping: Automatically maps the original Claude Code tools (Skill, TodoWrite, Task) to their Pi equivalent operations.
• 🤖 dispatch_agent Tool: Simulates Claude Code's Task subagent by implementing context isolation via the pi --no-session --print subprocess.
• ⚡ Prompt Templates: 3 slash commands (/brainstorm, etc.).

---

Table of Contents

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

---

Skills Overview

Once installed, a total of 14 skills are provided. The skill descriptions cover both Chinese and English keywords, and Pi automatically loads the corresponding skill when it receives a matching request.

Any skill can also be forcibly loaded via the /skill:<name> command.

Development Workflow

Skill	Trigger Scenario	Chinese Keyword Examples
brainstorming	Requirements analysis and architecture design before implementing a new feature/component	brainstorm, build a new feature, where to start, requirements analysis
writing-plans	Breaking down requirements into fine-grained implementation steps	write a plan, create a development plan, split tasks, make a plan
subagent-driven-development	Executing multiple independent tasks according to an implementation plan	execute plan, start implementation, execute task by task
executing-plans	Batch executing an existing written plan	implement according to plan, batch execute tasks
test-driven-development	Before implementing any feature or fixing a bug	TDD, test-driven development, write tests first, test first
using-git-worktrees	When isolation from the current workspace is needed	git worktree, isolated development, new branch development
dispatching-parallel-agents	Facing 2+ parallelizable independent tasks	parallel processing, multi-task concurrency, fix multiple issues at once
verification-before-completion	Right before declaring a task as complete	verify completion, before declaring done, pre-commit verification

Quality Assurance

Skill	Trigger Scenario	Chinese Keyword Examples
systematic-debugging	Encountering a bug, test failure, or unexpected behavior	debugging, find bug, fix issue, test failure, root cause analysis
requesting-code-review	Code review after completing a task or before merging	code review, review code, pre-commit review
receiving-code-review	Processing workflow after receiving review feedback	process review feedback, respond to review, technical rebuttal
finishing-a-development-branch	Implementation complete, tests passed, ready for integration	finish branch, submit PR, merge code, end development

Meta-skills

Skill	Trigger Scenario	Chinese Keyword Examples
using-superpowers	Beginning of every conversation (automatically injected by Bootstrap extension)	triggers automatically, no manual action needed
writing-skills	Creating or modifying skill files	write skill, create new skill, design workflow skill

---

Typical Workflows

1. Full Feature Development Flow

You: Help me build a user permission management module
 └→ AI automatically loads the brainstorming skill, starting requirements analysis
    ↓ Explores requirements, proposes multiple options, and gets confirmation
You: Okay, let's go with this option
 └→ AI automatically loads the writing-plans skill, breaking down implementation steps
    ↓ Generates a plan with 2-5 minute granularity per step
You: Start implementation
 └→ AI automatically loads subagent-driven-development / executing-plans skill
    ↓ Implements task by task using the TDD cycle (write test first, then implement, continue after review passes)
You: Everything is done
 └→ AI automatically loads the verification-before-completion skill, running verification commands
    ↓ After confirming success, loads finishing a development branch and decides on the merging method

2. Bug Debugging Flow