feat: add author skill — workflow YAML design guide #547

2026-05-26T16:49:39Z

xiaoju commented

2026-05-26 16:49:39 +00:00

What

Add uwf skill author — guide for designing workflow YAML definitions.

Content

Workflow Structure — complete YAML skeleton with all fields
Role Definition — field reference + design principles (single responsibility, minimal context)
Frontmatter Schema — $status field, oneOf patterns, flat vs multi-status schemas
Graph Routing — $START/$END, edge prompts with Mustache, loops/branching, fail routing
Self-Testing — register → dry-run → inspect workflow
Validation Checklist — 6-point checklist for common mistakes
Common Pitfalls — missing edges, field mismatches, overloaded roles

Changes

packages/workflow-util/src/author-reference.ts — skill content
packages/workflow-util/src/index.ts — export
packages/cli-workflow/src/commands/skill.ts — register
packages/cli-workflow/src/cli.ts — uwf skill author subcommand
packages/cli-workflow/src/__tests__/skill.test.ts — tests

Ref

Refs #539, part of #537

## What Add `uwf skill author` — guide for designing workflow YAML definitions. ## Content - **Workflow Structure** — complete YAML skeleton with all fields - **Role Definition** — field reference + design principles (single responsibility, minimal context) - **Frontmatter Schema** — `$status` field, oneOf patterns, flat vs multi-status schemas - **Graph Routing** — `$START`/`$END`, edge prompts with Mustache, loops/branching, fail routing - **Self-Testing** — register → dry-run → inspect workflow - **Validation Checklist** — 6-point checklist for common mistakes - **Common Pitfalls** — missing edges, field mismatches, overloaded roles ## Changes - `packages/workflow-util/src/author-reference.ts` — skill content - `packages/workflow-util/src/index.ts` — export - `packages/cli-workflow/src/commands/skill.ts` — register - `packages/cli-workflow/src/cli.ts` — `uwf skill author` subcommand - `packages/cli-workflow/src/__tests__/skill.test.ts` — tests ## Ref Refs #539, part of #537

xiaoju added 1 commit 2026-05-26 17:03:28 +00:00

feat: add author skill — workflow YAML design guide

CI / test (pull_request) Successful in 1m4s

Details

dbefe793f2

Adds 'uwf skill author' for agents/humans designing workflow definitions.
Covers: YAML structure, role definition, frontmatter schema design,
graph routing, edge prompts, self-testing, and common pitfalls.

Refs #539

xiaoju force-pushed feat/539-skill-author from 3fef8e9bc3 to dbefe793f2

2026-05-26 17:03:28 +00:00

Compare

xiaomo approved these changes 2026-05-26 17:04:50 +00:00

xiaomo left a comment

LGTM ✅ 内容与 solve-issue.yaml 实际结构对照验证准确。graph 语法、$status oneOf、Mustache 模板、$START/_、循环/fail routing 都覆盖到了。validation checklist 那节很实用。

xiaomo merged commit c4e94bbe56 into main

2026-05-26 17:04:51 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: uncaged/workflow#547