Workflow Orchestration Patterns
Use when designing durable multi-step workflows across services, distributed transactions, long-running processes, human approvals, retries, compensation, or resumable failure recovery.
Install
npx skills add sandbaseai/workbuddy-skill --skill workflow-orchestration-patternsgit clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/workflow-orchestration-patterns ~/.claude/skills/workflow-orchestration-patternsPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Workflow Orchestration Patterns 为跨服务、长时间运行或需要恢复的流程设计持久编排。将确定性的状态机与执行外部副作用的 Activity 分离,明确重试、超时、补偿、人工介入和恢复证据;不要把普通 CRUD 或无状态请求包装成复杂工作流。 ## 适用范围和边界 - 适合跨机器/服务/数据库的多步流程、需要断点恢复的长任务、分布式事务、基础设施流程和人工审批;简单 CRUD、纯批处理、实时流和普通 request/response 优先使用更简单的模式。 - 开始前确认工作流 ID、版本、状态/数据所有者、任务队列、环境、租户、超时预算、失败策略和副作用授权。 - 默认只读审查 workflow/activity 代码、契约、队列、指标、历史和测试;不启动生产执行、不调用外部 API、不写业务数据、不创建资源或批准人工动作。 - payload、日志、事件和搜索属性脱敏并设置大小/保留边界;不得放入 secret、令牌、完整客户内容或不必要的 PII。 ## Workflow 与 Activity 分离 Workflow 负责确定性编排、状态转移、条件、计时器、信号、查询和子工作流;Activity 负责数据库、网络、文件、队列、邮件和其他外部副作用。Workflow 不直接调用外部 API、读取当前时间/随机数、启动线程或依赖不可重复的全局状态;使用运行时提供的确定性时钟、随机性和版本兼容机制。 每个 Activity 定义输入/输出 schema、所有者、幂等键、超时、心跳、重试策略、可重入范围、错误分类和补偿。短 Activity 应在秒到分钟级完成;长任务报告进度、支持取消并有总时限,不能无限等待。 ## 状态、版本与确定性 将状态转移写成可审计的状态机,区分 `pending`、`running`、`waiting`、`succeeded`、`failed`、`compensating`、`cancelled` 和 `timed_out`。记录版本/变更 ID、事件顺序、信号来源和幂等去重结果。新增/修改 workflow 逻辑要考虑正在运行的旧实例,使用兼容版本、分支或迁移策略;不能仅依赖当前代码重放历史。 验证所有 workflow 路径可重放且结果一致,避免 wall clock、外部响应、未排序集合、线程竞态、语言运行时副作用和超过 payload 限制的数据。大对象放受控存储,工作流只传引用、摘要和不可逆关联 ID。 ## 重试、超时和容量 为启动、执行、心跳、等待、总流程和人工审批分别设置有界超时。仅对瞬态且幂等的错误重试,配置最大次数、指数退避/抖动、总预算和不可重试分类;避免客户端、Activity 和下游同时重试造成放大。认证/授权、校验、版本冲突和不可逆副作用失败默认不自动重放。 监控工作流时长、Activity 失败率、重试次数、排队/待处理数、心跳丢失、补偿失败、取消和资源消耗。任务队列按租户/优先级/容量隔离,批量和子工作流只在能证明降低负载且不破坏顺序时使用。 ## Saga、补偿与人工介入 对非原子分布式事务列出正向步骤、提交点、可补偿副作用、补偿顺序、不可补偿状态和人工升级条件。补偿必须幂等、可重试、有审计事件和最大次数;补偿失败不能伪装成原流程成功。明确最终一致性、用户可见中间状态、超时后的资源占用和取消语义。
Details
- Skill name
workflow-orchestration-patterns- Repository
- sandbaseai/workbuddy-skill
- Path
skills/workflow-orchestration-patterns/SKILL.md- License
- MIT
- Repo updated
- 8 September 2026
FAQ
What does the Workflow Orchestration Patterns skill do?
Use when designing durable multi-step workflows across services, distributed transactions, long-running processes, human approvals, retries, compensation, or resumable failure recovery.
How do I install the Workflow Orchestration Patterns skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill workflow-orchestration-patterns. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Workflow Orchestration Patterns popular?
It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.
Related skills
Access Control Security Best Practices
9sandbaseai/workbuddy-skill
Design, review, implement, and verify least-privilege access controls across users, services, tenants, resources, and administrative workflows.
Accessibility Review
9sandbaseai/workbuddy-skill
Use when reviewing a web interface or interaction for semantic, keyboard, focus, screen-reader, ARIA, and contrast accessibility risks.
Acquire Codebase Knowledge
9sandbaseai/workbuddy-skill
Use when the user asks to map, document, or onboard into an existing codebase and needs evidence-backed architecture, structure, conventions, integrations, testing, and concerns documentation.
Google Calendar Sync
5astoreyai/claude-skills
Manages Google Calendar through the Calendar API. Create, read, update, and delete events, manage multiple calendars, set reminders, handle recurring events, and sync with local schedules. Use when working with Google Calendar, scheduling events, checking availability, managing meetings, or automating calendar workflows.
Workflow Modeling
9sandbaseai/workbuddy-skill
Use when designing or reviewing staged workflows, lifecycle schemas, work packages, results, derivations, or pipeline stages; keep workflow gates as state and avoid multiplying objects, services, enums, or tables per stage.
Google Gmail Integration
5astoreyai/claude-skills
Manages Gmail through the Gmail API. Search and read emails, send messages, manage labels and filters, handle attachments, and automate email workflows. Use when working with Gmail, reading/sending emails, searching inbox, managing email organization, or processing email data.
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.