SuperAPI AI 工具集

trellis-check

数据与分析

查看项目

更新于 10-15 23:49

技能介绍

用途:对最近编写的代码做综合质量验证,把规范符合度、跨层安全与提交前检查合并在一起。

主要能力与流程:

  1. 识别改动范围:使用 git diff --name-only HEAD 与 git status 查看变更文件。
  2. 读取适用规范:运行 python3 ./.trellis/scripts/get_context.py --mode packages,再按变更的包/层读取规范索引 cat .trellis/spec/<package>/<layer>/index.md,并继续阅读索引中引用的具体指南文件。
  3. 运行项目检查:执行项目自身的 lint、类型检查与测试命令,先修复失败项再继续。
  4. 对照清单复核:代码质量(linter、类型检查、测试是否通过,是否残留调试日志,是否压制警告或绕过类型安全);测试覆盖(新函数是否补单元测试、缺陷修复是否补回归测试、行为变更是否更新既有测试);规范同步(.trellis/spec/ 是否需要更新,例如新模式、约定或经验教训)。
  5. 跨层维度(仅当改动跨层时):数据流(读流向 Storage→Service→API→UI、写流向 UI→API→Service→Storage 是否正确,类型/模式是否跨层正确传递,错误是否向上传播);代码复用(新建前是否搜索既有相似代码,如 grep -r "pattern" src/,重复值是否抽为共享常量,批量修改后是否全部更新);导入/依赖(导入路径是否正确、有无循环依赖);同层一致性。
  6. 报告并修复:报告发现的违规并直接修复,修复后重新运行项目检查。

适用场景:代码提交前、跨多层改动后、修改常量或新建工具函数时。

限制:资料未提供具体支持的编程语言、平台、安装方式、收费与价格信息,也未给出各项目 lint、类型检查与测试命令的具体内容,需按所在项目实际配置执行。