prime-dev-cli 2.0.1 → 2.0.2

package/README.md

@@ -0,0 +1,132 @@
+# prime-dev-cli
+
+`prime-dev-cli` 是一个用于管理多前端项目开发环境的工具，当前包含：
+- CLI
+- 本地 Web UI
+- 浏览器扩展
+- 通用 skill 源与 Claude Code 适配层
+
+## 安装
+
+```bash
+npm install -g prime-dev-cli
+```
+
+或：
+
+```bash
+pnpm add -g prime-dev-cli
+```
+
+## 常用命令
+
+```bash
+prime init
+prime ui
+prime update
+prime version
+prime help
+```
+
+## Skill 结构
+
+本仓库现在采用两层结构：
+
+### 1. 通用 skill 源
+
+平台无关的能力说明位于：
+- `skills/prime-workspace/README.md`
+- `skills/prime-workspace/SKILL.md`
+
+它描述的是 `prime-dev-cli` 的通用能力，而不是只绑定 Claude Code。
+
+### 2. Claude Code 适配层
+
+Claude Code plugin / skill 位于：
+- `plugin-marketplace/plugins/prime-dev-cli`
+
+其中提供：
+- `/prime-workspace`
+
+## 推荐安装方式：skills CLI
+
+下面的 `./skills` 和 `./plugin-marketplace` 示例默认在仓库根目录执行。
+如果你不是在仓库里，而是在已安装的 npm 包目录中操作，请把它们替换成实际安装目录下的对应路径。
+
+推荐直接使用 `skills` 安装通用 skill：
+
+```bash
+npx skills add ./skills --agent claude-code --global --copy --yes
+```
+
+如果你要装到别的 agent，替换 `--agent` 即可，例如：
+
+```bash
+npx skills add ./skills --agent codex --global --copy --yes
+```
+
+## 这个 skill 的目标体验
+
+这个 skill 应该支持用户直接说自然语言，而不是要求用户记接口。
+
+例如：
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 把 icrc 切到 sitnew
+- 给 isource 挂上 ilink-isource
+- 把 /api/user/info 切到异常场景
+- 看下 esource-fe 分支
+
+## `/prime-workspace` 能做什么
+
+- 查看 workspace / 项目状态看板
+- 查询单个应用状态
+- 启动 / 停止 / 查看日志
+- 管理 mock 场景
+- 切换代理地址
+- 切换 microapp 地址
+- 查看项目分支状态
+
+## Claude Code 兼容安装方式
+
+如果你需要使用 Claude Code plugin 兼容层，可以直接使用官方 Claude CLI：
+
+### 持久化安装
+
+```bash
+claude plugin marketplace add ./plugin-marketplace
+claude plugin install prime-dev-cli@prime-dev-cli-marketplace
+```
+
+### 当前 session 临时加载
+
+```bash
+claude --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```
+
+如果本机有 `cc` 别名，也可以：
+
+```bash
+cc --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```
+
+## 开发与验证
+
+### 校验 plugin / marketplace
+
+```bash
+claude plugin validate ./plugin-marketplace
+```
+
+### 本地加载 Claude adapter
+
+```bash
+claude --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```
+
+### 运行 root 测试
+
+```bash
+pnpm run test:root
+```

package/bin/cli.mjs

