SuperAPI AI 工具集

find-simplifications

编程与开发

查看项目

更新于 10-15 21:08

技能介绍

用途:把“找出可简化的地方”这类宽泛请求,转化为有证据支撑的 Agent Notes,用于删除或收敛代码、文档与技能中已有的表面。它是指导而非清单,强调跟随代码、保持判断,宁可给出少量证据充分的候选,也不要堆砌薄弱猜测。

主要能力:识别强候选,例如无生产消费者的公开方法、事件、配置项、注册通知、辅助函数、包、持久事件或测试产物;仅被测试或文档使用且行为非关键承载;同一事实存在两种表示(尤其持久事件与内存瞬时事件);接缝中所有实现都必须支持但无人使用的方法;仅为测试/演示/支持代码存在的独立包;无产品负责人的投机性通用设计;仅为保护未使用 API 而存在的不变量、回滚路径或特例测试;手写代码重复了成熟外部包或引擎内置能力且替换可删除实现及其专用测试。

使用方式:先读根 AGENTS.md 与仓库的防御模式、测试文档,浏览架构文档与 Agent Note 树;用 rg 搜索精确符号、事件名、包名、配置键、方法名及线上字符串,再读调用点;可用 knip 等死代码工具辅助,但不能替代对公开接口、动态事件名、测试、文档与加载路径的理解。按生产语料、非生产语料、模糊语料分类消费者。每个持久提案在 .agents/notes/<lifecycle>/<class>/yyyy-mm-dd-topic.md 下建一个文件,按 Problem、Proposal、Why not keep it、Acceptance criteria、Risks 结构撰写;小型本地清理用带稳定标签的内联 TODO/FIXME/XXX。

适用场景:仓库级简化审计、合并或收敛 Agent Note 树、折叠兄弟 PR 或分支中的简化想法。

限制:记录在案的架构孪生(双 LLM 适配器、双持久化后端)默认视为有意设计,除非用户明确覆盖;有生产调用方时属于功能决策而非清理;被已实现 Agent Note 或防御模式明确证成的 API 需新证据才能推翻;仅删除一个拼写错误、跑一次死代码工具或仅凭“看起来复杂”而无调用点证据的薄弱候选通常不足以形成 Agent Note。文档类工作至少运行仓库文档门禁、lint 与 git diff --check,例如 pnpm run doc-sync 加 pnpm run lint。