技能名称：自定义API集成

触发条件

当项目中出现API调用需求时自动激活

工作流程

1. 分析API文档并生成客户端代码
2. 创建使用示例和测试用例
3. 集成错误处理和重试机制

输出成果

• API客户端代码
• 测试套件
• 使用文档

将自定义技能放置在`skills/custom/`目录下，系统会自动发现并加载。

## ⚠️ 常见误区规避

### 1. 过度依赖自动化，忽视人工决策

**误区**：完全依赖AI代理做架构决策和技术选型。
**解决方案**：将AI建议视为参考，关键决策仍需人工确认。使用`/superpowers:review-design`命令获取多角度评估，辅助决策。

### 2. 跳过设计阶段，直接进入编码

**误区**：急于看到代码产出，跳过需求分析和设计环节。
**解决方案**：强制使用`/superpowers:brainstorm`完成设计文档，设置设计评审 checkpoint，未通过评审不允许进入开发阶段。

### 3. 忽视测试驱动开发原则

**误区**：允许AI代理先写实现代码，后补测试。
**解决方案**：在配置中设置`enforce_tdd: true`，强制AI代理遵循红-绿-重构流程，确保测试覆盖率不低于80%。

### 4. 未充分利用工作树隔离

**误区**：在单一工作空间中进行多任务开发。
**解决方案**：养成使用`/superpowers:create-worktree`命令的习惯，为每个功能创建独立工作树，避免代码冲突和环境污染。

## 🛠️ 技术选型建议

Superpowers并非万能解决方案，以下是其适用场景和限制条件的分析：

### 最适合的项目类型
- **中小型Web应用**：前后端分离架构的应用开发
- **API服务**：REST或GraphQL接口开发
- **工具类项目**：命令行工具和自动化脚本
- **原型验证**：快速将概念转化为可演示产品

### 需谨慎考虑的场景
- **低延迟系统**：需要极致性能优化的实时系统
- **嵌入式开发**：资源受限环境的固件开发
- **高度定制UI**：需要精细视觉设计的前端项目
- **遗留系统改造**：缺乏测试和文档的旧系统

## 🔍 故障排查指南

### 问题：AI代理频繁偏离开发计划

**可能原因**：
- 需求规格不够明确
- 任务分解过于粗略
- 技能优先级设置不当

**解决方案**：
1. 运行`/superpowers:refine-specs`重新梳理需求
2. 执行`/superpowers:split-tasks --finer`细化任务
3. 调整`skills/config.json`中的技能优先级

### 问题：测试通过率持续低下

**可能原因**：
- 测试用例设计不合理
- 实现代码与测试不同步
- 环境配置存在问题

**解决方案**：
1. 检查测试日志：`cat tests/logs/latest.txt`
2. 重新生成测试：`/superpowers:regenerate-tests`
3. 验证环境配置：`./scripts/verify-environment.sh`

## 📖 开发哲学：Superpowers的核心理念

Superpowers不仅仅是一套工具，更是一种现代化的开发思想体系：

### 1. 系统化优先于即兴发挥
"混乱的创造力"无法构建可靠系统。Superpowers强调可重复的系统化流程，确保每次开发都遵循经过验证的最佳实践，同时保留创新空间。

### 2. 证据驱动而非猜测
"我认为这能工作"在Superpowers中是不够的。每个功能必须通过自动化测试证明其正确性，每个决策必须基于可验证的证据。

### 3. 协作高于孤立工作
人类与AI不是对手，而是协作伙伴。Superpowers设计理念是让人类专注于创意和决策，AI处理执行细节，形成1+1>2的协同效应。

### 4. 持续进化而非静态不变
软件开发领域不断变化，Superpowers通过技能库的持续更新和用户反馈机制，确保始终采用最新的开发实践和技术理念。

## 🚀 进阶技巧：释放Superpowers全部潜能

### 1. 自定义技能组合模板
创建针对特定项目类型的技能组合模板，一键切换开发模式：

```bash
# 创建模板
/superpowers:save-template web-api --skills brainstorm,tdd,api-design

# 应用模板
/superpowers:load-template web-api

2. 集成第三方工具链

通过钩子系统将Superpowers与您喜爱的开发工具集成：

// hooks/hooks.json
{
  "post-code-generation": [
    "eslint --fix {{file_path}}",
    "prettier --write {{file_path}}"
  ]
}

3. 性能优化策略

对于大型项目，使用增量开发模式提高效率：

# 仅执行计划中的特定模块
/superpowers:execute-plan --module authentication