roll-doctorlisted

# Roll Doctor 诊断 Roll 工具链健康状态。快速定位 skill 不工作、convention 不同步、symlink 断裂等问题。 ## When to Use - "roll 怎么不工作了" - "skill 找不到了" - "convention 没有同步" - "$roll-debug 不响应" - 任何 Roll 相关功能异常 ## Checks ### 1. Roll Installation ```bash # Verify ROLL_HOME structure ls -la ~/.roll/ ls -la ~/.roll/skills/ ls -la ~/.roll/conventions/ ``` Expected: - `~/.roll/` exists - `~/.roll/skills/` has roll-* directories - `~/.roll/conventions/global/` has AGENTS.md, CLAUDE.md, etc. - `~/.roll/conventions/templates/` has backend-service, cli, frontend-only, fullstack ### 2. Skill Health ```bash # List all skills and check YAML frontmatter for f in ~/.roll/skills/*/SKILL.md; do echo "=== $(basename $(dirname $f)) ===" head -5 "$f" done ``` Check: - Each skill directory has `SKILL.md` - YAML frontmatter has `name:` and `description:` - No duplicate `name` values across skills - File is readable markdown ### 3. Symlinks ```bash # Claude Code ls -la ~/.claude/skills/roll-* # Antigravity (agy — reuses ~/.gemini/, if exists) ls -la ~/.gemini/skills/roll-* 2>/dev/null # Trae (if exists) ls -la ~/.trae/skills/roll-* 2>/dev/null ``` Check: - Each symlink exists - Each symlink points to valid target in `~/.roll/skills/` - No broken symlinks (red in ls output) ### 4. Conventions Sync ```bash # Check roll.md sync diff ~/.roll/conventions/global/CLAUDE.md ~/.claude/roll.md # Check CLAUDE.md includes @roll.md grep "@roll.md" ~/.claude/CLAUDE.md ``` Check: - `~/.claude/roll.md` exists and matches `