SuperAPI AI 工具集

preflight

编程与开发

查看项目

更新于 10-16 01:35

技能介绍

用途:preflight 是编码智能体的预检分析器,在开始大型或模糊的编码任务前,估算任务是否可能超出可用上下文与执行预算,防止盲目执行。除非用户在预检报告后明确要求继续,否则不实现代码。

主要能力:按任务清晰度、涉及文件与模块数量、是否需要全仓库搜索、架构与依赖分析、数据库/API 变更、前后端协调、测试与迭代次数、级联变更风险等维度评估。输出分类包括输入上下文规模(Tiny/Small/Medium/Large/Massive)、仓库范围(单文件/少量文件/模块/功能/全仓库)、执行风险(Low/Medium/High/Extreme)、上下文饱和风险(Low/Medium/High/Critical)。

使用方式:当用户输入 /preflight,或提出大型重构、架构变更、迁移、全仓库改动、跨多文件功能实现、根因不明的缺陷修复、跨模块测试生成、大型代码库文档生成、性能工作、安全审计,以及“检查整个项目”“修复一切”“现代化”“清理”等请求时激活。不适用于单文件小改动、简单解释、小片段、无实现的直接提问、仅格式化改动。

输出结构:固定为预检报告,含任务摘要、预期范围、估算文件数(用区间而非虚假精确值)、复杂度、上下文饱和风险、执行风险、建议(Proceed / Proceed With Checkpoints / Split Into Subtasks / Create Subagents / Stop And Redesign)、建议执行计划(发现、实现、验证三阶段)与停止条件。

限制:无法预先知道精确 token 用量,只能基于仓库范围、文件数、复杂度、不确定性和迭代次数估算。若建议为拆分或停止重设计,或上下文饱和风险为 High/Critical、执行风险为 High/Extreme,必须先停止并请求用户明确确认,才能调用任何修改文件的工具。语气直接,不过度承诺,任务过大时明确说明。