sion
e01f3330a2
- 创建结构化开发流程技能 (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 测试模板)
188 lines
3.3 KiB
Markdown
188 lines
3.3 KiB
Markdown
# [功能名称] 功能规格
|
|
|
|
## 1. 功能概述
|
|
- **功能名称**: 示例功能
|
|
- **优先级**: P1
|
|
- **负责人**: 开发团队
|
|
- **预计工期**: 3 天
|
|
|
|
## 2. 业务背景
|
|
|
|
### 当前痛点
|
|
- 描述当前存在的问题
|
|
- 用户痛点分析
|
|
|
|
### 解决方案
|
|
- 如何解决这些问题
|
|
- 技术方案概述
|
|
|
|
### 预期收益
|
|
- 提升用户体验
|
|
- 提高开发效率
|
|
- 其他收益
|
|
|
|
## 3. 功能详情
|
|
|
|
### 3.1 用户故事
|
|
作为 [用户角色]，我希望 [执行的操作]，以便 [达到的目的]
|
|
|
|
**示例**:
|
|
作为交易用户，我希望快速查看实时行情，以便及时做出交易决策
|
|
|
|
### 3.2 功能列表
|
|
- [ ] 功能点 1: 详细描述
|
|
- [ ] 功能点 2: 详细描述
|
|
- [ ] 功能点 3: 详细描述
|
|
|
|
### 3.3 UI/UX 设计
|
|
- 页面布局说明
|
|
- 交互流程图
|
|
- 原型链接 (如有)
|
|
|
|
## 4. 技术方案
|
|
|
|
### 4.1 架构设计
|
|
|
|
#### 前端方案 (Flutter)
|
|
- 状态管理: Provider
|
|
- UI 组件: shadcn_ui
|
|
- 路由管理: Navigator
|
|
|
|
#### 后端方案 (Spring Boot)
|
|
- API 设计: RESTful
|
|
- 数据库: MySQL
|
|
- 缓存: Redis
|
|
|
|
### 4.2 API 设计
|
|
|
|
#### 获取数据
|
|
```
|
|
GET /api/resource
|
|
Headers:
|
|
Authorization: Bearer {token}
|
|
|
|
Response:
|
|
{
|
|
"success": true,
|
|
"data": {
|
|
// 返回数据
|
|
}
|
|
}
|
|
```
|
|
|
|
#### 创建数据
|
|
```
|
|
POST /api/resource
|
|
Headers:
|
|
Authorization: Bearer {token}
|
|
Content-Type: application/json
|
|
|
|
Body:
|
|
{
|
|
"field1": "value1",
|
|
"field2": "value2"
|
|
}
|
|
|
|
Response:
|
|
{
|
|
"success": true,
|
|
"data": {
|
|
"id": "123"
|
|
}
|
|
}
|
|
```
|
|
|
|
### 4.3 数据模型
|
|
|
|
#### Dart Model
|
|
```dart
|
|
class ExampleModel {
|
|
final String id;
|
|
final String name;
|
|
final DateTime createdAt;
|
|
|
|
ExampleModel({
|
|
required this.id,
|
|
required this.name,
|
|
required this.createdAt,
|
|
});
|
|
|
|
factory ExampleModel.fromJson(Map<String, dynamic> json) {
|
|
return ExampleModel(
|
|
id: json['id'],
|
|
name: json['name'],
|
|
createdAt: DateTime.parse(json['createdAt']),
|
|
);
|
|
}
|
|
|
|
Map<String, dynamic> toJson() {
|
|
return {
|
|
'id': id,
|
|
'name': name,
|
|
'createdAt': createdAt.toIso8601String(),
|
|
};
|
|
}
|
|
}
|
|
```
|
|
|
|
## 5. 测试用例
|
|
|
|
### 5.1 正常流程测试
|
|
- [ ] 测试用例 1: 描述 + 预期结果
|
|
- [ ] 测试用例 2: 描述 + 预期结果
|
|
|
|
### 5.2 异常流程测试
|
|
- [ ] 测试用例 1: 异常场景 + 预期处理
|
|
- [ ] 测试用例 2: 异常场景 + 预期处理
|
|
|
|
### 5.3 边界条件测试
|
|
- [ ] 边界 1: 描述 + 预期结果
|
|
- [ ] 边界 2: 描述 + 预期结果
|
|
|
|
## 6. 验收标准
|
|
|
|
### 功能验收
|
|
- [ ] 所有功能点已实现
|
|
- [ ] UI 符合设计稿
|
|
- [ ] 交互流畅自然
|
|
|
|
### 质量验收
|
|
- [ ] 单元测试通过
|
|
- [ ] API 测试通过
|
|
- [ ] 代码审查通过
|
|
- [ ] 无明显性能问题
|
|
|
|
### 文档验收
|
|
- [ ] API 文档已更新
|
|
- [ ] 用户手册已更新
|
|
- [ ] CHANGELOG 已更新
|
|
|
|
## 7. 依赖与风险
|
|
|
|
### 依赖项
|
|
- 依赖 1: 描述 + 影响范围
|
|
- 依赖 2: 描述 + 影响范围
|
|
|
|
### 潜在风险
|
|
- 风险 1: 描述 + 缓解措施
|
|
- 风险 2: 描述 + 缓解措施
|
|
|
|
## 8. 时间规划
|
|
|
|
| 阶段 | 任务 | 预计时间 |
|
|
|------|------|----------|
|
|
| Phase 1 | 需求分析与设计 | 0.5 天 |
|
|
| Phase 2 | 开发实现 | 1.5 天 |
|
|
| Phase 3 | 测试与修复 | 0.5 天 |
|
|
| Phase 4 | 构建与部署 | 0.5 天 |
|
|
|
|
## 9. 参考资料
|
|
- 相关文档链接
|
|
- 技术文档
|
|
- 第三方库文档
|
|
|
|
---
|
|
|
|
**创建日期**: 2026-03-23
|
|
**最后更新**: 2026-03-23
|