debug-ios

Solid

Self-debug iOS app end to end — verify device/simulator, devtool, log daemon work, plan root-cause investigation, drive app via synthetic taps/gestures while capture timestamped logs, report findings back to human. Use whenever user report bug, crash, hang, stuck spinner, wrong behavior in iOS app, or ask reproduce/investigate/diagnose something on iOS, check device/simulator logs, or drive UI without touch phone self — even if no say "debug" explicit (e.g. "the reconnect spinner never stops", "workspace card does nothing when tapped", "why did it crash on my phone", "check what's happening on my iPhone").

Code & Development 152 stars 15 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
73
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Debug iOS Autonomous iOS debug loop: verify environment, plan investigation, drive app while capture logs, report back. Build on `docs/DEVTOOL.md` (in-app tap/touch driver, iOS + Android), `scripts/ios-log.sh daemon` (background log capture queryable by time range), and `scripts/ios-log.sh wait` (poll for expected log line, no sleep-and-hope). Invoke with bug description + optional flags: `/debug-ios <bug description> [--direct] [--no-devtool] [--perf]` — see "Flags" below for what each change. ## At a glance 0. **Verify** — device connect, log daemon capture fresh timestamp output, devtool reachable (built `--devtool --debug`). 1. **Plan** — hypothesis from read code first + ordered action steps + logs to add. 2. **Loop** — action → capture → evaluate → next, until root cause confirm or the first failed attempt requires more information (see below). 3. **Summary** — report to human: what wrong, what tried, the fix, cleanup status, assumptions, recommendations, new concepts, proposals. Each phase run as own subagent by default (`--direct` inline instead). Iron Law + Output hygiene apply every phase — read those next. ## Iron Law **NO FIX WITHOUT VERIFIED ROOT CAUSE. NO "DONE" WITHOUT RE-OBSERVE FIX WORKING.** Never assume — every hypothesis check against real log line or real screenshot/element query before act on it. Can't verify, say so and ask for the missing information; don't guess-and-ship. Token cost not reason to stop loop — wrong fix cost user fa...

Details

Author
tanlethanh
Repository
tanlethanh/zedra
Created
6 months ago
Last Updated
3 days ago
Language
Rust
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category