用途:在跨仓库契约获批后,按契约精确实现已批准的后端范围。后端拥有契约,必须按发布内容实现,不得静默修改。建议在 /backend-tasks 产出计划后使用;契约不稳定或超出批准范围时不要启动。
主要能力:按切片执行,每次调用只实现一个切片。先批量读取上下文(context_manifest.read_once 与 reference 一次读完),再按依赖顺序对每个 task_id 做 TDD:先写失败测试(RED),再写最小实现(GREEN),最后重构。实现顺序为类型/模式→领域/服务→持久化→API/控制器,并补充校验、错误映射、日志/指标等横切关注点。
使用方式:编辑前阅读 CLAUDE.md、AGENTS.md、后端 LLD(.maestro/<slug>/lld/backend.md)与契约(.maestro/<slug>/openapi.yaml),列出拟改文件。遇到 DB 迁移、认证/权限、支付逻辑、生产配置或依赖升级,须先停下询问人工。带 group_id 与 tasks_path 调用时只实现该切片;无 tasks.json 时先经 /backend-tasks 生成,再顺序执行。每个任务先写失败测试,再最小实现,重构保持测试通过,运行针对性检查后进入下一任务;失败时调用 /fix。全部完成后运行 /verify 并对照标准清单。
标准要求:安全(授权、输入校验、参数化查询、输出编码、密钥不入代码/日志、保护 PII、安全反序列化、防 SSRF);向后兼容(默认增量、不删改字段、新字段有默认值);限流与滥用防护(配额、分页与载荷上限、超时、429+retry-after);幂等与重试;数据与迁移(expand→migrate→contract、可逆、索引、避免长锁);并发(事务、乐观锁/ETag、隔离级别);可观测性(结构化日志、指标、追踪、错误分类);性能(避免 N+1、限制查询成本);错误契约(返回契约错误信封与正确状态码)。
边界情况:空/缺失/超长/边界数值/非法枚举/畸形/重复/Unicode/注入载荷;未认证、过期令牌、权限不足、跨租户;并发写、超时重试、幂等键复用;下游故障、DB 错误、部分写入、超时回退;分页首末空页、无效游标、排序不稳定;限流触发、大结果集、时区/夏令时/数值精度。
外部技能:读取 skills.config.yaml 的 backend.external.tdd(默认 test-driven-development 或 none)驱动 RED→GREEN→REFACTOR,确保测试覆盖上述边界与契约负路径。
安全与验证:不得运行破坏性命令(rm -rf、force-push、DROP/TRUNCATE TABLE)或写生产配置/密钥。完成后调用 /verify(lint、类型检查、单元+集成、迁移检查、提供方契约验证),失败调用 /fix(最多 3 次)。完成条件:测试通过、标准逐项处理、边界测试存在、变更文件汇总、剩余风险列出、契约精确遵守。输出 branch、summary、tests_passed;切片模式还返回 worktree 与 tasks_done。