SuperAPI AI 工具集

code-review-guardrails

测试与质量

查看项目

更新于 10-16 06:22

技能介绍

用途:审查 mosoo 变更的实际 diff 是否符合当前检出仓库的规则。使用前需先阅读 AGENTS.md、CONTRIBUTING.md、相关 PRD 与 docs/architecture.md;当技能与仓库文档冲突时,以当前项目文档和代码为准。每条发现需给出文件与行号、证据、用户或运行时影响及具体修复,不得把通用最佳实践当作阻塞项。

主要能力:检查是否重复实现现有平台能力(Cloudflare D1/Drizzle、Hono、GraphQL Yoga、Cloudflare bindings、现有 mosoo 服务与生成客户端);识别并行真相源或手改生成产物(GraphQL 源在 apps/api/src/adapters/graphql/graphql-module-specs.ts,schema.generated.graphql 与 apps/web/src/gql/** 为生成物,D1 schema 源在 pkgs/db/src/schema/**,0000_baseline.sql 冻结,后续迁移为追加链);检查 any、as unknown as、未校验反序列化等类型与边界问题;检查宽泛捕获、空 catch、静默回退与占位默认值;按风险匹配验证方式;审查新依赖、提交规范、App 与用户数据范围、架构边界及可观测性。

使用方式:按最小受影响范围验证,如 just fmt-check-path <path>、just tc-package <package>、just test-package <package>、just test-file <path>、just graphql-codegen、just check、just commit-check。D1 迁移遵循追加式规则,先看 just --list;本地可用 just db-reset-local,但仅限一次性本地状态。输出格式为 Review、Passed、Findings、Verification gaps、Verdict(PASS | PASS WITH NOTES | NEEDS CHANGES)。

限制:mosoo 当前没有安全的增量迁移生成配方,不得自行发明,也不得用破坏性基线重生成来演进既有迁移链;破坏性或数据重写 SQL 需明确批准及备份回滚方案;不得在无测量、日志、追踪或可复现冒烟的情况下声称性能、可用性或运行时健康。具体收费、价格与平台支持情况暂未提供。