SuperAPI AI 工具集

advisor

编程与开发

查看项目

更新于 11-19 04:05

技能介绍

Advisor 是 shaneholloman/cursor-plugins 中的一项插件技能,为 Cursor 中的主模型增加一个“顾问”模型,在几个关键检查点提供更强或不同视角的第二意见。顾问只阅读简报和完整对话记录,进行深入思考后返回裁决与指导,不编辑文件;实际工作和最终决定仍由主模型完成。

用途 Advisor 模式用于在以下场景引入额外审查:做出重大技术决策之前、同一错误或失败测试经过两次真实修复尝试仍卡住时、准备宣布任务完成之前,以及用户主动要求咨询时。它旨在把强模型调用用在刀刃上,避免例行步骤也消耗顾问资源。

主要能力 模式管理:通过 /advisor 命令启用默认顾问(当前最新 Grok 模型及其最高推理档位),或指定一个可用于子代理的模型;/advisor off 关闭并删除 .cursor/advisor/;/advisor status 报告模型、咨询次数和回合结束提醒是否开启;/advisor ask <问题> 可随时就当前工作发起咨询;/advisor nudge on/off 切换插件 stop 钩子发出的回合结束提醒。

状态持久化:启用时写入 .cursor/advisor/state.json,记录 enabled、model、nudge、advisor_agent_id、conversation_id、transcript_path、consults、last_consult_at 和 enabled_at。插件的钩子会填充对话 ID、记录路径和咨询计数。该目录不应被暂存或提交。

咨询流程:主模型根据 references/briefing-template.md 构建简报,内容包括用户原始请求与后续约束、已做过的工作、相关工具输出原文(如错误信息、堆栈、测试输出、差异)、当前状态(git status、git diff 等)、具体问题与选项以及自身倾向。咨询时以 advisor-subagent 子代理前台运行,传入 state.model;若已有 advisor_agent_id,则通过 resume 续接,保持顾问的模型和此前上下文,简报可只写增量。返回的 agent id 会保存到状态文件。

裁决处理:顾问返回 proceed、proceed with changes 或 stop 三类结果。主模型按裁决行动;若建议与用户指令或已核实事实冲突,可跳过并说明原因;若顾问对代码库判断有误,可出示证据或推翻,并向用户解释。每次咨询以一两行向用户汇报,完整回复默认不贴入聊天,但钩子会追加到 .cursor/advisor/log.md。

使用方式 在 Cursor 对话中输入 /advisor 即可为当前对话启用默认顾问;/advisor <model> 使用指定模型;/advisor off 关闭;/advisor status 查看状态;/advisor ask <question> 即时咨询;/advisor nudge on/off 切换回合结束提醒。启用后可继续执行同一消息中的任务。若希望该技能在整个会话中保持上下文,可将 /advisor 作为自定义模式调用。

适用场景 适合需要第二意见的重大架构选择、难以回滚或影响面广的变更(如 schema 或数据迁移、删除或重写模块、公共 API 或配置格式变更、依赖替换、认证、支付等安全敏感代码)、含糊且会实质改变工作的请求、反复卡住的错误、以及任务完成前的逻辑变更审查。

限制 顾问只读,不能让它编辑文件或执行任务;每个检查点最多一次后续追问,避免反复循环;不要为常规步骤、可自行验证的事项或每个文件分别咨询;一个任务中若需咨询超过约四次,应考虑拆分任务或询问用户;若 advisor-subagent 不可用(无 Task 工具或被钩子拒绝),告知用户一次后继续。不得未经请求启用该模式;“获取第二意见”属于一次性咨询,不改变模式状态。简报中须隐藏令牌、密钥和 .env 值。当前资料未提供价格、平台兼容范围等更多信息。