test-driven-development

Test-Driven Development 技能评估

核心用法

本技能提供了一套完整的测试驱动开发(TDD)工作流，通过三种输入模式适配不同场景：Spec模式（解析.spec.md的Given/When/Then验收标准自动生成测试桩）、Task模式（从.code-task.md提取需求并设计测试场景）、Description模式（针对临时任务澄清需求后编写失败测试）。所有模式均遵循严格的RED → GREEN → REFACTOR循环。

技能强调模式发现前置步骤，要求通过ripgrep扫描现有测试文件，镜像本地命名规范、断言风格和辅助工具。测试位置规则明确：单模块用内联#[cfg(test)]，跨模块用crates/<crate>/tests/集成测试，CLI行为单独存放。

显著优点

1. 结构化流程：强制测试优先，杜绝"先实现后补测试"的反模式
2. 多模式适配：三种输入方式覆盖从正式规格到临时描述的全场景
3. 生态集成：内置proptest使用指南（纯函数、确定性输出、非平凡输入空间才启用），以及通过cargo tarpaulin生成覆盖率报告的backpressure机制
4. 可编程支持：调用ralph_core::preflight模块实现验收标准自动解析

潜在局限

• 高度依赖Rust生态系统（cargo test、proptest、cargo tarpaulin），跨语言适用性受限
• 覆盖率工具在部分环境可能无法运行，需回退到"针对性测试证据"
• 模式发现步骤假设代码库已有成熟测试范例，新项目可能缺乏参照

适合人群

Rust开发者、追求严格TDD纪律的团队、需要自动化验收标准追踪的工程项目。

常规风险

• 生成的测试桩若未经审查直接通过，可能产生"虚假绿色"（测试通过但未实际验证行为）
• proptest引入会增加编译时间和依赖复杂度，需严格遵循使用条件
• 覆盖率报告缺失时，completion事件的证据效力下降

核心用法

本 Skill 提供统一的测试驱动开发（TDD）工作流，支持三种输入模式：

• Mode A（From Spec）：解析 .spec.md 文件，自动提取 Given/When/Then 验收标准，生成带 todo!() 的 Rust 测试桩
• Mode B（From Task）：读取 .code-task.md 任务文件，识别需求后设计测试场景
• Mode C（From Description）：针对即兴描述的需求，澄清后编写失败测试

核心流程始终遵循 RED → GREEN → REFACTOR 循环：
1. RED：编写精确描述行为的测试，确认失败原因正确
2. GREEN：编写最小实现使测试通过，禁止额外功能
3. REFACTOR：在测试保持绿色的前提下优化代码

显著优点

• 模式化入口：三种输入模式覆盖从规范到即兴任务的完整场景
• 模式发现机制：通过 rg 搜索现有测试文件，强制镜像本地代码库约定
• 智能属性测试指导：明确 proptest 使用条件（纯函数、确定性输出、非平凡输入空间），避免滥用
• 覆盖率集成：内置 cargo tarpaulin 调用规范，要求完成事件携带覆盖率证据
• 反模式清单：明确禁止"先写实现再补测试""复制测试不改编"等常见错误

潜在缺点与局限性

• Rust 生态绑定：测试桩生成、覆盖率工具均假设 Rust 环境，跨语言适用性有限
• ralph_core::preflight 等 API 引用暗示特定内部框架依赖，外部用户需适配
• 无自动修复能力：纯文档型 Skill，不提供 AI 自动补全实现，仅输出方法论指导
• Shell 命令示例需人工审查：文档中的 rg、cargo 命令仅为示例，实际执行需用户判断

适合人群

• 已具备 Rust 基础、希望规范 TDD 流程的开发团队
• 使用 ClawHub/ralph 生态、需要与 ralph emit 事件系统集成的项目
• 追求高代码覆盖率、需要验收测试驱动（ATDD）规范的工程师

常规风险

• 低执行风险：纯 Markdown 文档，无动态代码执行、无网络请求（仅含 ClawHub 引用链接）
• 命令示例误用：用户可能直接复制文档中的 Shell 命令而未根据环境调整
• 许可证未声明：当前版本未明确许可证条款，商业使用需确认

安全评估

CLS-Certify 扫描显示：

• 六维评分均达 85-100 分，综合等级 S（95分）
• 静态/动态分析满分，无危险函数、无敏感信息泄露
• 零第三方依赖，供应链攻击面为零
• 隐私合规全通过（GDPR/CCPA）