claude-code-auto-advisor

claude-code-auto-advisor

对于第二个模型能显著降低风险的任务，自动调用 Claude Code 配置的顾问。

决策树

应用此技能前，请按顺序回答以下判断项：

• 未在 Claude Code 中运行： 停止。不要使用子 Agent、网络搜索、其他模型或其他框架功能来模拟顾问。

• Claude Code 会话中未配置顾问模型，或没有可调用的顾问工具： 不要调用顾问。继续进行常规验证，仅在影响最终交接时记录跳过原因。

• 任务涉及安全、代码审查、高风险设计、开展大量工作前的多步骤高层计划验证、高风险重构、影响生产环境或数据的工作、反复出现的故障，或复杂的完成情况检查： 收集足够的本地证据，然后在确定方案或最终结论前咨询顾问。阅读 references/advisor-policy.md。

• 任务属于常规、可逆、单步骤、普通规划、小型检查清单，或已由本地证据完全确定： 不要咨询顾问。

• 不确定是否启用了顾问： 优先以实际的 Claude Code 工具列表为准。也可以运行 python3 scripts/detect_advisor_config.py --format text，进行保守的设置预检查，然后阅读 references/claude-code-mechanics.md。

快速参考

情况	操作
安全、身份验证、密钥、权限、沙箱、供应链、数据泄露	初步收集上下文后、提出建议或进行编辑前，咨询顾问
代码审查、PR 审查或用户要求的独立审查	最终确定审查结果前，咨询顾问
大型多步骤实施计划、迁移计划、多 Agent 交接，或影响范围显著的高层计划	根据证据和限制起草计划，然后在开始工作前咨询
大型重构、迁移、并发、数据模型、不可逆部署、生产环境影响	确定计划前咨询；如果仍有风险，完成前再次咨询
两次可信的尝试后，同类错误模式仍反复出现	再尝试推测性修复前，咨询顾问
没有顾问模型或工具、不支持主模型、顾问已禁用，或不使用 Claude 的框架	不要调用；除非用户要求配置顾问，否则不要让用户进行配置
小型格式调整、简单命令输出、明显的拼写错误、简短且稳定的问答、单步骤计划或常规任务规划	不要咨询

操作规则

1. 仅在 Claude Code 中使用此技能。如果当前运行环境是 Codex、Gemini CLI、Cursor、OpenCode 或未知环境，请立即退出此技能。
2. 将当前 Claude Code 会话中可调用的顾问工具视为已配置顾问模型的最有力信号。辅助脚本只检查可见设置，无法检测所有会话级覆盖项。
3. 不要仅仅因为顾问工具存在就调用它。咨询必须有具体的规划、审查、风险或调试理由。
4. 对于必须咨询的类别，请先收集相关文件、差异、日志、测试、文档和约束。缺少上下文的顾问调用通常不如稍后基于证据进行的调用。
5. 对于高层规划验证，必须先制定包含多个相互依赖步骤或阶段、且影响范围显著的完整计划。先起草实际计划：目标、阶段、文件／子系统、假设、风险、回滚或停止节点，以及验证方式。开始实施前再咨询顾问。不要用顾问来处理常规规划、简短待办清单或选择下一个本地命令。
6. 咨询时，先在普通助手文本中明确说明当前的不确定之处。不要尝试传递隐藏参数；Claude Code 的顾问会在服务器端接收对话上下文。
7. 批判性地采纳顾问建议。如果本地证据与之矛盾，应以证据为准，解释冲突，并按经过验证的路径继续。
8. 切勿仅为丰富顾问上下文而读取机密、凭据或私有数据。顾问会收到完整对话和工具结果，因此应尽量减少敏感的对话内容。

阅读指南

需求	阅读
判断任务是否需要咨询顾问	references/advisor-policy.md
了解 Claude Code 顾问的设置、要求、模型配对、成本、缓存和故障模式	references/claude-code-mechanics.md
在不调用顾问的情况下检查本地 Claude Code 设置	scripts/detect_advisor_config.py

注意事项

1. 顾问配置取决于会话。已保存的 advisorModel 不等于当前请求中可调用顾问；主模型、提供方、组织允许列表或禁用标志都可能阻止调用。
2. 顾问会读取完整对话，包括工具结果。不要仅为获得更好的第二意见而将敏感文件读入上下文。
3. 过早调用会浪费最佳审查时机。进行审查和安全工作时，应先检查实际代码，再咨询顾问。
4. 计划验证仅适用于实质性的多步骤计划。应在计划具体后进行，而不是在头脑风暴时进行；常规规划或简短待办清单无需验证。
5. 顾问不能替代测试、静态分析或本地证据，只是额外的一轮推理。
6. 顾问的调用时机由 Claude Code 控制。此技能会加强在恰当时机咨询的要求，但仍必须尊重已禁用或未配置顾问的会话。