Agent Doctor
使用此技能来基于实际存在的文件，对代理指令和技能发现进行诊断。它报告来源为已发现，绝不代表运行时已加载或配置为可用。
首先运行确定性扫描，然后仅依据报告和报告中所列的文件进行推理。该扫描为只读，绝不修复文件、加载技能、请求权限，也不读取通用家目录、环境变量、凭据或认证文件。
从此技能的安装目录运行：
python3 scripts/agent_doctor.py --project <path-to-project> --format markdown
使用 --home /fixture/home 进行 fixture 或备选全局发现。仅在需要额外的允许技能根目录时，添加显式的 --skill-root /path/to/skills 参数。--model <name> 接受您正在运行的模型名称（任何字面名称，例如 Claude、claude-opus-5-5 或 GPT-5），并将其与普通技能文本中字面上的 "You are " 身份声明进行比较，忽略大小写、连字符与空格或点的差异，以及开头的 claude-，并将不匹配项仅报告为建议。省略该参数则跳过此项检查。选择 --format json 可获得机器可读的输出。使用 --max-files、--max-bytes 和 --max-directories 来收紧有界扫描，实现聚焦诊断。
扫描会限制深度、目录数、文件数和字节数；它跳过依赖、版本控制、缓存和工作树目录。它识别祖先和嵌套的 AGENTS.md / CLAUDE.md / GEMINI.md、允许的全局指令文件（~/.codex/AGENTS.md、~/.claude/CLAUDE.md、~/.gemini/GEMINI.md），以及每个已记录的主机文件夹中的平面技能文件夹：主目录下的 .agents、.codex、.claude、.gemini、.cursor、.copilot 和 .codeium/windsurf 技能，以及项目目录下的 .agents、.codex、.claude、.gemini、.cursor、.github、.opencode、.cline、.clinerules、.devin 和 .windsurf 技能。通过多个文件夹（例如 Skills CLI 的符号链接）访问的技能只会报告一次。它保持规范路径和别名分离，拒绝符号链接逃逸，并且不输出原始文件内容。
技能使用与归档
对于很少或从未被调用的技能，运行 python3 scripts/agent_doctor.py --usage 并遵循 references/usage.md。它以只读方式读取会话日志，仅打印技能名称和计数。向用户展示表格，然后对每个技能询问：更新、保留还是归档。说“在日志中未找到调用”，绝不说“未使用”。仅使用 scripts/skill_archive.py 进行归档：plan，展示计划，获得对该技能明确的同意，然后 archive --yes；绝不要在与提问相同的轮次中操作。提及 restore。