在 VS Code 中设置测试驱动开发流程

测试驱动开发（TDD）是一种软件开发方法，即在实现功能之前先编写测试。这创建了一个紧密的反馈循环，有助于提高代码质量、尽早捕获错误并确保代码满足需求。Visual Studio Code 的 AI 功能可以通过指导您完成编写测试、实现代码、运行测试和优化代码的不同阶段，来增强您的 TDD 工作流。

本指南介绍了如何通过使用自定义代理、切换（handoffs）和自定义说明，在 VS Code 中设置 AI 辅助的测试驱动开发工作流。

实现概述

您可以使用自定义代理在 VS Code 中实现 AI 辅助的 TDD 工作流。TDD 过程的每个阶段（红、绿、重构）都有特定的目标，并且需要不同的 AI 行为。您可以为每个阶段创建一个自定义代理，定义该阶段的具体角色和指导原则。

借助自定义代理切换功能，一旦 AI 完成其任务，您就可以从一个阶段过渡到下一个阶段。这些自定义代理连接成一个循环，映射了 TDD 工作流：

• 红阶段 → 在编写失败测试后切换到 绿阶段
• 绿阶段 → 运行测试以验证实现，然后切换到 重构阶段
• 重构阶段 → 运行测试以确保它们仍然通过，然后切换回 红阶段以开始下一个循环

如果您已建立测试规范，可以使用 自定义说明 来设置测试上下文，指导 AI 生成符合您项目标准的测试。

下图展示了自定义代理如何协同工作以实现 TDD 工作流，以及切换功能如何实现阶段之间的平稳过渡。

第 1 步：设置测试指南

如果您已建立测试规范和实践，请创建一个自定义说明文件 (testing.instructions.md)，以帮助 AI 生成符合您项目标准的测试。

为什么这样做有帮助：如果没有明确的测试规范，AI 可能会生成不符合您项目风格、模式不一致或遗漏重要测试场景的测试。

要设置测试指南：

1. 在命令面板中运行 Chat: Create Instructions File 命令，在工作区中创建一个新的说明文件。

   • 选择 .github/instructions 以在您的工作区中创建说明文件。
   • 将说明文件的名称输入为“testing”。
   注意

   通过使用 *.instructions.md 文件而不是 copilot.instructions.md 文件，您可以有选择地将这些测试指南仅应用于项目中的测试文件，而不是将其包含在所有 AI 交互中。

