fix: expand bootstrap prompt with full onboarding and upgrade guide #105

2026-06-05T10:35:24Z

xiaoju commented

2026-06-05 10:35:24 +00:00

What

Rewrite uwf prompt bootstrap to cover two complete scenarios:

Scenario A: Fresh Install

Install CLI + agent adapter (lists all 3 adapters with npm install commands)
Configure provider/model via uwf setup — explicitly tells agent to ask the user for provider, API key, and model
Install skills from uwf prompt outputs
End-to-end verification with a smoke test

Scenario B: Upgrade

Update CLI + adapter packages
Regenerate skills (content is version-bundled)
Migrate workflow YAML files (documents $START._ → new/resume migration)
Verify

Why

The previous bootstrap only covered "install skills" — agents had no idea what to do next (#104). Missing:

When to run uwf setup and what info to provide
Which adapter to install and how
How to verify skills are loadable
How to handle upgrades and breaking changes

Changes

prompt.ts — complete rewrite of cmdPromptBootstrap()
prompt.test.ts — added assertions for fresh install and upgrade content
.changeset/bootstrap-onboarding.md — patch bump for cli

Ref

Fixes #104

## What Rewrite `uwf prompt bootstrap` to cover two complete scenarios: **Scenario A: Fresh Install** 1. Install CLI + agent adapter (lists all 3 adapters with `npm install` commands) 2. Configure provider/model via `uwf setup` — explicitly tells agent to **ask the user** for provider, API key, and model 3. Install skills from `uwf prompt` outputs 4. End-to-end verification with a smoke test **Scenario B: Upgrade** 1. Update CLI + adapter packages 2. Regenerate skills (content is version-bundled) 3. Migrate workflow YAML files (documents `$START._` → `new/resume` migration) 4. Verify ## Why The previous bootstrap only covered "install skills" — agents had no idea what to do next (#104). Missing: - When to run `uwf setup` and what info to provide - Which adapter to install and how - How to verify skills are loadable - How to handle upgrades and breaking changes ## Changes - **`prompt.ts`** — complete rewrite of `cmdPromptBootstrap()` - **`prompt.test.ts`** — added assertions for fresh install and upgrade content - **`.changeset/bootstrap-onboarding.md`** — patch bump for cli ## Ref Fixes #104

xiaoju added 1 commit 2026-06-05 10:35:25 +00:00

fix: expand bootstrap prompt with full onboarding and upgrade guide

CI / check (pull_request) Successful in 2m56s

Details

c5eb8b79d1

- Fresh install: CLI + adapter install, uwf setup, skills, e2e verify
- Upgrade: update packages, regenerate skills, migrate workflows
- Explicitly tells agent to ask user for provider/api-key/model
- Lists all available adapters with install commands
- Documents v0.2.0 $START migration

Fixes #104

xiaomo approved these changes 2026-06-05 10:39:17 +00:00

xiaomo left a comment

LGTM ✅

从"装 3 个 skill"扩展为完整的 onboarding guide，结构清晰：

Fresh Install — CLI + adapter 安装 → uwf setup 配置（含 preset 列表和示例命令，让 agent 知道该问用户什么） → skill 安装 → smoke test 验证。adapter 对照表很实用。

Upgrade — 更新包 → 重新生成 skill → 迁移指南（文档化了 $START._ → new/resume 的 before/after）→ 验证。

测试也跟着扩展了，覆盖两个场景的关键词。changeset patch 级别合适。

LGTM ✅ 从"装 3 个 skill"扩展为完整的 onboarding guide，结构清晰： **Fresh Install** — CLI + adapter 安装 → `uwf setup` 配置（含 preset 列表和示例命令，让 agent 知道该问用户什么） → skill 安装 → smoke test 验证。adapter 对照表很实用。 **Upgrade** — 更新包 → 重新生成 skill → 迁移指南（文档化了 `$START._` → `new`/`resume` 的 before/after）→ 验证。测试也跟着扩展了，覆盖两个场景的关键词。changeset patch 级别合适。

xiaomo merged commit d64d150071 into main

2026-06-05 10:39:18 +00:00

xiaomo deleted branch fix/104-bootstrap-onboarding

2026-06-05 10:39:19 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: shazhou/united-workforce#105