# Monisuo 开发技能使用指南

## 快速开始

### 1. 使用技能

在 Claude Code 中提及 "monisuo 开发" 即可触发此技能。

### 2. 开发流程

```
分支隔离 → 需求探索 → 计划分解 → 子代理开发 → 双重审查 → 验证门控 → 构建 → 分支完成
```

## 完整流程

### Phase 0: 分支隔离
- 使用 git worktree 创建隔离工作区
- 分支名: `feat/[feature-name]`

### Phase 1: 需求探索
- 探索项目上下文
- 逐步提问理解需求
- 提出 2-3 个方案含权衡分析
- 逐节确认设计
- 写入 Feature Spec 并自审
- 用户确认后才进入下一阶段

**Feature Spec 模板位置**: `docs/features/FEATURE_TEMPLATE.md`
**Spec 输出**: `docs/features/[功能名].md`

### Phase 1.5: 计划分解
- 探索现有代码库
- 定义 API 契约和数据模型
- 编写咬合级实施计划（每步 2-5 分钟）
- TDD 红绿循环设计
- 计划自审

**计划输出**: `docs/superpowers/plans/YYYY-MM-DD-[feature-name].md`

### Phase 2: 子代理驱动开发
- 每个任务独立子代理执行
- 双重审查: 规格合规 → 代码质量
- 审查不通过循环修复直到通过

### Phase 3: 质量验证（铁律门控）
- Agent A: 代码审查 + simplify + 测试
- 验证铁律: 没有运行命令不得声称通过

### Phase 4: 功能验证
- Agent B: 逐条验证 Spec 中的测试用例
- 追踪代码路径确认逻辑正确

### Phase 5: 构建
- Agent C: 后端 + Flutter 构建
- 必须看到 exit 0 才算成功

### Phase 6: 分支完成
- 合并到 main / 创建 PR / 保留分支

## 融合的超级技能

| 超级技能 | 用途 | 阶段 |
|----------|------|------|
| using-git-worktrees | 分支隔离 | Phase 0 |
| brainstorming | 需求探索、方案对比 | Phase 1 |
| writing-plans | 咬合级计划分解 | Phase 1.5 |
| subagent-driven-development | 子代理执行+双重审查 | Phase 2 |
| verification-before-completion | 验证铁律 | Phase 3 |
| systematic-debugging | 系统化 Bug 修复 | Bug 循环 |
| finishing-a-development-branch | 分支完成 | Phase 6 |

## 常用命令

### Flutter
```bash
cd flutter_monisuo
flutter pub get                                        # 安装依赖
flutter run -d chrome                                  # 开发模式
flutter analyze                                        # 代码检查
flutter test                                           # 运行测试
flutter build web --release --dart-define=ENV=prod     # 生产构建
```

### 后端
```bash
mvn spring-boot:run                    # 开发服务
mvn compile                            # 编译
mvn test                               # 测试
mvn clean package -DskipTests          # 打包
```

### Admin
```bash
cd monisuo-admin
pnpm install                           # 安装依赖
pnpm dev                               # 开发模式
pnpm build                             # 生产构建
pnpm lint / pnpm lint:fix              # 代码检查
```

### 测试
```bash
./tests/api/test-template.sh           # API 测试
```

## 环境配置

| 环境 | ENV | API 地址 |
|------|-----|----------|
| 开发 | dev | http://localhost:5010 |
| 生产 | prod | http://8.155.172.147:5010 |

## 代码规范

- **Flutter**: `flutter analyze` 无错，用 AppSpacing/AppRadius/AppColorScheme，禁止硬编码颜色
- **Java**: Lombok 简化，资金变动方法加 `@Transactional(rollbackFor = Exception.class)`，RESTful 设计
- **Admin**: TypeScript strict，TanStack Vue Query 做数据请求，shadcn-vue 组件不手动编辑
- **Git**: Conventional Commits — `feat(module): 描述`、`fix(module): 描述`

## 目录结构

```
monisuo/
├── .agents/skills/monisuo-dev/  # 本技能
├── docs/
│   ├── features/               # Feature Spec 文档
│   │   └── FEATURE_TEMPLATE.md # 模板
│   └── superpowers/plans/      # 实施计划
├── flutter_monisuo/            # Flutter 前端
├── monisuo-admin/              # Admin 后台
├── src/main/java/              # Java 后端
└── tests/
    ├── api/                    # API 测试脚本
    └── e2e/                    # 端到端测试
```

---
**版本**: v2.0.0
**更新日期**: 2026-04-04
**变更**: 融合超级技能体系，新增 brainstorming、writing-plans、subagent-driven-development、verification 铁律、systematic-debugging