关于 fixflow
fixflow 是面向需要端到端工程交付的编码 Agent 技能,强调先完整规划、再按序实施并持续验证。它规定逐步提交等策略,并按需加入 BDD 或 TDD。
主要功能
- 01完整规划后再编辑
- 02按步骤执行并持续验证
- 03逐步提交并记录提交映射
- 04按需加入 BDD 与 TDD
- 05交付前进行测试验证
适用场景
- 01要求先计划再连续完成工程任务
- 02需要每个实现步骤通过检查后提交
- 03需求模糊时补充行为场景
- 04交付前要求完整测试并提供验证依据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ majiayu000/ spellbook --skill fixflow安装后在 Claude Code 中输入/fixflow确认已加载。
附带文件references/bdd-guide.mdreferences/delivery-base.md
详细介绍
Fixflow
概述
使用此技能,在一次运行中完成端到端工程工作:
- 完整制定计划。
- 严格按顺序执行。
- 持续验证。
- 明确提交策略(默认使用
per_step;按需使用final_only/milestone)。 - 按需或在需求不明确时添加 BDD 行为规范。
触发条件
用户提出以下一项或多项要求时,触发此技能:
- 完整计划并按顺序执行。
- 不考虑向后兼容。
- 交付前测试所有内容。
- 完成后提交,或每进行下一步前提交。
- 行为驱动交付(BDD)或验收场景。
工作流
1. 定义就绪标准(DoR)
参见共享交付基础:
references/delivery-base.md
2. 编辑前制定完整计划
参见共享交付基础:
references/delivery-base.md
3. 按需添加 BDD/TDD 层
用户提出要求,或需求不明确时,使用 BDD。
3.0 TDD 模式(RED -> GREEN -> IMPROVE)
用户要求使用 TDD 或测试驱动交付时:
-
RED — 先编写一个失败的测试
- 从需求中提取可测试的行为
- 编写最简测试用例,断言预期行为
- 运行测试,确认其失败(红)
- 如果测试意外通过 -> 说明需求已满足,或测试有误
-
GREEN — 编写最简实现
- 只编写足以让测试通过的代码
- 不做额外改进,也不顺手修改其他内容
- 运行测试,确认其通过(绿)
-
IMPROVE — 在测试保持通过的前提下重构
- 消除重复,改进命名,简化逻辑
- 每次重构后运行测试,确认没有回归
- 重构不得改变外部行为
覆盖率目标:新代码的行覆盖率达到 80%,关键路径达到 100%。
TDD 模式的触发条件:
- 用户说“ TDD”“测试驱动”或“先写测试”
- 用户说“先写测试,再写代码”
- 需求定义明确,输入和输出清晰
关于 BDD Lite、场景质量检查清单、场景大纲和测试层映射,请参阅共享参考文档:
4. 逐步执行
参见共享交付基础:
references/delivery-base.md
对于 per_step(默认策略):
- 仅暂存当前步骤涉及的文件。
- 运行步骤级检查。
- 步骤检查通过后立即提交。
- 记录步骤与提交哈希的对应关系。
5. 按需应用不考虑向后兼容模式
参见共享交付基础:
references/delivery-base.md
6. 使用测试矩阵验证(验证循环)
参见共享交付基础:
references/delivery-base.md
7. 提交并交接
参见共享交付基础:
references/delivery-base.md
防护准则
- 预期需要实现时,不要止步于制定计划。
- 不要留下未完成的计划步骤。
- 可以立即运行的必要测试,不要推迟。
- 不要默认使用
final_only;除非用户明确提出其他要求,否则使用per_step。 - 当
commit_policy = per_step时,提交前不要进入下一项计划步骤。 - 用户明确要求不进行兼容性工作时,不要声称具有兼容性。
- 不要将无关的既有未提交文件纳入提交。
- 没有具体的验证证据时,不要交接。
评论
支持 Markdown