feat: add developer skill — coding conventions + architecture guide #548

2026-05-26T17:18:19Z

xiaoju commented

2026-05-26 17:18:19 +00:00

What

Add uwf skill developer — reference for engine contributors.

Content

Monorepo structure + dependency layers
Functional-first coding conventions (type over interface, no class, no optional properties)
Error handling (Result type), async (await only), logging (tagged logger)
Development workflow (build/check/format/test)
Key modules: moderator, extract pipeline, createAgent factory, CAS integration
Publishing (fixed-mode changesets)
Commit convention

Changes

packages/workflow-util/src/developer-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 developer subcommand
packages/cli-workflow/src/__tests__/skill.test.ts — tests

Ref

Refs #541, part of #537

## What Add `uwf skill developer` — reference for engine contributors. ## Content - Monorepo structure + dependency layers - Functional-first coding conventions (type over interface, no class, no optional properties) - Error handling (Result type), async (await only), logging (tagged logger) - Development workflow (build/check/format/test) - Key modules: moderator, extract pipeline, createAgent factory, CAS integration - Publishing (fixed-mode changesets) - Commit convention ## Changes - `packages/workflow-util/src/developer-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 developer` subcommand - `packages/cli-workflow/src/__tests__/skill.test.ts` — tests ## Ref Refs #541, part of #537

xiaoju added 1 commit 2026-05-26 17:18:20 +00:00

feat: add developer skill — coding conventions + architecture guide

CI / test (pull_request) Successful in 1m26s

Details

09b7ddf6d0

Adds 'uwf skill developer' for contributors to the workflow engine.
Covers: monorepo structure, dependency layers, functional-first conventions,
error handling, logging with tagged logger, development workflow,
testing, publishing, key modules (moderator, extract pipeline, createAgent).

Refs #541

xiaomo approved these changes 2026-05-26 17:19:15 +00:00

xiaomo left a comment

LGTM ✅ 架构层次、编码规范、extract pipeline、createAgent 工厂描述都准确。

1 个要改的： commit scope 列表里 agent-kit 已重命名为 util-agent，应更新。

可以合后 follow-up 修，不阻塞。

LGTM ✅ 架构层次、编码规范、extract pipeline、createAgent 工厂描述都准确。 **1 个要改的：** commit scope 列表里 `agent-kit` 已重命名为 `util-agent`，应更新。可以合后 follow-up 修，不阻塞。

xiaomo merged commit 5475dd3f5c into main

2026-05-26 17:19:17 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: uncaged/workflow#548