UWF

让 AI Agent 像团队一样协作

让一个 Agent 同时写代码、review 自己的代码，会怎样？
确认偏误 + 上下文退化 — 它会说服自己错的是对的

UWF 是什么

  • 不是更强的 Agent 是让 Agent 产出更可靠的基础设施
  • 类比 CI/CD CI/CD 不让你写出更好的代码，但让你更安全地发布
  • UWF 的角色 不让 Agent 更聪明，但让产出更可控、更可靠

Quick Start

  • 核心理念：不需要你学 uwf，让 Agent 自己学
# 1. 安装 CLI
$ pnpm install -g @united-workforce/cli
# 2. 让 Agent 自己配置（安装 adapter → 配 provider → 注册 workflow）
$ hermes chat -q "$(uwf prompt bootstrap)" # Hermes
$ uwf prompt bootstrap | claude -p # Claude Code

从可用到可成长

及格线
📚

Memory = 知识

业务背景、历史经验、团队约定

⚡

Skill = 能力

代码审查、部署流程、测试策略

🔒

Workflow = 纪律

SOP、协作规则、交付标准

只做到这里 = 可用的工具
成长线
📚+

知识 Delta

执行中自动沉淀新知、淘汰旧认知

⚡+

能力 Delta

eval 复盘 → 优化执行方式

🔒+

纪律 Delta

执行 → 观测 → 改 YAML → 再执行

静态 + Delta = 可成长的全职数字员工

Session 隔离的结构性优势

🧠

认知隔离

审计不能审自己。Reviewer 不知道 Developer 的决策过程

🎯

注意力聚焦

法庭上证据经过筛选才呈堂。JSON Schema 过滤过程噪声

🔄

上下文保鲜

换班医生看病历而非听口述。每个角色都有干净的 context

🛡️

流程可靠性

生产线工序不能跳过。Graph 强制执行，Agent 无法篡改步骤

核心架构

确定性骨架

Workflow YAML — 声明式定义角色和路由

Moderator — 纯查表路由，零 LLM 成本

Thread — 不可变 CAS 链，每步可寻址

不确定性肌肉

Agent — 独立 CLI 进程，Session 隔离

Frontmatter — 结构化输出，$status 驱动路由

Hook — commit 前跑 lint/test，失败自动回退

roles: developer: procedure: "..." # system prompt goal: "..." # 注入 context capabilities: [...] # 工具权限 frontmatter: # 输出 schema properties: $status: { enum: [done, blocked] } graph: $START: new: { role: developer } developer: done: { role: reviewer, prompt: "{{{result}}}" } reviewer: approved: { role: "$END" } rejected: { role: developer }
solve-issue workflow flowchart

solve-issue

从 Issue 到 PR 的完整工程流程。5 角色流水线 + 回退循环。

Planner ≠ Developer — 规划和执行分离

Reviewer 认知隔离 — 只看代码不看心路历程

$SUSPEND — 信息不足时挂起等人

debate workflow flowchart

debate

对抗性辩论 — 对称博弈 + Host 裁决 + 自主收敛。

oneOf frontmatter — speak / conceded / final 三路径

自主收敛 — Agent 自己决定何时认输

3 轮上限 — 自动结束机制

UWF vs Dynamic Workflow

UWF

  • 流程定义 — YAML 声明式
  • 可审查 — git diff 可 review
  • 可复用 — 同一 workflow 反复跑
  • 可迭代 — 改 YAML 即迭代
VS

Dynamic Workflow

  • 流程定义 — Agent 即兴生成
  • 可审查 — 运行时才知道
  • 可复用 — 用完即弃
  • 可迭代 — 每次从零开始

两层反馈闭环

  • 第一层：Workflow 内闭环 developer → reviewer → rejected → developer（角色间纠正）
  • 第二层：Workflow 级闭环 执行 → 观测 → 迭代 YAML → 再执行（流程本身进化）
uwf workflow show 审查 Workflow 定义
uwf thread list / read 追踪执行状态和上下文
uwf step show / read 逐步检查每一步产出
uwf step ask 向历史步骤的 Agent 提问
uwf step fork 从任意步骤分叉重跑
uwf log show 进程级调试日志
静态胜任只能维持当下，持续自我更新，才是组织核心人才的终极竞争力。
— 彼得·德鲁克《卓有成效的管理者》
① Session 隔离是对抗确认偏误的结构性武器 ② 确定性骨架 + 不确定性肌肉 = 可靠产出 ③ 静态三维 + Delta 成长力 = 可迭代的团队资产

Q&A

github.com/shazhou-ww/united-workforce