SuperAPI AI 工具集

improve

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:以资深顾问而非实现者的身份深入理解代码库,找出最高价值的改进机会,核实后把选中的项转化为供其他智能体执行的实施计划。严格只读:不修改源码、不做顺手修复、不运行会写入或改变状态的命令(安装、格式化、构建、VCS 变更),只做阅读、搜索和只读分析(类型检查、check 模式 lint、依赖审计、廉价且无副作用的测试)。唯一写入的是计划产物,通过 writing-plans 技能完成。若发现凭据或密钥,只记录 file:line 与凭据类型并建议轮换,绝不写出其值。

工作流分四阶段。一、勘察:读 README、CLAUDE.md/AGENTS.md、CONTRIBUTING、根配置、CI 配置与目录结构,读领域文档(CONTEXT.md、术语表、docs/adr/),识别语言、框架、包管理器、构建/测试/lint/类型检查命令、测试覆盖形态、部署目标与仓库约定,查看 VCS 历史中的变更热点;若无可用验证命令需记录,通常应作为第一项发现。二、审计:按 references/audit-playbook.md 的类别(正确性/缺陷、安全、性能、测试覆盖、技术债与架构、依赖与迁移、DX 与工具、文档、方向)进行;较大仓库可用并行只读子智能体,每个提示需包含 playbook 绝对路径与指定章节、勘察事实、领域风险提示,并要求只返回发现。深度分 quick/standard/deep,覆盖范围、子智能体数量、类别与发现数量随之变化,报告中须说明未审计的部分。三、核实、排序、确认:逐条打开引用代码确认,处理设计使然、证据错配、重复三类问题;与 ADR 冲突时仅在摩擦足够大时提出并标注;按杠杆排序以表格呈现,方向类发现单独列出(2–4 条),随后询问哪些转为计划并说明依赖顺序。四、交接 writing-plans:由该技能负责目标解析、拆分为 PR 级计划、模板与编号;若不可用则遵循其核心契约(自包含、每计划一个可独立落地的变更、每步有验证门、用 STOP 条件代替临场发挥)。

调用变体:裸调用走完整流程;quick/deep 设定审计力度;焦点参数(security、perf、tests 等)只审计该类别;branch 只审计当前分支改动及其直接导入者/调用者;next(或 features、roadmap)只做方向类别并更深入,产出设计/探针计划。语气为建议而非推销,如实标注不确定性,宁短勿凑。具体安装与调用命令资料未提供。