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
cd flutter_monisuo
flutter pub get # 安装依赖
flutter run -d chrome # 开发模式
flutter analyze # 代码检查
flutter test # 运行测试
flutter build web --release --dart-define=ENV=prod # 生产构建
后端
mvn spring-boot:run # 开发服务
mvn compile # 编译
mvn test # 测试
mvn clean package -DskipTests # 打包
Admin
cd monisuo-admin
pnpm install # 安装依赖
pnpm dev # 开发模式
pnpm build # 生产构建
pnpm lint / pnpm lint:fix # 代码检查
测试
./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