wf-composer
GitHub将自然语言工作流描述解析为DAG节点图，自动注入检查点并持久化为可复用JSON模板。支持断点续传和模板编辑，用于复杂任务的流程编排与设计。
Trigger Scenarios
Install
npx skills add catlog22/Claude-Code-Workflow --skill wf-composer -g -y
SKILL.md
Frontmatter
{
"name": "wf-composer",
"description": "Semantic workflow composer — parse natural language workflow description into a DAG of skill\/CLI\/agent nodes, auto-inject checkpoint save nodes, confirm with user, persist as reusable JSON template. Triggers on \"wf-composer \" or \"\/wf-composer\".",
"allowed-tools": "Agent(*), AskUserQuestion(*), Read(*), Write(*), Edit(*), Bash(*), Glob(*), Grep(*)",
"argument-hint": "[workflow description]"
}
Workflow Design
Parse user's semantic workflow description → decompose into nodes → map to executors → auto-inject checkpoints → confirm pipeline → save as reusable workflow-template.json.
Architecture
User describes workflow in natural language
-> Phase 1: Parse — extract intent steps + variables
-> Phase 2: Resolve — map each step to executor (skill/cli/agent/command)
-> Phase 3: Enrich — inject checkpoint nodes, set DAG edges
-> Phase 4: Confirm — visualize pipeline, user approval/edit
-> Phase 5: Persist — save .workflow/templates/<name>.json
Shared Constants
| Constant | Value |
|---|---|
| Session prefix | WFD |
| Template dir | .workflow/templates/ |
| Template ID format | wft-<slug>-<date> |
| Node ID format | N-<seq> (e.g. N-001), CP-<seq> for checkpoints |
| Max nodes | 20 |
Entry Router
Parse $ARGUMENTS.
| Detection | Condition | Handler |
|---|---|---|
| Resume design | --resume flag or existing WFD session |
-> Phase 0: Resume |
| Edit template | --edit <template-id> flag |
-> Phase 0: Load + Edit |
| New design | Default | -> Phase 1: Parse |
Phase 0: Resume / Edit (optional)
Resume design session:
- Scan
.workflow/templates/design-drafts/WFD-*.jsonfor in-progress designs - Multiple found → AskUserQuestion for selection
- Load draft → skip to last incomplete phase
Edit existing template:
- Load template from
--editpath - Show current pipeline visualization
- AskUserQuestion: which nodes to modify/add/remove
- Re-enter at Phase 3 (Enrich) with edits applied
Phase 1: Parse
Read phases/01-parse.md and execute.
Objective: Extract structured semantic steps + context variables from natural language.
Success: design-session/intent.json written with: steps[], variables[], task_type, complexity.
Phase 2: Resolve
Read phases/02-resolve.md and execute.
Objective: Map each intent step to a concrete executor node.
Executor types:
skill— invoke viaSkill(skill=..., args=...)cli— invoke viaccw cli -p "..." --tool ... --mode ...command— invoke viaSkill(skill="<namespace:command>", args=...)agent— invoke viaAgent(subagent_type=..., prompt=...)checkpoint— state save + optional user pause
Success: design-session/nodes.json written with resolved executor for each step.
Phase 3: Enrich
Read phases/03-enrich.md and execute.
Objective: Build DAG edges, auto-inject checkpoints at phase boundaries, validate port compatibility.
Checkpoint injection rules:
- After every
skill→skilltransition that crosses a semantic phase boundary - Before any long-running
agentspawn - After any node that produces a persistent artifact (plan, spec, analysis)
- At user-defined breakpoints (if any)
Success: design-session/dag.json with nodes[], edges[], checkpoints[], context_schema{}.
Phase 4: Confirm
Read phases/04-confirm.md and execute.
Objective: Visualize the pipeline, present to user, incorporate edits.
Display format:
Pipeline: <template-name>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
N-001 [skill] workflow-lite-plan "{goal}"
|
CP-01 [checkpoint] After Plan auto-continue
|
N-002 [skill] workflow-test-fix "--session N-001"
|
CP-02 [checkpoint] After Tests pause-for-user
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Variables: goal (required)
Checkpoints: 2 (1 auto, 1 pause)
AskUserQuestion:
- Confirm & Save
- Edit node (select node ID)
- Add node after (select position)
- Remove node (select node ID)
- Rename template
Success: User confirmed pipeline. Final dag.json ready.
Phase 5: Persist
Read phases/05-persist.md and execute.
Objective: Assemble final template JSON, write to template library, output summary.
Output:
.workflow/templates/<slug>.json— the reusable template- Console summary with template path + usage command
Success: Template saved. User shown: Skill(skill="wf-player", args="<template-path>")
Specs Reference
| Spec | Purpose |
|---|---|
| specs/node-catalog.md | Available executors, port definitions, arg templates |
| specs/template-schema.md | Full JSON template schema |
Version History
- 07491b0 Current 2026-07-25 09:32
