AgentSkillsCN

doctor-fix

运行 Evoloop 医生检查，并自动修复常见问题——包括缺失目录、不可执行脚本、缺少模板等，并提供手动修复的解决方案

SKILL.md
--- frontmatter
name: doctor-fix
description: Run Evoloop doctor checks and auto-fix common issues — missing directories, non-executable scripts, missing templates, and provide remediation for manual fixes
disable-model-invocation: true
allowed-tools:
  - Read
  - Glob
  - Grep
  - Bash
  - Edit
  - Write

Doctor Auto-Fix

Step 1: Run Doctor

Run ./scripts/doctor.sh --verbose. If missing/not executable → "Run ./scripts/bootstrap-plan.sh".

Step 2: Categorize Issues

Auto-fixable:

IssueFix
Missing directory (.log/, .state/, .plan/areas/, .plan/templates/)mkdir -p
Script not executablechmod +x
Missing templates in .plan/templates/Run ./scripts/bootstrap-plan.sh
Malformed JSON (formatting)Read with jq, rewrite

Manual (provide file:line + remediation):

  • •TODO/TBD/FIXME in planning docs → show exact location, suggest replacement
  • •Missing REQ-### IDs → show where to add, reference existing
  • •Areas not approved → suggest ./orchestrator.sh plan area --area <name>
  • •Missing planning docs → list which, explain contents
  • •Dependency cycles → show cycle, suggest removal
  • •Missing tools (jq, rg) → brew install jq ripgrep
  • •Missing runner tools → show which CLI per runners.json
  • •Story schema/deploy contract violations → show story ID + invalid field

Step 3: Confirm & Apply

Show summary (N issues, M auto-fixable, K manual). Ask confirmation. Apply fixes, report each.

Step 4: Manual Guide

For each manual issue: file:line, issue text, concrete fix.

Step 5: Re-Verify

Run ./scripts/doctor.sh again. Report "All passing" or "K remaining (manual)".