メニュー
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