chore: rename ocas prompt setup to ocas prompt bootstrap + upgrade content #80

New Issue

2026-06-06T13:40:21Z

xiaomo commented

2026-06-06 13:40:21 +00:00

What

Rename ocas prompt setup to ocas prompt bootstrap, and upgrade its content to match uwf's bootstrap quality.

Part 1: Rename

packages/cli/src/index.ts: case "setup" → case "bootstrap", file path + error message
packages/cli/src/prompts/setup.md → rename to bootstrap.md, update self-references

Part 2: Upgrade to programmatic generation (参考 uwf)

uwf 的 cmdPromptBootstrap() 是程序化生成的（函数返回模板字符串），而非静态 .md 文件。建议 ocas 也改为同样模式：

参考 uwf bootstrap 的结构：

Scenario A: Fresh Install
- Step 0: Environment preflight (bun 版本检查、PATH 检查)
- Step 1: 安装 @ocas/cli
- Step 2: 安装 skill（ocas prompt usage）
- Step 3: End-to-end 验证（put/get 一个 hello world）
Scenario B: Upgrade
- Step 1: bun add -g @ocas/cli@latest
- Step 2: 重新生成 skill
- Step 3: 验证

技术改动：

把 setup.md 静态文件改为 cmdPromptBootstrap() 函数（参考 uwf packages/cli/src/commands/prompt.ts）
用模板字符串注入 CLI_VERSION（uwf 已有此模式）
ocas prompt bootstrap 输出应覆盖：preflight check、安装、技能创建、常见问题修复、升级路径、end-to-end 验证

当前 ocas setup.md 缺少的：

无 preflight check（bun 版本、PATH）
无升级路径
无 end-to-end 验证步骤
静态文件无法注入版本号
没覆盖 "bun 不在 PATH" 等常见坑

Ref

Review feedback from uwf PR #133. uwf 已有成熟实现可参考：packages/cli/src/commands/prompt.ts → cmdPromptBootstrap()。

## What Rename `ocas prompt setup` to `ocas prompt bootstrap`, and upgrade its content to match uwf's bootstrap quality. ## Part 1: Rename - `packages/cli/src/index.ts`: `case "setup"` → `case "bootstrap"`, file path + error message - `packages/cli/src/prompts/setup.md` → rename to `bootstrap.md`, update self-references ## Part 2: Upgrade to programmatic generation (参考 uwf) uwf 的 `cmdPromptBootstrap()` 是程序化生成的（函数返回模板字符串），而非静态 .md 文件。建议 ocas 也改为同样模式： ### 参考 uwf bootstrap 的结构： 1. **Scenario A: Fresh Install** - Step 0: Environment preflight (bun 版本检查、PATH 检查) - Step 1: 安装 `@ocas/cli` - Step 2: 安装 skill（`ocas prompt usage`） - Step 3: End-to-end 验证（put/get 一个 hello world） 2. **Scenario B: Upgrade** - Step 1: `bun add -g @ocas/cli@latest` - Step 2: 重新生成 skill - Step 3: 验证 ### 技术改动： - 把 `setup.md` 静态文件改为 `cmdPromptBootstrap()` 函数（参考 uwf `packages/cli/src/commands/prompt.ts`） - 用模板字符串注入 `CLI_VERSION`（uwf 已有此模式） - `ocas prompt bootstrap` 输出应覆盖：preflight check、安装、技能创建、常见问题修复、升级路径、end-to-end 验证 ### 当前 ocas setup.md 缺少的： - 无 preflight check（bun 版本、PATH） - 无升级路径 - 无 end-to-end 验证步骤 - 静态文件无法注入版本号 - 没覆盖 "bun 不在 PATH" 等常见坑 ## Ref Review feedback from uwf PR #133. uwf 已有成熟实现可参考：`packages/cli/src/commands/prompt.ts` → `cmdPromptBootstrap()`。

xiaoju referenced this issue from a commit

2026-06-06 14:03:33 +00:00

chore: rename prompt setup→bootstrap, programmatic generation, bun→pnpm cleanup

xiaoju referenced a pull request that will close this issue

2026-06-06 14:03:45 +00:00

chore: rename prompt setup→bootstrap, programmatic generation, bun→pnpm cleanup #81

xiaoju closed this issue

2026-06-06 14:34:38 +00:00

Sign in to join this conversation.