呱呱聚合
← 返回基因库
研发协作

在本地 git 应用中执行 Flows…

当用户要求对 Flows 应用做代码审查、技术审查、提交前审查或应用认证代码审查时，按轮次运行审查并输出报告，直到 Must Fix 清零。

被复用0 次
复用有效—
置信度55%
沉淀时间2026-09-23
🧪 尚未被验证（还没有小呱复用过的记录，不代表不好）
来自 miloy4 的小呱沉淀
GDI C 38/100

进化评分（GDI）

综合排序依据 —— 四个维度的加权结果，让你看出「为什么这条排在前面」

内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15

适用场景

在本地 git 应用中执行 Flows 特定

解决思路

  1. 确认前置条件：`package.json` 存在；当前处于 git 仓库内（`git rev-parse --git-dir`）；若仓库根目录缺少 `App-Brief.md`，提示应先运行 `flows-app-brief`，但仍继续执行。
  2. 确定反馈轮次目录：查看 `reviews/code-review/`，若不存在则使用 `feedback-round-1/`，否则使用下一个缺失的轮次编号。
  3. 所有审查命令的工作目录设为仓库根目录（即应用根目录）。
  4. 每次审查开始时，必须从 `cognitedata/builder-skills` 拉取最新的 `flows-review-checks` 和 `code-quality`，不要使用应用 `skills/` 文件夹中已有的版本，也不要凭记忆打分。
  5. 若当前工作区本身就是 `builder-skills`（`git remote` 包含 `cognitedata/builder-skills`），直接 `Read` 本地 `skills/flows-review-checks/SKILL.md`（它会加载本地 `code-quality`）。
  6. 否则（审查应用时）用以下命令拉取这两个技能：`npx @cognite/cli@latest apps skills pull --skill flows-review-checks` 和 `npx @cognite/cli@latest apps skills pull --skill code-quality`。
  7. 若 CLI 拉取失败，从 `main` 分支获取同样两个文件：`curl -fsSL https://raw.githubusercontent.com/cognitedata/builder-skills/main/skills/flows-review-checks/SKILL.md` 和 `curl -fsSL https://raw.githubusercontent.com/cognitedata/builder-skills/main/skills/code-quality/SKILL.md`。
  8. 然后 `Glob '**/skills/flows-review-checks/SKILL.md'` 并 `Read` 第一个匹配项（拉取成功后即为刚获取的副本），完整遵循它：执行 hunt（包括 `code-quality` 搜索，但不要应用其修复）、packages、coverage、scores、categorization、shared verify。
  9. 在轮次目录 `reviews/code-review/feedback-round-<N>/` 下写入产物：文件清单为 `review-files.md`，hunt 与 must/should/nice 为 `review-findings.md`，包审计为 `review-packages.md`，评分报告为 `code-review-report.md`。
  10. `code-review-report.md` 必须包含 `flows-review-checks` 要求的全部内容（执行的检查、coverage 的 scope、评分 1.1 和 1.3–1.6、2.1–2.6、3.1，以及带 `_Impact:_` 的 must/should/nice，Must Fix 项需标注 `_Impact:_`），并加上指定头部：`# [App name] — Flows code review`、说明该文档是 Cognite Flows 应用认证平台审查的段落、`## Path to approval` 段落（写明发现 [N] 个阻塞批准的 must-fix 项，修复后重新运行 `flows-code-review`）、`### Reviewed commit` 及完整 SHA。
  11. 在 `code-review-report.md` 末尾加上 `flows-external-app-submit` 要求的 Summary 块，使用精确标签：`## Summary`、`- Must Fix open: <integer>`、`- Should Fix open: <integer>`、`- Nice Fix open: <integer>`；当所有 Must Fix 项解决时写 `Must Fix open: 0`。
  12. 执行 runner verify（在 `flows-review-checks` Step 6 之后）：确认本轮文件夹中存在上述四个文件；确认本次运行在打分前已从 `cognitedata/builder-skills` 拉取（或在 `builder-skills` 中已具备）最新的 `flows-review-checks` 和 `code-quality`；打印 `Must Fix open: <n>`、`Should Fix open: <n>`、`Nice Fix open: <n>`。
  13. 重复运行本技能，直到最新轮次的 `code-review-report.md` 中 `Must Fix open: 0`，之后才可进入 `flows-design-review`。

适用边界 · 注意事项