2. 更新说明的 applyTo 元数据，以将其自动应用于测试文件。同时设置 description 元数据，以表明这些说明提供了测试上下文。

   以下示例将 applyTo 字段更新为以 tests/ 目录中的所有文件为目标：

   ---
   description: 'Use these guidelines when generating or updating tests.'
   applyTo: tests/**
   ---
   

3. 将您项目的测试指南添加到说明文件的正文中。

   以下示例为测试规范提供了一个起点：

   ---
   description: 'Use these guidelines when generating or updating tests.'
   applyTo: tests/**
   ---
   # [Project Name] Testing Guidelines
   
   ## Test conventions
   * Write clear, focused tests that verify one behavior at a time
   * Use descriptive test names that explain what is being tested and the expected outcome
   * Follow Arrange-Act-Assert (AAA) pattern: set up test data, execute the code under test, verify results
   * Keep tests independent - each test should run in isolation without depending on other tests
   * Start with the simplest test case, then add edge cases and error conditions
   * Tests should fail for the right reason - verify they catch the bugs they're meant to catch
   * Mock external dependencies to keep tests fast and reliable
   

   提示

   您可以创建一个可选的测试结构模板，定义不同测试类型的节和模式（例如 test-template.md）。在您的说明文件中引用此模板，以便 AI 在生成测试时使用它。

第 2 步：创建“红”阶段自定义代理

创建一个“TDD-red”自定义代理，专注于 TDD 的红阶段。该自定义代理仅负责根据提供的需求编写失败的测试，不应实现任何应用程序代码。完成后，该代理将切换到绿阶段的自定义代理。

为什么这样做有帮助：如果没有专门的模式，AI 可能会将实现建议与测试创建混在一起，并错失 TDD 先编写测试的核心原则。

要创建 .github/agents/TDD-red.agent.md 红阶段 自定义代理：

1. 在命令面板中运行 Chat: New Custom Agent 命令。

   • 选择 .github/agents 以在您的工作区中创建自定义代理定义。
   • 将自定义代理的名称输入为“TDD-red”。

2. 更新自定义代理定义，描述红阶段的指南和规则，并指定切换到绿阶段的自定义代理。

   以下 TDD-red.agent.md 文件为红阶段提供了一个起点。

   ---
   name: TDD Red
   description: TDD phase for writing FAILING tests
   infer: true
   tools: ['read', 'edit', 'search']
   handoffs:
     - label: TDD Green
       agent: TDD Green
       prompt: Implement minimal implementation
   ---
   You are a test-writer: when given a function name, spec, or requirements, output a complete test file (or test function) that asserts the expected behavior, which must fail when run against the current codebase. Use the project’s style/conventions. Do not write implementation, only tests.
   

第 3 步：创建“绿”阶段自定义代理

创建一个“TDD-green”自定义代理，专注于 TDD 的绿阶段。该自定义代理仅负责编写使测试通过的最少实现代码，而不修改测试代码。实现后，该代理运行测试以验证它们是否通过，然后切换到重构阶段的自定义代理。

要创建 .github/agents/TDD-green.agent.md 绿阶段 自定义代理：

1. 在命令面板中运行 Chat: New Custom Agent 命令。

   • 选择 .github/agents 以在您的工作区中创建自定义代理定义。
   • 将自定义代理的名称输入为“TDD-green”。

2. 更新自定义代理定义，描述绿阶段的指南和规则，并指定切换到重构阶段的自定义代理。

   以下 TDD-green.agent.md 文件提供了一个起点：

   ---
   name: TDD Green
   description: TDD phase for writing MINIMAL implementation to pass tests
   infer: true
   tools: ['search', 'edit', 'execute']
   handoffs:
     - label: TDD Refactor
       agent: TDD Refactor
       prompt: Refactor the implementation
   ---
   
   You are a code-implementer. Given a failing test case and context (existing codebase or module), write the minimal code change needed so that the test passes - no extra features. Do not write tests, only implementation.
   
   After implementing changes, run the tests to verify they pass.
   

第 4 步：创建“重构”阶段自定义代理

创建一个“TDD-refactor”自定义代理，专注于 TDD 的重构阶段，旨在在保持所有测试通过的同时提高代码质量。该代理负责清理代码、消除重复、改进命名并增强结构，而不改变功能。重构后，该代理运行测试以确保它们仍然通过，然后切换回红阶段以开始下一个 TDD 循环。

要创建 .github/agents/TDD-refactor.agent.md 重构阶段 自定义聊天代理：

1. 在命令面板中运行 Chat: New Custom Agent 命令。

   • 选择 .github/agents 以在您的工作区中创建自定义代理定义。
   • 将自定义代理的名称输入为“TDD-refactor”。

2. 更新自定义代理定义，描述重构阶段的指南和规则。

   以下 TDD-refactor.agent.md 文件提供了一个起点：

   ---
   name: TDD Refactor
   description: Refactor code while maintaining passing tests
   tools: ['search', 'edit', 'read', 'execute']
   infer: true
   handoffs:
     - label: TDD Red
       agent: TDD Red
       prompt: Start next TDD cycle with new test
   ---
   You are refactor-assistant. Given code that passes all tests, examine it and suggest or apply refactoring to improve readability/structure/DRYness, without changing behavior. No new functionality, no breaking changes.
   
   After refactoring, run the tests to ensure all tests still pass and behavior is preserved.
   

使用 TDD 工作流实现功能

现在 TDD 自定义代理已设置完毕，您可以使用 TDD 工作流在项目中实现功能。

1. 打开 Chat 视图，从代理下拉菜单中选择 TDD Red 代理。

2. 提供一个描述您想要测试的功能或行为的提示词。

   例如

   Write tests for user registration with email validation and password requirements.
   

3. 审查生成的测试，并使用切换操作在 TDD 循环中过渡：

   • 测试编写完成后，选择 TDD Green 以实现使测试通过的最少代码。
   • 绿代理在实现后会自动运行测试。
   • 测试通过后，选择 TDD Refactor 以提高代码质量。
   • 重构代理在重构后会自动运行测试，以确保它们仍然通过。
   • 选择 TDD Red 以开始包含额外功能的下一个循环。

故障排除与最佳实践

AI 执行 TDD 时的常见陷阱

在没有切换的情况下运行 TDD：使用单个代理完成整个 TDD 循环会让开发人员脱离循环。切换提供了控制点，使您可以在进入下一阶段之前评估每个步骤、验证 AI 的工作并引导代理朝着正确的方向发展。

功能测试覆盖率缺失：TDD 代理专注于使现有测试通过，不会实现没有相应测试的功能。在期望实现包含某个需求之前，请确保规范中的每一项需求都有测试覆盖。

跳过红阶段：AI 可能会建议在编写测试之前实现代码。

过度实现：AI 可能会生成比通过当前测试所需更多的代码。请批判性地审查实现并删除不必要的复杂性。

测试实现细节：测试应该验证行为，而不是实现。如果重构需要更改测试，那么这些测试可能与实现细节耦合得太紧密了。

测试覆盖不完整：AI 可能会遗漏边界情况或错误条件。请批判性地审查生成的测试，并要求补充覆盖边界条件、错误场景和极端情况的测试。

AI 执行 TDD 的最佳实践

为任务选择合适的模型：不同的语言模型有不同的优势。考虑对复杂的测试生成和边界情况识别使用推理模型。在 Chat 视图中使用模型选择器在 TDD 工作流期间切换模型，或在自定义代理属性中定义 model。

验证测试质量：在 AI 生成测试后，对其进行审查以确保它因为正确的原因而失败。在实现之前运行测试，以验证它是否捕获到了缺失的功能。

保持增量进度：在 TDD 循环中采取小步骤。编写一个测试，实现最少代码，重构，然后重复。小的迭代可以防止严重的错误，并保持代码库正常工作。

频繁运行测试：在更改后立即执行测试。不要在测试之前累积多个更改。频繁运行测试可以提供快速反馈并尽早发现问题。

使用测试覆盖率作为指南：高覆盖率并不能保证质量，但低覆盖率表明存在未经测试的行为。要求 AI 为未覆盖的代码路径建议测试。

保持测试独立性：测试应该能够以任何顺序运行而不互相影响。如果测试依赖于执行顺序或共享状态，请进行重构使其独立。

根据需要更新测试上下文：随着项目的演进，请更新说明文件中的测试指南，以反映新的规范、框架或实践。

相关资源

了解更多关于 VS Code 中的测试和 AI 自定义的信息

• 使用 AI 进行测试
• 自定义代理
• 自定义指令
• 在 VS Code 中运行测试