菜单
Recover from flaky BLE pairing with the pedal — disconnect, remove the bond, scan, pair, connect, verify. Reads the pedal MAC from $ASP_PEDAL_MAC. Use this any time you would hand-roll `bluetoothctl disconnect/remove/pair` retries on the pedal.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Write Bash commands that don't trigger unnecessary permission prompts. Use Read/Edit/Grep instead of head/tail/sed/awk/cat/echo; split chained commands (&&, ;, ||) into separate Bash calls; drop diagnostic suffixes like `; echo "EXIT=$?"`. The allowlist matches whole command strings — every mismatch costs the user attention.
Commit user-named files atomically via scripts/commit-pathspec.sh (which wraps `git commit -m "..." -- <files>` and writes the provenance token the pre-commit hook validates). Applies the CLAUDE.md "Pre-commit hook failures on unrelated changes" protocol when the hook fails. Never adds --no-verify silently — explicit user approval is required.
Scaffold a new epic file in docs/developers/tasks/open/ and run housekeep
Scaffold a new idea file in docs/developers/ideas/open/ and regenerate the ideas OVERVIEW.md
Set a task to active — updates status, moves to active/, runs housekeep. Also resumes paused tasks (paused/ → active/ or active/ with closed prerequisites).
Mark a task as closed — writes effort_actual, moves the file to closed/, runs housekeep, and commits
| name | ble-reset |
| description | Recover from flaky BLE pairing with the pedal — disconnect, remove the bond, scan, pair, connect, verify. Reads the pedal MAC from $ASP_PEDAL_MAC. Use this any time you would hand-roll `bluetoothctl disconnect/remove/pair` retries on the pedal. |
Invoked as /ble-reset when BLE pairing with the pedal flakes — the
typical signal is the agent (or the user) running
bluetoothctl disconnect <MAC> two or more times in a row, or seeing
a stale "Connected: yes" while the host can no longer talk to the
pedal.
The skill replaces the freehand retry dance with one canonical recovery sequence. Each step is bounded by a timeout; on first failure the skill exits non-zero with a clear message naming the failed step, so you have one tool to reach for instead of guessing.
The skill reads the pedal MAC from $ASP_PEDAL_MAC (set in .envrc,
see .envrc.example and the
"Project env vars (direnv)" section of
DEVELOPMENT_SETUP.md).
If the variable is empty or unset, the skill exits with a clear
"set ASP_PEDAL_MAC" message — it does not scan for the pedal first
and pick a guess, because that hides the real configuration error.
The hex 24:62:AB:D4:E0:D2 from the project's reference pedal must
not appear inline anywhere in this skill — re-pairing a different
pedal must require only a .envrc edit.
The skill delegates to
.claude/skills/ble-reset/ble_reset.sh so the whole
sequence is one allowlistable Bash invocation:
.claude/skills/ble-reset/ble_reset.sh
The script runs, in order:
bluetoothctl disconnect $ASP_PEDAL_MAC. Tolerated
if the device wasn't connected (host already considers it gone).bluetoothctl remove $ASP_PEDAL_MAC. Forces a
fresh pair on the next attempt; clears stale link-key state.
Tolerated if the device wasn't known.bluetoothctl --timeout 8 scan on. The pedal must
re-appear in the cache after scan. Hard-fail if not seen.bluetoothctl pair $ASP_PEDAL_MAC. Hard-fail on
non-zero / AuthenticationFailed / AuthenticationCanceled.bluetoothctl connect $ASP_PEDAL_MAC. Hard-fail on
non-zero.python scripts/pedal_config.py scan and confirm the
pedal name appears in output (the same end-to-end signal used in
feature tests). Hard-fail if it doesn't.On any hard-fail, the script prints:
ble-reset FAILED at step <N> (<step name>): <stderr from the step>
…and exits non-zero. On full success it prints ble-reset OK and the
output of step 6.
bluetoothctl command (e.g. just info <MAC>).
Run that directly — this skill is the recovery sequence, not a
general-purpose bluetoothctl wrapper.Registered in .vibe/config.toml's
enabled_skills list per the project's CLAUDE.md skill-registration
rule.