打造你的 AI 软件开发搭档:从安装 Superpowers 到创建专属智能体

一站式教程：如何在 CoPaw 中安装 Superpowers 技能集，并打造一个专属于你的软件开发智能体

前言

你是否曾希望有一个”懂你”的 AI 开发搭档？它不仅理解你的需求，还能自动引导你完成从需求探索到代码实现的完整流程——测试驱动开发、代码审查、风险提示，一个都不能少。

今天，我们将一步步打造这样一个智能体。

一、什么是 Superpowers？

Superpowers 是一套完整的软件开发工作流技能集，专为 AI 编程助手设计。它不是简单的代码生成器，而是一套”方法论”：

需求探索 -> 编写计划 -> 测试驱动开发 -> 代码审查 -> 验证完成 -> 发布

核心理念

技能清单

Superpowers 包含 14 个精心设计的技能：

• • brainstorming – 需求探索（创建任何功能前必用）
• • writing-plans – 编写实施计划
• • executing-plans – 执行计划
• • test-driven-development – TDD 工作流
• • systematic-debugging – 系统化调试
• • dispatching-parallel-agents – 并行任务处理
• • subagent-driven-development – 子代理开发
• • requesting/receiving-code-review – 代码审查
• • verification-before-completion – 完成前验证
• • using-git-worktrees – Git worktree 操作
• • finishing-a-development-branch – 完成分支
• • using-superpowers – 使用指南
• • writing-skills – 创建新技能

二、安装 Superpowers 到 CoPaw

2.1 下载技能文件

CoPaw 的技能存放在工作空间的 customized_skills 目录下。我们从 GitHub 下载 Superpowers 技能：

# 进入技能目录cd /app/working/workspaces/default/customized_skills# 下载所有技能的 SKILL.md 文件for skill in brainstorming dispatching-parallel-agents executing-plans \    finishing-a-development-branch receiving-code-review requesting-code-review \    subagent-driven-development systematic-debugging test-driven-development \    using-git-worktrees using-superpowers verification-before-completion \    writing-plans writing-skills; do    mkdir -p $skill    curl -s "https://raw.githubusercontent.com/obra/superpowers/main/skills/$skill/SKILL.md" \        -o $skill/SKILL.mddone

2.2 下载辅助脚本

部分技能包含辅助脚本，我们也一并下载：

# brainstorming 技能的脚本mkdir -p brainstorming/scriptscurl -s "https://raw.githubusercontent.com/obra/superpowers/main/skills/brainstorming/scripts/frame-template.html" \    -o brainstorming/scripts/frame-template.html

2.3 验证安装

from copaw.agents.skills_manager import SkillServicefrom pathlib import Pathservice = SkillService(Path('/app/working/workspaces/default'))skills = service.list_all_skills()customized = [s for s in skills if s.source == 'customized']print(f"已安装 {len(customized)} 个自定义技能")

运行结果：

已安装 14 个自定义技能

三、创建 software-dev 技能

有了 Superpowers 技能集，我们创建一个”入口技能”——software-dev，它能智能识别用户意图，自动路由到正确的技能。

3.1 技能设计

核心功能：

意图到技能映射：

"创建新功能" -> brainstorming -> writing-plans -> TDD"修复 bug"   -> systematic-debugging -> TDD"写测试"     -> test-driven-development"代码审查"   -> requesting-code-review

3.2 创建技能文件

目录结构：

skills/software-dev/├── SKILL.md              # 技能定义├── scripts/│   └── intent-router.py  # 意图识别脚本└── references/    └── risk-levels.md    # 风险级别定义

SKILL.md 核心内容：

---name: software-devdescription: "软件开发智能路由技能"---# Software Development Skill## 意图识别优先级1. 显式触发（最高）: "使用 software-dev..."2. 上下文分析（中等）: 当前在代码项目目录3. 关键词匹配（基础）: "创建"、"修复"、"测试"...## 风险分级- HIGH RISK: 文件删除、Git push、部署（必须确认）- MEDIUM RISK: 创建文件、合并分支（警告但继续）- LOW RISK: 读取、分析、搜索（自动执行）

3.3 意图识别脚本

#!/usr/bin/env python3"""意图识别与技能路由"""from enum import Enumfrom typing import List, Tupleclass IntentType(Enum):    NEW_FEATURE = "new_feature"    BUG_FIX = "bug_fix"    TESTING = "testing"    CODE_REVIEW = "code_review"# 意图关键词映射INTENT_KEYWORDS = {    IntentType.NEW_FEATURE: ["创建", "实现", "开发", "create", "implement"],    IntentType.BUG_FIX: ["修复", "调试", "fix", "debug", "bug"],    IntentType.TESTING: ["测试", "test", "单元测试"],}# 意图到技能的路由INTENT_TO_SKILLS = {    IntentType.NEW_FEATURE: ["brainstorming", "writing-plans", "TDD"],    IntentType.BUG_FIX: ["systematic-debugging", "TDD"],    IntentType.TESTING: ["test-driven-development"],}def detect_intent(text: str) -> Tuple[IntentType, List[str]]:    """检测用户意图并返回目标技能"""    text_lower = text.lower()    for intent, keywords in INTENT_KEYWORDS.items():        for keyword in keywords:            if keyword.lower() in text_lower:                return intent, INTENT_TO_SKILLS.get(intent, [])    return IntentType.NEW_FEATURE, ["using-superpowers"]

