Files

sion e01f3330a2 feat(skills): 添加 monisuo 开发技能

- 创建结构化开发流程技能 (monisuo-dev)
- 添加 Feature Spec 模板
- 添加 API 测试脚本模板
- 完整的 4 阶段开发流程：
  1. 需求结构化定义
  2. 模块化生成
  3. 测试与重构
  4. 构建与部署

文件清单：
- .agents/skills/monisuo-dev/SKILL.md (主技能文件)
- .agents/skills/monisuo-dev/README.md (使用指南)
- docs/features/FEATURE_TEMPLATE.md (Feature Spec 模板)
- tests/api/test-template.sh (API 测试模板)

2026-03-23 21:45:45 +08:00

3.4 KiB

Raw Blame History

Monisuo 开发技能使用指南

快速开始

1. 使用技能

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

2. 开发流程

需求分析 → 模块化开发 → 测试验证 → 构建部署

详细说明

Phase 1: 需求结构化定义

目标: 将需求转化为结构化的 Feature Spec

步骤:

收集需求信息
创建 docs/features/[功能名].md
填写 Feature Spec 模板
评审并确认

模板位置: docs/features/FEATURE_TEMPLATE.md

Phase 2: 模块化开发

目标: 按模块实现功能

步骤:

根据设计文档实现代码
遵循代码规范
使用设计系统（AppSpacing, AppRadius, AppColorScheme）
提交代码

Flutter 开发:

cd flutter_monisuo
flutter pub get
flutter run -d chrome

Admin 开发:

cd monisuo-admin
pnpm install
pnpm dev

Phase 3: 测试与重构

目标: 确保代码质量和功能正确性

步骤:

应用 clean-code 技能优化代码
编写/更新 API 测试脚本
运行测试脚本
修复 Bug 直到全部通过

运行 API 测试:

cd tests/api
chmod +x test-template.sh
./test-template.sh

Flutter 单元测试:

cd flutter_monisuo
flutter test

Phase 4: 构建与部署

目标: 构建生产版本并提交

Flutter Web 构建:

cd flutter_monisuo
flutter build web --release --dart-define=ENV=prod

Admin 构建:

cd monisuo-admin
pnpm build

Git 提交:

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/                    # 端到端测试

常用命令

Flutter

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

Admin

pnpm install                     # 安装依赖
pnpm dev                         # 开发模式
pnpm build                       # 生产构建

测试

./tests/api/test-template.sh     # 运行 API 测试

环境配置

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

最佳实践

需求阶段: 充分理解业务，明确验收标准
开发阶段: 小步迭代，频繁提交，遵循规范
测试阶段: 自动化测试优先，覆盖完整
部署阶段: 使用生产配置，灰度发布

参考资源

版本: v1.0.0
创建日期: 2026-03-23

3.4 KiB Raw Blame History Unescape Escape