SuperAPI AI 工具集

legacy-codebase-recon

编程与开发

查看项目

更新于 10-15 17:29

技能介绍

用途:在改动陌生、遗留、文档缺失或高风险代码前做侦察,降低不确定性。产出不是补丁,而是一份简短侦察简报,说明已知、推断、未知以及风险最低的改法。

适用场景:旧代码、继承代码、高风险重构、跨归属边界的改动、触及旧抽象、删除疑似未使用代码,或依赖未被测试证明的行为。若代码已理解且改动局部、明确、有测试覆盖,则不必使用。

主要能力与工作流:先保护工作区,运行状态检查,未提交改动视为用户工作。侦察期间不编辑生产代码,可做只读搜索、查看历史、运行测试并创建临时产物。流程包括界定边界、映射代码、追踪历史与归属、证明行为、提取不变量、小心分类死路径、判断可编辑性。证据优先于叙事,可执行代码、测试、生成产物、运行行为与当前模式优先于陈旧文档和注释;事实与推断分离,无法证明即标未知。

证据标准:影响编辑计划的说法须引用文件与行、命令结果、测试或模式、提交或发布说明,或明确标注为推断。除非证据充分,避免“未使用”“平台所有”“可安全删除”等断言。

输出格式:实施前返回侦察简报,包含目标、地图、行为证据、历史与归属、不变量、死或休眠路径、风险、编辑边界、验证计划、未决问题,保持紧凑并附重要声明的文件引用。

限制:不替代直接实现;归属不清时标记未知;动态调用可能漏检,需查配置、生成代码、插件注册、反射、序列化名与构建标签;边界不清时应请求缺失决策而非大范围改动。命令如 git status --short、rg --files、git log --follow -- <path>、git blame -L <range> <path> 可按需使用。