3.4 风险级别定义

# 风险级别定义## HIGH RISK - 必须确认| 操作类型 | 示例 | 原因 ||---------|------|------|| 文件删除 | rm, delete | 数据丢失 || Git 操作 | push --force | 覆盖历史 || 部署发布 | deploy --prod | 影响线上 || 数据库变更 | DROP, TRUNCATE | 数据清空 |## MEDIUM RISK - 警告继续- 创建新文件- 添加依赖- Git merge## LOW RISK - 自动执行- 读取文件- 运行测试- 代码分析

四、创建 software-dev 智能体

有了技能，我们把它封装成一个独立的智能体，方便管理和使用。

4.1 创建工作空间

# 创建目录结构mkdir -p /app/working/workspaces/software-dev/{sessions,memory,customized_skills}# 复制 superpowers 技能cp -r /app/working/workspaces/default/customized_skills/* \    /app/working/workspaces/software-dev/customized_skills/

4.2 智能体配置文件

{  "id": "software-dev",  "name": "Software Development Agent",  "description": "智能软件开发代理 - 自动识别开发意图，路由到 superpowers 技能工作流程",  "workspace_dir": "/app/working/workspaces/software-dev",  "software_dev_config": {    "auto_route":true,    "risk_policy": {      "high_risk": "confirm",      "medium_risk": "warn",      "low_risk": "auto"    }  }}

4.3 系统提示词

# Software Development Agent你是一个专业的软件开发代理，基于 Superpowers 方法论工作。## 核心使命帮助用户完成软件开发生命周期中的所有任务，从需求探索到代码实现、测试、审查和发布。## 工作原则### 1. 先理解，后实现永远不要在理解需求之前开始写代码。### 2. 测试驱动开发 (TDD)永远先写测试，再写实现。Red -> Green -> Refactor。### 3. 小步提交每个功能点单独提交，每次提交前运行测试。### 4. YAGNI & DRY不过度设计，不重复代码。

4.4 注册智能体

更新全局配置 config.json：

{  "agents": {    "active_agent": "software-dev",    "profiles": {      "default": {        "id": "default",        "workspace_dir": "/app/working/workspaces/default"      },      "software-dev": {        "id": "software-dev",        "workspace_dir": "/app/working/workspaces/software-dev"      }    }  }}

五、使用效果演示

示例 1：创建新功能

用户: 我想创建一个用户认证模块Agent: 检测到新功能开发意图       -> 置信度: 高       -> 路由到: brainstorming, writing-plans, TDD       在开始编码之前，让我先了解几个问题：       1. 这个认证模块需要支持哪些登录方式？       2. 是否需要集成第三方 OAuth？       3. 用户数据存储在哪里？

示例 2：修复 Bug

用户: 用户登录后偶尔会掉线Agent: 检测到 Bug 修复意图       -> 路由到: systematic-debugging       让我系统地排查这个问题...       [Step 1] 复现问题       [Step 2] 定位原因       [Step 3] 编写测试       [Step 4] 修复代码

示例 3：高风险操作确认

用户: 删除所有测试文件Agent: 检测到高风险操作       您请求的操作会删除测试文件，属于：       - 文件删除（系统级）       - 不可逆操作       确认要继续吗？(yes/no)

六、架构总览

智能体架构图

+-----------------------------------------------------+|           Software Development Agent                |+-----------------------------------------------------+|                                                     ||   用户输入："创建一个登录功能"                       ||      |                                              ||   +------------------+                              ||   |  意图识别器       |  <- software-dev 技能      ||   |  (显式/上下文/关键词)                           ||   +------------------+                              ||      |                                              ||   +------------------+                              ||   |  风险评估器       |                              ||   |  (高/中/低)       |                              ||   +------------------+                              ||      |                                              ||   +---------------------------------------------+   ||   |           Superpowers 技能集                |   ||   |                                            |   ||   |  brainstorming  |  writing-plans  |  TDD   |   ||   |  debugging      |  code-review    |  verify|   ||   |  ...更多技能...                          |   ||   +---------------------------------------------+   ||                                                     |+-----------------------------------------------------+

技能路由流程

用户请求    |    v+--------------+| 意图识别      | <- "创建"、"修复"、"测试"...+--------------+    |    v+--------------+| 风险评估      | <- 是否需要确认？+--------------+    |    v+--------------+| 技能路由      | -> brainstorming / debugging / TDD+--------------+    |    v+--------------+| 执行工作流    | -> 需求探索 -> 计划 -> 实现 -> 验证+--------------+

七、总结

通过本文，我们完成了：

核心收获

1. 1. Superpowers 方法论 – 一套完整的软件开发工作流程
2. 2. 智能意图识别 – 自动理解用户需求并路由
3. 3. 风险感知执行 – 高风险操作自动提示确认
4. 4. 独立智能体 – 专属工作空间和配置

资源链接

• • Superpowers GitHub: https://github.com/obra/superpowers
• • CoPaw 官网: https://copaw.ai

下一步：试试对你的 AI 助手说：

“使用 software-dev 创建一个待办事项管理模块”

体验完整的开发工作流程！

如果这篇文章对你有帮助，欢迎点赞、在看、转发三连！

关注公众号，获取更多 AI 开发技巧。