用途:trellis-check 是 trellis 工作流中用于代码质量校验的技能,对最近编写的代码做综合验证,把规范符合度、跨层安全与提交前检查合并在一起。
主要能力与使用方式:先用 git diff --name-only HEAD 和 git status 确认改动范围;按顺序读取当前任务产物(prd.md、design.md、implement.md),并运行 python3 ./.trellis/scripts/get_context.py --mode packages。对每个改动的包/层读取规范索引 cat .trellis/spec/<package>/<layer>/index.md,再按其 Quality Check 章节与引用指南核对。随后运行项目的 lint、类型检查与测试命令,先修复失败项。检查清单覆盖:代码质量(linter、类型检查、测试是否通过,是否留有调试日志或抑制告警、绕过类型安全)、测试覆盖(新函数加单元测试、修复补回归测试、行为变更更新已有测试)、规范同步(是否需要更新 .trellis/spec/)、范围纪律(是否做了任务外的整理、为不存在的情况添加抽象或配置、无谓兜底、改动验收标准未提及的文件、在调用方而非行为实际所在处打补丁)。跨层维度仅当改动跨多层时展开:数据流(读流程 Storage→Service→API→UI、写流程 UI→API→Service→Storage,类型与错误是否正确传递)、代码复用(是否先检索已有相似代码,可用 grep -r "pattern" src/ 查找;只有代表同一稳定概念、调用方必须一起改的值才抽取复用)、导入依赖(相对/绝对路径、循环依赖)、同层一致性。
报告与修复:报告所有违规;机械且局部的问题就地修复并重跑项目检查;涉及设计或判断的问题(命名共享概念、移动模块边界、修改公共接口等)记录证据与建议后停止,不要静默改写;若修复会触及任务范围外的文件,应说明并停止,不要扩大改动。
限制:资料未提供该技能的其他运行环境要求、收费、性能或效果数据。