@@ -54,11 +54,11 @@ function helpStdout() {
     prime-cli ${pkg.version}
     `);
   console.log('Commands:');
-  console.log('  init   初始化配置文件');
-  console.log('  ui     启动UI');
-  console.log('  update 覆盖式更新配置文件');
-  console.log('  version 显示版本信息');
-  console.log('  help   显示帮助信息');
+  console.log('  init           初始化配置文件');
+  console.log('  ui             启动UI');
+  console.log('  update         覆盖式更新配置文件');
+  console.log('  version        显示版本信息');
+  console.log('  help           显示帮助信息');
 }
 
 
@@ -90,6 +90,7 @@ function startServer(){
   });
 }
 
+
 // 设置环境文件
 async function setProjectsFile(forceUpdate = false){
   const __filename = fileURLToPath(import.meta.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prime-dev-cli",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "main": "index.js",
   "scripts": {
     "refresh:config": "node ./bin/cli.mjs init",
@@ -8,7 +8,8 @@
     "zip:plugin": "pnpm --filter prime-dev-browser-extension zip",
     "dev:plugin": "pnpm --filter prime-dev-browser-extension dev",
     "dev:server": "pnpm --filter server dev",
-    "postbuild:server": "mkdir -p ./dist/server && cp -R ./packages/server/.next ./dist/server && cp -R ./packages/server/public ./dist/server"
+    "postbuild:server": "mkdir -p ./dist/server && cp -R ./packages/server/.next ./dist/server && cp -R ./packages/server/public ./dist/server",
+    "test:root": "node --test ./test/skill-assets.test.mjs"
   },
   "bin": {
     "prime": "bin/cli.mjs"
@@ -17,7 +18,9 @@
     "bin",
     "dist",
     "config",
-    "lib"
+    "lib",
+    "skills",
+    "plugin-marketplace"
   ],
   "keywords": [],
   "author": "",

package/plugin-marketplace/.claude-plugin/marketplace.json

@@ -0,0 +1,16 @@
+{
+  "name": "prime-dev-cli-marketplace",
+  "owner": {
+    "name": "prime-dev-cli"
+  },
+  "metadata": {
+    "description": "Bundled Claude Code plugins shipped with prime-dev-cli"
+  },
+  "plugins": [
+    {
+      "name": "prime-dev-cli",
+      "source": "./plugins/prime-dev-cli",
+      "description": "Workspace, mock, proxy, and microapp operations for prime-dev-cli"
+    }
+  ]
+}

package/plugin-marketplace/plugins/prime-dev-cli/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "prime-dev-cli",
+  "version": "2.0.1",
+  "description": "Claude Code plugin for prime-dev-cli workspace, mock, proxy, and microapp operations",
+  "author": {
+    "name": "prime-dev-cli"
+  },
+  "skills": "./skills"
+}

package/plugin-marketplace/plugins/prime-dev-cli/README.md

@@ -0,0 +1,48 @@
+# prime-dev-cli Claude adapter
+
+This directory is the Claude Code adapter for the generic `prime-workspace` skill source.
+
+The platform-neutral source lives at:
+- `skills/prime-workspace/README.md`
+- `skills/prime-workspace/SKILL.md`
+
+For most users, the recommended installation path is the `skills` CLI, not this adapter.
+
+## Included Claude skill
+
+- `/prime-workspace`
+
+This adapter is meant to preserve the same friendly experience as the generic skill source, including phrases like:
+- 帮我启动 icrc
+- 看看 iqc 在不在跑
+- 把 icrc 切到 sitnew
+- 给 isource 挂上 ilink-isource
+- 把 /api/user/info 切到异常场景
+
+## Persistent installation
+
+```bash
+claude plugin marketplace add ./plugin-marketplace
+claude plugin install prime-dev-cli@prime-dev-cli-marketplace
+```
+
+## Session-only loading
+
+```bash
+claude --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```
+
+If your shell exposes a `cc` alias, this also works:
+
+```bash
+cc --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```
+
+## Local testing
+
+From the repository root:
+
+```bash
+claude plugin validate ./plugin-marketplace
+claude --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```

package/plugin-marketplace/plugins/prime-dev-cli/skills/prime-workspace/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: prime-workspace
+description: Use this skill when the user wants to operate prime-dev-cli through friendly phrases such as starting icrc, checking one app's status, managing mock scenes, switching proxy targets, or updating microapp bindings.
+metadata:
+  author: prime-dev-cli
+  version: "0.1.0"
+  argument-hint: status | project | start | stop | logs | mock | proxy | microapp | branch
+---
+
+# Prime Workspace
+
+This file is the Claude Code adapter for the generic `skills/prime-workspace/SKILL.md` execution spec.
+
+Follow the generic skill rules first. This adapter only adds Claude-specific guidance.
+
+## Claude-specific guidance
+
+### Default local server
+- Base URL: `http://localhost:52741`
+
+### If the server is unavailable
+Prefer telling packaged users to run:
+- `prime ui`
+
+For repository developers, `pnpm run dev:server` is also acceptable.
+
+### Output style
+For successful actions, prefer concise task-oriented output. Example:
+- 已启动 icrc
+- 访问地址：`http://localhost:8806`
+
+For ambiguous actions, ask one narrow follow-up question instead of dumping raw config.
+
+## High-value friendly examples
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 把 icrc 切到 sitnew
+- 把 ilink 的 /icrc-api 切到 uat
+- 给 isource 挂上 ilink-isource
+- 把 /api/user/info 切到异常场景
+- 看下 esource-fe 分支
+
+## Claude-specific safety emphasis
+Always confirm before:
+- deleting a mock scene
+- deleting a whole mock API
+- opening all mock scenes
+- closing all mock scenes
+- changing microapp selections
+- changing proxies when the target prefix is ambiguous
+
+## Reference
+The generic execution contract lives at:
+- `skills/prime-workspace/SKILL.md`

package/skills/prime-workspace/README.md

@@ -0,0 +1,109 @@
+# prime-workspace
+
+`prime-workspace` 是 `prime-dev-cli` 的通用 skill 源说明，不绑定单一 Agent 平台。
+
+## 目标效果
+
+这个 skill 的目标不是让用户记 endpoint。
+而是让用户可以直接说自然语言，例如：
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 把 icrc 切到 sitnew
+- 给 isource 挂上 ilink-isource
+- 把 /api/user/info 切到异常场景
+
+## 能力范围
+
+- workspace / 项目状态看板
+- 单项目状态查询
+- 启动 / 停止 / 状态 / 日志
+- mock 接口创建与返回体编辑（含 Mock.js 随机数据）
+- mock 场景管理
+- 代理地址切换
+- microapp 地址切换
+- 分支状态查看
+
+## 推荐安装方式：skills CLI
+
+下面的 `./skills` 和 `./plugin-marketplace` 示例默认在仓库根目录执行。
+如果你是从已安装的 npm 包中读取 skill，请改成对应安装目录下的路径。
+
+推荐通过 `skills` CLI 安装这份通用 skill：
+
+```bash
+npx skills add ./skills --agent claude-code --global --copy --yes
+```
+
+如果你要接到其他 agent，替换 `--agent` 即可，例如：
+
+```bash
+npx skills add ./skills --agent codex --global --copy --yes
+```
+
+## 这个 skill 需要具备的执行能力
+
+它应该至少知道：
+- 默认本地 server 是 `http://localhost:52741`
+- server 不可达时不要编造结果
+- 启动类操作优先按 env 解释
+- 打开项目 / 看分支 / 创建工作区优先按 project 解释
+- 启动成功后的访问地址优先来自 env 的 `host`
+- 删除 mock / 一键 mock / microapp 修改 / 多前缀代理修改要先确认
+
+## Friendly usage examples
+
+### 启动 / 状态 / 日志
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 打开 isource 的日志
+
+### 代理
+- 看 icrc 现在走哪个代理
+- 把 icrc 切到 sitnew
+- 把 ilink 的 /icrc-api 切到 uat
+- 给 ispar 新增 /idea-api
+
+### Mock
+- 打开 iqc-fe 的 mock 功能
+- 打开 iqc-fe 的 mock 拦截
+- 看 mock 列表
+- 把 /api/user/info 切到异常场景
+- 新建一个超时场景
+- 删除这个 mock 场景
+- 一键关闭所有 mock
+
+### MicroApp
+- 看 icrc 挂了哪些微应用
+- 给 isource 挂上 ilink-isource
+- 清空 iua 的微应用代理
+
+### 项目 / 工作区 / 分支
+- 看下工作空间状态
+- 打开 esource-fe
+- 给我建个 ilink-fe 和 iqc-fe 的工作区
+- 看下 esource-fe 分支
+
+## Claude Code 兼容适配
+
+如果你需要使用 Claude Code plugin 兼容层：
+
+### 手动持久化安装
+
+```bash
+claude plugin marketplace add ./plugin-marketplace
+claude plugin install prime-dev-cli@prime-dev-cli-marketplace
+```
+
+### 当前 session 临时加载
+
+```bash
+claude --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```
+
+如果本机有 `cc` 别名，也可以：
+
+```bash
+cc --plugin-dir ./plugin-marketplace/plugins/prime-dev-cli
+```

package/skills/prime-workspace/SKILL.md

@@ -0,0 +1,347 @@
+---
+name: prime-workspace
+description: Use this skill to handle prime-dev-cli workspace operations through natural language, such as starting an env like icrc, checking one app's status, creating or editing mock APIs and Mock.js responses, managing mock scenes, switching proxy targets, and updating microapp bindings.
+---
+
+# prime-workspace
+
+This is the platform-neutral execution spec for `prime-dev-cli`.
+
+The goal is not to expose raw API endpoints to the user. The goal is to let the user speak naturally, for example:
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 把 icrc 切到 sitnew
+- 给 isource 挂上 ilink-isource
+- 把 /api/user/info 切到异常场景
+
+## Preconditions
+
+### Default local server
+- Base URL: `http://localhost:52741`
+
+### Reachability rule
+Before using any action, first verify that the local server is reachable.
+
+If the local server is not reachable:
+- do not fabricate results
+- for packaged users, suggest `prime ui`
+- for repository developers, `pnpm run dev:server` is also acceptable
+
+### Configuration source
+Treat the runtime workspace configuration as the source of truth:
+- current workspace/project/env structure comes from `~/.prime-projects.json`
+- do not rely on stale example config fields if runtime data differs
+
+## Intent-first action map
+
+Do not think in terms of endpoints first. Think in terms of user intent first.
+
+### 1. Workspace status
+Typical requests:
+- 看下工作空间状态
+- 哪些项目还没准备好
+- 项目空间现在什么情况
+
+Use:
+- `GET /api/check-workspace`
+- `GET /api/process/status`
+
+Return:
+- whether workspace exists
+- project counts
+- existing / pending / incomplete projects
+- currently running envs
+
+### 2. Project drill-down
+Typical requests:
+- 看下 esource-fe
+- 看下 esource-fe 分支
+- 打开 esource-fe
+- 给我建个 ilink-fe 和 iqc-fe 的工作区
+
+Use as needed:
+- `GET /api/project-config?project=<projectName>`
+- `GET /api/current-branch?project=<projectName>`
+- `POST /api/open-project`
+- `POST /api/workspace/create`
+
+### 3. Start / stop / status / logs
+Typical requests:
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 打开 isource 的日志
+
+Use:
+- `POST /api/process/start`
+- `DELETE /api/process/start?projectName=<projectName>&envName=<envName>`
+- `GET /api/process/status?projectName=<projectName>&envName=<envName>`
+- `GET /api/process/logs?projectName=<projectName>&envName=<envName>&tail=100`
+
+When starting one env:
+- use that env's configured `startCommand`
+- report the access URL from that env's configured `host`
+- prefer output like:
+  - 已启动 icrc
+  - 访问地址：`http://localhost:8806`
+
+### 4. Mock project-level control
+Typical requests:
+- 打开 iqc-fe 的 mock 功能
+- 关闭 iqc-fe 的 mock 功能
+- 打开 iqc-fe 的 mock 拦截
+- 关闭 iqc-fe 的 mock 拦截
+
+Use:
+- `GET /api/project-config?project=<projectName>`
+- `PUT /api/project-config`
+
+Project-level mock fields:
+- `mockOpen`
+- `mockingIntercept`
+
+### 5. Mock scene management
+Typical requests:
+- 看 mock 列表
+- 把 /api/user/info 切到异常场景
+- 新建一个超时场景
+- 打开这个场景
+- 关闭这个场景
+- 预览 GET /api/user/info 现在返回什么
+
+Use:
+- `GET /api/mock-file?project=<projectName>`
+- `POST /api/mock-file`
+- `GET /api/mock-file-content?project=<projectName>&apiName=<apiName>&method=<method>&siteName=<siteName>`
+- `PUT /api/mock-file-content`
+- `PUT /api/mock-setting`
+- `PUT /api/mock-open-status`
+- `GET /api/get-mock-data?project=<projectName>&url=<url>&method=<method>`
+
+### 6. Mock deletion and bulk toggles
+Typical requests:
+- 删除这个 mock 场景
+- 删除整个 /api/user mock 接口
+- 一键开启所有 mock
+- 一键关闭所有 mock
+
+Use:
+- `DELETE /api/mock-file?project=<projectName>&apiName=<apiName>&method=<method>&siteName=<siteName>`
+- `DELETE /api/delete-mock-api?project=<projectName>&apiName=<apiName>`
+- `POST /api/open-all-mock`
+- `POST /api/cleanup-mock`
+
+### 7. Proxy viewing and editing
+Typical requests:
+- 看 icrc 现在走哪个代理
+- 把 icrc 切到 sitnew
+- 把 ilink 的 /icrc-api 切到 uat
+- 给 ispar 新增 /idea-api
+
+Use:
+- `GET /api/project-config?project=<projectName>`
+- `PUT /api/project-config`
+
+### 8. MicroApp bindings
+Typical requests:
+- 看 icrc 挂了哪些微应用
+- 给 isource 挂上 ilink-isource
+- 清空 iua 的微应用代理
+
+Use:
+- `GET /api/all-projects-envs`
+- `PUT /api/microapp-proxy-config`
+
+## Natural-language routing rules
+
+### Project vs env interpretation
+Normalize both forms:
+- `project` / `projectName`
+- `env` / `envName`
+
+Interpretation priority:
+- start / stop / logs / proxy / microapp -> prefer **env**
+- open project / branch / workspace creation -> prefer **project**
+
+Examples:
+- `帮我启动 icrc` -> treat `icrc` as an env
+- `打开 ilink-fe` -> treat `ilink-fe` as a project
+- `打开 ilink` -> ambiguous, ask whether the user means the project or the env
+
+### Access URL rule
+When an env is running or has just been started:
+- derive the user-facing URL from that env's configured `host`
+- if process APIs also return a port, still prefer `host` as the primary display URL
+
+### Project workspace vs editor workspace
+These are different intents:
+- “创建项目空间” -> initialize/repair local repos
+- “创建工作区” -> create/open a multi-project editor workspace
+
+Do not collapse them into one action.
+
+## Confirmation matrix
+
+Always confirm before:
+- deleting one mock scene
+- deleting a whole mock API
+- opening all mock scenes
+- closing all mock scenes
+- changing microapp selections
+- changing proxies when multiple prefixes may match
+
+Also explain why confirmation is needed.
+
+## Required input rules
+
+### Starting one env
+To start an env reliably, determine:
+- `projectName`
+- `envName`
+- `startCommand` from runtime config
+- `host` from runtime config
+
+If the env name maps cleanly to one configured env, proceed.
+If multiple matches exist, ask a follow-up question.
+
+### Proxy edits
+For proxy edits, determine:
+- `projectName`
+- `envName`
+- target prefix
+- target proxy name or custom URL
+- optional rewrite settings
+
+If the env has multiple prefixes and the user did not specify which one, ask.
+
+### Mock scene operations
+For mock scene operations, determine:
+- `projectName`
+- `apiName`
+- `method`
+- `siteName`
+
+Use “scene” as the user-facing term.
+
+### MicroApp edits
+For microapp operations, determine:
+- `projectName`
+- `envName`
+- `selectedItems`
+
+Important:
+- `selectedItems` are env-name strings
+- they are not full project/env identifiers
+- explain this if the operation may affect expectations
+
+## Request examples
+
+### Workspace status
+```http
+GET /api/check-workspace
+```
+
+### Project config
+```http
+GET /api/project-config?project=esource-fe
+```
+
+### One env status
+```http
+GET /api/process/status?projectName=esource-fe&envName=icrc
+```
+
+### Start one env
+```http
+POST /api/process/start
+Content-Type: application/json
+
+{
+  "projectName": "esource-fe",
+  "envName": "icrc",
+  "startCommand": "npm run serve:c"
+}
+```
+
+### Switch current mock scene
+```http
+PUT /api/mock-setting
+Content-Type: application/json
+
+{
+  "projectName": "iqc-fe",
+  "apiName": "api_user_info",
+  "method": "get",
+  "currentSite": "异常场景"
+}
+```
+
+### Update env proxy config
+```http
+PUT /api/project-config
+Content-Type: application/json
+
+{
+  "projectName": "esource-fe",
+  "envName": "icrc",
+  "apiProxies": []
+}
+```
+
+### Update microapp bindings
+```http
+PUT /api/microapp-proxy-config
+Content-Type: application/json
+
+{
+  "projectName": "isource-fe",
+  "envName": "isource",
+  "selectedItems": ["ilink-isource"]
+}
+```
+
+## Friendly usage examples
+
+### Workspace / project / branch
+- 看下工作空间状态
+- 打开 esource-fe
+- 给我建个 ilink-fe 和 iqc-fe 的工作区
+- 看下 esource-fe 分支
+
+### Start / stop / status / logs
+- 帮我启动 icrc
+- 停掉 ilink-icrc
+- 看看 iqc 在不在跑
+- 打开 isource 的日志
+
+### Proxy
+- 看 icrc 现在走哪个代理
+- 把 icrc 切到 sitnew
+- 把 ilink 的 /icrc-api 切到 uat
+- 给 ispar 新增 /idea-api
+
+### Mock
+- 打开 iqc-fe 的 mock 功能
+- 打开 iqc-fe 的 mock 拦截
+- 看 mock 列表
+- 把 /api/user/info 切到异常场景
+- 新建一个超时场景
+- 删除这个 mock 场景
+- 一键关闭所有 mock
+
+### MicroApp
+- 看 icrc 挂了哪些微应用
+- 给 isource 挂上 ilink-isource
+- 清空 iua 的微应用代理
+
+## Failure handling
+
+If an API fails:
+- name the exact action that failed
+- report whether the likely cause is missing project, missing env, missing local workspace, bad input, or server unavailability
+- do not invent missing values
+
+If a request is ambiguous:
+- ask one narrow follow-up question
+- prefer clarifying project/env/prefix/scene ambiguity before doing anything destructive