alanbox 0.1.2 → 0.1.4

package/README.md

@@ -1,8 +1,8 @@
 # alanbox
 
-`alanbox` is a local worker orchestration CLI for running isolated Codex or Claude child workers.
+`alanbox` is a local AI-tool command package. It routes package resource commands to `0boxer`, worker orchestration to `1swarmer`, runtime UI measurement to `2designer`, and Git weekly report generation to `4reporter`.
 
-The current stable workflow is `swam` / `swarm` from `0commondflowv1`.
+The stable worker workflow is still `swarmer` / `swarm` from `1swarmer`.
 
 ## Install
 
@@ -13,21 +13,32 @@ npm install -g alanbox
 ## Commands
 
 ```powershell
-alanbox info
+swarmer info
 alanbox doctor
 alanbox init
 alanbox update
 alanbox install --target codex
 alanbox install --target claude
 alanbox install --target both
-swam --namespace run-name --worker "codex:reviewer:检查当前改动"
-swam --namespace run-name --worker "claude:reviewer:检查当前改动"
+alanbox designer measure --url "http://localhost:3000" --selector ".dialog"
+designer screenshot --url "http://localhost:3000" --output page.png
+designer changelist --design design.png --runtime runtime.png --output changes.json --annotated changes.png
+reporter weekly --path "C:\path\to\repo-or-file" --user "Your Git Name" --output weekly.md
+alanbox reporter weekly --path "C:\path\to\repo-or-file" --user "you@example.com"
+swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+swarmer --namespace run-name --worker "claude:reviewer:检查当前改动"
+swarmer review-file "C:\path\to\file-or-dir"
+swarmer review-file "C:\path\to\file-or-dir" --review-kind improvements
 ```
 
-`alanbox init` and `alanbox update` prompt you to choose Codex, Claude, or both. The package also exposes `swam` as a direct bin, so worker runs do not need the `alanbox` prefix. `multirunagent` remains available as a compatibility bin name.
+`alanbox init` and `alanbox update` prompt you to choose Codex, Claude, or both. The package also exposes `swarmer`, `designer`, and `reporter` as direct bins, so those flows do not need the `alanbox` prefix.
 
 ## Notes
 
-- `init`, `update`, and `install` explicitly copy bundled skills, hooks, scripts, and MCP resource placeholders to Codex and/or Claude homes.
-- `1uiflowv1` measure and `2apiflowv1` getapi are not exposed by this npm package yet.
-- `swam` is a compatibility alias for `swarm`.
+- `init`, `update`, and `install` explicitly copy bundled skills, hooks, scripts, and MCP resources to Codex and/or Claude homes. Codex installs also append the bundled `mcp/config.toml` Playwright MCP entry when `mcp_servers.playwright` is missing.
+- `cli.js` is the package-level command router. Keep package resource command parsing inside `0boxer/src/cli.js`, worker parsing inside `1swarmer/src/cli.js`, UI parsing inside `2designer/dist/cli.js`, and Git weekly report parsing inside `4reporter/dist/cli.js`.
+- `aibox/skills` is the package-level skill installation source. It can include `2designer` workflow guidance. `designer` is now bundled as a direct bin and as `alanbox designer ...`. `reporter` is bundled as a direct bin and as `alanbox reporter ...`. `3apiflower` is maintained as a separate local `alan-utils` API flow and is not exposed by this npm package yet.
+- `reporter weekly --path <file-or-repo> --user <name-or-email>` scans local Git history for the current week by default and writes a Chinese Markdown weekly report; use `--since`, `--until`, `--current-branch`, `--format json`, and `--include-uncommitted` for narrower runs.
+- `swarmer` is a compatibility alias for `swarm`.
+- `swarmer review-file <file-or-dir>` first asks Codex and Claude to write separate initial Markdown sidecars such as `*.codex.initial.md` and `*.claude.initial.md`, then merges `[codex√]` and `[claude√]` findings into one consensus-chain Markdown report under `C:\Users\lenovo\Desktop\all-project\.tmp\swarm\<yyyy-mm-dd-HHmmss>-<hash>.md` when that workspace exists. Items use tags such as `[codex√]`, `[codex√claude❌]`, and `[codex√claude❌codex√]`; unresolved `❌` items keep being reviewed and finally end with `√`.
+- Use `--phase initial|cross-check|all`, `--report-file <path>`, `--report-dir <path>`, `--providers codex,claude`, and `--review-kind defects|improvements` to resume, split long review runs, or switch between blocker-bug review and actionable-improvement review.

