用途:为行为变更型功能或修复工作提供测试驱动开发流程,适用于用户提及 TDD、test-first、red-green-refactor、tracer bullet 等场景。
核心规则:以垂直的红-绿-重构切片推进。RED 阶段为一个可观察行为写一个测试;GREEN 阶段实现能让该测试通过的最小生产代码变更;REFACTOR 阶段仅在测试全绿时清理。不要先批量编写臆想的测试再实现,每个新测试应回应上一轮循环对真实行为与接口的认识。
Plaited 默认约定:使用 bun test 做针对性测试,使用 bun --bun tsc --noEmit 做类型门禁;使用 test 而非 it,用 describe 组织;优先使用真实依赖和真实运行时边界而非 mock,仅在外部边界(远程 API、时间、随机性、罕见文件系统情况)使用 mock;避免条件断言,先断言分支,再断言分支特定值;对条件、回退和错误路径测试两个分支;测试公共接口与运行时契约而非私有辅助函数;遵循触及区域适用的仓库技能与 AGENTS.md 规则。
开始工作时:先探索代码库。若公共接口、预期行为或风险边界可从代码、测试或文档中发现,以证据为准而非询问用户。仅当决策无法发现且合理假设有风险时,提出一个简明的、附带推荐答案的问题。写生产代码前先确定:被测的公共接口或运行时边界、首个要证明的可观察行为、本轮的针对性测试命令、交付前需要的更广泛验证。
循环纪律:对每个行为,添加或更新恰好一个聚焦测试;运行针对性测试并确认因预期原因失败;只实现足够通过的代码;再次运行同一针对性测试并确认通过;如有益则重构后重跑受影响测试。若生产代码变更前测试已通过,则不是有效的 RED 信号,应收紧测试、换一个行为,或说明既有覆盖已证明该行为。
参考文件:references/tests.md(行为测试示例与实现细节危险信号)、references/mocking.md(仅边界 mock 指导)、references/interface-design.md(可测试的公共接口设计)、references/deep-modules.md(小接口深实现指导)、references/refactoring.md(绿色后运行的重构检查)。
限制:资料未提供安装命令、收费、价格、平台或效果信息。