SuperAPI AI 工具集

flows-review-checks

智能体与模型

查看项目

更新于 10-16 05:02

技能介绍

该文件是 Flows 技术评审的公开规范,定义评审必须在本仓库中搜索什么、每档严格程度如何,以及如何为 1.1、1.3–1.6、2.1–2.6、3.1 等公开标准打分。它本身不决定是否构建应用、使用 Codespace 还是本地、Jira/Zendesk/git 相关目录,以及产物输出路径(reviews/code-review/… 还是 reviews/external-submissions/…);这些都由调用方设定,调用方随后读取本文件并逐项执行检查。规范要求不得修改应用、不得立即修复。

主要能力:

检查项猎取(Step 1)——运行每个命令,不得只抽样 src/。

1.1 覆盖率与测试配置(标准 1.4):先读 vitest.config.、vite.config.(test/coverage 块)与 jest.config.*,再执行示例命令:

grep -n -A 40 -E "coverage|exclude|include|coveragePathIgnorePatterns|collectCoverageFrom|testPathIgnorePatterns" vitest.config.ts vitest.config.mts vitest.config.js vite.config.ts vite.config.mts jest.config.ts jest.config.js jest.config.mjs 2>/dev/null

记录 coverage.exclude / coveragePathIgnorePatterns / 反向 coverage.include(未被度量的文件)以及 test.exclude / testPathIgnorePatterns(永不运行的测试)两份清单。允许的覆盖率排除项为 .test.、.spec.、vite-env.d.ts、src/main.tsx、生成代码;src/ 下其他文件不得排除。若生产文件被排除,打印的覆盖率数字无效,标准 1.4 判定为 1 或 2,即使 Vitest 显示 ≥ 80%。

1.2 正确性(标准 1.1):用 grep 检查 ErrorBoundary 等、TODO/FIXME/HACK/XXX、useEffect、useQuery/useMutation/isLoading/isPending/isError,标记缺少 ErrorBoundary、无加载/错误/空状态、useEffect 无清理、关键路径 TODO。

1.3 CDF Raw(标准 2.6):grep client.raw. 等,无命中则 2.6 记 N/A。

1.4 DMS 与限制(标准 2.1–2.5):grep instances.list/search/query/aggregate/retrieve、QueuedTaskRunner/cdfTaskRunner、429/Retry-After/exponential/backoff。

1.5 质量与可测试性(标准 1.5、1.6):从同一 cognitedata/builder-skills 仓库加载 skills/code-quality/SKILL.md(本地或 curl),以其作为基准但不应用其修复;运行该技能中的全部搜索命令,包括 any/vi.mock/createContext/useContext、new CogniteClient、lint、tsc、组件行数统计及未使用文件检测。

用途:作为评审的执行标准与打分基准,调用方负责确定评审范围、输出路径并触发检查;每个后续评分都必须指向本次猎取结果。

限制:规范不决定构建与流程类事项,不决定产物路径;不负责修复;不得修改应用。资料未提供该文件在具体产品中的收费、平台与效果信息。