用途
implementation-agent 是一个用于 Ruby on Rails 项目的 TDD 实现型技能,专门负责 TDD 循环中的 GREEN 阶段。TDD 循环为 Red → GREEN → Refactor,本技能处在中间环节:在测试已经被写好并处于失败状态后,通过实现最小可用代码让测试通过。它明确声明自己工作于 @tdd_red_agent 写出失败测试之后,并在完成后交由 @tdd_refactoring_agent 改进代码结构。
主要能力
- 分析失败的测试输出,判断被测功能是什么、需要哪一层实现、涉及应用的哪些层。
- 根据失败类型自动委派给专家子智能体(通过 runSubagent 工具)。
- 覆盖从数据库到前端的多个层面,可处理的委派包括:数据库迁移、ActiveRecord 模型、业务服务对象、Pundit 授权策略、控制器、ViewComponent、Tailwind 样式、表单对象、后台任务、ActionMailer 邮件、Turbo、Stimulus、Presenter/Decorator、复杂查询对象。
- 在多层改动时按依赖顺序编排委派:数据库(迁移 → 模型)→ 业务逻辑(服务 → 查询)→ 应用层(控制器 → 策略)→ 展示层(Presenter → ViewComponent → Stimulus)。
- 每次子智能体完成实现后运行对应测试文件验证,全部通过后运行完整测试套件与 rubocop。
使用方式
该技能声明了自己在 Rails 项目中的具体技术栈与架构约定,并给出可直接运行的命令:
- 运行全部测试:
bundle exec rspec - 运行指定文件:
bundle exec rspec spec/path/to_spec.rb - 运行指定行:
bundle exec rspec spec/path/to_spec.rb:25 - 详细格式:
bundle exec rspec --format documentation spec/path/to_spec.rb - 快速失败:
bundle exec rspec --fail-fast - 仅失败用例:
bundle exec rspec --only-failures - Lint 自动修复:
bundle exec rubocop -a - 指定路径 Lint:
bundle exec rubocop -a app/models/ - 控制台:
bin/rails console
其工作流程为:分析失败测试 → 自动委派给对应专家子智能体 → 多层时按依赖顺序委派 → 每个子智能体完成后运行测试验证是否 GREEN → 全部通过后运行完整测试与 Lint 并报告完成。委派时传给子智能体的上下文包括:失败的测试文件、具体错误信息、清晰的实现要求、测试期望的行为。
文档中给出了若干委派示例,例如:测试报 uninitialized constant Product 时,先用 @migration_agent 创建 products 表,再用 @model_agent 实现 Product 模型;测试报 undefined method 'call' 时,用 @service_agent 实现 Orders::CreateService;请求测试同时缺失表、模型、控制器、策略时,按迁移 → 模型 → 策略 → 控制器的顺序委派。
适用场景
适用于采用 Ruby 3.3、Rails 8.1、Hotwire(Turbo + Stimulus)、PostgreSQL、RSpec、FactoryBot、Shoulda Matchers、Capybara、Pundit 技术栈,并已按文档所述目录结构组织代码的 Rails 项目。典型使用时机是:已经由 TDD Red 阶段写好失败测试,希望由智能体驱动完成最小实现让测试转绿。常见实现流程包括:新模型功能(迁移 → 模型)、新端点(迁移 → 模型 → 策略 → 控制器)、业务服务(服务,可选配合查询、任务、邮件)、UI 组件(ViewComponent → Stimulus)、后台处理(任务 → 邮件)。
边界与限制
该技能定义了明确的行为边界:始终要在每次实现后运行测试、委派给专家子智能体、实现最小方案;在添加测试未要求的功能前需要先询问;绝不允许修改测试文件、过度设计、跳过改动后的测试运行。其核心原则是最小实现(只实现测试明确要求的内容)与 YAGNI,不预先添加“以防万一”的功能,不过早优化。它明确列出要避免的反模式,包括添加测试未要求的功能、自己编写测试、过度工程、跳过子智能体委派、不在每次改动后运行测试、为了让测试通过而修改测试。此外,spec/ 目录被标注为只读(测试已由 @tdd_red_agent 写好)。
成功标准
全部测试通过(GREEN)、实现最小、代码遵循 Rails 约定、Rubocop 通过、每一层由合适的专家处理。
暂未提供的信息
该技能的价格、收费模式、平台可用性等商业信息在资料中暂未提供。