loom-team-manager-pane-dead-on-spawn

诊断并修复 Loom 团队管理员面板瞬间崩溃的问题（tmux 面板状态为 1）。

SKILL.md

--- frontmatter

name: loom-team-manager-pane-dead-on-spawn
description: Diagnose and fix Loom team manager pane dying immediately (tmux pane status 1).
license: MIT
compatibility: opencode,claude
metadata:
  created_at: "2026-01-29T09:27:53.279Z"
  updated_at: "2026-01-29T09:27:53.279Z"
  version: "1"

When To Use

•loom team start <TEAM> succeeds, but manager pane shows dead (status 1) and capture output is empty.

Diagnose

•
Confirm run exists:
- •loom team status <TEAM> --show-dead
•
Capture manager:
- •loom team capture <TEAM> manager --lines 200 --header
•
Open the capture metadata file under .team/runs/<TEAM>/captures/*.json and check:
- •pane.start_command
- •pane.current_command
- •pane.dead

Common Root Cause: Missing `team` Binary

•
If pane.start_command begins with team tui ...:
- •Verify: command -v team (likely missing)
- •Verify Loom exists: command -v loom
- •This means the pane died because tmux tried to run team directly.

Fix Options

•
Option A (fast local): add a team shim on PATH that forwards to Loom.
- •team should behave like: loom team "$@"
•Option B (proper): adjust Loom/runner config so tmux spawns loom team tui ... (not team tui ...).
•Option C: pass an explicit harness --bin that points to the correct executable if supported.

Validate

•
Restart run (or use --force):
- •loom team start <TEAM> --force ...
•
Confirm manager pane is alive:
- •loom team status <TEAM>
- •loom team capture <TEAM> manager --lines 40

Manual notes

This section is preserved when the skill is updated. Put human notes, caveats, and exceptions here.