SuperAPI AI 工具集

fresh-eyes-sweep

测试与质量

查看项目

更新于 10-16 07:56

技能介绍

用途:对指定 Git 范围做一次全仓库式的“新鲜视角”审计,基于证据找出正确性错误、缺陷、遗漏、重复、不一致,以及陈旧、重复或同义反复的测试,并修复每一个安全的问题。完成后需对映射到的每个文件都有交代;若确认无需改动(no-op),也需完整覆盖且未发现新问题才算合格,因此“成功”不要求必须产生编辑。

主要能力与流程:

  • 账本接口:用 uv run "<skill-dir>/scripts/sweep-ledger.py" init --root <repo> --ledger <scratch.json> [<path>...] 初始化仓库映射账本(不传路径则映射整个仓库);用 mark 记录每个路径的 inspected/fixed/reported/excluded 状态,excluded 必须写理由;用 pending 获取下一批未处理路径,用 summary 得到精确状态计数、完整性百分比与进度条。账本存在仓库外,可跨会话续跑。
  • 运行控制:--max-runtime 接受如 45m、3h 的正整数加单位形式;给定截止时间时先算出时限,保留最后 15% 用于汇总验证与报告,该窗口内不再开新修复,超时则报告带账本的不完整扫描。
  • 夜间自主:调用时读取本地时间,严格晚于 22:00 或早于 08:00 时整轮按自主模式运行,不提问、不等待确认,将歧义、阻塞和需审批的选项放入夜间待办清单,结束时以“发现”形式呈报,不扩大技能的权限。
  • 规划与分片:要求 Git,读取仓库说明,记录根目录、起始提交与状态;建立系统地图(入口、依赖方向、公开接口、生成物、数据接缝、不变量归属),按证据排优先级(正确性、数据丢失、安全、外部暴露的个人数据优先),发现构建/测试/lint/typecheck/format/codegen 检查并先建立基线。超过约 2000 文件且未指定路径时,自动切分为有界分片继续,不因文件数提问。
  • 子代理:可委派独立分片,评审并发默认上限 4,需事先一行说明 agent 数量与模型分组;写者只负责不重叠的写入范围,子代理与 worker 不提交,由协调会话串行提交检查点。
  • 检查与修复:按第一性原理先质疑“是否多余/过于复杂”,优先删除、再简化、再优化、最后自动化;追踪控制、数据、并发、错误路径;在外部与持久化数据接缝检查校验、单位、确定性排序、幂等、原子性、重试与分页、并发与取消、秘密与路径与命令安全。只修复可验证范围内的问题,不添加投机功能或大范围重构。
  • 测试与注释:删除同义反复、陈旧、无意义、锁死实现细节的测试,合并等价的重复测试,合并需保留每个断言、输入与失败信息,记录测试数量变化;注释只修明确 STALE、ORPHANED、MISLEADING、REDUNDANT 的情况,承载行为的注释(编译指令、许可证头、公开 API 文档、并发与安全契约)仅在工具语义被验证后改动,否则标记 reported。

限制与暂未提供:不执行破坏性、披露、购买、公开合同等需审批的操作;不使用仓库级 clean/checkout/reset;源代码超过 1000 行、测试超过 2000 行仅作发现线索,不单凭行数拆分。该技能的具体安装方式、依赖版本、收费与平台支持情况暂未提供。