SuperAPI AI 工具集

validator-workflow

办公与效率

查看项目

更新于 10-15 20:32

技能介绍

用途:这是给验证型智能体(validator agent)使用的阶段级验证工作流。智能体被指派在构建者报告完成后验证某个阶段,其启动提示中会含阶段文件路径与计划目录。工作流用于避免浅层检查、遗漏模式偏差以及自动修复引入的问题。

主要步骤:0)加载项目规则,读取 ~/.claude/rules/coding-style.md 与 ~/.claude/rules/patterns.md,文件不存在则跳过(团队成员不会继承全部父级规则,仅有 alwaysApply 规则原生加载)。1)创建任务列表,先 TaskList 检查是否已有任务;无则用 TaskCreate 建立 [Review] 前缀任务并 TaskUpdate 设 owner。2)读取阶段文件,提取 frontmatter 中的 skill、验收标准、实现步骤、创建/修改的文件。3)运行代码评审:Skill({ skill: "code-review", args: "[phase-file-path]" }),会派生评审子智能体,对照阶段规格与代码库模式评审、自动修复 Critical/High/Medium 问题,并把评审写入 {plan-folder}/reviews/code/phase-{NN}.md。4)运行验证:若评审结论为 Ready 且零自动修复则完全跳过;否则运行 pnpm run typecheck 与 pnpm test。按阶段 skill 决定额外测试:react-form-builder、vercel-react-best-practices、web-design-guidelines、playwright-e2e 跑 E2E(pnpm test:e2e,可按关键词匹配 e2e/**/{keyword}.spec.ts 限定范围),postgres-expert 跑 pnpm test:db,server-action-builder 与 service-builder 单元测试即可;命令不存在则跳过并注明。5)判定:PASS 为评审 Ready、无未修复 Critical/High 且验证通过或跳过;FAIL 为存在未修复 Critical/High,或类型检查、测试、E2E、DB 测试失败。6)用 SendMessage 向 team-lead 汇报 PASS/FAIL、评审结论、评审文件路径、各项验证状态,失败时给出文件:行号、违反的模式与参考文件、确切修复内容、失败测试名与断言预期对比。7)进入空闲等待下一次指派。

续接:上下文压缩后以 TaskList 与元数据为准,从进行中或首个待办任务继续,不要重启验证。修改已有文件前必须先 Read,否则 Write 会静默失败,优先用 Edit。适用场景:多智能体协作下的分阶段开发验收;限制:具体项目规则文件、计划目录、测试脚本与 E2E/DB 配置由项目提供,未提供则跳过相应项。