Agent skill
tdd-cycle
执行 TDD 红绿重构循环(RED→GREEN→REFACTOR→REPEAT),通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。
Install this agent skill to your Project
npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/execspec_fulfill/tdd-cycle
SKILL.md
TDD Cycle Skill
Scope: EXECSPEC_FULFILL — Fulfill ExecSpec(落实 ExecSpec)
版本: 0.1.0(占位)| 创建日期: 2025-11-27
概述
TDD Cycle 是测试驱动开发的核心循环:
┌─────────────────────────────────────────────────────┐
│ 🔄 TDD Cycle │
├─────────────────────────────────────────────────────┤
│ ┌─────┐ │
│ │ RED │ ← 写失败的测试 │
│ └──┬──┘ │
│ ↓ │
│ ┌─────┐ │
│ │GREEN│ ← 最小代码让测试通过 │
│ └──┬──┘ │
│ ↓ │
│ ┌──────────┐ │
│ │REFACTOR │ ← 重构,保持测试绿色 │
│ └────┬─────┘ │
│ └──────→ REPEAT │
└─────────────────────────────────────────────────────┘
核心节奏:
- 🔴 RED: 先写失败的测试
- 🟢 GREEN: 写最小代码让测试通过
- 🔵 REFACTOR: 重构代码,保持测试绿色
- 🔁 REPEAT: 循环直到功能完成
L1-STREAMLINED
检查清单
- 测试先于实现代码编写
- 每次 GREEN 后立即考虑重构
- 单元测试覆盖率 ≥ 80%
- 测试金字塔比例合理(60%单元/30%集成/10%E2E)
- GOAL 注释已添加到测试文件
通过标准
- 5 项中 4 项通过(≥80%)
>> 命令
>>tdd_check_l1 # 检查 TDD 节奏
>>coverage_report_l1 # 测试覆盖率报告
GOAL 注释规范
// GOAL: GOAL-XXX-001
describe('功能描述', () => {
it('should ...', () => {
// 测试代码
});
});
常见问题
🔴 RED 阶段
问题:测试写得太大 解决:每个测试只验证一个行为
问题:不知道先测什么 解决:从最简单的 Happy Path 开始
🟢 GREEN 阶段
问题:写了太多代码 解决:只写让测试通过的最小代码
问题:想一步到位 解决:接受"丑陋"的代码,重构阶段再优化
🔵 REFACTOR 阶段
问题:跳过重构 解决:每次 GREEN 后强制问自己"能更简单吗?"
问题:重构时破坏测试 解决:小步重构,每步都运行测试
相关 Skills
- 前置: bdd-scenario(BDD 场景已定义)
- 并行: code-quality(质量门禁)
- 原则: principle-dry, principle-kiss
TODO: 待细化覆盖率检查脚本和 TDD 节奏监控
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
code-review
执行代码审查流程(提交PR→自查→同行审查→反馈修改→合并),覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。
code-quality
执行代码质量门禁检查(测试通过→覆盖率→Lint→GOAL追溯→可提交),验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。
refactoring
执行代码重构(识别坏味道→选择手法→小步修改→运行测试),在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。
arch-options-compare
比较多个架构方案(单体/微服务等),从SOLID原则、成本、复杂度等维度评分,生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。
dev-tech-view-supplement
根据设计补充Dev视角的技术细节(数据库/API/通信协议),帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。
design-consistency-check
检查VS↔SD/DM一致性(value_path是否与序列图/数据模型匹配),生成不一致项清单和修复建议。当Self-Reflection报告一致性问题或准备CONSTRAINT验收前使用。
Didn't find tool you were looking for?