SuperAPI AI 工具集

tdd-plan

编程与开发

查看项目

更新于 10-15 20:08

技能介绍

用途:在开始任何新功能、产品或缺陷修复、写代码之前使用,把需求拆解为若干“薄垂直切片”,每个切片是系统行为上最小、可独立交付且能端到端测试的改动,并写成 plans/ 下的 Markdown 执行计划。该计划是后续 red-green-refactor 执行的契约,也会被 tdd-ci 和 safe-pr 读取。

主要能力:理解需求并用一两句话复述;只问会改变切片的必要问题(用户是谁、外部可观察行为、经过的边界如 Web UI/HTTP API/CLI、硬约束)。检测上下文:新系统还是既有系统,查看仓库的构建工具、现有测试与框架;若尚无可用构建/测试/部署路径,第一个切片必须是 walking skeleton。记录项目目录(根目录为 .,monorepo 子目录或 services/<x>、sandbox/ 等),后续阶段在该目录安装/测试/构建,CI 据此设置 working-directory 与 cache-dependency-path;git 分支始终在仓库根切出。垂直切片:每个切片贯穿所需各层(UI→逻辑→持久化)交付一个可观察行为,禁止水平切片。按 INVEST 校验每个切片,过大或不可测则再拆,无价值则丢弃,目标是一个开发者远不到一天能完成。写计划:创建 plans/<feature-slug>/,含 README.md 索引/状态板,以及每个切片一个 <NN>-<slice-slug>.md 执行计划,<NN> 为零填充序号。填写各节,关键是把验收标准写成 Given/When/Then,作为该切片失败的外层 e2e 测试,并给出初始单元测试列表。确认与交接:向用户展示切片列表(标题、一句话目标、建议的首个切片),获得签字后再写代码,然后提示对切片 01 运行 red-green-refactor;若使用 tdd-harness 编排器则交还控制权。

好计划的标准:一个切片一个行为;验收标准具体且从系统外部可观察,命名真实端点(URL、CLI 调用、API 调用)而非内部函数;明确列出范围外内容;计划可由他人仅凭计划文件执行。

输出:仅计划,本阶段不写生产或测试代码,交付物是 plans/<feature-slug>/ 下的 README 索引与每切片一个计划,外加给用户的简短切片摘要与推荐的首个切片。

限制:资料未提供具体安装命令、收费、价格、平台或效果信息。