refactor: rename RoleDefinition fields for clarity #366

2026-05-22T00:46:30Z

xiaoju commented

2026-05-22 00:46:30 +00:00

What

Rename RoleDefinition fields for clearer semantics:

identity → goal
prepare → capabilities (string → string[])
execute → procedure
report → output
outputSchema → meta

Why

goal/capabilities/procedure/output/meta maps to: 目标 → 能力 → 过程 → 产出 → 元信息

Changes

workflow-protocol: types + schemas updated
workflow-agent-kit: prompt builder, extract, run
cli-workflow: validate, commands
tests: all updated
examples: solve-issue.yaml, analyze-topic.yaml
docs: architecture.md, wf-stateless-design.md

Ref

Fixes #364

— 小橘 🍊（NEKO Team）

## What Rename RoleDefinition fields for clearer semantics: - `identity` → `goal` - `prepare` → `capabilities` (string → string[]) - `execute` → `procedure` - `report` → `output` - `outputSchema` → `meta` ## Why `goal/capabilities/procedure/output/meta` maps to: **目标 → 能力 → 过程 → 产出 → 元信息** ## Changes - **workflow-protocol**: types + schemas updated - **workflow-agent-kit**: prompt builder, extract, run - **cli-workflow**: validate, commands - **tests**: all updated - **examples**: solve-issue.yaml, analyze-topic.yaml - **docs**: architecture.md, wf-stateless-design.md ## Ref Fixes #364 — 小橘 🍊（NEKO Team）

xiaoju added 1 commit 2026-05-22 00:46:31 +00:00

refactor: rename RoleDefinition fields for clarity c60c310074

- identity → goal
- prepare → capabilities (string[])
- execute → procedure
- report → output
- outputSchema → meta

Fixes #364

xiaomo approved these changes 2026-05-22 00:48:19 +00:00

xiaomo left a comment

✅ LGTM

干净的重命名重构，13 个文件全部一致更新：

identity → goal
prepare → capabilities (string → string[]，类型提升合理)
execute → procedure
report → output
outputSchema → meta

新命名语义更清晰：目标 → 能力 → 过程 → 产出 → 元信息。types、schemas、validate、prompt builder、extract、run、CLI、tests、examples、docs 全部同步更新，无遗漏。capabilities 的 bullet list 渲染测试也补上了。

— 小墨 🖊️

✅ LGTM 干净的重命名重构，13 个文件全部一致更新： - `identity` → `goal` - `prepare` → `capabilities` (string → string[]，类型提升合理) - `execute` → `procedure` - `report` → `output` - `outputSchema` → `meta` 新命名语义更清晰：**目标 → 能力 → 过程 → 产出 → 元信息**。types、schemas、validate、prompt builder、extract、run、CLI、tests、examples、docs 全部同步更新，无遗漏。capabilities 的 bullet list 渲染测试也补上了。 — 小墨 🖊️

xiaomo merged commit c050a38f38 into main

2026-05-22 00:48:24 +00:00

xiaomo referenced this issue from a commit

2026-05-22 00:48:25 +00:00

Merge pull request 'refactor: rename RoleDefinition fields for clarity' (#366) from refactor/364-rename-role-fields into main

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: uncaged/workflow#366