sdd-full 3.2.0 → 4.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin.js +63 -31
- package/package.json +1 -1
- package/skills/brainstorming/SKILL.md +164 -0
- package/skills/brainstorming/scripts/frame-template.html +214 -0
- package/skills/brainstorming/scripts/helper.js +88 -0
- package/skills/brainstorming/scripts/server.cjs +338 -0
- package/skills/brainstorming/scripts/start-server.sh +153 -0
- package/skills/brainstorming/scripts/stop-server.sh +55 -0
- package/skills/brainstorming/spec-document-reviewer-prompt.md +48 -0
- package/skills/brainstorming/visual-companion.md +286 -0
- package/skills/chinese-code-review/SKILL.md +277 -0
- package/skills/chinese-commit-conventions/SKILL.md +364 -0
- package/skills/chinese-documentation/SKILL.md +448 -0
- package/skills/chinese-git-workflow/SKILL.md +510 -0
- package/skills/design-planning/enterprise-spec/SKILL.md +3 -52
- package/skills/design-planning/flutter-av/SKILL.md +34 -44
- package/skills/design-planning/flutter-map/SKILL.md +31 -41
- package/skills/design-planning/ui-sdd-specialized/SKILL.md +40 -46
- package/skills/development-execution/flutter-errors/SKILL.md +34 -44
- package/skills/dispatching-parallel-agents/SKILL.md +182 -0
- package/skills/executing-plans/SKILL.md +175 -0
- package/skills/finishing-a-development-branch/SKILL.md +200 -0
- package/skills/mcp-builder/SKILL.md +255 -0
- package/skills/quality-assurance/bdd-acceptance/SKILL.md +37 -44
- package/skills/receiving-code-review/SKILL.md +213 -0
- package/skills/requesting-code-review/SKILL.md +105 -0
- package/skills/requesting-code-review/code-reviewer.md +146 -0
- package/skills/requirement-analysis/sdd-full/SKILL.md +36 -717
- package/skills/requirement-analysis/unified-flow/SKILL.md +26 -128
- package/skills/rules/skill-map.md +97 -0
- package/skills/rules/user_rules.md +69 -223
- package/skills/special-tools/env-check/SKILL.md +34 -40
- package/skills/subagent-driven-development/SKILL.md +277 -0
- package/skills/subagent-driven-development/code-quality-reviewer-prompt.md +26 -0
- package/skills/subagent-driven-development/implementer-prompt.md +113 -0
- package/skills/subagent-driven-development/spec-reviewer-prompt.md +61 -0
- package/skills/systematic-debugging/CREATION-LOG.md +119 -0
- package/skills/systematic-debugging/SKILL.md +296 -0
- package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -0
- package/skills/systematic-debugging/condition-based-waiting.md +115 -0
- package/skills/systematic-debugging/defense-in-depth.md +122 -0
- package/skills/systematic-debugging/find-polluter.sh +63 -0
- package/skills/systematic-debugging/root-cause-tracing.md +169 -0
- package/skills/systematic-debugging/test-academic.md +14 -0
- package/skills/systematic-debugging/test-pressure-1.md +58 -0
- package/skills/systematic-debugging/test-pressure-2.md +68 -0
- package/skills/systematic-debugging/test-pressure-3.md +69 -0
- package/skills/test-driven-development/SKILL.md +371 -0
- package/skills/test-driven-development/testing-anti-patterns.md +299 -0
- package/skills/using-git-worktrees/SKILL.md +218 -0
- package/skills/using-superpowers/SKILL.md +134 -0
- package/skills/using-superpowers/references/codex-tools.md +25 -0
- package/skills/using-superpowers/references/gemini-tools.md +33 -0
- package/skills/verification-before-completion/SKILL.md +139 -0
- package/skills/workflow-runner/SKILL.md +172 -0
- package/skills/writing-plans/SKILL.md +152 -0
- package/skills/writing-plans/plan-document-reviewer-prompt.md +49 -0
- package/skills/writing-skills/SKILL.md +654 -0
- package/skills/writing-skills/anthropic-best-practices.md +1149 -0
- package/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +189 -0
- package/skills/writing-skills/graphviz-conventions.dot +172 -0
- package/skills/writing-skills/persuasion-principles.md +187 -0
- package/skills/writing-skills/render-graphs.js +168 -0
- package/skills/writing-skills/testing-skills-with-subagents.md +384 -0
- package/skills/README.md +0 -97
- package/skills/call-adaptation/SKILL.md +0 -23
- package/skills/call-adaptation/call-adaptation-guide.md +0 -136
- package/skills/call-adaptation/claude-code-call-spec.md +0 -50
- package/skills/call-adaptation/trae-call-spec.md +0 -56
- package/skills/checklist.md +0 -154
- package/skills/design-planning/ai-coding-rules/SKILL.md +0 -52
- package/skills/design-planning/design-to-code/SKILL.md +0 -53
- package/skills/design-planning/function-sdd/SKILL.md +0 -54
- package/skills/design-planning/sdd-code/SKILL.md +0 -347
- package/skills/design-planning/sdd-deploy/SKILL.md +0 -501
- package/skills/design-planning/sdd-ops/SKILL.md +0 -306
- package/skills/design-planning/sdd-test/SKILL.md +0 -383
- package/skills/design-planning/ui-sdd/SKILL.md +0 -291
- package/skills/design-planning/writing-plans/SKILL.md +0 -144
- package/skills/development-execution/sdd-add/SKILL.md +0 -540
- package/skills/development-execution/systematic-debugging/SKILL.md +0 -298
- package/skills/development-execution/test-driven-development/SKILL.md +0 -373
- package/skills/development-execution/verification-before-completion/SKILL.md +0 -141
- package/skills/knowledge-precipitation/claudeception/SKILL.md +0 -96
- package/skills/knowledge-precipitation/mempalace-auto-saver/SKILL.md +0 -302
- package/skills/quality-assurance/flutter-test/SKILL.md +0 -56
- package/skills/quality-assurance/quality-gate/SKILL.md +0 -350
- package/skills/quality-assurance/security-audit/SKILL.md +0 -386
- package/skills/release-ops/finishing-a-development-branch/SKILL.md +0 -202
- package/skills/release-ops/release-flow/SKILL.md +0 -404
- package/skills/requirement-analysis/brainstorming/SKILL.md +0 -166
- package/skills/requirement-analysis/competitive-brief/SKILL.md +0 -121
- package/skills/requirement-analysis/market-research/SKILL.md +0 -143
- package/skills/requirement-analysis/prd-write/SKILL.md +0 -111
- package/skills/requirement-analysis/requirement-completion-officer/SKILL.md +0 -124
- package/skills/requirement-analysis/sdd/SKILL.md +0 -1044
- package/skills/rules/project_rules.md +0 -167
- package/skills/sdd-framework/SKILL.md +0 -90
- package/skills/special-tools/receiving-code-review/SKILL.md +0 -215
- package/skills/special-tools/requesting-code-review/SKILL.md +0 -107
- package/skills/special-tools/using-superpowers/SKILL.md +0 -117
- package/skills/templates/API-SDD.md +0 -31
- package/skills/templates/Andrej Karpathy AI/347/274/226/347/240/201/350/247/204/345/210/231/350/220/275/345/234/260SDD.md" +0 -117
- package/skills/templates/BDD/351/243/216/346/240/274/351/252/214/346/224/266/346/240/207/345/207/206SDD.md +0 -147
- package/skills/templates/Base-SDD.md +0 -38
- package/skills/templates/Brain-SDD.md +0 -36
- package/skills/templates/Code-SDD.md +0 -41
- package/skills/templates/Competitor-SDD.md +0 -34
- package/skills/templates/Env-SDD.md +0 -37
- package/skills/templates/Flutter/345/205/250/347/261/273/345/236/213/346/265/213/350/257/225/347/255/226/347/225/245SDD.md +0 -162
- package/skills/templates/Flutter/345/234/260/345/233/276/345/257/274/350/210/252/344/270/232/345/212/241SDD.md +0 -136
- package/skills/templates/Flutter/345/270/270/350/247/201/345/274/202/345/270/270/344/270/223/351/241/271SDD.md +0 -159
- package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md +0 -121
- package/skills/templates/PRD-SDD.md +0 -45
- package/skills/templates/SKILL.md +0 -29
- package/skills/templates/Test-SDD.md +0 -34
- package/skills/templates/UI-SDD.md +0 -38
- package/skills/templates/UI-SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -141
- package/skills/templates/UI/350/265/204/346/272/220/346/217/220/347/244/272/350/257/215/347/224/237/346/210/220SDD.md +0 -67
- package/skills/templates//344/274/201/344/270/232/347/272/247/345/205/250/346/240/210/345/267/245/347/250/213/350/247/204/350/214/203SDD.md +0 -152
- package/skills/templates//345/212/237/350/203/275SDD/344/270/223/347/224/250/346/250/241/346/235/277.md +0 -132
- package/skills/templates//347/216/257/345/242/203/351/242/204/346/243/200/346/240/207/345/207/206/345/214/226SDD.md +0 -153
- package/skills/templates//351/253/230/344/277/235/347/234/237/350/256/276/350/256/241/350/275/254/344/273/243/347/240/201SDD.md +0 -119
- package/skills//345/256/214/346/225/264/345/274/200/345/217/221/346/265/201/347/250/213/346/211/213/345/206/214.md +0 -408
- package/skills//346/212/200/350/203/275/344/275/223/347/263/273/345/256/214/345/226/204/345/273/272/350/256/256.md +0 -305
- package/skills//346/212/200/350/203/275/344/275/277/347/224/250/346/214/207/345/215/227.md +0 -265
- package/skills//346/212/200/350/203/275/345/206/263/347/255/226/346/240/221.md +0 -294
|
@@ -1,136 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:Flutter地图导航业务SDD】【trae调用标识:Flutter地图导航业务SDD+地图集成】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
|
|
2
|
-
|
|
3
|
-
# Flutter地图导航业务SDD:[项目名称]
|
|
4
|
-
|
|
5
|
-
## 一、SDK集成
|
|
6
|
-
|
|
7
|
-
### 1.1 版本锁定
|
|
8
|
-
| SDK | 版本号 | 锁定状态 |
|
|
9
|
-
|------|------|---------|
|
|
10
|
-
| 高德地图Flutter SDK | 【10.0.0】 | 【已锁定】 |
|
|
11
|
-
| amap_flutter_map | 【3.0.0】 | 【已锁定】 |
|
|
12
|
-
| amap_flutter_location | 【3.0.0】 | 【已锁定】 |
|
|
13
|
-
|
|
14
|
-
### 1.2 依赖配置
|
|
15
|
-
```yaml
|
|
16
|
-
dependencies:
|
|
17
|
-
amap_flutter_map: ^3.0.0
|
|
18
|
-
amap_flutter_location: ^3.0.0
|
|
19
|
-
amap_flutter_base: ^3.0.0
|
|
20
|
-
```
|
|
21
|
-
|
|
22
|
-
### 1.3 初始化时机
|
|
23
|
-
- [ ] 应用启动时全局初始化一次
|
|
24
|
-
- [ ] 禁止在页面中重复初始化
|
|
25
|
-
- [ ] 初始化完成后缓存实例
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
29
|
-
## 二、核心功能
|
|
30
|
-
|
|
31
|
-
### 2.1 地图显示
|
|
32
|
-
| 功能 | 实现方式 | 验收标准 |
|
|
33
|
-
|------|---------|---------|
|
|
34
|
-
| 地图加载 | MapWidget | 地图正常显示 |
|
|
35
|
-
| 地图类型切换 | mapType | 支持普通/卫星/夜间模式 |
|
|
36
|
-
| 缩放控制 | zoomControls | 支持手势缩放 |
|
|
37
|
-
| 拖动控制 | gestureRecognizers | 支持手势拖动 |
|
|
38
|
-
|
|
39
|
-
### 2.2 定位服务
|
|
40
|
-
| 功能 | 实现方式 | 验收标准 |
|
|
41
|
-
|------|---------|---------|
|
|
42
|
-
| 首次定位 | LocationPlugin | 进入页面自动定位并居中 |
|
|
43
|
-
| 持续定位 | startLocation | 实时更新位置 |
|
|
44
|
-
| 定位权限 | PermissionHandler | 权限申请流程完整 |
|
|
45
|
-
|
|
46
|
-
### 2.3 导航功能
|
|
47
|
-
| 功能 | 实现方式 | 验收标准 |
|
|
48
|
-
|------|---------|---------|
|
|
49
|
-
| 路径规划 | AMapNavi | 支持驾车/步行/骑行 |
|
|
50
|
-
| 导航指引 | NaviWidget | 语音+视觉指引 |
|
|
51
|
-
| 实时路况 | TrafficInfo | 显示实时交通状况 |
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
55
|
-
## 三、Marker处理
|
|
56
|
-
|
|
57
|
-
### 3.1 Marker创建
|
|
58
|
-
| 属性 | 说明 | 示例值 |
|
|
59
|
-
|------|------|------|
|
|
60
|
-
| position | 经纬度 | LatLng(39.908860, 116.397390) |
|
|
61
|
-
| icon | 自定义图标 | BitmapDescriptor.fromAsset() |
|
|
62
|
-
| anchor | 锚点位置 | Offset(0.5, 1.0) |
|
|
63
|
-
| infoWindow | 信息窗口 | InfoWindow(title, snippet) |
|
|
64
|
-
|
|
65
|
-
### 3.2 警告处理
|
|
66
|
-
| 警告类型 | 处理方式 | 代码示例 |
|
|
67
|
-
|----------|---------|---------|
|
|
68
|
-
| 重复添加 | 先remove再add | marker.remove() |
|
|
69
|
-
| 内存泄漏 | dispose时清理 | dispose()中调用clearMarkers() |
|
|
70
|
-
| 图标加载失败 | 备用图标 | fallback icon |
|
|
71
|
-
|
|
72
|
-
### 3.3 自定义样式
|
|
73
|
-
| 样式类型 | 实现方式 | 适用场景 |
|
|
74
|
-
|---------|---------|---------|
|
|
75
|
-
| 自定义图标 | BitmapDescriptor | 不同类型Marker |
|
|
76
|
-
| 动画效果 | AnimationController | 选中/高亮效果 |
|
|
77
|
-
| 聚合显示 | ClusterManager | 大量Marker |
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
81
|
-
## 四、常见问题
|
|
82
|
-
|
|
83
|
-
### 4.1 地图不显示
|
|
84
|
-
| 排查步骤 | 检查内容 | 解决方案 |
|
|
85
|
-
|---------|---------|---------|
|
|
86
|
-
| 1 | API Key是否正确 | 检查key配置 |
|
|
87
|
-
| 2 | 权限是否开启 | 检查Info.plist/AndroidManifest |
|
|
88
|
-
| 3 | 网络是否正常 | 检查网络连接 |
|
|
89
|
-
| 4 | 依赖是否正确 | 检查pubspec配置 |
|
|
90
|
-
|
|
91
|
-
### 4.2 定位失败
|
|
92
|
-
| 排查步骤 | 检查内容 | 解决方案 |
|
|
93
|
-
|---------|---------|---------|
|
|
94
|
-
| 1 | 定位权限是否获取 | 请求定位权限 |
|
|
95
|
-
| 2 | 定位服务是否开启 | 提示用户开启 |
|
|
96
|
-
| 3 | 网络定位是否可用 | 切换网络 |
|
|
97
|
-
| 4 | GPS是否开启 | 提示用户开启 |
|
|
98
|
-
|
|
99
|
-
### 4.3 导航异常
|
|
100
|
-
| 排查步骤 | 检查内容 | 解决方案 |
|
|
101
|
-
|---------|---------|---------|
|
|
102
|
-
| 1 | 起点终点是否有效 | 校验坐标 |
|
|
103
|
-
| 2 | 路径规划是否成功 | 检查API返回 |
|
|
104
|
-
| 3 | 导航组件是否初始化 | 检查初始化流程 |
|
|
105
|
-
| 4 | 语音播报是否正常 | 检查权限和配置 |
|
|
106
|
-
|
|
107
|
-
---
|
|
108
|
-
|
|
109
|
-
## 五、验收标准
|
|
110
|
-
|
|
111
|
-
### 5.1 功能验证
|
|
112
|
-
- [ ] 地图正常加载显示
|
|
113
|
-
- [ ] 首次定位自动居中
|
|
114
|
-
- [ ] 手动拖动不自动回弹
|
|
115
|
-
- [ ] Marker点击显示信息窗口
|
|
116
|
-
- [ ] 导航路径规划正确
|
|
117
|
-
|
|
118
|
-
### 5.2 性能指标
|
|
119
|
-
- [ ] 地图加载时间 ≤ 2秒
|
|
120
|
-
- [ ] 定位响应时间 ≤ 1秒
|
|
121
|
-
- [ ] 内存占用正常(无泄漏)
|
|
122
|
-
- [ ] 动画流畅(60fps)
|
|
123
|
-
|
|
124
|
-
### 5.3 稳定性测试
|
|
125
|
-
- [ ] 连续运行24小时无崩溃
|
|
126
|
-
- [ ] 切换后台/前台正常
|
|
127
|
-
- [ ] 网络切换后自动恢复
|
|
128
|
-
- [ ] 低内存环境正常运行
|
|
129
|
-
|
|
130
|
-
---
|
|
131
|
-
|
|
132
|
-
## 六、trae调用参数说明
|
|
133
|
-
- **调用路径**: skills/templates/Flutter地图导航业务SDD.md
|
|
134
|
-
- **必传参数**: 项目名称
|
|
135
|
-
- **可选参数**: SDK版本、功能范围
|
|
136
|
-
- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代
|
|
@@ -1,159 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:Flutter常见异常专项SDD】【trae调用标识:Flutter常见异常专项SDD+异常处理】【流程场景:4.Bug处理】
|
|
2
|
-
|
|
3
|
-
# Flutter常见异常专项SDD:[项目名称]
|
|
4
|
-
|
|
5
|
-
## 一、SocketException异常
|
|
6
|
-
|
|
7
|
-
### 1.1 异常描述
|
|
8
|
-
| 属性 | 说明 |
|
|
9
|
-
|------|------|
|
|
10
|
-
| 异常类型 | SocketException |
|
|
11
|
-
| 错误码 | 通常为OS错误码 |
|
|
12
|
-
| 常见原因 | 网络不可用、连接被拒绝、超时 |
|
|
13
|
-
|
|
14
|
-
### 1.2 排查流程
|
|
15
|
-
| 步骤 | 检查内容 | 验证方法 |
|
|
16
|
-
|------|---------|---------|
|
|
17
|
-
| 1 | 网络连接 | ping baidu.com |
|
|
18
|
-
| 2 | 服务器状态 | 检查API是否可访问 |
|
|
19
|
-
| 3 | 端口开放 | telnet host port |
|
|
20
|
-
| 4 | 代理配置 | 检查系统代理设置 |
|
|
21
|
-
|
|
22
|
-
### 1.3 修复方案
|
|
23
|
-
```dart
|
|
24
|
-
try {
|
|
25
|
-
final response = await http.get(Uri.parse(url));
|
|
26
|
-
} on SocketException catch (e) {
|
|
27
|
-
// 网络异常处理
|
|
28
|
-
showError('网络连接失败,请检查网络设置');
|
|
29
|
-
}
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
### 1.4 预防措施
|
|
33
|
-
- [ ] 添加网络状态监听
|
|
34
|
-
- [ ] 实现重试机制
|
|
35
|
-
- [ ] 添加超时配置
|
|
36
|
-
- [ ] 提供离线模式
|
|
37
|
-
|
|
38
|
-
---
|
|
39
|
-
|
|
40
|
-
## 二、Framebuffer渲染异常
|
|
41
|
-
|
|
42
|
-
### 2.1 异常描述
|
|
43
|
-
| 属性 | 说明 |
|
|
44
|
-
|------|------|
|
|
45
|
-
| 异常类型 | FlutterError |
|
|
46
|
-
| 错误码 | 渲染相关错误 |
|
|
47
|
-
| 常见原因 | Widget树不一致、布局溢出、资源缺失 |
|
|
48
|
-
|
|
49
|
-
### 2.2 排查流程
|
|
50
|
-
| 步骤 | 检查内容 | 验证方法 |
|
|
51
|
-
|------|---------|---------|
|
|
52
|
-
| 1 | Widget树 | 检查build方法返回 |
|
|
53
|
-
| 2 | 布局约束 | 检查Container/SizedBox约束 |
|
|
54
|
-
| 3 | 资源文件 | 检查图片/字体是否存在 |
|
|
55
|
-
| 4 | 日志分析 | 查看Flutter控制台 |
|
|
56
|
-
|
|
57
|
-
### 2.3 修复方案
|
|
58
|
-
```dart
|
|
59
|
-
// 确保Widget树一致性
|
|
60
|
-
@override
|
|
61
|
-
Widget build(BuildContext context) {
|
|
62
|
-
if (data == null) {
|
|
63
|
-
return CircularProgressIndicator();
|
|
64
|
-
}
|
|
65
|
-
return Text(data!.text);
|
|
66
|
-
}
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### 2.4 预防措施
|
|
70
|
-
- [ ] 使用const构造函数
|
|
71
|
-
- [ ] 添加null安全检查
|
|
72
|
-
- [ ] 使用LayoutBuilder处理约束
|
|
73
|
-
- [ ] 启用debug模式检查
|
|
74
|
-
|
|
75
|
-
---
|
|
76
|
-
|
|
77
|
-
## 三、其他常见异常
|
|
78
|
-
|
|
79
|
-
### 3.1 空指针异常(NullPointerException)
|
|
80
|
-
| 排查 | 修复 |
|
|
81
|
-
|------|------|
|
|
82
|
-
| 检查变量是否为null | 使用?.或??运算符 |
|
|
83
|
-
| 检查函数返回值 | 添加null检查 |
|
|
84
|
-
|
|
85
|
-
### 3.2 类型转换异常(TypeError)
|
|
86
|
-
| 排查 | 修复 |
|
|
87
|
-
|------|------|
|
|
88
|
-
| 检查类型转换位置 | 使用as进行安全转换 |
|
|
89
|
-
| 检查泛型使用 | 指定正确的泛型类型 |
|
|
90
|
-
|
|
91
|
-
### 3.3 内存泄漏(Memory Leak)
|
|
92
|
-
| 排查 | 修复 |
|
|
93
|
-
|------|------|
|
|
94
|
-
| 使用DevTools分析 | 及时dispose资源 |
|
|
95
|
-
| 检查Stream订阅 | 取消不必要的订阅 |
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
99
|
-
## 四、异常处理框架
|
|
100
|
-
|
|
101
|
-
### 4.1 全局异常捕获
|
|
102
|
-
```dart
|
|
103
|
-
void main() {
|
|
104
|
-
FlutterError.onError = (details) {
|
|
105
|
-
FlutterError.presentError(details);
|
|
106
|
-
// 上报到日志系统
|
|
107
|
-
logError(details.exception, details.stack);
|
|
108
|
-
};
|
|
109
|
-
|
|
110
|
-
runApp(MyApp());
|
|
111
|
-
}
|
|
112
|
-
```
|
|
113
|
-
|
|
114
|
-
### 4.2 Zone异常捕获
|
|
115
|
-
```dart
|
|
116
|
-
runZonedGuarded(() {
|
|
117
|
-
runApp(MyApp());
|
|
118
|
-
}, (error, stackTrace) {
|
|
119
|
-
// 处理异步异常
|
|
120
|
-
logError(error, stackTrace);
|
|
121
|
-
});
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
### 4.3 Error Widget
|
|
125
|
-
```dart
|
|
126
|
-
ErrorWidget.builder = (FlutterErrorDetails details) {
|
|
127
|
-
return MaterialApp(
|
|
128
|
-
home: Scaffold(
|
|
129
|
-
body: Center(
|
|
130
|
-
child: Text('发生错误: ${details.exception}'),
|
|
131
|
-
),
|
|
132
|
-
),
|
|
133
|
-
);
|
|
134
|
-
};
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
---
|
|
138
|
-
|
|
139
|
-
## 五、验收标准
|
|
140
|
-
|
|
141
|
-
### 5.1 异常处理验证
|
|
142
|
-
- [ ] SocketException有捕获和提示
|
|
143
|
-
- [ ] Framebuffer异常有防护
|
|
144
|
-
- [ ] 全局异常处理已配置
|
|
145
|
-
- [ ] 错误日志已上报
|
|
146
|
-
|
|
147
|
-
### 5.2 稳定性测试
|
|
148
|
-
- [ ] 网络断开后恢复正常
|
|
149
|
-
- [ ] Widget树异常不导致崩溃
|
|
150
|
-
- [ ] 内存泄漏检测通过
|
|
151
|
-
- [ ] 长时间运行无异常
|
|
152
|
-
|
|
153
|
-
---
|
|
154
|
-
|
|
155
|
-
## 六、trae调用参数说明
|
|
156
|
-
- **调用路径**: skills/templates/Flutter常见异常专项SDD.md
|
|
157
|
-
- **必传参数**: 项目名称
|
|
158
|
-
- **可选参数**: 异常类型(SocketException/Framebuffer/其他)
|
|
159
|
-
- **流程场景**: 4.Bug处理
|
package/skills/templates/Flutter/351/237/263/350/247/206/351/242/221/345/205/250/346/240/210SDD.md
DELETED
|
@@ -1,121 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:Flutter音视频全栈SDD】【trae调用标识:Flutter音视频全栈SDD+音视频集成】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代】
|
|
2
|
-
|
|
3
|
-
# Flutter音视频全栈SDD:[项目名称]
|
|
4
|
-
|
|
5
|
-
## 一、离线ASR语音转写
|
|
6
|
-
|
|
7
|
-
### 1.1 SDK集成
|
|
8
|
-
| SDK | 版本 | 配置方式 |
|
|
9
|
-
|------|------|---------|
|
|
10
|
-
| speech_to_text | ^6.0.0 | pubspec依赖 |
|
|
11
|
-
| pocketsphinx | ^0.10.0 | 离线模型 |
|
|
12
|
-
|
|
13
|
-
### 1.2 配置说明
|
|
14
|
-
```yaml
|
|
15
|
-
dependencies:
|
|
16
|
-
speech_to_text: ^6.0.0
|
|
17
|
-
pocketsphinx: ^0.10.0
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
### 1.3 核心功能
|
|
21
|
-
| 功能 | 说明 | 验收标准 |
|
|
22
|
-
|------|------|---------|
|
|
23
|
-
| 语音录制 | 麦克风采集 | 支持多种采样率 |
|
|
24
|
-
| 语音识别 | 离线识别引擎 | 准确率≥90% |
|
|
25
|
-
| 实时转写 | 边录边识别 | 延迟≤500ms |
|
|
26
|
-
| 语言选择 | 多语言支持 | 中文/英文 |
|
|
27
|
-
|
|
28
|
-
### 1.4 权限配置
|
|
29
|
-
| 平台 | 权限 | 配置位置 |
|
|
30
|
-
|------|------|---------|
|
|
31
|
-
| iOS | NSMicrophoneUsageDescription | Info.plist |
|
|
32
|
-
| Android | RECORD_AUDIO | AndroidManifest.xml |
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
36
|
-
## 二、TTS语音合成
|
|
37
|
-
|
|
38
|
-
### 2.1 SDK集成
|
|
39
|
-
| SDK | 版本 | 配置方式 |
|
|
40
|
-
|------|------|---------|
|
|
41
|
-
| flutter_tts | ^3.0.0 | pubspec依赖 |
|
|
42
|
-
|
|
43
|
-
### 2.2 配置说明
|
|
44
|
-
```yaml
|
|
45
|
-
dependencies:
|
|
46
|
-
flutter_tts: ^3.0.0
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
### 2.3 核心功能
|
|
50
|
-
| 功能 | 说明 | 验收标准 |
|
|
51
|
-
|------|------|---------|
|
|
52
|
-
| 文本转语音 | TTS引擎 | 发音清晰 |
|
|
53
|
-
| 语速调节 | 0.5-2.0倍 | 可调节 |
|
|
54
|
-
| 音量调节 | 0-1.0 | 可调节 |
|
|
55
|
-
| 音色选择 | 多种声音 | 支持切换 |
|
|
56
|
-
|
|
57
|
-
### 2.4 平台差异
|
|
58
|
-
| 平台 | 引擎 | 特性 |
|
|
59
|
-
|------|------|------|
|
|
60
|
-
| iOS | AVSpeechSynthesizer | 自然语音 |
|
|
61
|
-
| Android | TextToSpeech | 多语言支持 |
|
|
62
|
-
|
|
63
|
-
---
|
|
64
|
-
|
|
65
|
-
## 三、OCR文字识别
|
|
66
|
-
|
|
67
|
-
### 3.1 SDK集成
|
|
68
|
-
| SDK | 版本 | 配置方式 |
|
|
69
|
-
|------|------|---------|
|
|
70
|
-
| google_mlkit_text_recognition | ^0.10.0 | pubspec依赖 |
|
|
71
|
-
| tflite | ^1.1.2 | 离线模型 |
|
|
72
|
-
|
|
73
|
-
### 3.2 配置说明
|
|
74
|
-
```yaml
|
|
75
|
-
dependencies:
|
|
76
|
-
google_mlkit_text_recognition: ^0.10.0
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
### 3.3 核心功能
|
|
80
|
-
| 功能 | 说明 | 验收标准 |
|
|
81
|
-
|------|------|---------|
|
|
82
|
-
| 图片识别 | 从图片提取文字 | 准确率≥95% |
|
|
83
|
-
| 实时识别 | 摄像头实时识别 | 帧率≥15fps |
|
|
84
|
-
| 多行识别 | 支持多行文本 | 自动换行 |
|
|
85
|
-
| 语言支持 | 多语言识别 | 中文/英文/数字 |
|
|
86
|
-
|
|
87
|
-
### 3.4 权限配置
|
|
88
|
-
| 平台 | 权限 | 配置位置 |
|
|
89
|
-
|------|------|---------|
|
|
90
|
-
| iOS | NSCameraUsageDescription | Info.plist |
|
|
91
|
-
| Android | CAMERA | AndroidManifest.xml |
|
|
92
|
-
|
|
93
|
-
---
|
|
94
|
-
|
|
95
|
-
## 四、验收标准
|
|
96
|
-
|
|
97
|
-
### 4.1 ASR验收
|
|
98
|
-
- [ ] 语音录制正常
|
|
99
|
-
- [ ] 离线识别准确率≥90%
|
|
100
|
-
- [ ] 实时转写延迟≤500ms
|
|
101
|
-
- [ ] 静音检测正常
|
|
102
|
-
|
|
103
|
-
### 4.2 TTS验收
|
|
104
|
-
- [ ] 语音合成清晰
|
|
105
|
-
- [ ] 语速调节正常
|
|
106
|
-
- [ ] 音量调节正常
|
|
107
|
-
- [ ] 暂停/继续正常
|
|
108
|
-
|
|
109
|
-
### 4.3 OCR验收
|
|
110
|
-
- [ ] 图片识别准确率≥95%
|
|
111
|
-
- [ ] 实时识别帧率≥15fps
|
|
112
|
-
- [ ] 多行识别正确
|
|
113
|
-
- [ ] 倾斜文本识别正常
|
|
114
|
-
|
|
115
|
-
---
|
|
116
|
-
|
|
117
|
-
## 五、trae调用参数说明
|
|
118
|
-
- **调用路径**: skills/templates/Flutter音视频全栈SDD.md
|
|
119
|
-
- **必传参数**: 项目名称
|
|
120
|
-
- **可选参数**: 功能模块(ASR/TTS/OCR)
|
|
121
|
-
- **流程场景**: 1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代
|
|
@@ -1,45 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:PRD-SDD】【trae调用标识:PRD-SDD+prd-write/requirement-completion-officer】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目】
|
|
2
|
-
|
|
3
|
-
# PRD-SDD:[项目名称]产品需求文档(skill选项式设计)
|
|
4
|
-
|
|
5
|
-
## 一、需求背景(skill可选项,支持多选/自定义补充)
|
|
6
|
-
- 选项1:需求来源 → 选项:用户反馈/市场需求/业务规划 → 自定义来源:__________
|
|
7
|
-
- 选项2:需求目的 → 选项:提升用户体验/完善功能闭环/解决核心痛点 → 自定义目的:__________
|
|
8
|
-
- 选项3:需求优先级 → 选项:P0(核心)/P1(重要)/P2(一般) → 自定义优先级:__________
|
|
9
|
-
|
|
10
|
-
## 二、用户角色定义(skill可选项,支持多选/自定义补充)
|
|
11
|
-
- 选项1:核心用户 → 选项:普通用户/管理员/运营人员 → 自定义用户:__________
|
|
12
|
-
- 选项2:用户特征 → 选项:年轻用户(18-25岁)/职场用户(25-35岁) → 自定义特征:__________
|
|
13
|
-
- 选项3:用户需求 → 选项:便捷操作/功能全面/性能稳定 → 自定义需求:__________
|
|
14
|
-
|
|
15
|
-
## 三、用户旅程梳理(skill可选项,支持多选/自定义补充)
|
|
16
|
-
- 选项1:用户场景 → 选项:首次使用/日常使用/异常场景 → 自定义场景:__________
|
|
17
|
-
- 选项2:旅程步骤 → 选项:进入页面→操作功能→完成目标→退出页面 → 自定义步骤:__________
|
|
18
|
-
- 选项3:痛点梳理 → 选项:操作繁琐/等待时间长/功能不清晰 → 自定义痛点:__________
|
|
19
|
-
|
|
20
|
-
## 四、功能范围界定(skill可选项,支持多选/自定义补充)
|
|
21
|
-
- 选项1:必做功能 → 选项:核心功能1/核心功能2 → 自定义必做功能:__________
|
|
22
|
-
- 选项2:可选功能 → 选项:拓展功能1/拓展功能2 → 自定义可选功能:__________
|
|
23
|
-
- 选项3:不做功能 → 选项:非核心功能/场景需求低的功能 → 自定义不做功能:__________
|
|
24
|
-
|
|
25
|
-
## 五、需求补全清单(skill可选项,支持多选/自定义补充)
|
|
26
|
-
- 选项1:补全类型 → 选项:场景补全/逻辑补全/异常处理补全 → 自定义补全类型:__________
|
|
27
|
-
- 选项2:补全内容 → 选项:补充XX场景的操作流程/完善XX逻辑的异常处理 → 自定义补全内容:__________
|
|
28
|
-
|
|
29
|
-
## 六、主干流程(skill可选项,支持多选/自定义补充)
|
|
30
|
-
- 选项1:流程类型 → 选项:正常流程/异常流程/分支流程 → 自定义流程类型:__________
|
|
31
|
-
- 选项2:流程步骤 → 选项:步骤1→步骤2→步骤3→完成 → 自定义步骤:__________
|
|
32
|
-
|
|
33
|
-
## 七、架构&模块拆分(附录)(skill可选项,支持多选/自定义补充)
|
|
34
|
-
- 选项1:架构类型 → 选项:前后端分离架构/单体架构 → 自定义架构:__________
|
|
35
|
-
- 选项2:模块拆分 → 选项:用户模块/功能模块/数据模块 → 自定义模块:__________
|
|
36
|
-
|
|
37
|
-
## 八、验收标准(skill可选项,支持多选/自定义补充)
|
|
38
|
-
- 选项1:功能验收 → 选项:功能正常运行/符合需求描述 → 自定义验收:__________
|
|
39
|
-
- 选项2:体验验收 → 选项:交互流畅/操作便捷 → 自定义验收:__________
|
|
40
|
-
- 选项3:性能验收 → 选项:响应时间≤1s/无卡顿 → 自定义验收:__________
|
|
41
|
-
|
|
42
|
-
## trae调用参数说明(仅trae触发时使用)
|
|
43
|
-
- 调用路径:skills/templates/PRD-SDD.md
|
|
44
|
-
- 必传参数:项目名称、需求优先级、核心用户
|
|
45
|
-
- 可选参数:功能范围、验收标准补充内容
|
|
@@ -1,29 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:templates】【trae调用标识:templates+SDD模板库】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目、3.小型功能迭代、4.Bug处理、5.代码发布】
|
|
2
|
-
|
|
3
|
-
---
|
|
4
|
-
name: templates
|
|
5
|
-
description: SDD模板库 - 包含9种标准化SDD模板,支持双调用机制,按流程场景分类
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# SDD模板库
|
|
9
|
-
|
|
10
|
-
## 功能说明
|
|
11
|
-
本技能提供9种标准化SDD模板,支持Trae与Claude Code双调用机制:
|
|
12
|
-
|
|
13
|
-
## 模板列表
|
|
14
|
-
| 模板名称 | 简称 | 适配场景 |
|
|
15
|
-
|---------|------|---------|
|
|
16
|
-
| Base-SDD.md | Base | 全局通用基线 |
|
|
17
|
-
| Brain-SDD.md | Brain | 头脑风暴 |
|
|
18
|
-
| Competitor-SDD.md | Competitor | 竞品分析 |
|
|
19
|
-
| PRD-SDD.md | PRD | 产品需求 |
|
|
20
|
-
| UI-SDD.md | UI | UI设计 |
|
|
21
|
-
| Code-SDD.md | Code | 代码实现 |
|
|
22
|
-
| API-SDD.md | API | 接口设计 |
|
|
23
|
-
| Env-SDD.md | Env | 环境配置 |
|
|
24
|
-
| Test-SDD.md | Test | 测试设计 |
|
|
25
|
-
| UI资源提示词生成SDD.md | UI提示词 | UI资源生成 |
|
|
26
|
-
|
|
27
|
-
## 调用方式
|
|
28
|
-
- **Claude Code**: 调用 模板名称(如:调用 Brain-SDD)
|
|
29
|
-
- **Trae**: trae调用 模板名称 或 trae快捷 简称
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:Test-SDD】【trae调用标识:Test-SDD+sdd-test】【流程场景:1.完整3阶段SDD流程、3.小型功能迭代、4.Bug处理】
|
|
2
|
-
|
|
3
|
-
# Test-SDD:[测试模块名称](skill选项式设计)
|
|
4
|
-
|
|
5
|
-
## 一、测试策略(skill可选项,支持多选/自定义补充)
|
|
6
|
-
- 选项1:测试类型 → 选项:单元测试/集成测试/E2E测试/性能测试/安全测试 → 自定义类型:__________
|
|
7
|
-
- 选项2:测试范围 → 选项:全部模块/核心模块/新增功能 → 自定义范围:__________
|
|
8
|
-
- 选项3:测试环境 → 选项:测试环境/预发环境/生产环境(灰度) → 自定义环境:__________
|
|
9
|
-
|
|
10
|
-
## 二、测试用例(skill可选项,支持多选/自定义补充)
|
|
11
|
-
- 选项1:用例类型 → 选项:正常流程用例/异常流程用例/边界条件用例 → 自定义类型:__________
|
|
12
|
-
- 选项2:用例内容 → 选项:测试场景:__________ / 预期结果:__________ → 自定义内容:__________
|
|
13
|
-
|
|
14
|
-
## 三、测试数据(skill可选项,支持多选/自定义补充)
|
|
15
|
-
- 选项1:数据类型 → 选项:正常数据/边界数据/异常数据 → 自定义类型:__________
|
|
16
|
-
- 选项2:数据来源 → 选项:Mock数据/真实数据/测试数据生成器 → 自定义来源:__________
|
|
17
|
-
|
|
18
|
-
## 四、测试覆盖率目标(skill可选项,支持多选/自定义补充)
|
|
19
|
-
- 选项1:单元测试覆盖率 → 选项:≥80%/≥90%/≥95% → 自定义覆盖率:__________
|
|
20
|
-
- 选项2:集成测试覆盖率 → 选项:≥70%/≥80%/≥85% → 自定义覆盖率:__________
|
|
21
|
-
|
|
22
|
-
## 五、性能测试指标(skill可选项,支持多选/自定义补充)
|
|
23
|
-
- 选项1:响应时间 → 选项:≤100ms/≤500ms/≤1s → 自定义时间:__________
|
|
24
|
-
- 选项2:并发数 → 选项:100/1000/10000 → 自定义并发:__________
|
|
25
|
-
- 选项3:成功率 → 选项:≥99%/≥99.9%/≥99.99% → 自定义成功率:__________
|
|
26
|
-
|
|
27
|
-
## 六、安全测试要点(skill可选项,支持多选/自定义补充)
|
|
28
|
-
- 选项1:测试项 → 选项:SQL注入/XSS攻击/CSRF攻击/接口越权 → 自定义测试项:__________
|
|
29
|
-
- 选项2:测试工具 → 选项:OWASP ZAP/Nessus/Burp Suite → 自定义工具:__________
|
|
30
|
-
|
|
31
|
-
## trae调用参数说明(仅trae触发时使用)
|
|
32
|
-
- 调用路径:skills/templates/Test-SDD.md
|
|
33
|
-
- 必传参数:测试模块名称、测试类型、测试范围
|
|
34
|
-
- 可选参数:测试用例、测试数据补充内容
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
【claude code调用标识:UI-SDD】【trae调用标识:UI-SDD+ui-sdd】【流程场景:1.完整3阶段SDD流程、2.从零开始新项目】
|
|
2
|
-
|
|
3
|
-
# UI-SDD:[页面/组件名称](skill选项式设计)
|
|
4
|
-
|
|
5
|
-
## 一、页面/组件概述(skill可选项,支持多选/自定义补充)
|
|
6
|
-
- 选项1:页面/组件类型 → 选项:首页/详情页/按钮组件/弹窗组件 → 自定义类型:__________
|
|
7
|
-
- 选项2:核心用途 → 选项:展示内容/接收操作/提示信息 → 自定义用途:__________
|
|
8
|
-
- 选项3:所属模块 → 选项:用户模块/功能模块/公共模块 → 自定义模块:__________
|
|
9
|
-
|
|
10
|
-
## 二、Figma链接(skill可选项,支持多选/自定义补充)
|
|
11
|
-
- 选项1:完整设计稿链接 → 选项:填写Figma链接/填写备用导出文件链接 → 自定义链接:__________
|
|
12
|
-
- 选项2:关键截图 → 选项:上传截图/填写截图路径 → 自定义截图:__________
|
|
13
|
-
- 选项3:备用方案(链接失效时) → 选项:上传PDF标注文件/上传PNG标注文件 → 自定义备用方案:__________
|
|
14
|
-
|
|
15
|
-
## 三、页面结构(skill可选项,支持多选/自定义补充)
|
|
16
|
-
- 选项1:结构类型 → 选项:上下布局/左右布局/混合布局 → 自定义结构:__________
|
|
17
|
-
- 选项2:核心模块 → 选项:头部导航/内容区域/底部信息 → 自定义模块:__________
|
|
18
|
-
|
|
19
|
-
## 四、组件清单(skill可选项,支持多选/自定义补充)
|
|
20
|
-
- 选项1:组件类型 → 选项:基础组件(按钮/输入框)/业务组件(表单/列表) → 自定义组件:__________
|
|
21
|
-
- 选项2:组件数量 → 选项:≤5个/5-10个/>10个 → 自定义数量:__________
|
|
22
|
-
|
|
23
|
-
## 五、交互流程(skill可选项,支持多选/自定义补充)
|
|
24
|
-
- 选项1:交互类型 → 选项:点击交互/滑动交互/hover交互 → 自定义交互:__________
|
|
25
|
-
- 选项2:交互反馈 → 选项:弹窗提示/状态变化/跳转页面 → 自定义反馈:__________
|
|
26
|
-
|
|
27
|
-
## 六、状态设计(skill可选项,支持多选/自定义补充)
|
|
28
|
-
- 选项1:组件状态 → 选项:正常状态/ hover状态/禁用状态/选中状态 → 自定义状态:__________
|
|
29
|
-
- 选项2:页面状态 → 选项:正常状态/加载状态/空状态/异常状态 → 自定义状态:__________
|
|
30
|
-
|
|
31
|
-
## 七、设计规范(对齐Base-SDD)(skill可选项,支持多选/自定义补充)
|
|
32
|
-
- 选项1:对齐规范 → 选项:对齐Base-SDD颜色规范/对齐Base-SDD字体规范 → 自定义对齐:__________
|
|
33
|
-
- 选项2:偏差说明 → 选项:无偏差/有偏差(说明:__________) → 自定义说明:__________
|
|
34
|
-
|
|
35
|
-
## trae调用参数说明(仅trae触发时使用)
|
|
36
|
-
- 调用路径:skills/templates/UI-SDD.md
|
|
37
|
-
- 必传参数:页面/组件名称、所属模块、Figma链接(或备用文件路径)
|
|
38
|
-
- 可选参数:组件清单、交互流程补充内容
|