关于 charted-green
一项测试技能,逐个启用已有代码的待办测试,并只做通过当前测试所需的修改。它还会更新设计文档中的指定进度标记,并在测试通过后停止。
主要功能
- 01以设计文档为唯一依据
- 02逐个启用已有实现的测试
- 03只做当前测试所需的实现修改
- 04更新指定进度复选框
- 05每次修改后运行测试
适用场景
- 01逐步实现测试文件中的待办测试
- 02将实现范围限制在当前测试
- 03在设计文档中记录已完成工作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ marmicode/ skills --skill charted-green安装后在 Claude Code 中输入/charted-green确认已加载。
详细介绍
上下文
- designDocPath:$ARGUMENTS[0]
- testFilePath:$ARGUMENTS[1]
目标
以 ${designDocPath} 中的设计文档为唯一事实来源,逐步启用 ${testFilePath} 中的测试。
步骤
- 将
${testFilePath}中的每项测试分类为:
- 已实现的测试:包含实际测试代码的测试(不只是空内容或注释)
- 空测试:内容为空或仅包含注释的测试——完全忽略这些测试
- 对于每项已实现的测试,将
it.todo(...)转换为it(...),但必须严格一次只处理一项测试,然后仅做足以让该特定测试通过的实现修改——除此之外一概不做。
不要实现与当前测试没有直接关系的任何内容。
-
当前测试通过后,更新
${designDocPath}中的进度(参见下方的设计文档进度)。 -
所有这些测试都通过后,停止。
-
如果已实现的条目已完成且可安全使用,请移除其中的 wiprecation(@deprecated 🚧 work in progress)jsdoc。
设计文档进度
每项测试通过后,更新 ${designDocPath},以反映已完成的工作。
将 🚧 改为 ✅,并将 - [ ] 改为 - [x]。不要编辑设计文档中的其他文本、标题、图表或结构。
仅勾选以下部分中的条目:
- PR 的测试策略——与刚刚启用的测试相匹配的
### 🚧 {test_title}标题。 - PR 的任务——所有工作已完成并经通过的测试验证的
- [ ] ...任务描述...条目。 - PR 计划——当该 PR 的所有任务和测试策略条目都已勾选时,勾选
## 🚧 {pr_title}条目。
如果不确定某项实现细节是否已完成,请保持未勾选。
规则
不要实现空测试。
绝不要编写测试。
只有在尝试其他所有方法后,才将修改测试作为最后手段。
设计文档只能修改复选框,或将 🚧 替换为 ✅。绝不要在 ${designDocPath} 中改写、重排、添加或删除内容。
每次修改后都要运行测试。只有当前测试通过后,才能继续处理下一项。
如果有 Wallaby Skill,请使用它运行测试;否则,按照项目推荐的方式运行测试。
评论
支持 Markdown