142 lines
4.3 KiB
Markdown
142 lines
4.3 KiB
Markdown
# 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
|