SuperAPI AI 工具集

nv-implement

编程与开发

查看项目

更新于 11-06 03:07

技能介绍

nv-implement 是一个用于实现计划工作的技能,它将工作描述(计划文件、规格或工单)拆分成多个垂直切片,每个切片由一个子代理在独立的工作树上执行。该技能鼓励在预先约定的接缝处尽可能使用 TDD(测试驱动开发),定期运行类型检查和单个测试文件,并在最后运行一次完整的测试套件。

工作流程

  1. 划分接缝:将计划拆分成互不重叠的文件切片,每个切片可独立提交和测试。对于每个接缝,预先决定是否适合 TDD(如公共函数、用例、解析器)或通过 lint 验证(如无单元测试框架的仪表板 UI)。确保每个计划项恰好由一个切片负责,且没有两个切片编辑同一个文件。

  2. 解析特性分支并创建工作树:检测集成目标。如果已在特性分支上(非 next/main/master),则直接使用该分支;否则从 origin/next 创建新特性分支。然后为每个接缝创建一个工作树,并将依赖符号链接到每个工作树中。

  3. 并行分发子代理:在一个消息中启动所有切片子代理(并行任务调用,后台运行)。每个提示必须携带完整上下文,包括工作树路径、切片目标、要更改的文件、TDD 指令、测试命令等。子代理完成提交并运行 /nv-park-and-review 后,检查其摘要;跳过审查或测试未通过的子代理需要恢复而不是合并。

  4. 将切片合并回特性分支:在主检出目录中,切换到特性分支,按依赖顺序合并切片分支。合并后移除工作树并删除切片分支。

  5. 集成检查:切片是孤立审查的,接缝之间的交互未检查。预期会出现跨切片的影响,如一个切片更改了文案而另一个切片的测试断言旧字符串。进行类型检查、运行所有涉及的测试文件,并启动一个全差异代码质量审查子代理来修复有效发现的问题。

  6. 运行完整测试套件并清理:最后运行一次相关的完整测试套件,报告通过/失败计数,并解释任何不相关的失败。

命令(Novu)

  • API 类型检查:cd apps/api && pnpm exec nest build
  • 单个测试文件:使用 mocha 命令,具体见资料。
  • 仪表板大部分组件没有单元测试框架,通过 ReadLints 验证。

防护措施

  • 如果检出已在特性分支上,重用该分支,不要从 origin/next 分支或合并切片到 next。
  • 一个切片、一个工作树、一个分支——子代理在工作树外编辑会破坏兄弟切片。
  • 切片提交和审查重构提交保持独立,合并时不要修改或压缩。
  • 需要运行 API/数据库的端到端测试套件不在切片范围内,应标记给 CI。
  • 如果最终 PR 需要 Linear 工单,尽早创建;实现完成后交给 /novu-prepare-pr。

相关技能

  • /tdd:每个可 TDD 切片运行的红色-绿色循环。
  • /nv-park-and-review:每个切片的收尾审查。
  • thermo-nuclear-code-quality-review:第 5 步的全差异审计。
  • novu-prepare-pr:实现后的 PR 准备。
  • nv-worktree-commands:工作树调试参考。