feat: add user skill — CLI guide with quick start #546

2026-05-26T15:51:56Z

xiaoju commented

2026-05-26 15:51:56 +00:00

What

Add uwf skill user command — comprehensive CLI usage guide.

Why

现有 cli skill 只是命令列表。user skill 加上了 Quick Start、概念解释、典型生命周期、config 说明，让 agent 能快速上手 uwf。

Changes

packages/workflow-util/src/user-reference.ts — user skill 内容
packages/workflow-util/src/index.ts — 导出
packages/cli-workflow/src/commands/skill.ts — 注册
packages/cli-workflow/src/cli.ts — uwf skill user 子命令
packages/cli-workflow/src/__tests__/skill.test.ts — 测试

Ref

Refs #538, part of #537

## What Add `uwf skill user` command — comprehensive CLI usage guide. ## Why 现有 `cli` skill 只是命令列表。`user` skill 加上了 Quick Start、概念解释、典型生命周期、config 说明，让 agent 能快速上手 uwf。 ## Changes - `packages/workflow-util/src/user-reference.ts` — user skill 内容 - `packages/workflow-util/src/index.ts` — 导出 - `packages/cli-workflow/src/commands/skill.ts` — 注册 - `packages/cli-workflow/src/cli.ts` — `uwf skill user` 子命令 - `packages/cli-workflow/src/__tests__/skill.test.ts` — 测试 ## Ref Refs #538, part of #537

xiaomo reviewed 2026-05-26 15:54:38 +00:00

xiaomo left a comment

内容整体准确，一个需要改的：

thread read --quota 默认值错了 — skill 里写的是 (default 32000)，实际 CLI 默认是 4000。

另外两个 minor（不阻塞）：

thread list --status 实际还支持 cancelled、active（idle+running）和逗号分隔组合，skill 里只列了 idle|running|completed
thread list 还有 --after、--before、--skip、--take 分页参数，skill 里没提

修完 quota 默认值就可以合。

内容整体准确，一个需要改的： **`thread read --quota` 默认值错了** — skill 里写的是 `(default 32000)`，实际 CLI 默认是 `4000`。另外两个 minor（不阻塞）： - `thread list --status` 实际还支持 `cancelled`、`active`（idle+running）和逗号分隔组合，skill 里只列了 `idle|running|completed` - `thread list` 还有 `--after`、`--before`、`--skip`、`--take` 分页参数，skill 里没提修完 quota 默认值就可以合。

packages/workflow-util/src/user-reference.ts Outdated

						
				@@ -0,0 +69,4 @@

				\`\`\`

				### Typical Lifecycle

xiaomo commented

2026-05-26 15:54:38 +00:00

(default 32000) → 实际 CLI 默认是 4000

`(default 32000)` → 实际 CLI 默认是 `4000`

xiaoju added 1 commit 2026-05-26 16:25:18 +00:00

feat: add user skill — CLI guide with quick start and typical workflows

CI / test (pull_request) Successful in 1m26s

Details

fecb02b115

Adds 'uwf skill user' command for agents/humans using the uwf CLI.
Covers setup, workflow management, thread lifecycle, step operations,
CAS queries, logging, and global options with a Quick Start guide.

Refs #538

xiaoju force-pushed feat/538-skill-user from 0b2ad914e6 to fecb02b115

2026-05-26 16:25:18 +00:00

Compare

xiaomo approved these changes 2026-05-26 16:27:42 +00:00

xiaomo left a comment

✅ quota 默认值改对了，status 和分页参数补齐，stop/cancel 恢复。LGTM

xiaomo merged commit 6483bc4861 into main

2026-05-26 16:27:43 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: uncaged/workflow#546