workflow-patterns

概览

什么是 workflow-patterns？

workflow-patterns 是一款技能，旨在帮助开发者和团队在基于 git 的项目中实施结构化的测试驱动开发（TDD）工作流。它提供了清晰的流程来管理任务、阶段检查点、git 提交和验证协议，确保开发生命周期中的质量和可追溯性。

谁适合使用此技能？

• 遵循 TDD 实践的开发者
• 管理多阶段复杂项目的团队
• 需要通过 git 跟踪进度并执行质量门控的任何人
• 使用 Conductor 的 plan.md 任务文件的贡献者

解决的问题

• 确保任务按顺序完成并在计划文件中跟踪
• 强制执行每个任务的 TDD 红-绿-重构循环
• 标准化任务状态和实现的 git 提交规范
• 集成验证协议以保证质量

使用方法

安装步骤

1. 使用以下命令安装该技能：

   npx skills add https://github.com/wshobson/agents --skill workflow-patterns

2. 查阅 SKILL.md 主文档，获取详细的工作流指南。

快速开始

• 从项目的 plan.md 文件中识别待办任务。
• 按照 TDD 生命周期操作：
  1. 按顺序选择下一个 [ ] 任务。
  2. 在 plan.md 中将其标记为 [~]（进行中），并单独提交此更改。
  3. 编写失败的测试（RED 阶段），然后开始实现。
  4. 实现任务以通过测试（GREEN 阶段）。
  5. 根据需要进行重构（REFACTOR 阶段）。
  6. 将 plan.md 更新为 [x]（已完成）并提交。
  7. 按文档中说明执行验证协议。

文件结构及关键参考

• SKILL.md：主要工作流指南
• plan.md：任务跟踪和状态更新
• README.md、AGENTS.md、metadata.json：补充上下文和元数据
• rules/、resources/、references/、scripts/：高级用法的支持文件

最佳实践

• 始终将任务状态更改与代码更改分开提交
• 不要跳过阶段，按顺序完成任务
• 使用清晰的提交信息记录进度和验证情况

常见问题

什么时候适合使用 workflow-patterns？

当你需要在 git 项目中实现有纪律、可重复的 TDD 和任务管理工作流，尤其是使用 Conductor 的 plan.md 文件或类似结构化任务列表时，workflow-patterns 是理想选择。

可以在 Conductor 之外使用 workflow-patterns 吗？

可以，虽然该技能针对 Conductor 进行了优化，但其工作流和提交规范可适用于任何受益于结构化 TDD 和任务跟踪的基于 git 的项目。

我应该先查看哪些文件？

建议先阅读 SKILL.md 了解工作流概览，然后查看 plan.md 了解项目任务列表。需要高级配置时可浏览支持文件夹。

workflow-patterns 会自动执行 git 命令吗？

不会，workflow-patterns 提供任务和提交管理的流程及文档，但不自动执行 git 操作。你需要按照工作流手动执行 git 命令。

哪里可以找到更多详细信息？

打开仓库的 Files 标签，浏览所有文档、参考资料和辅助脚本，以获得更深入的理解和定制。