嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载本篇技术指南完整讲解 FastLED 仓库内置的 TDDTest-Driven Development工作流即以红—绿—重构Red-Green-Refactor三阶段循环为核心的测试优先开发纪律。指南适用于在 FastLED 上实现新功能或修复缺陷的场景读者将掌握如何先编写失败测试、再以最小实现使其通过、最后安全重构并回归验证的完整闭环同时学会使用FL_前缀断言宏、bash test命令行入口以及按源码结构镜像摆放测试文件的仓库约定最终能独立为 FastLED 的任意功能编写高质量、可复现的单元测试。一、TDD 工作流总览Red-Green-Refactor 三阶段闭环FastLED 仓库在 .claude/skills/tdd/SKILL.md 中定义了一套供 Agent 与开发者共同遵循的 TDD 工作流。其核心不变量是严格的阶段纪律RED红先写一个能精确描述期望行为的测试运行并确认它如预期失败GREEN绿用最小的实现让测试通过禁止过早优化REFACTOR重构在不改变行为的前提下清理代码每步修改后都保持测试通过。三个阶段之间必须持续运行测试——在每一个阶段转换点运行测试是硬性要求non-negotiable。整个循环结束后输出一份包含功能描述、测试文件、源文件、测试数量与通过状态的结构化摘要。该工作流与 FastLED 庞大的头文件式模板库src/fl/下有 600 头文件高度契合由于大量逻辑是编译期模板单元测试是验证其行为最直接的手段。测试目录 tests/fl 按功能域chipsets/、audio/、fx/、stl/、gfx/等组织了 250 测试文件TDD 流程要求新测试尽量并入这些既有文件而非随意新建。二、RED 阶段先写一个失败的测试2.1 步骤与验收标准RED 阶段的目标不是写测试而是验证测试本身有效。标准流程为理解需求阅读相关源码弄清 API 与期望行为查找既有测试在tests/中搜索相关测试文件优先扩展它们先写测试创建最小测试描述期望行为运行测试执行bash test TestName确认它FAILS核验失败原因测试必须因功能缺失或缺陷存在而失败绝不能因编译错误或拼写错误而失败——若因编译错误失败说明测试本身无效需回到第 3 步修正。在仓库实践中RED 阶段对应的失败输出形如## RED Phase **Test file**: tests/fl/example.cpp **Test case**: Feature - expected behavior **Status**: FAILS as expected **Failure reason**: [why it fails — confirms the test is valid]2.2 测试约定从宏到文件摆放FastLED 的测试约定由 agents/tests.md 完整定义核心要求如下约定项要求断言宏必须使用FL_前缀的 trampoline如FL_CHECK_EQ、FL_REQUIRE_TRUE禁止直接调用底层测试框架宏头文件包含必须包含test.h与FastLED.h命名空间使用using namespace fl;并将测试辅助代码放入与测试名对应的匿名命名空间文件摆放镜像源码结构src/fl/foo.h→ 测试放在tests/fl/foo.cpp简单性不引入 mock、不使用辅助类保持最小 setup一个行为一个测试例如源码位于src/fl/stl/flat_map.h则测试应放在tests/fl/stl/flat_map.cpp源码位于src/fl/channels/uart_wave_encoder.h则测试放在tests/fl/channels/uart_wave_encoder.cpp。新文件只应在不存在任何相关测试时创建小缺陷修复一律并入既有测试。2.3 正确的断言宏选型agents/tests.md 明确要求使用语义精确的断言宏以换取更好的错误信息与类型安全相等FL_CHECK_EQ(A, B)/FL_REQUIRE_EQ(A, B)而不是FL_CHECK(A B)大小关系FL_CHECK_LT/FL_CHECK_LE/FL_CHECK_GT/FL_CHECK_GE对应 REQUIRE 版本布尔FL_CHECK_TRUE(x)/FL_CHECK_FALSE(x)字符串FL_CHECK_STREQ(a, b)/FL_CHECK_STRNE(a, b)浮点FL_CHECK_DOUBLE_EQ(a, b)/FL_CHECK_DOUBLE_NE(a, b)以及FL_CHECK_CLOSE(a, b, epsilon)这类带容差的比较异常/类型FL_CHECK_THROWS系列、FL_CHECK_TRAIT、FL_CHECK_UNARY等。完整的 trampoline 清单35 个遵循FL_底层宏名的统一命名模式覆盖 CHECK/REQUIRE 两大族、EQU/NE/LT/LE/GT/GE 六种比较、浮点、字符串、类型 trait、一元表达式与异常断言。例外地TEST_CASE/SUBCASE/TEST_SUITE等测试结构宏保持原名不加前缀CHECK_CLOSE/REQUIRE_CLOSE与DOCTEST_CONFIG_*也不转换。2.4 模板表达式逗号陷阱当向FL_宏传入含逗号的模板表达式时预处理器会把逗号当作宏参数分隔符导致编译期参数数量错误。解决方案是把整个模板表达式用括号包起来// ❌ 错误预处理器看到 3 个参数 FL_CHECK_EQ(int_scaleT1, T2(arg), expected) // ✅ 正确括号保护逗号 FL_CHECK_EQ((int_scaleT1, T2(arg)), expected) FL_CHECK_TRUE((std::is_sameA, B::value)) FL_REQUIRE_LT((map_rangeint, int, long(x, 0, 100, 0, 1000)), max_value)需要包裹的场景包括模板实例化funcT1, T2(...)、模板类型 traitstd::is_sameA, B::value、模板成员访问ContainerK, V::size()等不需要包裹的场景是普通函数多参数调用FL_CHECK_EQ(func(a, b, c), expected)逗号本就是函数实参分隔符和花括号初始化列表FL_CHECK_EQ(vec, {1, 2, 3})。三、测试框架底层从 doctest 到 fl::test 自研框架FL_宏并非凭空存在其底层是 FastLED 的自研测试框架fl::test。从 tests/shared/fl_unittest.h 可以看到该框架取代了外部 doctest 依赖提供完整的测试注册、执行与报告能力关键特性包括原生装饰器支持skip()与tags()装饰器FL_TEST_CASE(name, skip())即可跳过用例SUBCASE 重执行语义FL_SUBCASE通过线程本地上下文fl::ThreadLocalSubcaseCtx*跟踪嵌套路径并重新执行测试体表达式分解ExprDecomposer在断言失败时输出左右操作数与运算符字符串符号安全比较detail::EqImpl/SafeCompare通过 SFINAE 处理有符号/无符号混合整数比较避免隐式转换告警零外部依赖TestEntry注册表get_entries()用fl::vector实现断言宏全部基于record_assertion。tests/test.h 则是兼容层它把FL_*宏再映射回 doctest 风格的CHECK_*/REQUIRE_*别名并实现CHECK_CLOSE比较|a - b| epsilon与TestApprox容差近似类型。实际测试文件只需要#include test.h无需直接接触底层框架。在 RED 阶段一个真实的失败测试形态可以参考 tests/fl/clamp.cpp 中的FL_TEST_CASE(fl::clamp)结构——该文件用FL_SUBCASE按integer types、uint8_t、int8_t……直到double、edge cases组织断言并覆盖零范围min max、边界值与超大值等边界场景。四、GREEN 阶段最小实现与回归验证4.1 步骤GREEN 阶段的目标是以最简方式让测试转绿写最小实现——刚刚好能让测试通过不做任何超前设计运行bash test TestName确认PASSES运行完整 C 套件bash test --cpp确认无回归。## GREEN Phase **Implementation**: src/fl/example.h (lines X-Y) **Changes**: [brief description of what was added/changed] **Test status**: PASSES **Full suite**: All tests pass (no regressions)4.2 测试执行入口bash test 包装脚本.claude/skills/tdd/SKILL.md 明确要求始终使用bash test绝不直接运行裸python、meson或ninja并停留在项目根目录禁止cd进子目录。仓库根目录的 test 脚本内容为#!/bin/bash set -e cd $(dirname $0) uv run test.py $即bash test最终委托给 test.py 统一入口。常用命令语义详见 agents/docs/testing-commands.md命令作用bash test运行完整测试套件C 单元测试 示例 Python 测试bash test TestName构建并运行指定测试bash test --cpp仅运行 C 单元测试过滤到 unit testsbash test --clean从零重建禁止手动rm -rf .buildbash test --list-tests列出全部可用测试名后退出bash test --debug启用 ASan/UBSan 消毒器-Og -g3的调试构建测试自动发现机制见 tests/discover_tests.pytests/下的所有*.cpp/*.ino文件都会被 Meson 自动识别为测试源排除基础设施文件与EXCLUDED_TEST_DIRS中的目录无需手工注册。4.3 超时与挂死检测测试运行自带 10 秒超时看门狗若测试无输出挂死系统会自动附加 lldb/gdb 转储全部线程栈TEST HUNG输出再杀死进程并报告失败位置test.py内部还设有两级保护主看门狗 deadman timer 强制os._exit防止诊断本身被卡住。GREEN 阶段如果看到超时应依据栈回溯定位死循环或死锁后修复。五、REFACTOR 阶段增量清理与边界补强5.1 步骤审查代码寻找重复、命名不清、不必要的复杂度增量重构一次只做一个改动每步跑测试bash test TestName必须始终保持绿色补边界用例若存在明显的关键边界场景追加 1~2 个测试用例完整回归bash test --cpp确认一切通过。## REFACTOR Phase **Changes made**: [list of refactoring improvements] **Test status**: All tests still pass **Edge cases added**: [any additional test cases, or none needed]5.2 测试简单性原则REFACTOR 阶段特别强调测试即文档。仓库对测试设计的要求是绝对简单优先只测关键功能、一个聚焦的测试胜过十个冗余变体、避免 mock 框架与辅助类、测试状态显式且直接。例如测试一个Timeout的计数器回绕从0xFFFFFFFF越界到0x00000000行为直接构造uint32_t start 0xFFFFFF00; Timeout timeout(start, 512);然后断言done(start)与done(start 512)而不是搭建一整套 MockTime 基础设施。5.3 测试文件合并纪律为避免测试文件碎片化仓库要求最小化文件增殖优先把新用例并入既有TEST_CASE块、扩展既有文件、复用既有基础设施只有测试全新子系统、隔离功能域或复杂集成时才新建文件合并目录模式如tests/fl/fx/2d/下多个.cpp由父文件tests/fl/fx/2d.cpp统一#include需要在tests/test_config.py的EXCLUDED_TEST_DIRS中登记避免自动发现重复编译开发/修复期间允许临时测试文件快速迭代但完成前必须合并进主测试文件并删除临时文件。六、关键规则与 TDD 摘要输出6.1 不可违反的规则.claude/skills/tdd/SKILL.md 以 Key Rules 形式固化纪律永远不要在测试之前写实现代码NEVER write implementation code before the test永远不要跳过 RED 阶段——必须先亲眼看到测试失败保持测试简单——每个行为一个聚焦测试在每一个阶段转换点运行测试——不可协商停留在项目根目录——禁止cd到子目录使用bash test——禁止裸python、meson、ninja。配套约定还包括完成一轮 TDD 后应运行bash test全部测试而非仅--cpp并通过uv run mcp_server.py的validate_completion工具校验确保没有残留失败agents/tests.md 中后台 Agent 完成前必须全量跑测试的要求与 TDD 循环相互印证。6.2 结构化摘要三轮结束后输出统一摘要便于评审与追踪## TDD Summary **Feature**: [what was implemented] **Test file**: [path] **Source file(s)**: [paths] **Tests added**: [count and names] **All tests passing**: Yes/No七、完整实战速查一个 TDD 循环的最小命令序列将上述内容收敛为可直接执行的命令序列全程在仓库根目录# 1. RED先写失败测试放入既有相关测试文件然后 bash test TestName # 必须看到 FAILS且失败原因 功能缺失 # 2. GREEN写最小实现 bash test TestName # 必须看到 PASSES bash test --cpp # 全量 C 测试回归确认无副作用 # 3. REFACTOR逐小步清理 bash test TestName # 每步保持绿色 bash test --cpp # 收尾全量回归 # 4. 最终交付前 bash test # 完整套件含示例与 Python 测试全部通过如需清缓存重建则用bash test --cleanbash test --list-tests可随时查看可用测试名。这套以 Red-Green-Refactor 为核心、以bash test为唯一入口、以FL_断言宏与镜像目录为约定的工作流正是 FastLED 在 250 测试文件、1300 平台头文件的规模下保持高质量回归的工程基石。赞分享嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载相关推荐用 RED-GREEN-REFACTOR 驱动测试先行开发ag-kit 的 TDD 工作流实战指南用 RED GREEN REFACTOR 驱动测试先行开发ag kit 的 TDD 工作流实战指南 本文以 .agents/skills/tdd workfl人工智能AI 技能把电视盒改Linux变身2W家用服务器S905X3移植Armbian完整实战指南把电视盒改Linux变身2W家用服务器S905X3移植Armbian完整实战指南 一台吃灰的 X96 Max 电视盒加上 amlogic s9xxx ar嵌入式开发工具构建工具操作系统Ruby 测试驱动开发TDD实战用 RSpec 与 Red-Green-Refactor 循环驱动代码设计Ruby 测试驱动开发TDD实战用 RSpec 与 Red Green Refactor 循环驱动代码设计 导读 测试驱动开发Test Driven D文档教程教育上一篇告别繁琐3步实现GetX自定义导航过渡动画下一篇Momentum Firmware 开发板 USB 连接指南串口识别、双设备原理与故障排查创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 FastLED TDD 工作流实战：基于 Red-Green-Refactor 纪律的测试驱动开发指南
嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载本篇技术指南完整讲解 FastLED 仓库内置的 TDDTest-Driven Development工作流即以红—绿—重构Red-Green-Refactor三阶段循环为核心的测试优先开发纪律。指南适用于在 FastLED 上实现新功能或修复缺陷的场景读者将掌握如何先编写失败测试、再以最小实现使其通过、最后安全重构并回归验证的完整闭环同时学会使用FL_前缀断言宏、bash test命令行入口以及按源码结构镜像摆放测试文件的仓库约定最终能独立为 FastLED 的任意功能编写高质量、可复现的单元测试。一、TDD 工作流总览Red-Green-Refactor 三阶段闭环FastLED 仓库在 .claude/skills/tdd/SKILL.md 中定义了一套供 Agent 与开发者共同遵循的 TDD 工作流。其核心不变量是严格的阶段纪律RED红先写一个能精确描述期望行为的测试运行并确认它如预期失败GREEN绿用最小的实现让测试通过禁止过早优化REFACTOR重构在不改变行为的前提下清理代码每步修改后都保持测试通过。三个阶段之间必须持续运行测试——在每一个阶段转换点运行测试是硬性要求non-negotiable。整个循环结束后输出一份包含功能描述、测试文件、源文件、测试数量与通过状态的结构化摘要。该工作流与 FastLED 庞大的头文件式模板库src/fl/下有 600 头文件高度契合由于大量逻辑是编译期模板单元测试是验证其行为最直接的手段。测试目录 tests/fl 按功能域chipsets/、audio/、fx/、stl/、gfx/等组织了 250 测试文件TDD 流程要求新测试尽量并入这些既有文件而非随意新建。二、RED 阶段先写一个失败的测试2.1 步骤与验收标准RED 阶段的目标不是写测试而是验证测试本身有效。标准流程为理解需求阅读相关源码弄清 API 与期望行为查找既有测试在tests/中搜索相关测试文件优先扩展它们先写测试创建最小测试描述期望行为运行测试执行bash test TestName确认它FAILS核验失败原因测试必须因功能缺失或缺陷存在而失败绝不能因编译错误或拼写错误而失败——若因编译错误失败说明测试本身无效需回到第 3 步修正。在仓库实践中RED 阶段对应的失败输出形如## RED Phase **Test file**: tests/fl/example.cpp **Test case**: Feature - expected behavior **Status**: FAILS as expected **Failure reason**: [why it fails — confirms the test is valid]2.2 测试约定从宏到文件摆放FastLED 的测试约定由 agents/tests.md 完整定义核心要求如下约定项要求断言宏必须使用FL_前缀的 trampoline如FL_CHECK_EQ、FL_REQUIRE_TRUE禁止直接调用底层测试框架宏头文件包含必须包含test.h与FastLED.h命名空间使用using namespace fl;并将测试辅助代码放入与测试名对应的匿名命名空间文件摆放镜像源码结构src/fl/foo.h→ 测试放在tests/fl/foo.cpp简单性不引入 mock、不使用辅助类保持最小 setup一个行为一个测试例如源码位于src/fl/stl/flat_map.h则测试应放在tests/fl/stl/flat_map.cpp源码位于src/fl/channels/uart_wave_encoder.h则测试放在tests/fl/channels/uart_wave_encoder.cpp。新文件只应在不存在任何相关测试时创建小缺陷修复一律并入既有测试。2.3 正确的断言宏选型agents/tests.md 明确要求使用语义精确的断言宏以换取更好的错误信息与类型安全相等FL_CHECK_EQ(A, B)/FL_REQUIRE_EQ(A, B)而不是FL_CHECK(A B)大小关系FL_CHECK_LT/FL_CHECK_LE/FL_CHECK_GT/FL_CHECK_GE对应 REQUIRE 版本布尔FL_CHECK_TRUE(x)/FL_CHECK_FALSE(x)字符串FL_CHECK_STREQ(a, b)/FL_CHECK_STRNE(a, b)浮点FL_CHECK_DOUBLE_EQ(a, b)/FL_CHECK_DOUBLE_NE(a, b)以及FL_CHECK_CLOSE(a, b, epsilon)这类带容差的比较异常/类型FL_CHECK_THROWS系列、FL_CHECK_TRAIT、FL_CHECK_UNARY等。完整的 trampoline 清单35 个遵循FL_底层宏名的统一命名模式覆盖 CHECK/REQUIRE 两大族、EQU/NE/LT/LE/GT/GE 六种比较、浮点、字符串、类型 trait、一元表达式与异常断言。例外地TEST_CASE/SUBCASE/TEST_SUITE等测试结构宏保持原名不加前缀CHECK_CLOSE/REQUIRE_CLOSE与DOCTEST_CONFIG_*也不转换。2.4 模板表达式逗号陷阱当向FL_宏传入含逗号的模板表达式时预处理器会把逗号当作宏参数分隔符导致编译期参数数量错误。解决方案是把整个模板表达式用括号包起来// ❌ 错误预处理器看到 3 个参数 FL_CHECK_EQ(int_scaleT1, T2(arg), expected) // ✅ 正确括号保护逗号 FL_CHECK_EQ((int_scaleT1, T2(arg)), expected) FL_CHECK_TRUE((std::is_sameA, B::value)) FL_REQUIRE_LT((map_rangeint, int, long(x, 0, 100, 0, 1000)), max_value)需要包裹的场景包括模板实例化funcT1, T2(...)、模板类型 traitstd::is_sameA, B::value、模板成员访问ContainerK, V::size()等不需要包裹的场景是普通函数多参数调用FL_CHECK_EQ(func(a, b, c), expected)逗号本就是函数实参分隔符和花括号初始化列表FL_CHECK_EQ(vec, {1, 2, 3})。三、测试框架底层从 doctest 到 fl::test 自研框架FL_宏并非凭空存在其底层是 FastLED 的自研测试框架fl::test。从 tests/shared/fl_unittest.h 可以看到该框架取代了外部 doctest 依赖提供完整的测试注册、执行与报告能力关键特性包括原生装饰器支持skip()与tags()装饰器FL_TEST_CASE(name, skip())即可跳过用例SUBCASE 重执行语义FL_SUBCASE通过线程本地上下文fl::ThreadLocalSubcaseCtx*跟踪嵌套路径并重新执行测试体表达式分解ExprDecomposer在断言失败时输出左右操作数与运算符字符串符号安全比较detail::EqImpl/SafeCompare通过 SFINAE 处理有符号/无符号混合整数比较避免隐式转换告警零外部依赖TestEntry注册表get_entries()用fl::vector实现断言宏全部基于record_assertion。tests/test.h 则是兼容层它把FL_*宏再映射回 doctest 风格的CHECK_*/REQUIRE_*别名并实现CHECK_CLOSE比较|a - b| epsilon与TestApprox容差近似类型。实际测试文件只需要#include test.h无需直接接触底层框架。在 RED 阶段一个真实的失败测试形态可以参考 tests/fl/clamp.cpp 中的FL_TEST_CASE(fl::clamp)结构——该文件用FL_SUBCASE按integer types、uint8_t、int8_t……直到double、edge cases组织断言并覆盖零范围min max、边界值与超大值等边界场景。四、GREEN 阶段最小实现与回归验证4.1 步骤GREEN 阶段的目标是以最简方式让测试转绿写最小实现——刚刚好能让测试通过不做任何超前设计运行bash test TestName确认PASSES运行完整 C 套件bash test --cpp确认无回归。## GREEN Phase **Implementation**: src/fl/example.h (lines X-Y) **Changes**: [brief description of what was added/changed] **Test status**: PASSES **Full suite**: All tests pass (no regressions)4.2 测试执行入口bash test 包装脚本.claude/skills/tdd/SKILL.md 明确要求始终使用bash test绝不直接运行裸python、meson或ninja并停留在项目根目录禁止cd进子目录。仓库根目录的 test 脚本内容为#!/bin/bash set -e cd $(dirname $0) uv run test.py $即bash test最终委托给 test.py 统一入口。常用命令语义详见 agents/docs/testing-commands.md命令作用bash test运行完整测试套件C 单元测试 示例 Python 测试bash test TestName构建并运行指定测试bash test --cpp仅运行 C 单元测试过滤到 unit testsbash test --clean从零重建禁止手动rm -rf .buildbash test --list-tests列出全部可用测试名后退出bash test --debug启用 ASan/UBSan 消毒器-Og -g3的调试构建测试自动发现机制见 tests/discover_tests.pytests/下的所有*.cpp/*.ino文件都会被 Meson 自动识别为测试源排除基础设施文件与EXCLUDED_TEST_DIRS中的目录无需手工注册。4.3 超时与挂死检测测试运行自带 10 秒超时看门狗若测试无输出挂死系统会自动附加 lldb/gdb 转储全部线程栈TEST HUNG输出再杀死进程并报告失败位置test.py内部还设有两级保护主看门狗 deadman timer 强制os._exit防止诊断本身被卡住。GREEN 阶段如果看到超时应依据栈回溯定位死循环或死锁后修复。五、REFACTOR 阶段增量清理与边界补强5.1 步骤审查代码寻找重复、命名不清、不必要的复杂度增量重构一次只做一个改动每步跑测试bash test TestName必须始终保持绿色补边界用例若存在明显的关键边界场景追加 1~2 个测试用例完整回归bash test --cpp确认一切通过。## REFACTOR Phase **Changes made**: [list of refactoring improvements] **Test status**: All tests still pass **Edge cases added**: [any additional test cases, or none needed]5.2 测试简单性原则REFACTOR 阶段特别强调测试即文档。仓库对测试设计的要求是绝对简单优先只测关键功能、一个聚焦的测试胜过十个冗余变体、避免 mock 框架与辅助类、测试状态显式且直接。例如测试一个Timeout的计数器回绕从0xFFFFFFFF越界到0x00000000行为直接构造uint32_t start 0xFFFFFF00; Timeout timeout(start, 512);然后断言done(start)与done(start 512)而不是搭建一整套 MockTime 基础设施。5.3 测试文件合并纪律为避免测试文件碎片化仓库要求最小化文件增殖优先把新用例并入既有TEST_CASE块、扩展既有文件、复用既有基础设施只有测试全新子系统、隔离功能域或复杂集成时才新建文件合并目录模式如tests/fl/fx/2d/下多个.cpp由父文件tests/fl/fx/2d.cpp统一#include需要在tests/test_config.py的EXCLUDED_TEST_DIRS中登记避免自动发现重复编译开发/修复期间允许临时测试文件快速迭代但完成前必须合并进主测试文件并删除临时文件。六、关键规则与 TDD 摘要输出6.1 不可违反的规则.claude/skills/tdd/SKILL.md 以 Key Rules 形式固化纪律永远不要在测试之前写实现代码NEVER write implementation code before the test永远不要跳过 RED 阶段——必须先亲眼看到测试失败保持测试简单——每个行为一个聚焦测试在每一个阶段转换点运行测试——不可协商停留在项目根目录——禁止cd到子目录使用bash test——禁止裸python、meson、ninja。配套约定还包括完成一轮 TDD 后应运行bash test全部测试而非仅--cpp并通过uv run mcp_server.py的validate_completion工具校验确保没有残留失败agents/tests.md 中后台 Agent 完成前必须全量跑测试的要求与 TDD 循环相互印证。6.2 结构化摘要三轮结束后输出统一摘要便于评审与追踪## TDD Summary **Feature**: [what was implemented] **Test file**: [path] **Source file(s)**: [paths] **Tests added**: [count and names] **All tests passing**: Yes/No七、完整实战速查一个 TDD 循环的最小命令序列将上述内容收敛为可直接执行的命令序列全程在仓库根目录# 1. RED先写失败测试放入既有相关测试文件然后 bash test TestName # 必须看到 FAILS且失败原因 功能缺失 # 2. GREEN写最小实现 bash test TestName # 必须看到 PASSES bash test --cpp # 全量 C 测试回归确认无副作用 # 3. REFACTOR逐小步清理 bash test TestName # 每步保持绿色 bash test --cpp # 收尾全量回归 # 4. 最终交付前 bash test # 完整套件含示例与 Python 测试全部通过如需清缓存重建则用bash test --cleanbash test --list-tests可随时查看可用测试名。这套以 Red-Green-Refactor 为核心、以bash test为唯一入口、以FL_断言宏与镜像目录为约定的工作流正是 FastLED 在 250 测试文件、1300 平台头文件的规模下保持高质量回归的工程基石。赞分享嵌入式物联网硬件开发驱动开发【免费下载链接】FastLEDThe FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r Wed like to use github issues just for tracking library bugs / enhancements.项目地址https://gitcode.com/gh_mirrors/fa/FastLED点击查看免费下载相关推荐用 RED-GREEN-REFACTOR 驱动测试先行开发ag-kit 的 TDD 工作流实战指南用 RED GREEN REFACTOR 驱动测试先行开发ag kit 的 TDD 工作流实战指南 本文以 .agents/skills/tdd workfl人工智能AI 技能把电视盒改Linux变身2W家用服务器S905X3移植Armbian完整实战指南把电视盒改Linux变身2W家用服务器S905X3移植Armbian完整实战指南 一台吃灰的 X96 Max 电视盒加上 amlogic s9xxx ar嵌入式开发工具构建工具操作系统Ruby 测试驱动开发TDD实战用 RSpec 与 Red-Green-Refactor 循环驱动代码设计Ruby 测试驱动开发TDD实战用 RSpec 与 Red Green Refactor 循环驱动代码设计 导读 测试驱动开发Test Driven D文档教程教育上一篇告别繁琐3步实现GetX自定义导航过渡动画下一篇Momentum Firmware 开发板 USB 连接指南串口识别、双设备原理与故障排查创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考