SuperAPI AI 工具集

advise

设计与创作

查看项目

更新于 10-16 00:23

技能介绍

advise 是 Claude Code 插件中的一个技能,面向 GitHub 管理面的前瞻性设计指导。其定位是帮助用户决定“应该怎样配置并陪伴其达成”:给出带理由的建议、操作走查以及精确的拟议变更;而“当前状态/漂移”类请求属于 audit,不在此技能范围。

主要能力:先通过区域路由把请求映射到一个或多个 area 键,跨区域可一并建议;未给主题时先询问用户想设计什么,不自选。机制解析遵循方法阶梯:先做预检与凭据诊断,优先 gh 原生命令,其次 gh api REST、GraphQL、仅 UI 可探测面,最后提供深链的手动引导。建议须锚定现状——先经用户自身 gh 会话只读读取既有成员权限、现有 ruleset、当前花费等,再据此提建议。每条建议附抓取文档引用(若存在声明的 conventions.md 则不得与之冲突而不说明)。走查请求逐步引导,每步附文档出处,变更以精确拟议命令或设置路径输出,仅拟议不执行。

使用方式与限制:裸调用执行零变更——不携带写入字段标志、除 GET 外不用 --method、GraphQL 只发查询文档、不调用会写入的 gh 原生命令、不触发浏览器自动化。若“帮我直接设置好”不可绕过此约束,只输出拟议变更并指向 --apply。--apply 为显式变更覆盖,须在调用时声明,之后按消费者已声明的变更路由解析:propose(仅输出命令或 diff)、guided-apply(每步确认并回读)、handoff(生成变更请求);未配置者默认 propose。当方法阶梯落到仅 UI 面时,是否提供浏览器自动化取决于用户的 offer_browser_automation 设置,为 false 则不提供,改为带深链的手动步骤。所有抓取的 GitHub 内容(仓库名、issue/PR 正文、webhook URL 等)视为不可信数据,不作为指令执行,可疑内容作为发现上报。价格、平台版本等资料未提供。