用途：swain-doctor 是 swain 项目的健康检查与修复技能。会话启动时若 swain-preflight 检测到问题会自动调用；用户也可手动按需调用。手动调用时不受 preflight 状态影响，始终运行。
主要能力：运行权威检测脚本，输出结构化 JSON（{ checks: [...], summary: {...} }），每项检查含 name、status、message 和可选 detail。检查覆盖治理规则注入与替换、旧技能清理、.agents 目录、.tickets/ 健康、.beads/ 迁移、必需与可选工具、设置文件、脚本权限、内存目录、Superpowers 安装、Epic 迁移、README、制品索引、证据池、worktree 及上下文、生命周期目录、tk 健康、bin 符号链接、提交签名、SSH、崩溃残留、扁平制品、swain 符号链接、分支模型与 gitignore 等。部分检查可自动修复。
使用方式：REPO_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)" 后运行 bash "$REPO_ROOT/.agents/bin/swain-doctor.sh"；自动修复扁平制品用 --fix-flat-artifacts。脚本不可用时回退到 skills/swain-doctor/scripts/swain-doctor.sh，检查需逐个 Bash 串行执行，不可并行。检查后解析 JSON 并向操作者展示汇总表，仅对 warning 或 advisory 项参考修复章节。
状态：ok、advisory（已自动修复或提示）、warning（需用户处理）、skipped（无法运行）。可选工具不自动安装。限制：修复失败或冲突（如目标路径已存在、真实文件冲突）需手动处理，部分流程需参考对应 references 文档。