package/bin/alanbox.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+/**
+ * alanbox package command entry.
+ * Keep bin launchers thin and route command handling to package-level cli.js.
+ */
+
+require('../cli').main().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = 1;
+});

package/bin/designer.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+/**
+ * Direct designer bin bundled through alanbox.
+ */
+
+require('../cli').runDesigner().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = error.exitCode || 1;
+});

package/bin/reporter.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+/**
+ * Direct reporter bin bundled through alanbox.
+ */
+
+require('../cli').runReporter().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = error.exitCode || 1;
+});
+

package/bin/swarmer.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+/**
+ * Direct swarmer bin.
+ * Keep it mapped to 1swarmer swarm behavior.
+ */
+
+require('../cli').runSwarmer().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = error.exitCode || 1;
+});

package/cli.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+
+/**
+ * alanbox 包级命令路由器。
+ * 这里只判断进入哪个子流程；各子流程自己的参数解析留在各自实现里。
+ */
+
+const { existsSync } = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const BOXER_COMMANDS = new Set(['install', 'init', 'update']);
+const SWARMER_COMMANDS = new Set(['swarm', 'doctor', 'review-file']);
+const DESIGNER_COMMANDS = new Set(['designer']);
+const REPORTER_COMMANDS = new Set(['reporter']);
+
+async function main(argv = process.argv.slice(2)) {
+  const command = argv[0] && !argv[0].startsWith('-') ? argv[0] : '';
+
+  if (!command) {
+    if (argv.includes('-h') || argv.includes('--help')) {
+      printUsage();
+      return;
+    }
+
+    await runCommonFlow(argv);
+    return;
+  }
+
+  if (command === 'help') {
+    printUsage();
+    return;
+  }
+
+  if (command === 'swarmer') {
+    await runSwarmer(argv.slice(1));
+    return;
+  }
+
+  if (BOXER_COMMANDS.has(command)) {
+    await runBoxer(argv);
+    return;
+  }
+
+  if (SWARMER_COMMANDS.has(command)) {
+    await runSwarmerFlow(argv);
+    return;
+  }
+
+  if (DESIGNER_COMMANDS.has(command)) {
+    await runDesigner(argv.slice(1));
+    return;
+  }
+
+  if (REPORTER_COMMANDS.has(command)) {
+    await runReporter(argv.slice(1));
+    return;
+  }
+
+  throw new Error(`unknown alanbox command: ${command}`);
+}
+
+async function runSwarmer(argv = process.argv.slice(2)) {
+  if (argv[0] === 'info' || argv[0] === 'doctor' || argv[0] === 'review-file') {
+    await runSwarmerFlow(argv);
+    return;
+  }
+
+  await runSwarmerFlow(['swarm', ...argv]);
+}
+
+async function runBoxer(argv) {
+  await require('./0boxer/src/cli').main(argv);
+}
+
+async function runSwarmerFlow(argv) {
+  await require('./1swarmer/src/cli').main(argv);
+}
+
+async function runCommonFlow(argv) {
+  await runSwarmerFlow(argv);
+}
+
+async function runDesigner(argv = process.argv.slice(2)) {
+  const cliPath = path.join(__dirname, '2designer', 'dist', 'cli.js');
+  if (!existsSync(cliPath)) {
+    throw new Error(
+      'designer dist/cli.js not found. Build it from 2designer before running this command.',
+    );
+  }
+
+  await runNodeCli('designer', cliPath, argv);
+}
+
+async function runReporter(argv = process.argv.slice(2)) {
+  const cliPath = path.join(__dirname, '4reporter', 'dist', 'cli.js');
+  if (!existsSync(cliPath)) {
+    throw new Error(
+      'reporter dist/cli.js not found. Build it from 4reporter before running this command.',
+    );
+  }
+
+  await runNodeCli('reporter', cliPath, argv);
+}
+
+function runNodeCli(label, cliPath, argv) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [cliPath, ...argv], {
+      stdio: 'inherit',
+      env: process.env,
+    });
+
+    child.on('error', reject);
+    child.on('exit', (code, signal) => {
+      if (signal) {
+        reject(new Error(`${label} exited with signal ${signal}`));
+        return;
+      }
+
+      if (code && code !== 0) {
+        const error = new Error(`${label} exited with code ${code}`);
+        error.exitCode = code;
+        reject(error);
+        return;
+      }
+
+      resolve();
+    });
+  });
+}
+
+function printUsage() {
+  console.log(`
+alanbox command router
+
+Usage:
+  alanbox doctor
+  alanbox install --target codex|claude|both
+  swarmer info
+  swarmer doctor
+  swarmer review-file C:\\path\\to\\file.ts
+  alanbox swarmer [options] --worker "codex:<role>:<prompt>"
+  alanbox swarm [options] --worker "codex:<role>:<prompt>"
+  alanbox review-file C:\\path\\to\\file.ts
+  swarmer [options] --worker "codex:<role>:<prompt>"
+  alanbox designer <command> [options]
+  designer <command> [options]
+  alanbox reporter weekly --path C:\\repo --user "Your Git Name"
+  reporter weekly --path C:\\repo --user "Your Git Name"
+
+Command groups:
+  install, init, update          0boxer package/resource commands
+  swarmer, swarm, doctor         1swarmer worker orchestration and provider diagnostics
+  swarmer info                   1swarmer worker execution config check
+  designer                       2designer runtime UI measurement CLI
+  reporter                       4reporter Git weekly report CLI
+
+Examples:
+  swarmer info
+  swarmer doctor
+  swarmer review-file C:\\repo\\src\\index.ts
+  swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+  alanbox designer measure --url http://localhost:3000 --selector ".dialog"
+  alanbox designer screenshot --url http://localhost:3000 --output page.png
+  reporter weekly --path C:\\repo --user "Your Git Name" --output weekly.md
+`);
+}
+
+module.exports = {
+  main,
+  printUsage,
+  runBoxer,
+  runCommonFlow,
+  runSwarmerFlow,
+  runSwarmer,
+  runDesigner,
+  runReporter,
+};

