用途:这是 Flows 应用认证流程中技术(代码)审查步骤的本地运行器,位于 flows-app-brief → build → flows-code-review(本技能,重复直到通过)→ flows-design-review → flows-external-app-submit 的链路中。审查标准与评分定义在 flows-review-checks 中,本技能不复制、不凭记忆评分,也不以测试覆盖率等修复技能替代审查标准。
主要能力:执行 git 与应用简报预检查(package.json 是否存在、是否在 git 仓库内、App-Brief.md 缺失时警告但继续);确定反馈轮次目录(reviews/code-review/ 下,不存在则用 feedback-round-1/,否则取下一个缺失轮号);以仓库根目录为工作目录;每次运行都从 cognitedata/builder-skills 拉取 flows-review-checks 与 code-quality 后再评分;按 flows-review-checks 要求完成检查、包审计、覆盖率、评分与分类,并写出四类产物:review-files.md、review-findings.md、review-packages.md、code-review-report.md。
使用方式:若工作区本身是 builder-skills 仓库,直接读取本地 skills/flows-review-checks/SKILL.md;否则先拉取:npx @cognite/cli@latest apps skills pull --skill flows-review-checks 与 npx @cognite/cli@latest apps skills pull --skill code-quality。拉取失败时可用 curl 从 main 分支获取同名 SKILL.md。随后 Glob '**/skills/flows-review-checks/SKILL.md' 并读取首个匹配文件,完整遵循其流程。
产物要求:code-review-report.md 需包含 flows-review-checks 要求的全部内容(执行的检查、覆盖范围、评分 1.1 与 1.3–1.6、2.1–2.6、3.1,以及带 Impact: 的 must/should/nice),并以规定的 Summary 块结尾,使用 Must Fix open、Should Fix open、Nice Fix open 标签。
限制与停止条件:重复运行本技能,直到最新一轮 code-review-report.md 中 Must Fix open: 0,才可进入 flows-design-review。资料未提供具体评分细则、检查项细节与 CLI 之外的平台要求。