메뉴
Use when facing Xcode build errors, linker failures, XCTest failures, event pipeline bugs, network issues, SDK crashes, or any technical problem where a first attempt didn't work or the cause is unclear
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when receiving an ambiguous feature request, when scope is unclear, or before writing any plan
Use after verification-before-completion passes and code review is clean, to close out the development branch
Use after writing a plan document in docs/plans/, before requesting user confirmation
Use when receiving feedback from code-reviewer subagent or human reviewer
Use when a feature, bugfix, or refactoring step is completed and needs review, or before merging to main, or when user says "review", "审查", "帮我看看代码"
Use when executing an implementation plan with 3+ independent tasks in the current session
| name | systematic-debugging |
| description | Use when facing Xcode build errors, linker failures, XCTest failures, event pipeline bugs, network issues, SDK crashes, or any technical problem where a first attempt didn't work or the cause is unclear |
Type: Technique | Discipline: Rigid
遇到技术问题时，用纪律代替直觉。随机猜测让问题变得更复杂；系统性方法让每次尝试都增加信息量。
核心原则： 在不理解根本原因之前，不修改代码。每次修改只验证一个假设。
目标：用一句话准确描述问题。"X 在 Y 处因为 Z 失败。" 填不上这句话 → 继续调查。
Xcode / xcodebuild 编译错误：
error: 行和具体文件路径 + 行号XCTest 测试失败：
XCTAssert* 断言setUp / tearDown 是否正确重置了单例状态运行时 / 事件管道问题：
dataCollectionEnabled 开关，检查后台队列任务是否静默失败sessionInterval 超时逻辑，检查 App 生命周期钩子SDK 特有规律速查：
| 症状 | 常见根因 |
|---|---|
| Debug 正常，Release 失败 | 编译优化 / 符号剥离 / 混淆导致方法找不到 |
| 第一次测试通过，第二次失败 | 单例状态未在 tearDown 中重置 |
| 本地正常，CI 失败 | 模拟器版本差异 / 缺少 CocoaPods 依赖 |
| 事件入库后消失 | 上报成功删除逻辑误触发 |
| 首次 VISIT 事件重复 | 多次调用 startWithConfiguration: / AppDelegate 钩子重复触发 |
| 主线程 watchdog 杀掉 | 数据库写入在主线程执行 |
| 无埋点点击不触发 | method swizzling 失败 / load 顺序问题 |
git log --oneline --grep="关键词" -10用一句话陈述假设：
"我认为 [具体的 X] 导致了 [具体的 Y]，因为 [具体的 Z]。"
确定最小验证手段——改一行代码 + 一条命令能证伪或证实。
禁止行为：
只实施假设对应的最小修复，然后立即验证：
xcodebuild test \
-workspace Example/GrowingAnalytics.xcworkspace \
-scheme GrowingAnalyticsTests \
-testPlan GrowingAnalyticsTests \
-destination 'platform=iOS Simulator,name=iPhone 17 Pro' \
| xcbeautify
修复后问题消失 → 记录根因 → 回到 verification-before-completion 重跑。
3 次假设验证后问题仍未解决 → 强制停止，输出升级报告：
## 调试报告
问题描述：[一句话]
已尝试：
1. 假设 [X]，修改了 [Y]，结果 [Z]
2. 假设 [X]，修改了 [Y]，结果 [Z]
3. 假设 [X]，修改了 [Y]，结果 [Z]
当前状态：[问题仍然存在]
疑似方向：[你的猜测和为什么卡住]
需要：[具体需要什么帮助]
| Excuse | Reality |
|---|---|
| "直接改一下看看行不行" | 无假设的试探 = 随机游走 |
| "这个错误面熟" | 面熟是陷阱；Phase 1 要读完整错误再判断 |
| "同时试 3 个修复" | 无法分离原因 |
| "失败 3 次再试第 4 次" | 3 次是硬上限，强制升级 |
verification-before-completion