package/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-  "description": "Optional Codex hook examples for multirunagent. Keep disabled unless the local Codex hook schema is explicitly configured.",
+  "description": "Optional Codex hook examples for alanbox. Keep disabled unless the local Codex hook schema is explicitly configured.",
   "hooks": {
     "SessionStart": [
       {

package/mcp/README.md

@@ -2,4 +2,10 @@
 
 This directory is reserved for optional alanbox MCP resources.
 
-The installer copies this directory to Codex and Claude resource homes when present. No MCP server is implemented here yet; keep this placeholder so packaged installs still create the target `mcp/alanbox` directory.
+The installer copies this directory to Codex and Claude resource homes when present. No alanbox-owned MCP server is implemented here yet; keep this placeholder so packaged installs still create the target `mcp/alanbox` directory.
+
+For Codex installs, `alanbox install/init/update --target codex` also ensures the user's Codex MCP config has the bundled `mcp_servers.playwright` entry from `config.toml`. Existing Playwright MCP entries are left untouched.
+
+### Important files
+
+- `config.toml` — source MCP config fragment copied into Codex config only when `[mcp_servers.playwright]` is missing.

package/mcp/config.toml

@@ -0,0 +1,4 @@
+[mcp_servers.playwright]
+args = ["-y", "@playwright/mcp@0.0.76"]
+command = "npx"
+startup_timeout_sec = 120

package/package.json

@@ -1,16 +1,24 @@
 {
   "name": "alanbox",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Run isolated child Codex or Claude workers with serial, parallel, and auto swarm orchestration.",
-  "main": "0commondflowv1/src/cli.js",
+  "main": "cli.js",
   "bin": {
-    "alanbox": "bin/multirunagent.js",
-    "multirunagent": "bin/multirunagent.js",
-    "swam": "bin/multirunagent.js"
+    "alanbox": "bin/alanbox.js",
+    "swarmer": "bin/swarmer.js",
+    "designer": "bin/designer.js",
+    "reporter": "bin/reporter.js"
   },
   "files": [
+    "cli.js",
     "bin/**",
-    "0commondflowv1/**",
+    "shared/**",
+    "0boxer/**",
+    "1swarmer/**",
+    "2designer/package.json",
+    "2designer/dist/**",
+    "4reporter/package.json",
+    "4reporter/dist/**",
     "skills/**",
     "plugin/**",
     "hooks/**",
@@ -20,10 +28,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "swarm": "node bin/multirunagent.js swarm",
-    "doctor": "node bin/multirunagent.js doctor",
-    "test": "node bin/multirunagent.js --help && node bin/multirunagent.js info",
-    "validate": "node bin/multirunagent.js info"
+    "swarm": "node bin/swarmer.js",
+    "doctor": "node bin/alanbox.js doctor",
+    "designer": "node bin/designer.js",
+    "reporter": "node bin/reporter.js",
+    "test": "node bin/alanbox.js --help && node bin/alanbox.js swarmer info && node bin/swarmer.js info && node bin/swarmer.js doctor --help && node bin/designer.js --help && node bin/reporter.js --help",
+    "validate": "node bin/swarmer.js info && node bin/designer.js --help && node bin/reporter.js --help"
   },
   "keywords": [
     "codex",
@@ -41,6 +51,13 @@
   },
   "engines": {
     "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "sharp": "^0.34.5",
+    "ws": "^8.20.0"
+  },
+  "optionalDependencies": {
+    "playwright": "^1.59.1"
   }
 }
-

package/plugin/AGENTS.md

@@ -1,12 +1,12 @@
 ## alanbox plugin
 
-`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\plugin` 存放源码侧 Codex plugin manifest。安装时 `0commondflowv1/src/commands/install.js` 会把本目录复制到用户插件目录的 `plugins/alanbox/.codex-plugin/`，所以源码目录名是 `plugin/`，安装目标目录名才是 `.codex-plugin/`。
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\plugin` 存放源码侧 Codex plugin manifest。安装时 `0boxer/src/commands/install.js` 会把本目录复制到用户插件目录的 `plugins/alanbox/.codex-plugin/`，所以源码目录名是 `plugin/`，安装目标目录名才是 `.codex-plugin/`。
 
 **Important:** 这里是 Codex 插件展示与 skill 发现配置，不是 Claude 配置。Claude 侧只复用 `skills/`、`hooks/`、`scripts/`、`mcp/` 资源，不读取 `plugin.json`。
 
 ### Important files
 
-- `plugin.json` — Codex plugin manifest；`skills` 必须继续指向 `./skills/`，默认提示词应只描述当前真实入口 `swam`/`swarm`、`info`、`doctor`。
+- `plugin.json` — Codex plugin manifest；`skills` 必须继续指向 `./skills/`，默认提示词应只描述当前真实入口 `aitool`、`swarmer`/`swarm`、`info`、`doctor` 和 `designer`。
 
 ### Implementation notes
 

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "alanbox",
-  "version": "0.1.1",
-  "description": "Codex skills for using alanbox to run isolated Codex or Claude child workers.",
+  "version": "0.1.2",
+  "description": "Codex skills for using alanbox AI tools, swarmer worker orchestration, and designer UI measurement.",
   "author": {
     "name": "local"
   },
@@ -16,8 +16,8 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "alanbox",
-    "shortDescription": "Use alanbox swam/swarm to run child Codex or Claude workers.",
-    "longDescription": "Provides concise skills that explain how to call alanbox for swam/swarm, parallel worker scheduling, auto workflow, and doctor checks.",
+    "shortDescription": "Use alanbox for swarmer workers, diagnostics, and designer UI measurement.",
+    "longDescription": "Provides concise skills that explain how to choose alanbox tools, call swarmer/swarm for child workers, run parallel or auto workflows, diagnose with info/doctor, and use designer for UI measurement.",
     "developerName": "local",
     "category": "Productivity",
     "capabilities": [
@@ -25,9 +25,9 @@
       "Automation"
     ],
     "defaultPrompt": [
-      "Use alanbox swam to run one child Codex worker.",
-      "Use alanbox swam to run one child Claude worker.",
-      "Plan a serial swam workflow for this task."
+      "Choose the correct alanbox tool for this task.",
+      "Use swarmer to run child Codex or Claude workers.",
+      "Use designer to measure or compare runtime UI when needed."
     ]
   }
 }

package/shared/AGENTS.md

@@ -0,0 +1,15 @@
+## shared
+
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\shared` 存放 `alanbox` 包级共享工具。这里的代码可以被 `0boxer`、根 CLI 或其他流程复用，但必须保持轻量、无副作用，不应放具体业务流程的 runner、安装写入逻辑或 provider 调用。
+
+**Important:** 共享工具被发布包使用时，必须确认 `package.json.files` 包含 `shared/**`。不要把 `1swarmer` 的 worker/swarm 参数解析搬到这里，除非后续明确要做跨流程统一参数模型。
+
+### Important files
+
+- `package-args.js` — 包级资源命令参数解析器；当前服务 `0boxer` 的 `install/init/update`，只解析 target 相关选项。
+
+### Implementation notes
+
+- 共享模块不要在 require 时读写用户目录、启动 provider、读取个人配置或修改环境变量。
+- 新增共享工具时，优先让命名表达所属语义，例如 `package-*`、`path-*`，避免和 `1swarmer/src/args.js` 这种流程专属模块混淆。
+- 修改共享模块后，从包根目录运行 `npm test` 和 `npm run validate`；涉及发布包内容时再跑 `npm pack --json --dry-run`。

package/shared/package-args.js

@@ -0,0 +1,68 @@
+/**
+ * Package-resource command argument parser.
+ * This parser is intentionally separate from 1swarmer worker/swarm args.
+ */
+
+const VALUE_FLAGS = new Set(['target', 'to', 'platform']);
+const BOOLEAN_FLAGS = new Set(['codex', 'claude', 'both']);
+
+function parsePackageArgs(argv = []) {
+  const result = { _: [] };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+
+    if (arg === '--') {
+      result._.push(...argv.slice(i + 1));
+      break;
+    }
+
+    if (!arg.startsWith('-') || arg === '-') {
+      result._.push(arg);
+      continue;
+    }
+
+    const { key, inlineValue } = splitFlag(arg);
+
+    if (BOOLEAN_FLAGS.has(key)) {
+      if (inlineValue !== undefined) {
+        throw new Error(`${formatFlag(key)} does not take a value`);
+      }
+
+      result[key] = true;
+      continue;
+    }
+
+    if (VALUE_FLAGS.has(key)) {
+      const value = inlineValue !== undefined ? inlineValue : argv[i + 1];
+      if (inlineValue === undefined) i += 1;
+
+      if (!value || String(value).startsWith('-')) {
+        throw new Error(`missing value for ${formatFlag(key)}`);
+      }
+
+      result[key] = value;
+      continue;
+    }
+
+    throw new Error(`unknown package option: ${arg}`);
+  }
+
+  return result;
+}
+
+function splitFlag(arg) {
+  const [keyPart, inlineValue] = arg.split('=', 2);
+  return {
+    key: keyPart.replace(/^--?/, ''),
+    inlineValue,
+  };
+}
+
+function formatFlag(key) {
+  return `--${key}`;
+}
+
+module.exports = {
+  parsePackageArgs,
+};

package/skills/AGENTS.md

@@ -1,17 +1,21 @@
 ## aibox skills
 
-`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills。当前只描述 `0commondflowv1` 的 `swam`/`swarm`、`info` 和 `doctor` 用法；不要在这里接入 `1uiflowv1` 的 measure 或 `2apiflowv1` 的 getapi，除非用户重新明确要求。
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills，按 `0boxer` 的安装命令作为统一安装源。当前用 `swarmer` 承载 `1swarmer` 的 `swarmer`/`swarm`、`info` 用法，用 `aitool` 作为 alanbox 总入口说明，并保留用户明确要求接入的 `2designer` UI 高精度还原 workflow；不要在这里接入 `3apiflower` 的 `alan-utils` / `st`，除非用户重新明确要求。
 
-**Important:** skills 只写调用 workflow，不实现业务逻辑。worker 执行示例优先使用裸 `swam ...`；初始化和资源更新使用 `alanbox init` / `alanbox update`；本地源码调试才使用 `node bin/multirunagent.js ...`。
+**Important:** skills 只写调用 workflow，不实现业务逻辑。worker 执行示例优先使用裸 `swarmer ...`；初始化和资源更新使用 `alanbox init` / `alanbox update`；本地源码调试才使用 `node bin/alanbox.js ...`。
+
+**Important:** 本目录是 `alanbox install/init/update` 的安装源；`2designer` 不再维护 standalone skill 发布入口。`designer` 相关 agent workflow 以本目录 `desginer/SKILL.md` 为准。
 
 ### Important files
 
-- `aibox-swam/SKILL.md` — 通用 swam workflow skill；同时适用于 Codex 和 Claude，示例应覆盖 `codex:` 与 `claude:` worker。
-- `sub-codex-swarm/SKILL.md` — 兼容旧触发名的 swarm skill；保留但内容必须和当前 `swam`/`swarm` CLI 行为一致。
-- `sub-codex-doctor/SKILL.md` — 诊断 skill；只指导调用 `info` 和 `doctor`。
+- `aitool/SKILL.md` — `alanbox` 总入口 skill；用于在 `swarmer`、`designer` 和安装/更新命令之间选择正确入口。
+- `swarmer/SKILL.md` — 合并后的 worker 编排、配置检查与 provider 诊断 skill；同时覆盖 `codex:`、`claude:` worker、串行/并行/auto workflow、`info` 和 `doctor`。
+- `desginer/SKILL.md` — `2designer` 的 UI 高精度还原 workflow；目录名当前按现状保留，内容通过 `designer` 的 `measure` / `screenshot` / `overlay` / `changelist` 命令做设计稿网站与运行页的像素级对比，并要求用 `all/message.md` 固定截图坐标、用 `regions\word\<id>` 调用 `codex:` 或 `claude:` 子 agent 并发生成组件树 TODO。
 
 ### Implementation notes
 
 - 新增或修改 CLI 参数时，同步检查对应 `SKILL.md` 示例。
 - `install` 会把本目录中含 `SKILL.md` 的子目录安装到 Codex 的 `~/.codex/skills`，以及 Claude 的 `~/.claude/skill`。
+- `desginer` 调用的是 `designer` CLI；更新 `2designer` 的命令名、参数或产物路径约定时，同步更新本目录同名 skill。UI 对齐流程的长期产物约定包括 `all\message.md`、每轮 `changelist.json`、`regions\word|graphic\<id>` 和合并后的组件树 `todo.json`。
+- `aibox-swarmer`、`sub-codex-swarmer`、`sub-codex-doctor` 已合并进 `swarmer`；安装/更新逻辑会清理这些旧 skill 名，避免用户环境里出现重复入口。
 - 不要把一次性本机 runId、账号、token、私有服务地址写进 skill。

package/skills/aitool/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: aitool
+description: 当需要使用 alanbox 这个本地 AI 工具包，并需要在 swarmer worker 编排、designer UI 测量或安装/更新资源之间选择正确入口时使用。
+---
+
+# aitool
+
+`alanbox` 是本机 AI 工具包的总入口。先判断任务属于哪一类，再调用对应 CLI 或 skill；不要把所有参数解析都塞到一个命令里。
+
+## 入口选择
+
+- 子 worker 编排、串行/并行复核、自动 workflow 和 `info` 配置检查：使用 `swarmer` skill 和 `swarmer` / `alanbox swarm` 命令。
+- provider 健康检查：使用 `alanbox doctor` 或 `swarmer doctor`，该命令归 `1swarmer`。
+- UI 高精度还原、运行页测量、截图、overlay 对比：使用 `designer` CLI；如果任务是按设计稿精修页面，优先使用当前安装的 UI 还原 skill。
+- 安装或更新 Codex/Claude 资源：使用 `alanbox init`、`alanbox update` 或 `alanbox install --target codex|claude|both`。
+- `3apiflower` API flow 当前作为独立本地 `alan-utils` / `st` 工作区维护，不作为 `alanbox` npm 包公开命令；除非用户明确要求，不要把它接进 skills 或默认入口。
+
+## 常用命令
+
+```powershell
+alanbox --help
+swarmer info
+alanbox doctor
+alanbox install --target codex
+alanbox install --target claude
+swarmer --namespace run-name --worker "codex:reviewer:检查当前改动"
+designer measure --url "http://localhost:3000" --selector ".dialog"
+designer screenshot --url "http://localhost:3000" --output page.png
+```
+
+## 维护边界
+
+- CLI 负责真实执行；skills 只负责指导调用。
+- `swarmer` 是 worker 编排稳定入口；内部 `swarm` 是同一条执行链路。
+- `designer` 只采集运行时 UI 数据和图片，不替 agent 做判断。
+- 安装命令会复制 bundled skills、hooks、scripts 和 MCP 占位资源；普通 `npm install` / `npx` 不应隐式注入用户 agent skills。