superpowers

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Superpowers - Agent Development Workflows

超级能力 - Agent开发工作流

Comprehensive agent development skill collection optimized for AI-assisted coding workflows. Contains 14 skills across 5 categories, prioritized by workflow stage to guide development from ideation to completion.
这是一套针对AI辅助编码工作流优化的全面Agent开发技能集合,包含5个类别共14项技能,按工作流阶段排序,可指导从构思到完成的全流程开发。

When to Apply

适用场景

Reference these skills when:
  • Starting a new feature or project (brainstorming, writing-plans)
  • Debugging any issue (systematic-debugging)
  • Writing or modifying code (test-driven-development)
  • Managing branches and isolation (using-git-worktrees)
  • Completing and integrating work (finishing-a-development-branch)
  • Receiving or requesting code review (receiving-code-review, requesting-code-review)
当你处于以下场景时,可参考这些技能:
  • 启动新功能或项目(brainstorming、编写计划)
  • 调试各类问题(systematic-debugging)
  • 编写或修改代码(test-driven-development)
  • 管理分支与隔离(using-git-worktrees)
  • 完成并集成工作(finishing-a-development-branch)
  • 接收或发起代码评审(receiving-code-review、requesting-code-review)

Skill Categories by Workflow Stage

按工作流阶段划分的技能类别

StageCategorySkillsPriority
1Ideation & Planning
brainstorming
,
writing-plans
CRITICAL
2Implementation
test-driven-development
,
subagent-driven-development
,
executing-plans
CRITICAL
3Debugging
systematic-debugging
HIGH
4Code Review
requesting-code-review
,
receiving-code-review
HIGH
5Completion
verification-before-completion
,
finishing-a-development-branch
HIGH
6Utilities
using-git-worktrees
,
dispatching-parallel-agents
,
using-superpowers
,
writing-skills
MEDIUM
阶段类别技能优先级
1构思与规划
brainstorming
writing-plans
关键
2实现
test-driven-development
subagent-driven-development
executing-plans
关键
3调试
systematic-debugging
4代码评审
requesting-code-review
receiving-code-review
5完成
verification-before-completion
finishing-a-development-branch
6工具类
using-git-worktrees
dispatching-parallel-agents
using-superpowers
writing-skills

Quick Reference

快速参考

1. Ideation & Planning (CRITICAL)

1. 构思与规划(关键)

  • brainstorming
    - Collaborative design exploration before implementation
  • writing-plans
    - Create detailed implementation plans with bite-sized tasks
  • brainstorming
    - 实现前的协作式设计探索
  • writing-plans
    - 创建包含细分任务的详细实现计划

2. Implementation (CRITICAL)

2. 实现(关键)

  • test-driven-development
    - RED-GREEN-REFACTOR cycle for all code
  • subagent-driven-development
    - Execute plans with fresh subagent per task
  • executing-plans
    - Batch execution with checkpoints in separate session
  • test-driven-development
    - 适用于所有代码的RED-GREEN-REFACTOR循环
  • subagent-driven-development
    - 为每个任务分配独立的新subagent来执行计划
  • executing-plans
    - 在独立会话中批量执行并设置检查点

3. Debugging (HIGH)

3. 调试(高)

  • systematic-debugging
    - Four-phase root cause investigation before fixes
  • systematic-debugging
    - 修复前的四阶段根因分析

4. Code Review (HIGH)

4. 代码评审(高)

  • requesting-code-review
    - Dispatch code reviewer subagent after implementation
  • receiving-code-review
    - Technical evaluation, not performative agreement
  • requesting-code-review
    - 实现完成后分配代码评审subagent
  • receiving-code-review
    - 技术评估,而非形式化同意

5. Completion (HIGH)

5. 完成(高)

  • verification-before-completion
    - Evidence before claims, always
  • finishing-a-development-branch
    - Merge, PR, keep, or discard options
  • verification-before-completion
    - 始终先验证再提出结论
  • finishing-a-development-branch
    - 合并、PR、保留或丢弃分支的选项

6. Utilities (MEDIUM)

6. 工具类(中)

  • using-git-worktrees
    - Isolated workspaces for parallel development
  • dispatching-parallel-agents
    - One agent per independent problem domain
  • using-superpowers
    - How to find and invoke skills
  • writing-skills
    - TDD applied to process documentation
  • using-git-worktrees
    - 用于并行开发的独立工作区
  • dispatching-parallel-agents
    - 为每个独立问题域分配一个agent
  • using-superpowers
    - 如何查找并调用技能
  • writing-skills
    - 将TDD应用于流程文档

Core Principles

核心原则

Each skill enforces key discipline principles:
PrincipleSkillsIron Law
Test First
test-driven-development
No production code without failing test
Root Cause First
systematic-debugging
No fixes without investigation
Evidence First
verification-before-completion
No claims without verification
Plan First
brainstorming
,
writing-plans
No code without design
每项技能都遵循关键的规范原则:
原则技能铁律
测试优先
test-driven-development
无失败测试则不编写生产代码
根因优先
systematic-debugging
未调查则不修复
证据优先
verification-before-completion
未验证则不提出结论
规划优先
brainstorming
writing-plans
无设计则不编写代码

How to Use

使用方法

Read individual skill files for detailed instructions:
brainstorming/SKILL.md
test-driven-development/SKILL.md
systematic-debugging/SKILL.md
Each skill file contains:
  • Overview and core principle
  • When to use (and when NOT to)
  • Step-by-step process
  • Common mistakes and red flags
  • Integration with other skills
阅读单个技能文件获取详细说明:
brainstorming/SKILL.md
test-driven-development/SKILL.md
systematic-debugging/SKILL.md
每个技能文件包含:
  • 概述与核心原则
  • 适用(及不适用)场景
  • 分步流程
  • 常见错误与警示信号
  • 与其他技能的集成

Full Compiled Document

完整编译文档

For the complete guide with all skills expanded:
AGENTS.md
如需包含所有技能详细内容的完整指南,请查看:
AGENTS.md