sdd-full 4.6.0 → 4.6.1

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 CHANGED
@@ -6,7 +6,7 @@ const fs = require('fs');
6
6
  const path = require('path');
7
7
 
8
8
  const SDD = {
9
- version: '4.6.0',
9
+ version: '4.6.1',
10
10
  name: 'sdd-full',
11
11
  description: '完整的软件设计开发技能包'
12
12
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdd-full",
3
- "version": "4.6.0",
3
+ "version": "4.6.1",
4
4
  "description": "SDD Full - 完整的软件设计开发技能包",
5
5
  "main": "index.js",
6
6
  "bin": "./bin.js",
package/skills/README.md CHANGED
@@ -72,6 +72,7 @@
72
72
  - using-superpowers - Superpowers全流程
73
73
  - requesting-code-review - 请求代码审查
74
74
  - receiving-code-review - 接收代码审查
75
+ - ios-full-auto-debug - iOS真机全自动化调试
75
76
 
76
77
  ## 快速安装
77
78
  ### 使用npm包安装(推荐)
@@ -92,7 +92,7 @@
92
92
  | quality-assurance/ | quality-gate, security-audit | [ ] |
93
93
  | release-ops/ | finishing-a-development-branch, release-flow | [ ] |
94
94
  | knowledge-precipitation/ | claudeception, mempalace-auto-saver | [ ] |
95
- | special-tools/ | using-superpowers, requesting-code-review, receiving-code-review | [ ] |
95
+ | special-tools/ | using-superpowers, requesting-code-review, receiving-code-review, ios-full-auto-debug | [ ] |
96
96
 
97
97
  ### 3.3 按需加载配置检查
98
98
 
@@ -121,10 +121,43 @@ description: "SDD全流程开发 - 提供5个流程选项:完整3阶段流程
121
121
 
122
122
  ## 4. Bug处理
123
123
 
124
+ 请选择您要处理的Bug类型:
125
+
126
+ ```
127
+ 1. 简单Bug修复 - 已知原因的小Bug,直接修复
128
+ 2. 复杂Bug系统调试 - 原因不明的Bug,需要系统化调试
129
+ 3. 性能问题修复 - 性能相关的Bug
130
+ 4. 安全漏洞修复 - 安全相关的Bug
131
+ 5. 回归Bug修复 - 回归测试发现的Bug,需补充回归用例
132
+ 6. 特定平台语言Bug修复 - Flutter/iOS真机调试等平台相关Bug
133
+ ```
134
+
135
+ ---
136
+
137
+ ### 4.1 简单Bug修复
138
+
139
+ > 适用场景:已知原因的小Bug,修复方案明确,无需复杂调试
140
+
141
+ ```
142
+ 1. 直接修复代码
143
+
144
+ 2. verification-before-completion验证
145
+
146
+ 3. quality-gate质量检查
147
+
148
+ 4. claudeception经验沉淀
149
+ ```
150
+
151
+ ---
152
+
153
+ ### 4.2 复杂Bug系统调试
154
+
155
+ > 适用场景:原因不明的Bug,需要复现确认和系统化调试定位
156
+
124
157
  ```
125
- 1. bug-reproduction-confirm复现确认(新增)
158
+ 1. bug-reproduction-confirm复现确认
126
159
 
127
- 2. systematic-debugging调试
160
+ 2. systematic-debugging系统化调试
128
161
 
129
162
  3. verification-before-completion验证
130
163
 
@@ -135,6 +168,108 @@ description: "SDD全流程开发 - 提供5个流程选项:完整3阶段流程
135
168
 
136
169
  ---
137
170
 
171
+ ### 4.3 性能问题修复
172
+
173
+ > 适用场景:性能相关的Bug,如响应慢、内存泄漏、加载缓慢等
174
+
175
+ ```
176
+ 1. performance-optimize性能优化
177
+
178
+ 2. verification-before-completion验证
179
+
180
+ 3. quality-gate质量检查
181
+
182
+ 4. claudeception经验沉淀
183
+ ```
184
+
185
+ ---
186
+
187
+ ### 4.4 安全漏洞修复
188
+
189
+ > 适用场景:安全相关的Bug,如XSS、SQL注入、权限绕过等
190
+
191
+ ```
192
+ 1. security-audit安全审计定位
193
+
194
+ 2. bug-reproduction-confirm复现确认
195
+
196
+ 3. systematic-debugging调试修复
197
+
198
+ 4. verification-before-completion验证
199
+
200
+ 5. quality-gate质量检查
201
+
202
+ 6. security-audit安全复核
203
+
204
+ 7. claudeception经验沉淀
205
+ ```
206
+
207
+ ---
208
+
209
+ ### 4.5 回归Bug修复
210
+
211
+ > 适用场景:回归测试发现的功能异常,需补充回归用例防止再次出现
212
+
213
+ ```
214
+ 1. bug-reproduction-confirm复现确认
215
+
216
+ 2. systematic-debugging调试定位
217
+
218
+ 3. Test-SDD补充回归用例
219
+
220
+ 4. 修复代码
221
+
222
+ 5. verification-before-completion验证
223
+
224
+ 6. quality-gate质量检查
225
+
226
+ 7. claudeception经验沉淀
227
+ ```
228
+
229
+ ---
230
+
231
+ ### 4.6 特定平台语言Bug修复 - Flutter iOS真机调试
232
+
233
+ > 适用场景:Flutter项目在iOS真机调试时出现的平台相关Bug,如签名问题、依赖冲突、原生插件兼容性、编译错误、真机闪退等
234
+
235
+ ```
236
+ 1. env-check环境检查
237
+ ├─ flutter doctor 环境诊断
238
+ ├─ iOS真机连接状态确认
239
+ ├─ 证书/Provisioning Profile有效性检查
240
+ └─ Xcode版本兼容性验证
241
+
242
+ 2. bug-reproduction-confirm复现确认
243
+ ├─ 真机复现Bug
244
+ ├─ 收集设备日志(Xcode Device Log / flutter logs)
245
+ └─ 区分Flutter层与原生层问题
246
+
247
+ 3. flutter-errors Flutter专项调试
248
+ ├─ Flutter引擎错误分析
249
+ ├─ Dart层堆栈跟踪
250
+ ├─ 原生插件兼容性检查
251
+ └─ 平台通道通信诊断
252
+
253
+ 4. 定位修复
254
+ ├─ Flutter层问题 → sdd-add修复
255
+ ├─ 原生层问题 → 手动修改原生代码(Swift/OC)
256
+ ├─ 插件问题 → 版本升降级/替换/自定义fork
257
+ └─ 证书/配置问题 → 更新Xcode配置
258
+
259
+ 5. 真机验证
260
+ ├─ flutter run --release 真机运行
261
+ ├─ Xcode真机调试(断点/日志/性能工具)
262
+ └─ 多机型兼容性验证
263
+
264
+ 6. verification-before-completion验证
265
+
266
+ 7. quality-gate质量检查
267
+
268
+ 8. claudeception经验沉淀(记录平台特定问题解决方案)
269
+ ```
270
+
271
+ ---
272
+
138
273
  ## 5. 代码发布
139
274
 
140
275
  ```
@@ -213,11 +348,10 @@ description: "SDD全流程开发 - 提供5个流程选项:完整3阶段流程
213
348
  │ 阶段 3:开发流程(Development Flow) │
214
349
  │ ├─ 实现计划(writing-plans) │
215
350
  │ ├─ TDD开发(test-driven-development) │
216
- │ │ ├─ 分支A:调试流程(bug-reproduction-confirm systematic-debugging)← 测试失败时触发
217
- │ │ │ ├─ 复现确认(bug-reproduction-confirm)
218
- │ │ │ ├─ 错误根因分析
219
- │ │ │ ├─ 修复问题
220
- │ │ │ └─ 验证测试 │
351
+ │ │ ├─ 分支A:Bug修复分支(跳转「4. Bug处理」6个选项)← 测试失败/遇到问题时触发
352
+ │ │ │ ├─ 选择Bug类型(1-简单/2-复杂/3-性能/4-安全/5-回归/6-平台)
353
+ │ │ │ ├─ 按对应子流程执行
354
+ │ │ │ └─ 修复完成 → 返回TDD主流程
221
355
  │ │ ├─ 分支B:临时需求流程(sdd-add)← 临时需求插入时触发 │
222
356
  │ │ │ ├─ 需求澄清(5W1H) │
223
357
  │ │ │ ├─ 优先级决策 │
@@ -560,7 +694,7 @@ MVP验证阶段已完成!
560
694
  **工具/技能**:
561
695
  - `writing-plans` - 实现计划
562
696
  - `test-driven-development` - TDD开发
563
- - `systematic-debugging` - 调试流程(分支A
697
+ - `systematic-debugging` - Bug修复分支(分支A,跳转4. Bug处理选项)
564
698
  - `sdd-add` - 临时需求流程(分支B)
565
699
  - `verification-before-completion` - 验证完成
566
700
  - `requesting-code-review` + `receiving-code-review` - 代码审查
@@ -586,17 +720,20 @@ MVP验证阶段已完成!
586
720
  - 按Todo列表逐个执行
587
721
  - 每个功能完成后验证
588
722
 
589
- **分支A:调试流程**
723
+ **分支A:Bug修复分支**
590
724
  ```
591
- 触发条件:测试失败 / 发现Bug
592
-
593
- ├─ 调用 systematic-debugging
594
- ├─ 错误根因分析
595
- ├─ 定位问题代码
596
- └─ 制定修复方案
597
- ├─ 执行修复
598
- ├─ 重新运行测试
599
- └─ 验证通过 返回TDD主流程
725
+ 触发条件:测试失败 / 发现Bug / 开发过程中遇到问题
726
+
727
+ ├─ 跳转到「4. Bug处理」选项菜单,由用户选择Bug类型:
728
+ 1. 简单Bug修复 - 已知原因,直接修复
729
+ 2. 复杂Bug系统调试 - 原因不明,需系统化调试
730
+ 3. 性能问题修复 - 性能相关Bug
731
+ │ 4. 安全漏洞修复 - 安全相关Bug
732
+ │ 5. 回归Bug修复 - 需补充回归用例
733
+ │ 6. Flutter iOS真机调试 - 平台相关Bug
734
+ ├─ 用户选择对应选项
735
+ ├─ 按选项完整流程执行
736
+ └─ 修复完成 → 返回TDD主流程
600
737
  ```
601
738
 
602
739
  **分支B:临时需求流程**
@@ -742,7 +879,7 @@ MVP验证阶段已完成!
742
879
  | | **用户确认通过** | ⬜ |
743
880
  | **阶段3** | 实现计划(writing-plans) | ⬜ |
744
881
  | | TDD开发 | ⬜ |
745
- | | 调试流程(分支A,按需) | ⬜ |
882
+ | | Bug修复分支(分支A,按需跳转「4. Bug处理」) | ⬜ |
746
883
  | | 临时需求流程(分支B,按需) | ⬜ |
747
884
  | | 验证完成 | ⬜ |
748
885
  | | 代码审查 | ⬜ |
@@ -12,8 +12,16 @@
12
12
  ```
13
13
 
14
14
  ### 2.2 Bug修复流程
15
+
16
+ Bug修复流程为选项类型,根据Bug类型选择对应子流程:
17
+
15
18
  ```
16
- 问题定位 Test-SDD补充回归用例 代码修复 → 验证 → 质量检查 → 经验沉淀
19
+ 1. 简单Bug修复 - 直接修复 → 验证 → 质量检查 → 经验沉淀
20
+ 2. 复杂Bug系统调试 - 复现确认 → 系统化调试 → 验证 → 质量检查 → 经验沉淀
21
+ 3. 性能问题修复 - 性能优化 → 验证 → 质量检查 → 经验沉淀
22
+ 4. 安全漏洞修复 - 安全审计 → 复现确认 → 系统化调试 → 验证 → 质量检查 → 安全复核 → 经验沉淀
23
+ 5. 回归Bug修复 - 复现确认 → 系统化调试 → 补充回归用例 → 修复 → 验证 → 质量检查 → 经验沉淀
24
+ 6. Flutter iOS真机调试 - 环境检查 → 复现确认 → Flutter专项调试 → 定位修复 → 真机验证 → 验证 → 质量检查 → 经验沉淀
17
25
  ```
18
26
 
19
27
  ### 2.3 小型功能迭代流程
@@ -37,7 +45,7 @@
37
45
  ### 3.2 强制使用技能
38
46
  - ✅ **所有发布前必须通过 quality-gate**
39
47
  - ✅ **所有需求必须经过 sdd/sdd-full 拆分**
40
- - ✅ **所有Bug修复必须经过 bug-reproduction-confirm → systematic-debugging**
48
+ - ✅ **所有Bug修复根据类型选择对应流程:简单Bug直接修复,复杂Bug走bug-reproduction-confirm → systematic-debugging,性能问题走performance-optimize,安全漏洞走security-audit,回归Bug需补充Test-SDD,Flutter iOS真机调试走env-check → flutter-errors**
41
49
  - ✅ **所有性能问题必须经过 performance-optimize**
42
50
  - ✅ **发布后必须进行 claudeception 经验沉淀**
43
51
 
@@ -72,13 +72,12 @@
72
72
  #### 选项B:我要做新功能/大需求
73
73
  → **sdd**(基础SDD拆分)或 **sdd-full**(完整SDD流程)→ 到「选项E:我要设计/开发了」
74
74
 
75
- #### 选项C:我要做小功能迭代/Bug修复
75
+ #### 选项C:我要做小功能迭代
76
76
  → 子问题:需求是否明确?
77
77
  → → 否:**requirement-completion-officer**(需求补全)
78
78
  → → 是:跳过
79
79
  → **sdd-add**(快速落地)
80
80
  → 如果需要UI:补充调用 **ui-sdd**
81
- → 如果需要调试:**systematic-debugging**
82
81
  → 如果需要制定计划:**writing-plans**
83
82
 
84
83
  #### 选项D:我要发布代码
@@ -108,8 +107,14 @@
108
107
  → → 否:跳过
109
108
  → 然后开始开发(sdd-add/test-driven-development/等)
110
109
 
111
- #### 选项F:我要调试问题
112
- **systematic-debugging**
110
+ #### 选项F:我要处理Bug
111
+ 子问题:Bug属于什么类型?
112
+ → → **简单Bug(已知原因)**:直接修复 → verification-before-completion → quality-gate → claudeception
113
+ → → **复杂Bug(原因不明)**:bug-reproduction-confirm → systematic-debugging → verification-before-completion → quality-gate → claudeception
114
+ → → **性能问题**:performance-optimize → verification-before-completion → quality-gate → claudeception
115
+ → → **安全漏洞**:security-audit → bug-reproduction-confirm → systematic-debugging → verification-before-completion → quality-gate → security-audit → claudeception
116
+ → → **回归Bug**:bug-reproduction-confirm → systematic-debugging → Test-SDD补充 → 修复 → verification-before-completion → quality-gate → claudeception
117
+ → → **Flutter iOS真机调试**:env-check → bug-reproduction-confirm → flutter-errors → 定位修复 → 真机验证 → verification-before-completion → quality-gate → claudeception
113
118
 
114
119
  #### 选项G:我要做测试
115
120
  → **sdd-test**(设计测试)→ **test-driven-development**(TDD开发)
@@ -135,9 +140,12 @@
135
140
  - `/prd` 或 `写PRD` → 触发 prd-write
136
141
 
137
142
  #### Bug修复流程
138
- - `/bug` 或 `修复Bug` → systematic-debugging → sdd-add → verification-before-completion → quality-gate → claudeception
143
+ - `/bug` 或 `修复Bug` → 显示Bug类型选项(6种),根据选择执行对应流程
139
144
  - `/debug` 或 `调试` → 触发 systematic-debugging
140
145
  - `/fix` 或 `修复` → 触发 sdd-add
146
+ - `/perf` 或 `性能` → 触发 performance-optimize
147
+ - `/security` 或 `安全漏洞` → 触发 security-audit
148
+ - `/ios-debug` 或 `iOS真机调试` → 触发 Flutter iOS真机调试流程
141
149
 
142
150
  #### 小型功能迭代流程
143
151
  - `/iter` 或 `迭代` → requirement-completion-officer → sdd-add → verification-before-completion → quality-gate
@@ -170,6 +178,7 @@
170
178
  - `/flutter-av` → 触发 flutter-av(音视频)
171
179
  - `/flutter-test` → 触发 flutter-test(测试策略)
172
180
  - `/flutter-errors` → 触发 flutter-errors(异常排查)
181
+ - `/ios-debug` 或 `iOS真机` → 触发 Flutter iOS真机调试流程
173
182
 
174
183
  #### 质量保障
175
184
  - `/security` 或 `安全审计` → 触发 security-audit
@@ -0,0 +1,65 @@
1
+ name: iOS真机全自动化调试
2
+ description: Flutter iOS真机全自动化AI闭环调试,自动环境检测、缓存清理、错误修复、崩溃日志抓取
3
+ author:
4
+ version: 1.0.0
5
+ trigger:
6
+ - iOS调试
7
+ - iOS真机调试
8
+ - Flutter iOS调试
9
+ - ios_full_auto_debug
10
+ tags:
11
+ - Flutter
12
+ - iOS
13
+ - 真机调试
14
+ - 自动化
15
+
16
+ 【claude code调用标识:iOS真机全自动化调试】【trae调用标识:iOS真机全自动化调试+iOS调试】【流程场景:1.Flutter开发调试、2.iOS真机测试、3.Bug修复、4.自动化构建】
17
+
18
+ ## 功能描述
19
+
20
+ 本技能提供 Flutter iOS 真机全自动化 AI 闭环调试能力,包含环境自动检测、缓存清理、错误识别修复、崩溃日志抓取等完整流程,真正实现无人值守调试。
21
+
22
+ ## 核心能力
23
+
24
+ | 功能模块 | 能力说明 |
25
+ |---------|---------|
26
+ | 环境检测 | 自动检测 Flutter、Xcode、libimobiledevice 环境 |
27
+ | 缓存清理 | 自动清理项目缓存、重装 pub/pod 依赖 |
28
+ | 设备识别 | 自动识别 iPhone 真机,生成唯一 BundleID 防签名冲突 |
29
+ | 编译安装 | 自动编译、安装、拉起真机调试 |
30
+ | 错误修复 | 自动识别错误类型(Pod/签名/权限/依赖)并修复 |
31
+ | 崩溃捕获 | 自动抓取真机崩溃日志,保存崩溃堆栈 |
32
+ | 自动重试 | 最多3轮自动重试,失败→修复→再编译闭环 |
33
+
34
+ ## 调用方式
35
+
36
+ ### Claude Code调用
37
+ ```
38
+ 调用 iOS真机全自动化调试
39
+ ```
40
+
41
+ ### Trae调用
42
+ ```
43
+ trae调用 iOS真机全自动化调试
44
+ ```
45
+
46
+ ## 使用方式
47
+
48
+ 1. **首次使用**:将 `ios_full_auto_debug.sh` 脚本放到 Flutter 项目根目录
49
+ 2. **授权执行**:运行 `chmod +x ios_full_auto_debug.sh`
50
+ 3. **启动调试**:运行 `./ios_full_auto_debug.sh` 即可
51
+
52
+ ## 输出内容
53
+
54
+ 1. 环境检测日志
55
+ 2. 编译构建日志
56
+ 3. 错误识别与修复记录
57
+ 4. 真机崩溃日志(自动保存到 `ios_crash_logs` 目录)
58
+ 5. 完整调试日志(保存到 `ios_debug_full.log`)
59
+
60
+ ## 适用场景
61
+
62
+ - Flutter iOS 真机开发调试
63
+ - 自动化构建与测试
64
+ - 真机崩溃问题排查
65
+ - CI/CD 流程集成
@@ -0,0 +1,137 @@
1
+ #!/bin/zsh
2
+ set -euo pipefail
3
+
4
+ # ========== 配置项 ==========
5
+ MAX_RETRY=3
6
+ LOG_FILE=./ios_debug_full.log
7
+ CRASH_LOG_DIR=./ios_crash_logs
8
+ WATCH_DEVICE=true
9
+ # ===========================
10
+
11
+ mkdir -p $CRASH_LOG_DIR
12
+ > $LOG_FILE
13
+
14
+ log() {
15
+ echo "[$(date +%H:%M:%S)] $1" | tee -a $LOG_FILE
16
+ }
17
+
18
+ # 捕获崩溃日志并保存
19
+ capture_crash_log() {
20
+ log "📋 正在抓取 iOS 真机崩溃日志..."
21
+ local crashFile="$CRASH_LOG_DIR/crash_$(date +%Y%m%d_%H%M%S).log"
22
+ idevcrash --list 2>/dev/null | tee $crashFile
23
+ log "✅ 崩溃日志已保存:$crashFile"
24
+ }
25
+
26
+ # 环境自检
27
+ check_env() {
28
+ log "🔍 校验 Flutter 环境"
29
+ command -v flutter >/dev/null 2>&1 || { log "❌ 未配置Flutter环境变量"; exit 1; }
30
+
31
+ log "🔍 校验 Xcode 命令行工具"
32
+ xcode-select -p >/dev/null 2>&1 || {
33
+ log "⚙️ 自动安装 Xcode 命令行工具"
34
+ xcode-select --install
35
+ exit 1
36
+ }
37
+
38
+ # 安装依赖工具:idevcrash 抓崩溃
39
+ if ! command -v idevcrash &>/dev/null; then
40
+ log "⚙️ 自动安装 ios 设备调试工具"
41
+ brew install libimobiledevice
42
+ fi
43
+ }
44
+
45
+ # 全量清理重置
46
+ full_clean() {
47
+ log "🧹 全量清理项目缓存"
48
+ flutter clean >> $LOG_FILE 2>&1
49
+ rm -rf ios/Pods ios/Podfile.lock >> $LOG_FILE 2>&1
50
+ rm -rf ~/.dart-tool >> $LOG_FILE 2>&1
51
+ log "📦 重新安装 pub 依赖"
52
+ flutter pub get >> $LOG_FILE 2>&1
53
+
54
+ log "🔧 重装 iOS Pod"
55
+ cd ios
56
+ pod deintegrate >> $LOG_FILE 2>&1
57
+ pod install >> $LOG_FILE 2>&1
58
+ cd ..
59
+ }
60
+
61
+ # 自动修正 BundleID 防签名冲突
62
+ auto_fix_bundle_id() {
63
+ log "⚙️ 自动生成唯一 BundleID"
64
+ local PBX="ios/Runner.xcodeproj/project.pbxproj"
65
+ local RAND=$(head -c8 /dev/urandom | base64 | tr -dc 'a-zA-Z0-9')
66
+ sed -i.bak "s/com\.example\.[A-Za-z0-9]*$/com.flutter.auto$RAND/g" $PBX
67
+ rm -f $PBX.bak 2>/dev/null
68
+ }
69
+
70
+ # 自动获取真机
71
+ get_iphone_device() {
72
+ log "📱 自动探测 iPhone 真机"
73
+ local DEV=$(flutter devices | grep -i "iPhone" | head -1 | awk '{print $1}')
74
+ if [[ -z "$DEV" ]]; then
75
+ log "❌ 未检测到iPhone,请插线、解锁、信任此电脑"
76
+ exit 1
77
+ fi
78
+ echo $DEV
79
+ }
80
+
81
+ # AI 错误自动修复逻辑
82
+ auto_fix_by_error() {
83
+ if grep -qi "Pod\|CocoaPods" $LOG_FILE; then
84
+ log "🧩 识别为 Pod 异常,自动修复"
85
+ rm -rf ios/Pods ios/Podfile.lock
86
+ cd ios && pod install && cd ..
87
+ elif grep -qi "CodeSign\|provisioning\|signature" $LOG_FILE; then
88
+ log "🔐 识别为 签名证书 异常,自动重置"
89
+ auto_fix_bundle_id
90
+ xcodebuild -project ios/Runner.xcodeproj clean >> $LOG_FILE 2>&1
91
+ elif grep -qi "permission\|entitlement\|Info.plist" $LOG_FILE; then
92
+ log "📄 识别为 权限/配置 异常"
93
+ flutter clean && flutter pub get
94
+ elif grep -qi "undefined symbol\|framework\|link failed" $LOG_FILE; then
95
+ log "🔗 识别为 链接/框架 依赖异常"
96
+ full_clean
97
+ else
98
+ log "⚠️ 未知错误,执行全量重置"
99
+ full_clean
100
+ fi
101
+ }
102
+
103
+ # 单次编译运行
104
+ run_build() {
105
+ local DEV=$1
106
+ log "🚀 开始编译并安装到真机"
107
+ if flutter run -d $DEV --verbose >> $LOG_FILE 2>&1; then
108
+ log "✅ 编译成功,进入真机调试,支持热重载(r/R/q)"
109
+ capture_crash_log
110
+ return 0
111
+ fi
112
+ return 1
113
+ }
114
+
115
+ # 主流程
116
+ main() {
117
+ check_env
118
+ full_clean
119
+ auto_fix_bundle_id
120
+ local DEVICE=$(get_iphone_device)
121
+
122
+ local retry=0
123
+ while (( retry < MAX_RETRY )); do
124
+ if run_build $DEVICE; then
125
+ return 0
126
+ fi
127
+ retry=$((retry+1))
128
+ log "❌ 构建失败,准备AI自动修复,剩余重试:$((MAX_RETRY - retry))"
129
+ auto_fix_by_error
130
+ done
131
+
132
+ log "❌ 已达最大重试次数,调试失败,查看日志:$LOG_FILE"
133
+ log "📂 崩溃日志目录:$CRASH_LOG_DIR"
134
+ exit 1
135
+ }
136
+
137
+ main
@@ -346,12 +346,12 @@ docs/
346
346
 
347
347
  ### 标准版(推荐,带复现确认)
348
348
  ```
349
- /bug 或 修复Bug → bug-reproduction-confirm → systematic-debugging → verification-before-completion → quality-gate → claudeception
349
+ /bug 或 修复Bug → bug-reproduction-confirm → [Flutter iOS真机问题? ios-full-auto-debug] → systematic-debugging → verification-before-completion → quality-gate → claudeception
350
350
  ```
351
351
 
352
352
  ### 极简版(无复现确认)
353
353
  ```
354
- /bug 或 修复Bug → systematic-debugging → verification-before-completion → quality-gate → claudeception
354
+ /bug 或 修复Bug → [Flutter iOS真机问题? ios-full-auto-debug] → systematic-debugging → verification-before-completion → quality-gate → claudeception
355
355
  ```
356
356
 
357
357
  ### 分支流转规则
@@ -418,7 +418,7 @@ Base-SDD → Brain-SDD → Competitor-SDD → PRD-SDD → Figma设计 → UI-SDD
418
418
  ### Bug修复流程(SDD融合版)
419
419
 
420
420
  ```
421
- 1. systematic-debugging → 更新Code-SDD技术债务记录
421
+ 1. [Flutter iOS真机问题? ios-full-auto-debug] → systematic-debugging → 更新Code-SDD技术债务记录
422
422
 
423
423
  2. Test-SDD补充回归用例 → 关联bug编号
424
424
 
@@ -447,6 +447,7 @@ Base-SDD → Brain-SDD → Competitor-SDD → PRD-SDD → Figma设计 → UI-SDD
447
447
  ---
448
448
 
449
449
  ## 更新日志
450
+ - v5.1(2026-05-06):添加ios-full-auto-debug技能到Bug修复流程中
450
451
  - v4.0(2026-05-06):新增SDD融合框架,9份标准化模板,强制顺序流水线,Bug修复流程融合
451
452
  - v3.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
452
453
  - v2.0(2026-05-04):更新技能列表,匹配当前实际存在的技能
@@ -37,6 +37,7 @@
37
37
  | **claudeception** | 沉淀层 | 持续学习系统 | 经验提取 |
38
38
  | **mempalace-auto-saver** | 沉淀层 | 记忆宫殿自动保存 | 知识记录 |
39
39
  | **using-superpowers** | 工具层 | Superpowers代码全流程 | 全流程自动化 |
40
+ | **ios-full-auto-debug** | 专项工具类 | iOS真机全自动化调试 | 开发执行/调试 |
40
41
 
41
42
  ### 现有覆盖度
42
43
  ✅ 需求阶段 - 完整覆盖
@@ -75,7 +76,7 @@
75
76
  ├─────────────────────────────────────────────────────────┤
76
77
  │ 交付层 | sdd-add, test-driven-development, systematic-debugging, verification-before-completion, quality-gate, security-audit, finishing-a-development-branch, release-flow │
77
78
  ├─────────────────────────────────────────────────────────┤
78
- │ 沉淀层 | claudeception, mempalace-auto-saver, using-superpowers, requesting-code-review, receiving-code-review │
79
+ │ 沉淀层 | claudeception, mempalace-auto-saver, using-superpowers, requesting-code-review, receiving-code-review, ios-full-auto-debug
79
80
  └─────────────────────────────────────────────────────────┘
80
81
  ```
81
82
 
@@ -145,6 +146,7 @@
145
146
  - **using-superpowers**:Superpowers全流程
146
147
  - **requesting-code-review**:请求代码审查
147
148
  - **receiving-code-review**:接收代码审查
149
+ - **ios-full-auto-debug**:iOS真机全自动化调试
148
150
 
149
151
  ---
150
152
 
@@ -208,7 +210,7 @@
208
210
 
209
211
  ### 3. Bug修复
210
212
  ```
211
- 1. systematic-debugging(调试问题)
213
+ 1. systematic-debugging(调试问题,iOS项目可选ios-full-auto-debug)
212
214
  2. sdd-add(快速修复)
213
215
  3. verification-before-completion(验证)
214
216
  4. quality-gate(质量检查)
@@ -268,7 +270,7 @@
268
270
  ├─────────────────────────────────────────────────────────────────┤
269
271
  │ 交付层 | sdd-add, test-driven-development, systematic-debugging, verification-before-completion, quality-gate, security-audit, finishing-a-development-branch, release-flow, API-SDD, Env-SDD, Test-SDD │
270
272
  ├─────────────────────────────────────────────────────────────────┤
271
- │ 沉淀层 | claudeception, mempalace-auto-saver, using-superpowers, requesting-code-review, receiving-code-review │
273
+ │ 沉淀层 | claudeception, mempalace-auto-saver, using-superpowers, requesting-code-review, receiving-code-review, ios-full-auto-debug
272
274
  └─────────────────────────────────────────────────────────────────┘
273
275
  ```
274
276
 
@@ -298,6 +300,7 @@
298
300
  ---
299
301
 
300
302
  ## 更新日志
303
+ - v5.1(2026-05-06):添加ios-full-auto-debug技能
301
304
  - v5.0(2026-05-06):新增SDD融合框架,9份标准化模板,全流程SDD融合体系,扩展风险评估
302
305
  - v4.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
303
306
  - v3.0(2026-05-04):更新技能列表,标记为已完整
@@ -170,6 +170,7 @@
170
170
  → → 音视频功能:**flutter-av**
171
171
  → → 异常排查:**flutter-errors**
172
172
  → → 测试策略:**flutter-test**
173
+ → → iOS真机调试: **ios-full-auto-debug**
173
174
 
174
175
  → 子问题2:需要设计吗?
175
176
  → → 是:**ui-sdd** / **sdd-code**(选择对应模板)
@@ -208,6 +209,7 @@
208
209
  | 全流程 | using-superpowers |
209
210
  | Flutter开发 | flutter-map / flutter-av / flutter-test / flutter-errors |
210
211
  | 环境预检 | env-check |
212
+ | iOS真机调试 | ios-full-auto-debug |
211
213
 
212
214
  ---
213
215
 
@@ -328,6 +330,7 @@ systematic-debugging → Test-SDD补充回归用例 → sdd-add修复 → verifi
328
330
  ---
329
331
 
330
332
  ## 更新日志
333
+ - v5.1(2026-05-06):添加ios-full-auto-debug技能到Flutter专项开发中
331
334
  - v5.0(2026-05-06):新增SDD融合框架,9份标准化模板,全流程SDD融合体系
332
335
  - v4.0(2026-05-05):发布到npm包,新增npx安装方式,支持Trae/Trae-cn/Claude Code多环境安装
333
336
  - v3.0(2026-05-04):更新技能列表,匹配当前实际存在的技能