SuperAPI AI 工具集

toise

通用与其它

查看项目

更新于 10-16 09:59

技能介绍

用途:Toise 是给 Claude 维护的代码库做周期性深度清理与结构评估的技能。当你不确定地基是否稳固(早期搭地基、项目中途漂移、规模压力、接手陌生仓库、重构后确认经验是否落地)时使用。它不用于刚完成功能的快速评审、一次性脚本,或只消费不修改的第三方库。

主要能力:分阶段运行。阶段一是测量,运行脚本 uv run --script <path-to-skill>/references/metrics.py <repo-path>,并读取 CLAUDE.md / AGENTS.md 与 .bon/understanding.md 作为上下文。阶段二是并行派出三个 agent:Cracks 看架构、边界与文档质量;Dustballs 看约定漂移、模式一致性与累积杂物;Goofs 找 bug、逻辑错误、安全隐患与未按配方扩展的代码。阶段三是综合,先给出“该担心吗”的诚实结论,再按视角分组列出发现并给原则评分(A-F),最多约 10 条高优先级发现。阶段四可将确认的发现用 bon new -q 归档为 outcome 与 action,需先询问用户哪些要归档。

五条原则:文件自说明、处处同一形状、边界即架构、小而纯且显式、按配方扩展。报告需引用具体文件、置信度 0.60 以上,避免编造、通胀评分和泛泛建议。限制:评估对象假定 Claude 为主要改码方;理解文档只读不写;最终决策留给维护者。