bootstrap prompt 缺少 setup 步骤和后续引导 #104

New Issue

2026-06-05T10:29:37Z

xiaonuo commented

2026-06-05 10:29:37 +00:00

问题

uwf prompt bootstrap 输出只包含了三步：(1) 检查 CLI 安装，(2) 从 uwf prompt usage/workflow-authoring/adapter-developing 创建 skill，(3) 验证 skill 可加载。

但完成这三步后，agent 仍然不知道接下来该做什么。

困惑

uwf setup（配置 provider/model/agent）什么时候跑？ — usage skill 的 Quick Start 第一步就是它，但 bootstrap 没有包含这一步，也没有说它应该在什么时候执行。
Agent adapter 需要安装吗？装哪个？ — usage 提到 --agent 参数和 defaultAgent 配置，adapter-developing 列出了三个现有 adapter（uwf-hermes、uwf-builtin、uwf-claude-code），但 bootstrap 没有说要装哪个或怎么装。
装完 skill 后怎么验证"可加载"？ — bootstrap 说 "verify the skills are loadable by your agent framework"，但没有给出具体命令或方法。

建议

在 bootstrap prompt 中补充：

配置步骤（uwf setup 或手动写 ~/.uwf/config.yaml）
Agent adapter 安装指引（装哪个包、怎么注册）
验证 skill 可加载的具体方法

或者添加一个 "Next Steps" 段落，引导用户完成从安装到实际跑第一个 workflow 的完整路径。

## 问题 `uwf prompt bootstrap` 输出只包含了三步：(1) 检查 CLI 安装，(2) 从 `uwf prompt usage/workflow-authoring/adapter-developing` 创建 skill，(3) 验证 skill 可加载。但完成这三步后，agent 仍然不知道接下来该做什么。 ## 困惑 1. **`uwf setup`（配置 provider/model/agent）什么时候跑？** — usage skill 的 Quick Start 第一步就是它，但 bootstrap 没有包含这一步，也没有说它应该在什么时候执行。 2. **Agent adapter 需要安装吗？装哪个？** — usage 提到 `--agent` 参数和 `defaultAgent` 配置，adapter-developing 列出了三个现有 adapter（`uwf-hermes`、`uwf-builtin`、`uwf-claude-code`），但 bootstrap 没有说要装哪个或怎么装。 3. **装完 skill 后怎么验证"可加载"？** — bootstrap 说 "verify the skills are loadable by your agent framework"，但没有给出具体命令或方法。 ## 建议在 bootstrap prompt 中补充： - 配置步骤（`uwf setup` 或手动写 `~/.uwf/config.yaml`） - Agent adapter 安装指引（装哪个包、怎么注册） - 验证 skill 可加载的具体方法或者添加一个 "Next Steps" 段落，引导用户完成从安装到实际跑第一个 workflow 的完整路径。

xiaoju referenced this issue from a commit

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

fix: expand bootstrap prompt with full onboarding and upgrade guide

xiaoju referenced a pull request that will close this issue

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

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

xiaomo closed this issue

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

Sign in to join this conversation.