sion/monisuo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 优化

Browse Source
This commit is contained in:
sion123
2026-04-04 20:42:15 +08:00
parent 682f5dc63b
commit 2850629e0d
2 changed files with 362 additions and 205 deletions
Download Patch File Download Diff File Expand all files Collapse all files

204
.agents/skills/monisuo-dev/README.md
View File

@@ -4,138 +4,104 @@
### 1. 使用技能
在 OpenClaw 中提及 "monisuo 开发" 即可触发此技能。
在 Claude Code 中提及 "monisuo 开发" 即可触发此技能。
### 2. 开发流程
```
需求分析 → 模块化开发 → 测试验证 → 构建部署
分支隔离 → 需求探索 → 计划分解 → 子代理开发 → 双重审查 → 验证门控 → 构建 → 分支完成
```
## 详细说明
## 完整流程
### Phase 1: 需求结构化定义
### Phase 0: 分支隔离
- 使用 git worktree 创建隔离工作区
- 分支名: `feat/[feature-name]`
**目标**: 将需求转化为结构化的 Feature Spec
### Phase 1: 需求探索
- 探索项目上下文
- 逐步提问理解需求
- 提出 2-3 个方案含权衡分析
- 逐节确认设计
- 写入 Feature Spec 并自审
- 用户确认后才进入下一阶段
**步骤**:
1. 收集需求信息
2. 创建 `docs/features/[功能名].md`
3. 填写 Feature Spec 模板
4. 评审并确认
**Feature Spec 模板位置**: `docs/features/FEATURE_TEMPLATE.md`
**Spec 输出**: `docs/features/[功能名].md`
**模板位置**: `docs/features/FEATURE_TEMPLATE.md`
### Phase 1.5: 计划分解
- 探索现有代码库
- 定义 API 契约和数据模型
- 编写咬合级实施计划（每步 2-5 分钟）
- TDD 红绿循环设计
- 计划自审
### Phase 2: 模块化开发
**计划输出**: `docs/superpowers/plans/YYYY-MM-DD-[feature-name].md`
**目标**: 按模块实现功能
### Phase 2: 子代理驱动开发
- 每个任务独立子代理执行
- 双重审查: 规格合规 → 代码质量
- 审查不通过循环修复直到通过
**步骤**:
1. 根据设计文档实现代码
2. 遵循代码规范
3. 使用设计系统（AppSpacing, AppRadius, AppColorScheme）
4. 提交代码
### Phase 3: 质量验证（铁律门控）
- Agent A: 代码审查 + simplify + 测试
- 验证铁律: 没有运行命令不得声称通过
**Flutter 开发**:
```bash
cd flutter_monisuo
flutter pub get
flutter run -d chrome
```
### Phase 4: 功能验证
- Agent B: 逐条验证 Spec 中的测试用例
- 追踪代码路径确认逻辑正确
**Admin 开发**:
```bash
cd monisuo-admin
pnpm install
pnpm dev
```
### Phase 5: 构建
- Agent C: 后端 + Flutter 构建
- 必须看到 exit 0 才算成功
### Phase 3: 测试与重构
### Phase 6: 分支完成
- 合并到 main / 创建 PR / 保留分支
**目标**: 确保代码质量和功能正确性
## 融合的超级技能
**步骤**:
1. 应用 clean-code 技能优化代码
2. 编写/更新 API 测试脚本
3. 运行测试脚本
4. 修复 Bug 直到全部通过
**运行 API 测试**:
```bash
cd tests/api
chmod +x test-template.sh
./test-template.sh
```
**Flutter 单元测试**:
```bash
cd flutter_monisuo
flutter test
```
### Phase 4: 构建与部署
**目标**: 构建生产版本并提交
**Flutter Web 构建**:
```bash
cd flutter_monisuo
flutter build web --release --dart-define=ENV=prod
```
**Admin 构建**:
```bash
cd monisuo-admin
pnpm build
```
**Git 提交**:
```bash
git add .
git commit -m "feat(模块): 功能描述
- 详细说明 1
- 详细说明 2"
git push origin main
```
## 目录结构
```
monisuo/
├── .agents/skills/monisuo-dev/ # 本技能
├── docs/
│ └── features/ # Feature Spec 文档
│ └── FEATURE_TEMPLATE.md # 模板
├── flutter_monisuo/ # Flutter 前端
├── monisuo-admin/ # Admin 后台
└── tests/
├── api/ # API 测试脚本
│ └── test-template.sh # 测试模板
└── e2e/ # 端到端测试
```
| 超级技能 | 用途 | 阶段 |
|----------|------|------|
| 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
flutter pub get # 安装依赖
flutter run -d chrome # 开发模式
flutter analyze # 代码检查
flutter test # 运行测试
flutter build web --release --dart-define=ENV=prod # 生产构建
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
pnpm install # 安装依赖
pnpm dev # 开发模式
pnpm build # 生产构建
cd monisuo-admin
pnpm install # 安装依赖
pnpm dev # 开发模式
pnpm build # 生产构建
pnpm lint / pnpm lint:fix # 代码检查
```
### 测试
```bash
./tests/api/test-template.sh # 运行 API 测试
./tests/api/test-template.sh # API 测试
```
## 环境配置
@@ -145,21 +111,31 @@ pnpm build # 生产构建
| 开发 | dev | http://localhost:5010 |
| 生产 | prod | http://8.155.172.147:5010 |
## 最佳实践
## 代码规范
1. **需求阶段**: 充分理解业务，明确验收标准
2. **开发阶段**: 小步迭代，频繁提交，遵循规范
3. **测试阶段**: 自动化测试优先，覆盖完整
4. **部署阶段**: 使用生产配置，灰度发布
- **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): 描述`
## 参考资源
## 目录结构
- [Flutter 文档](https://flutter.dev/docs)
- [Spring Boot 文档](https://spring.io/projects/spring-boot)
- [Conventional Commits](https://www.conventionalcommits.org/)
- [Clean Code 技能](~/.agents/skills/clean-code/SKILL.md)
```
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/ # 端到端测试
```
---
**版本**: v1.0.0
**创建日期**: 2026-03-23
**版本**: v2.0.0
**更新日期**: 2026-04-04
**变更**: 融合超级技能体系，新增 brainstorming、writing-plans、subagent-driven-development、verification 铁律、systematic-debugging