feat: add actor skill — frontmatter protocol + CAS reference #545

2026-05-26T15:32:45Z

xiaoju commented

2026-05-26 15:32:45 +00:00

What

Add uwf skill actor command — reference for agents executing workflow roles.

Why

现有 skills 按知识模块分（cli/architecture/yaml/moderator），不按使用场景分。Actor 是最常见的场景——每次 workflow 跑起来，每个 role 的 agent 都是 actor。

Changes

packages/workflow-util/src/actor-reference.ts — actor skill 内容（frontmatter 协议 + CAS 操作）
packages/workflow-util/src/index.ts — 导出 generateActorReference
packages/cli-workflow/src/commands/skill.ts — 注册 actor skill
packages/cli-workflow/src/cli.ts — 添加 uwf skill actor 子命令
packages/cli-workflow/src/__tests__/skill.test.ts — 新增测试

Ref

Refs #540, part of #537

## What Add `uwf skill actor` command — reference for agents executing workflow roles. ## Why 现有 skills 按知识模块分（cli/architecture/yaml/moderator），不按使用场景分。Actor 是最常见的场景——每次 workflow 跑起来，每个 role 的 agent 都是 actor。 ## Changes - `packages/workflow-util/src/actor-reference.ts` — actor skill 内容（frontmatter 协议 + CAS 操作） - `packages/workflow-util/src/index.ts` — 导出 `generateActorReference` - `packages/cli-workflow/src/commands/skill.ts` — 注册 actor skill - `packages/cli-workflow/src/cli.ts` — 添加 `uwf skill actor` 子命令 - `packages/cli-workflow/src/__tests__/skill.test.ts` — 新增测试 ## Ref Refs #540, part of #537

xiaoju added 1 commit 2026-05-26 15:32:46 +00:00

feat: add actor skill — frontmatter protocol + CAS reference

CI / test (pull_request) Failing after 8m9s

Details

95a130136b

Adds 'uwf skill actor' command for agents executing workflow roles.
Covers the two things an actor needs to know:
1. Frontmatter output protocol (status field, schema-defined fields)
2. CAS operations (put, get, refs, walk, merkle DAG pattern)

Refs #540

xiaomo approved these changes 2026-05-26 15:44:30 +00:00

xiaomo left a comment

LGTM ✅ 结构清晰，和现有 skill 子命令（cli/architecture/yaml/moderator）一致。

文档内容准确：status 作为唯一标准字段、frontmatter 必须在 byte 0、retry 机制、CAS 命令和 merkle DAG 模式都覆盖到了。测试也到位。

LGTM ✅ 结构清晰，和现有 skill 子命令（cli/architecture/yaml/moderator）一致。文档内容准确：status 作为唯一标准字段、frontmatter 必须在 byte 0、retry 机制、CAS 命令和 merkle DAG 模式都覆盖到了。测试也到位。

xiaomo merged commit 87938c1886 into main

2026-05-26 15:44:31 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: uncaged/workflow#545