用途：Counselors 是一个多智能体评审技能（Multi-Agent Review Skill），将同一提示并行分发给多个 AI 编程智能体，再综合它们的回答，用于代码审查、方案评估与风险排查。
主要能力：按阶段执行——收集上下文（用 Glob/Grep 查找提示中提到的文件、运行 git diff HEAD 与 git diff --staged 获取近期改动、检索相关代码，最多约 5 个文件、总量约 50KB）；选择智能体（默认 claude-opus、or-gemini-3.1-pro、or-codex-5.4，可用 counselors ls 发现可用智能体并让用户多选，且必须回显确认清单）；组装提示（生成 slug，创建带秒级 UNIX 时间戳前缀的输出目录 ./agents/counselors/TIMESTAMP-[slug]，写入 prompt.md）；分发（并行运行，通常 2-5 分钟）；读取结果（优先解析 run.json，缺失时扫描各 {tool-id}.md 与 .stderr）；综合呈现共识、分歧、关键风险、盲点与建议；可选进入后续行动。
使用方式：通过 Bash 运行，例如 set -a; for f in ~/.env .env ~/.vibe-tools/.env; do [ -f "$f" ] && source "$f"; done; set +a; counselors run -f ./agents/counselors/[slug]/prompt.md --tools [comma-separated-selections] --json。使用 -f 文件模式原样发送提示，--json 获取结构化输出；Bash 超时设为 480000（8 分钟）。未安装时提示 npm install -g counselors；未配置工具时运行 counselors init 或 counselors add。
限制：不要只依赖 JSON stdout，进程被中断时 stdout 可能为空，需回退到文件系统扫描；run.json 中 status 为 success 但 wordCount 为 0 属静默失败，需查看 .stderr（常见原因：API 密钥过期、402 需付费、限流）；部分工具失败时需询问用户是否继续或重试，全部失败则不要进入综合阶段；8 分钟超时为硬上限，不应添加 sleep/重试循环。其他收费、平台与效果信息暂未提供。