关于 workflow-orchestration
workflow-orchestration 是一项面向 Agent 的技能,通过规划、分派、验证和从修正中总结经验来组织复杂任务。它还提供实施与复查的任务跟踪方法。
主要功能
- 01将任务拆为可检查步骤
- 02分派研究和并行分析
- 03在收到修正后记录经验
- 04完成前验证结果
- 05跟踪进度并记录复查
适用场景
- 01规划多步骤实施工作
- 02将研究分配给子 Agent
- 03验证失败后重新规划任务
- 04记录反复出现的问题与经验
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ vxcozy/ workflow-orchestration --skill workflow-orchestration安装后在 Claude Code 中输入/workflow-orchestration确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSE.gitignoreREADME.mddocs/explanation.mdhowto.mdtutorial.mdreferences/task-templates.mdlessons-format.mdREFERENCE.md详细介绍
工作流编排
遵循这些实践,严谨、高质量地执行任务。
快速参考
| 实践 | 何时应用 |
|---|---|
| 计划模式 | 任何包含 3 个或更多步骤,或涉及架构决策的任务 |
| 子 Agent | 研究、探索、并行分析 |
| 经验教训 | 用户提出任何更正后 |
| 验证 | 将任何任务标记为完成前 |
| 优雅性检查 | 仅针对非平凡的更改 |
1. 默认使用计划模式
- 对任何非平凡任务(3 个或更多步骤,或涉及架构决策)进入计划模式
- 如果进展不顺利,立即停止并重新规划
- 验证步骤也要使用计划模式,而不仅仅是构建时
- 提前编写详细规格,减少歧义
2. 子 Agent 策略
保持主上下文窗口整洁:
- 将研究、探索和并行分析交给子 Agent
- 对于复杂问题,通过子 Agent 投入更多算力
- 每个子 Agent 只分配一项任务,以便专注执行
模板:
Agent({
description: "Search auth patterns",
prompt: "Find all authentication middleware in src/ and list file paths with a one-line summary of each."
})
3. 自我改进循环
用户提出任何更正后:
- 将相关模式更新到
tasks/lessons.md - 编写规则,避免重蹈覆辙
- 在每次会话开始时查看经验教训
内联示例(完整模板见 references/lessons-format.md):
## 2024-01-10 - Testing
**Mistake**: Mocks hid real API behavior; production broke
**Pattern**: Over-mocking created false confidence
**Rule**: Include at least one integration test hitting real services
**Applied**: All API endpoints, external service integrations
4. 完成前验证
- 未证明任务有效前,绝不将其标记为完成
- 相关时,对比主分支与更改后的行为
- 问问自己:“资深工程师会认可这项工作吗?”
- 运行测试、检查日志,并展示更正结果
- 如果验证失败 → 返回计划步骤并修改,然后再重试
5. 追求优雅(保持平衡)
- 对于非平凡的更改,暂停并思考:“有没有更优雅的做法?”
- 如果修复方案感觉像权宜之计,就问:“基于我现在掌握的全部信息,如何实现优雅的解决方案?”
- 简单、明显的修复可以跳过这一步——不要过度设计
6. 自主修复 Bug
- 收到 Bug 报告时:直接修复。不要要求用户手把手指导
- 找出日志、错误和失败的测试,然后解决问题
- 不需要用户切换上下文
任务管理协议
- 先规划:在
tasks/todo.md中编写计划,并列出可勾选的事项 - 验证计划:在开始实施前进行确认
- 跟踪进度:完成事项后及时标记
- 说明更改:在每个步骤提供高层次摘要
- 验证结果:运行测试并确认行为后,再标记为完成
- 处理失败:如果验证失败 → 重新规划(步骤 1),不要硬着头皮继续
- 记录结果:在
tasks/todo.md中添加审查记录 - 吸取教训:收到更正后更新
tasks/lessons.md
内联示例(完整模板见 references/task-templates.md):
# Task: Fix memory leak in WebSocket handler
## Plan
- [ ] Reproduce the issue locally
- [ ] Identify leak source with profiler
- [ ] Implement fix
- [ ] Verification: Memory stable over 1000 connections
核心原则
- 简单至上:让每项更改都尽可能简单
- 拒绝敷衍:找出根本原因,不做临时修复。遵循高级开发者标准
- 影响最小化:只改必要之处,避免引入 Bug
评论
支持 Markdown