SuperAPI AI 工具集

audit-architecture

测试与质量

查看项目

更新于 10-16 09:32

技能介绍

用途:对仓库做整树非确定性审计。与只检查 diff 的 /review 不同,它检查仓库中的每个文件,发现多次小改动累积的缓慢漂移。触发场景包括用户执行 /audit-architecture、每周定时漂移扫描、里程碑或版本发布前、大型重构之后。

运行方式:先用 git rev-parse --show-toplevel 从当前工作目录确定仓库根(非 git 仓库则用 cwd),所有提示中的路径均相对于仓库。然后在单条消息中并行启动八个 subagent_type=Explore 的只读子代理,各提示自包含(子代理没有对话上下文)。八个全部返回后,汇总生成聚合报告。

八个审计轴:一是分层、导入方向与包边界(client 与 cli 之间、client 内部 domain/resources 等方向的允许清单);二是类型严格性(as 断言、any、Record<string,unknown>、非空断言、ts-ignore 等);三是边界与流程纪律(fetch、JSON.parse、process.exit、环境变量、/api/ 字面量等模式的允许位置);四是测试配对(叶命令与 e2e、ALL_COMMANDS 列表、resources 单测、纯助手单测、fast-check 属性测试);五是 schema 与资源契约及死导出(Compact 的 .strip()、八条方法约定、列表窗口化、未被引用的导出);六是代码异味(静默吞错、占位默认值、无校验的边界解析、跨文件魔法字面量、布尔陷阱等)。

限制:这些子代理均为只读,不做任何编辑;资料中该技能说明文本在“类型守卫”一节处被截断,后续内容暂未提供。