SuperAPI AI 工具集

contexts

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:在实现、修复或重构之前自动收集上下文。它把输入分类为面向代码库、面向文档或两者兼有,调用相应工作流,并在首行输出 detected: 确认信息。

主要能力:分类器按优先级判断模式。both 需同时存在仓库内信号(路径、glob、符号或模块)与外部信号(库、框架、SDK、API、CLI 或服务名);code-ref 仅有仓库内信号;doc-ref 仅有外部信号;ambiguous 为两者均未清晰检测到或都不占主导。当结果为 ambiguous,或两种信号都存在但模式不明确时,触发 AskUserQuestion 单选询问,选项为 code-ref、doc-ref、both,并在最接近的分类匹配上标记 Recommended。

使用方式:code-ref 调用代码库探索工作流,输出八个部分(任务理解、架构上下文、模式上下文、工具上下文、依赖图、关键文件摘要、约束与注意事项、建议后续步骤)。doc-ref 调用外部研究工作流,按五级来源阶梯(官方文档→API 参考→书籍/论文→教程→社区)给出带来源引用和置信度标签的结论。both 为顺序分派:先运行代码库探索,提取与外部主题相关的符号、模块和接口,再把这些符号列表作为额外上下文输入外部研究工作流,使研究基于实际仓库用法,最后依次输出两部分并清晰标注。顺序分派耗时约为单一模式的两倍,detected: 行会注明 (sequential dispatch: codebase first, then external)。

限制与注意:该技能为只读,收集上下文期间不得写入或编辑文件;detected: 确认行是承重输出,下游解析器和用户依赖它,不可跳过;分类器必须按顺序检查,both 要放在 code-ref 和 doc-ref 之前,否则在首个匹配获胜规则下 both 不可达;AskUserQuestion 必须单选,不可用 multiSelect。斜杠参数覆盖 /contexts code-ref、/contexts doc-ref 或 /contexts both 可绕过分类器直接分派。不适用于缺陷复现或根因调查(应使用调试工作流)、已在进行中的实现,以及没有实现前意图的纯分析输出。