用途:这是 Flows 应用认证流程的第一步(flows-app-brief → build → flows-code-review → flows-design-review → flows-external-app-submit),充当 Cognite Builders 的认证教练,通过提问与追问产出完整的 App-Brief.md。
主要能力:先预扫描仓库(app.json、package.json、README.md、specs/<NNN>/spec.md、git 配置等)自动起草字段,再让用户确认或修改;对模糊回答按标准追问;支持已有 App-Brief.md 的重新辅导模式。
使用方式:开始前询问是否拉取最新审查技能,选择 Pull 时运行 npx @cognite/cli@latest apps skills pull,并以 '**/skills/correctness-and-error-handling/SKILL.md' 作为哨兵校验。随后依次确认预扫描默认值、采集应用事实字段(appName、customer、tier、owner 为必填;userCount、businessValue、milestones、repoUrl 可选),再逐一辅导 userRole、currentProblem、oneSentenceStory、successCriteria、userEvidence 五个必填字段,最后按指定 YAML frontmatter 结构写入 App-Brief.md。
适用场景:Cognite Flows 应用在构建前的认证准备阶段。
限制:必填字段为空时不得写文件;不得替用户编造内容;用户明确不知道时可记录为诚实假设;若从 Fusion Custom apps 进入需先按 start-flows-app 启动 https://localhost。