@givolt/i3-composer-agent 2.2.0 → 2.2.1

package/.agents/plugins/marketplace.json

@@ -6,7 +6,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.2.0",
+      "version": "2.2.1",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "source": {
         "source": "local",

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
   "plugins": [
     {
       "name": "i3-composer-agent",
-      "version": "2.2.0",
+      "version": "2.2.1",
       "source": "./",
       "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
       "homepage": "https://github.com/49780522/i3-composer-agent",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "i3-composer-agent",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "覆盖需求、计划、开发、测试、审查与发布的软件工程技能，默认使用简体中文。",
   "author": {
     "name": "Givolt"

package/README.md

@@ -1,4 +1,4 @@
-# i3 Composer Agent v2.2.0
+# i3 Composer Agent v2.2.1
 
 **Intelligence. Integration. Innovation.**
 
@@ -18,13 +18,14 @@ npx @givolt/i3-composer-agent --workbuddy --scope global
 ```
 
 首屏依次为 CodeBuddy、WorkBuddy、Codex、Claude Code、Cursor、Gemini CLI，
-WorkBuddy 在第 2 项。选 `7`/`更多` 打开其余工具，每页 10 项；`n` 下一页、`p` 上一页、
-`b` 返回，`/关键词` 搜索全部 80 个工具。编号在分页和搜索中保持一致。
-输入编号或 ID（中英文逗号均可）累积多选，跨页保留；`-编号/ID` 移除选择。
-回车或 `done`/`完成` 确认已选工具，随后选择项目/全局范围并确认安装；`q`/`取消` 退出。
-通过参数预选的工具会保留，仍可继续多选。
-
-全部目标均安装 25 个技能和共享参考资料。
+WorkBuddy 在第 2 项。上下键移动，空格勾选/取消，回车确认；列表原地刷新，
+下方实时显示已选工具。移到“更多”按空格或直接按 `m` 打开其他工具。
+更多列表上下移动可跨页，`n`/`p` 或 PageDown/PageUp 整页翻页，`b`/左键返回常用。
+按 `/` 输入关键词实时搜索全部 80 个工具；回车或下键结束输入，再用空格选择。
+搜索、翻页和命令参数预选均保留选择。搜索外 `q`、Esc 或 Ctrl-C 取消。
+确认工具后选择项目/全局范围并确认安装。
+
+全部目标均安装 25 个技能、共享参考资料，以及完整评测/Hook/脚本配套。
 CodeBuddy、WorkBuddy、Claude Code 另安装 9 个短命令和 4 个 Agent 角色。
 其他工具通过其原生 Skills 机制使用；短命令支持取决于宿主。
 目录预设来自固定的 [Skills CLI 工具登记](https://github.com/vercel-labs/skills/blob/48dc9e8eb8aa19040e91cb90ba0b642c9cbad57e/src/agents.ts)
@@ -55,9 +56,45 @@ CodeBuddy 和 WorkBuddy 的项目安装共用 `.codebuddy/`，相同目标只安
 迁移只清理旧清单所属的无前缀 Skill/命令路径，保留自定义内容。
 标准 MIT 许可随共享参考资料安装。`npx -y` 确认 npm 下载；包的 `--yes` 确认安装计划。
 
-## 注册完整插件
+## 安装内容与可选功能
+
+| 内容 | 默认安装 | 用途 |
+| --- | --- | --- |
+| `skills/`（含技能内部的 `scripts/` 等资源） | 是 | 工程工作流及运行辅助文件 |
+| `references/` | 是 | 技能引用的检查清单与参考资料 |
+| `commands/`、`agents/` | CodeBuddy、WorkBuddy、Claude Code | 短命令与专业角色 |
+| `hooks/` | 是，文件安装后按宿主方式启用 | 会话注入、文档缓存和代码块保护 |
+| `scripts/` | 是 | 评测运行器、五项校验脚本及其共享库 |
+| `evals/` | 是 | 中英文触发/行为用例、测试项目样例及插件评分规则 |
+
+完整配套默认放在宿主目录下的 `i3-composer-agent/`，例如
+`.codebuddy/i3-composer-agent/` 或 `~/.workbuddy/i3-composer-agent/`。
+其中保留对应的技能、命令、角色、参考资料与清单，供评测、校验和 Hook 的相对路径使用；
+宿主调用入口继续安装在其原生目录。该配套与技能一起升级、复用和失败恢复。
+
+从配套目录运行以下检查，不调用模型：
+
+```bash
+npm test
+node scripts/run-evals.js --locale zh-CN --min-rank1 95
+```
+
+模型行为评测需要主动运行并消耗模型额度，详见 [评测说明](evals/README.md)。
+本包的 `npm test` 检查随包技能的结构和中英文触发，不是业务项目测试或宿主执行验收。
+评测结果不进入安装替换清单。安装过程不执行评测，也不自动启用 Hook。
+
+可选 Hook 不影响普通技能和命令的使用，默认中文交互也不依赖 Hook。
+未配置 Hook 时，自动注入、缓存和代码块保护这些增强功能不会运行。
+会话注入仅适合缺少原生技能路由的宿主；已有原生路由时不应重复注入元技能。
+缓存与代码块保护的配置说明分别在配套目录的 `hooks/SDD-CACHE.md`、
+`hooks/SIMPLIFY-IGNORE.md`，当前示例针对 Claude Code，其他宿主需适配自己的事件协议。
+脚本依赖 Bash、jq；缓存还需 curl 和哈希工具，代码块保护还需其文档列出的工具。
+Windows PowerShell 本身不会自动提供这些脚本依赖。
+
+## 通过宿主插件管理器安装
 
-完整插件包含 Skills、Commands、Agents、Hooks 和 references。准备持久目录：
+默认配套已包含 Skills、Commands、Agents、references、evals、hooks 和 scripts。
+若希望另行导出目录，交给宿主插件管理器管理：
 
 ```bash
 npx @givolt/i3-composer-agent --prepare --codebuddy
@@ -65,7 +102,9 @@ npx @givolt/i3-composer-agent --prepare --codex
 npx @givolt/i3-composer-agent --prepare --claude
 ```
 
-此模式准备 `./i3-composer-agent/` 并输出宿主注册命令。
+`--prepare` 只准备 `./i3-composer-agent/` 运行文件并输出宿主注册命令，
+不会把插件自动注册到宿主，也不会启用可选 Hook。普通技能安装完成后无需再执行它。
+需要让宿主插件管理器统一发现和管理插件时，再按下面步骤注册：
 在 CodeBuddy Code（终端）或 Claude Code 中执行：
 
 ```text
@@ -80,8 +119,8 @@ codex plugin marketplace add ./i3-composer-agent
 codex plugin add i3-composer-agent@i3-composer-agent
 ```
 
-按宿主管理器选择安装范围，启用后新建会话。原生文件安装与完整插件注册是两种入口。
-原生安装不自动启用插件 Hook；无需 Hook，入口本身也要求默认中文回复。
+按宿主管理器选择安装范围，启用后新建会话。原生文件安装与插件注册是两种入口。
+本包没有默认 Hook 注册配置；插件启用后，可选 Hook 仍需按上面的用途和宿主要求单独配置。
 
 ## 命令
 

package/bin/asset-fingerprint.cjs

@@ -21,6 +21,7 @@ function fingerprint(file, asset) {
     if (stat.isDirectory()) {
       for (const entry of fs.readdirSync(current).sort()) {
         if (asset && entry === '.DS_Store') continue;
+        if (asset?.kind === 'support' && ['results', 'node_modules', '.git'].includes(entry)) continue;
         if (!visit(path.join(current, entry), path.join(relative, entry))) return false;
       }
     } else {

package/bin/i3-composer-agent.cjs

@@ -34,7 +34,7 @@ ${pkg.name}
   --project-dir <dir> 项目安装根目录，默认当前目录
   --yes              确认明确指定的非交互安装
   --list-agents      列出全部支持的工具目录
-  --prepare          准备完整插件，供宿主原生插件管理器注册
+  --prepare          另行导出插件目录并显示宿主注册步骤
   --extract          导出完整插件内容
   --dir <directory>  插件输出目录；隐含 --prepare
   --dry-run          显示安装/导出计划，不写入文件
@@ -43,11 +43,13 @@ ${pkg.name}
   --help             显示帮助
 
 终端向导先显示常用工具，WorkBuddy 在第 2 项；选择“更多”可分页/搜索全部工具。
-编号或 ID 支持多选，跨页保留选择；回车或 done/完成确认，q/取消退出。
+上下键移动/跨页，空格勾选/取消，回车确认；列表下实时显示已选，q/Esc 退出。
 CodeBuddy、WorkBuddy、Claude Code 同时安装短命令和 Agent 角色。
-其他工具获得 Skills 与参考资料，短命令支持取决于宿主。
+其他工具通过 Skills 调用，短命令支持取决于宿主。
+所有工具默认安装完整配套目录 i3-composer-agent/，含 evals、hooks、scripts 及所需资料。
 WorkBuddy 桌面版建议全局安装，便于技能列表和输入补全发现。
-完整插件及 Hook 注册使用 --prepare。
+评测需主动运行；Hook 文件已提供，需按宿主事件协议单独启用。
+--prepare 仅供插件管理器安装方式使用，不自动注册插件或启用 Hook。
 `;
 
 function quote(value) { return "'" + value.replaceAll("'", "'\\''") + "'"; }
@@ -134,6 +136,7 @@ function prepare() {
   }
   console.log(identity);
   console.log(`已在 ${directory} 准备好 ${name}`);
+  console.log('包含 evals、hooks、scripts 及依赖资料；评测需主动运行，Hook 需按宿主事件协议启用。');
   if (host === 'extract') return;
   console.log('\n请在目标宿主中执行以下原生命令注册并启用插件：');
   const selector = `${name}@${name}`;
@@ -199,10 +202,11 @@ async function main() {
   for (const target of plan.targets) {
     console.log(`已为 ${target.agents.join(', ')} 安装技能：${target.skillsDirectory}`);
     if (target.commandsDirectory) console.log(`命令：/i3-spec、/i3-plan、/i3-build、/i3-ship（共 ${fs.readdirSync(target.commandsDirectory).filter(file => file.endsWith('.md')).length} 个工作流）：${target.commandsDirectory}`);
+    console.log(`配套目录（含 evals、hooks、scripts）：${target.supportDirectory}`);
+    console.log(`中文评测：node "${path.join(target.supportDirectory, 'scripts/run-evals.js')}" --locale zh-CN --min-rank1 95`);
   }
   console.log('请重新加载 IDE 窗口或新建宿主会话以发现安装内容。');
   if (plan.agents.some(id => !['codebuddy', 'workbuddy', 'claude-code'].includes(id))) console.log('这些工具通过技能 ID 调用；生命周期短命令支持取决于宿主。');
-  console.log('原生技能安装完成；插件 Hook 需按宿主方式注册和启用。');
-  if (plan.agents.some(id => ['codebuddy', 'codex', 'claude-code'].includes(id))) console.log('如需 CodeBuddy、Codex 或 Claude Code 完整插件，请使用 --prepare 和对应宿主参数。');
+  console.log('安装完成。评测运行方式见配套目录 evals/README.md；Hook 文件已安装，尚未启用。');
 }
 main().catch(error => { console.error(`${name}: ${error.message}`); process.exitCode = 1; });

package/bin/install.cjs

@@ -11,6 +11,7 @@ const { fingerprint } = require('./asset-fingerprint.cjs');
 const root = path.resolve(__dirname, '..');
 const name = 'i3-composer-agent';
 const version = require('../package.json').version;
+const pluginFiles = require('../package.json').i3ComposerAgent.pluginFiles;
 const aliases = { claude: 'claude-code', gemini: 'gemini-cli', copilot: 'github-copilot' };
 function exists(file) {
   try { fs.lstatSync(file); return true; }
@@ -46,9 +47,10 @@ function checkDestination(file) {
     throw new Error('安装目标必须位于包目录之外。');
   }
 }
+function assetPath(base, file) { return path.relative(base, file).split(path.sep).join('/'); }
 function manifestContent(plan, asset) {
   return JSON.stringify({ name, version, entryPrefix: 'i3-', scope: plan.scope, agents: asset.target.agents,
-    assets: plan.assets.filter(item => item.base === asset.base && item.kind !== 'legacy').map(item => path.relative(asset.base, item.destination)) }, null, 2) + '\n';
+    assets: plan.assets.filter(item => item.base === asset.base && item.kind !== 'legacy').map(item => assetPath(asset.base, item.destination)) }, null, 2) + '\n';
 }
 function planInstallation({ agents, scope, projectDir = process.cwd(), home = os.homedir(), env = process.env }) {
   agents = selectAgents(agents);
@@ -59,7 +61,7 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
     const agent = registry.agents.find(item => item.id === id);
     const skillsDirectory = destination(scope === 'project' ? path.resolve(projectDir, agent.projectSkillsDir) : globalSkillsDir(agent, home, env));
     const base = path.dirname(skillsDirectory);
-    if (!targets.has(skillsDirectory)) targets.set(skillsDirectory, { agents: [], skillsDirectory, referencesDirectory: path.join(base, 'references'), base });
+    if (!targets.has(skillsDirectory)) targets.set(skillsDirectory, { agents: [], skillsDirectory, referencesDirectory: path.join(base, 'references'), supportDirectory: path.join(base, name), base });
     const target = targets.get(skillsDirectory);
     target.agents.push(id);
     if (['codebuddy', 'workbuddy', 'claude-code'].includes(id)) {
@@ -82,6 +84,9 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
     const previous = exists(manifestFile) && !fs.lstatSync(manifestFile).isSymbolicLink()
       ? JSON.parse(fs.readFileSync(manifestFile, 'utf8')) : undefined;
     const owned = previous?.name === name && Array.isArray(previous.assets);
+    // Earlier Windows installs persisted backslashes. Normalize before lookup
+    // and containment checks so owned upgrades work across both manifest forms.
+    if (owned) previous.assets = previous.assets.map(relative => typeof relative === 'string' ? relative.replaceAll('\\', '/') : relative);
     const sameVersion = owned && previous.version === version && previous.scope === scope && previous.entryPrefix === 'i3-';
     if (owned && previous.scope === scope && Array.isArray(previous.agents)) {
       const applicable = previous.agents.filter(id => {
@@ -105,16 +110,25 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
     const licenseDirectory = path.join(target.referencesDirectory, name);
     if (exists(licenseDirectory) && fs.lstatSync(licenseDirectory).isSymbolicLink()) throw new Error(`安装目录是符号链接（symlink）： ${licenseDirectory}.`);
     assets.push({ source: path.join(root, 'LICENSE'), destination: destination(path.join(licenseDirectory, 'LICENSE')), kind: 'attribution' });
+    // Keep the canonical plugin layout for eval fixtures, validators and Hook
+    // relative paths. Native entry points above remain host-adapted copies.
+    for (const relative of pluginFiles) {
+      const file = path.join(target.supportDirectory, relative);
+      if (destination(file) !== file) throw new Error(`配套目录包含符号链接（symlink）： ${file}`);
+      assets.push({ source: path.join(root, relative), destination: file, kind: 'support' });
+    }
     if (owned) {
       const legacy = fs.readdirSync(path.join(root, 'skills')).filter(id => id.startsWith('i3-')).map(id => `skills/${id.slice(3)}`);
       if (target.commandsDirectory) legacy.push(...fs.readdirSync(path.join(root, '.claude/commands')).filter(file => file.startsWith('i3-') && file.endsWith('.md')).map(file => `commands/${file.slice(3)}`));
       legacy.push(`${name}-LICENSE`, `${name}-NOTICE.md`);
-      const current = new Set(assets.slice(start).map(asset => path.relative(target.base, asset.destination)));
+      const current = new Set(assets.slice(start).map(asset => assetPath(target.base, asset.destination)));
       for (const relative of previous.assets) {
-        // Only installer-owned top-level assets can be retired. Ignore malformed
-        // or escaping manifest paths rather than extending their deletion scope.
-        if (typeof relative !== 'string' || !/^(skills|commands|agents|references)\/[^/\\]+$/.test(relative)
-          || relative.includes('\0') || ['.', '..'].includes(relative.split('/')[1])) continue;
+        // Retire only owned native entries or entries inside this package's
+        // companion directory. Never let a manifest extend the deletion scope.
+        if (typeof relative !== 'string' || relative.includes('\0') || relative.includes(':')
+          || relative.split('/').some(part => ['', '.', '..'].includes(part))) continue;
+        if (!/^(skills|commands|agents|references)\/[^/]+$/.test(relative) && !relative.startsWith(`${name}/`)) continue;
+        if (relative.startsWith(`${name}/`) && destination(path.join(target.base, relative)) !== path.join(target.base, relative)) continue;
         if (!current.has(relative)) legacy.push(relative);
       }
       for (const relative of new Set(legacy)) {
@@ -128,7 +142,7 @@ function planInstallation({ agents, scope, projectDir = process.cwd(), home = os
       asset.buddyCommand = asset.kind === 'command' && target.agents.some(id => ['codebuddy', 'workbuddy'].includes(id));
       asset.scope = scope;
       asset.personasDirectory = target.personasDirectory;
-      if (sameVersion && previous.assets.includes(path.relative(target.base, asset.destination)) && asset.source && exists(asset.destination)) {
+      if (sameVersion && previous.assets.includes(assetPath(target.base, asset.destination)) && asset.source && exists(asset.destination)) {
         asset.expectedFingerprint = fingerprint(asset.source, asset);
         asset.reusable = fingerprint(asset.destination) === asset.expectedFingerprint;
       }
@@ -180,7 +194,8 @@ function executeInstallation(plan, { force = false } = {}) {
       } else {
         fs.cpSync(asset.source, asset.staged, { recursive: true, filter: file => {
           if (fs.lstatSync(file).isSymbolicLink()) throw new Error(`包内容中包含符号链接（symlink）： ${file}`);
-          return path.basename(file) !== '.DS_Store';
+          return path.basename(file) !== '.DS_Store' && (asset.kind !== 'support'
+            || !/(?:^|[\\/])(?:results|node_modules|\.git)(?:[\\/]|$)/.test(path.relative(root, file)));
         } });
         portable(asset.staged, asset, asset.source.endsWith('.md'));
       }

package/bin/native-content.cjs

@@ -10,6 +10,7 @@ function replaceBlock(content, name, replacement) {
 // Adapt stable blocks, never their prose. Shared project commands work for
 // either Buddy client; global paths belong to the selected profile.
 function nativeContent(content, asset) {
+  if (asset.kind === 'support') return content;
   content = content.replaceAll('i3-composer-agent:', '').replaceAll('agent-skills:', '');
   if (!asset.buddyCommand) return content;
   const projectPersonas = '.codebuddy/agents/';

package/bin/tool-selector.cjs

@@ -0,0 +1,164 @@
+'use strict';
+
+const readline = require('node:readline');
+const { orderedAgents, commonIds } = require('./tool-menu.cjs');
+
+// Terminal columns are not JavaScript string lengths: Chinese characters use
+// two cells. Keep every rendered line within the viewport before repainting.
+function cellWidth(character) {
+  const code = character.codePointAt(0);
+  if (/\p{Mark}/u.test(character) || code === 0x200d) return 0;
+  return code >= 0x1100 && (code <= 0x115f || code === 0x2329 || code === 0x232a
+    || (code >= 0x2e80 && code <= 0xa4cf && code !== 0x303f)
+    || (code >= 0xac00 && code <= 0xd7a3) || (code >= 0xf900 && code <= 0xfaff)
+    || (code >= 0xfe10 && code <= 0xfe19) || (code >= 0xfe30 && code <= 0xfe6f)
+    || (code >= 0xff00 && code <= 0xff60) || (code >= 0xffe0 && code <= 0xffe6)
+    || (code >= 0x1f300 && code <= 0x1faff) || (code >= 0x20000 && code <= 0x3fffd)) ? 2 : 1;
+}
+function width(text) { return [...text].reduce((size, character) => size + cellWidth(character), 0); }
+function clip(text, columns) {
+  if (width(text) <= columns) return text;
+  const suffix = columns >= 3 ? '...' : '';
+  let result = '', size = 0;
+  for (const character of text) {
+    size += cellWidth(character);
+    if (size > columns - suffix.length) break;
+    result += character;
+  }
+  return result + suffix;
+}
+function wrap(text, columns) {
+  const lines = [];
+  let line = '', size = 0;
+  for (const character of text) {
+    const cells = cellWidth(character);
+    if (line && size + cells > columns) { lines.push(line); line = ''; size = 0; }
+    line += character; size += cells;
+  }
+  lines.push(line);
+  return lines;
+}
+
+function selectTools(initialSelection, input = process.stdin, output = process.stdout) {
+  const selected = new Set(initialSelection);
+  let view = 'common', cursor = 0, commonCursor = 0, query = '', searching = false, message = '';
+  let frame = [], pageSize = 10, finished = false;
+  const wasRaw = Boolean(input.isRaw), wasFlowing = input.readableFlowing;
+  const choices = () => view === 'common' ? [...orderedAgents.slice(0, commonIds.length), null]
+    : view === 'more' ? orderedAgents.slice(commonIds.length)
+      : orderedAgents.filter(agent => `${agent.label} ${agent.id}`.toLowerCase().includes(query.toLowerCase()));
+  const selectedLabels = () => [...selected].map(id => orderedAgents.find(agent => agent.id === id).label).join('、');
+
+  function clearFrame() {
+    if (!frame.length) return;
+    const columns = output.columns || 80;
+    const rows = frame.reduce((count, line) => count + Math.max(1, Math.ceil(width(line) / columns)), 0);
+    readline.moveCursor(output, 0, -rows);
+    readline.cursorTo(output, 0);
+    readline.clearScreenDown(output);
+    frame = [];
+  }
+  function render() {
+    if (finished) return;
+    const columns = Math.max(1, (output.columns || 80) - 1), rows = output.rows || 24;
+    const entries = choices();
+    cursor = Math.max(0, Math.min(cursor, entries.length - 1));
+    const summary = wrap(`已选（${selected.size}）：${selectedLabels() || '无'}`, columns);
+    const summaryLimit = rows < 16 ? 1 : 3;
+    if (summary.length > summaryLimit) {
+      summary.length = summaryLimit;
+      summary[summaryLimit - 1] = clip(summary[summaryLimit - 1], Math.max(0, columns - 3)) + '...';
+    }
+    const hints = searching
+      ? ['输入关键词实时搜索', 'Enter/↓ 浏览结果 · Esc返回 · Ctrl-C取消']
+      : ['↑↓ 移动/跨页 · 空格勾选 · Enter确认', 'm 更多 · / 搜索 · b/← 返回 · q/Esc取消'];
+    const footer = ['', ...summary, ...hints.flatMap(line => wrap(line, columns)), message];
+    const searchLine = view === 'search' ? [`搜索：${query}${searching ? '|' : ''}`] : [];
+    pageSize = Math.max(1, Math.min(10, rows - footer.length - searchLine.length - 2));
+    const page = Math.floor(cursor / pageSize), pages = Math.max(1, Math.ceil(entries.length / pageSize));
+    const title = view === 'common' ? '选择常用工具（支持多选）：'
+      : `${view === 'more' ? '更多工具' : '搜索结果'}：第 ${page + 1}/${pages} 页，共 ${entries.length} 项`;
+    const lines = [title, ...searchLine];
+    for (let index = page * pageSize; index < Math.min(entries.length, (page + 1) * pageSize); index++) {
+      const agent = entries[index], pointer = index === cursor ? '>' : ' ';
+      lines.push(agent ? `${pointer} [${selected.has(agent.id) ? 'x' : ' '}] ${orderedAgents.indexOf(agent) + 1}. ${agent.label} [${agent.id}]${agent.globalSkillsDir ? '' : '（仅项目）'}`
+        : `${pointer}     更多工具（空格展开）`);
+    }
+    if (!entries.length) lines.push('没有匹配工具；按 / 重新搜索，或 Esc 返回。');
+    clearFrame();
+    frame = [...lines, ...footer].map(line => clip(line, columns));
+    output.write(frame.join('\n') + '\n');
+  }
+
+  return new Promise((resolve, reject) => {
+    function finish(value, error) {
+      if (finished) return;
+      finished = true;
+      input.off('keypress', keypress);
+      input.off('end', cancel);
+      input.off('error', fail);
+      output.off('resize', redraw);
+      process.off('SIGINT', cancel);
+      input.setRawMode(wasRaw);
+      if (!wasFlowing) input.pause();
+      try {
+        clearFrame();
+        output.write('\x1b[?25h');
+        if (value) output.write(`已选择工具：${selectedLabels()}\n`);
+      } catch (outputError) { error ||= outputError; }
+      if (error) reject(error); else resolve(value);
+    }
+    function cancel() { finish(null); }
+    function fail(error) { finish(null, error); }
+    function redraw() { try { render(); } catch (error) { fail(error); } }
+    function openMore() {
+      if (view === 'common') commonCursor = cursor;
+      view = 'more'; cursor = 0; searching = false;
+    }
+    function back() { view = 'common'; cursor = commonCursor; searching = false; query = ''; }
+    function keypress(text, key = {}) {
+      if (finished) return;
+      try {
+        message = '';
+        if (key.ctrl && ['c', 'd'].includes(key.name)) { cancel(); return; }
+        if (searching) {
+          if (key.name === 'escape') back();
+          else if (['return', 'enter', 'down'].includes(key.name)) searching = false;
+          else if (key.name === 'backspace') { query = [...query].slice(0, -1).join(''); cursor = 0; }
+          else if (text && !key.ctrl && !key.meta && !/[\x00-\x1f\x7f]/.test(text)) { query += text; cursor = 0; }
+        } else if (key.name === 'escape') {
+          if (view === 'search') back(); else { cancel(); return; }
+        } else if (text === 'q') { cancel(); return; }
+        else if (['return', 'enter'].includes(key.name)) {
+          if (selected.size) { finish([...selected]); return; }
+          message = '请至少用空格选择一个工具。';
+        } else if (key.name === 'space' || text === ' ') {
+          const entry = choices()[cursor];
+          if (entry) { if (selected.has(entry.id)) selected.delete(entry.id); else selected.add(entry.id); }
+          else if (view === 'common') openMore();
+        } else if (['up', 'down', 'pageup', 'pagedown'].includes(key.name) || ['n', 'p'].includes(text)) {
+          const direction = ['up', 'pageup'].includes(key.name) || text === 'p' ? -1 : 1;
+          const step = ['pageup', 'pagedown'].includes(key.name) || ['n', 'p'].includes(text) ? pageSize : 1;
+          cursor = Math.max(0, Math.min(choices().length - 1, cursor + direction * step));
+        } else if (text === 'm' || (key.name === 'right' && view === 'common')) openMore();
+        else if (text === 'b' || key.name === 'left') back();
+        else if (text === '/') { if (view === 'common') commonCursor = cursor; view = 'search'; query = ''; cursor = 0; searching = true; }
+        render();
+      } catch (error) { fail(error); }
+    }
+    try {
+      readline.emitKeypressEvents(input);
+      input.setRawMode(true);
+      input.on('keypress', keypress);
+      input.once('end', cancel);
+      input.once('error', fail);
+      output.on('resize', redraw);
+      process.once('SIGINT', cancel);
+      output.write('\x1b[?25l');
+      render();
+      input.resume();
+    } catch (error) { fail(error); }
+  });
+}
+
+module.exports = { selectTools };

package/bin/wizard.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 const readline = require('node:readline');
-const { registry, selectAgents } = require('./install.cjs');
-const { orderedAgents, commonIds } = require('./tool-menu.cjs');
+const { selectAgents } = require('./install.cjs');
+const { selectTools } = require('./tool-selector.cjs');
 
 async function session(action) {
   const terminal = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -23,49 +23,11 @@ async function session(action) {
 }
 async function choose(options, identity) {
   console.log(identity);
+  const agents = await selectTools(selectAgents(options.agents));
+  if (!agents) return null;
+  if (agents.includes('workbuddy')) console.log('WorkBuddy 桌面版建议全局安装，以便技能列表和输入补全发现 Skills；项目安装仍支持命令，技能列表可能不显示。');
   return session(async ask => {
-    const selected = new Set(selectAgents(options.agents));
-    let view = 'common', page = 0, query = '';
     const cancelled = input => input === null || ['q', 'cancel', '取消'].includes(input.toLowerCase());
-    while (true) {
-      const matches = view === 'common' ? orderedAgents.slice(0, commonIds.length)
-        : view === 'search' ? orderedAgents.filter(agent => `${agent.id} ${agent.label}`.toLowerCase().includes(query.toLowerCase()))
-          : orderedAgents.slice(commonIds.length);
-      const pages = Math.max(1, Math.ceil(matches.length / 10));
-      page = Math.max(0, Math.min(page, pages - 1));
-      console.log(view === 'common' ? '\n选择常用工具（支持多选）：'
-        : `\n${view === 'search' ? `搜索“${query}”` : '更多工具'}：第 ${page + 1}/${pages} 页，共 ${matches.length} 项`);
-      for (const agent of view === 'common' ? matches : matches.slice(page * 10, page * 10 + 10)) {
-        console.log(`${orderedAgents.indexOf(agent) + 1}. ${agent.label} [${agent.id}]${selected.has(agent.id) ? ' ✓ 已选' : ''}${agent.globalSkillsDir ? '' : '（仅项目安装）'}`);
-      }
-      if (view === 'common') console.log('7. 更多（m）');
-      else console.log('n 下一页 · p 上一页 · b 返回常用工具');
-      console.log(`已选：${[...selected].join(', ') || '无'}；/关键词 搜索全部 ${registry.agents.length} 个工具；回车或完成确认；-编号/ID 移除选择。`);
-      const input = await ask('输入编号/ID，可用逗号多选（q/取消退出）： ');
-      if (cancelled(input)) return null;
-      if (['', 'done', '完成'].includes(input.toLowerCase())) {
-        if (selected.size) break;
-        console.log('请至少选择一个工具。'); continue;
-      }
-      if (['m', 'more', '更多'].includes(input.toLowerCase()) || (view === 'common' && input === '7')) { view = 'more'; page = 0; continue; }
-      if (['b', 'back', '返回'].includes(input.toLowerCase())) { view = 'common'; page = 0; continue; }
-      if (view !== 'common' && ['n', '下一页'].includes(input.toLowerCase())) { page = Math.min(pages - 1, page + 1); continue; }
-      if (view !== 'common' && ['p', '上一页'].includes(input.toLowerCase())) { page = Math.max(0, page - 1); continue; }
-      if (input.startsWith('/')) { view = 'search'; query = input.slice(1).trim(); page = 0; continue; }
-      try {
-        const values = ['all', '全部'].includes(input.toLowerCase()) ? orderedAgents.map(agent => agent.id) : input.split(/[,，]/);
-        const additions = [], removals = [];
-        for (const value of values) {
-          const remove = value.trim().startsWith('-'), raw = value.trim().replace(/^-/, '');
-          const id = /^\d+$/.test(raw) ? orderedAgents[Number(raw) - 1]?.id || raw : raw;
-          (remove ? removals : additions).push(...selectAgents([id]));
-        }
-        for (const id of additions) selected.add(id);
-        for (const id of removals) selected.delete(id);
-      } catch (error) { console.log(error.message); }
-    }
-    const agents = [...selected];
-    if (agents.includes('workbuddy')) console.log('WorkBuddy 桌面版建议全局安装，以便技能列表和输入补全发现 Skills；项目安装仍支持命令，技能列表可能不显示。');
     let scope = options.scope;
     while (!scope) {
       const input = await ask('安装范围：1. 项目（当前项目），2. 全局（所有项目）[1]（q/取消退出）： ');
@@ -82,10 +44,11 @@ async function confirm(plan) {
   for (const target of plan.targets) {
     console.log(`  ${target.agents.join(', ')}: ${target.skillsDirectory}`);
     if (target.commandsDirectory) console.log(`  命令：${target.commandsDirectory}`);
+    console.log(`  完整配套（evals、hooks、scripts）：${target.supportDirectory}`);
   }
   if (plan.conflicts.length) console.log(`将替换 ${plan.conflicts.length} 个已有内容；安装成功后清理旧文件，失败则恢复。`);
   if (plan.reused.length) console.log(`将复用同版本的 ${plan.reused.length} 个未修改内容。`);
-  console.log('包含完整技能及共享参考资料。插件 Hook 需按宿主方式注册和启用。');
+  console.log('包含技能、共享资料和完整评测/Hook/脚本配套。安装不执行评测；Hook 需按宿主方式启用。');
   return session(async ask => {
     const answer = await ask('确认安装这些内容？[y/N]： ');
     return answer !== null && ['y', 'yes', '是', '确认'].includes(answer.toLowerCase());

package/docs/codebuddy-setup.md

@@ -11,6 +11,7 @@ npx @givolt/i3-composer-agent --codebuddy
 向导预选 CodeBuddy，可增加其他工具，再选择项目或全局范围。
 项目安装提供 `.codebuddy/skills/`（25 个技能）、`references/`、
 `commands/`（9 个命令）和 `agents/`（4 个角色）。
+同级 `i3-composer-agent/` 默认提供完整的 `evals/`、`hooks/`、`scripts/` 和依赖资料。
 全局使用 `~/.codebuddy/` 的相同结构。默认中文说明和回复；技能/命令标识不改名。
 安装成功清理旧内容，失败恢复；设置与自定义命令保留。
 
@@ -37,9 +38,16 @@ CodeBuddy 与 WorkBuddy 项目共用 `.codebuddy/`；同版本追加客户端会
 全局目录彼此独立。WorkBuddy 桌面版建议全局安装，详见 [WorkBuddy 说明](workbuddy-setup.md)。
 升级或同名冲突先查看 `--dry-run`，再确认或使用 `--yes --force`。
 
-## CodeBuddy Code 完整插件
+## 配套检查
 
-终端宿主的插件管理器使用完整目录：
+进入 `.codebuddy/i3-composer-agent/`（全局安装使用对应全局路径）运行 `npm test`，
+可检查技能格式及中英文触发，不调用模型。行为评测、样例和脚本用法见
+[评测说明](../evals/README.md)。Hook 文件已安装，需要按宿主协议单独启用。
+
+## 通过 CodeBuddy Code 插件管理器安装
+
+这是另一种由宿主插件管理器管理的安装方式；已完成原生安装时无需再次执行。
+`--prepare` 只导出文件并显示注册步骤，不自动注册插件或启用 Hook：
 
 ```bash
 npx @givolt/i3-composer-agent --prepare --codebuddy
@@ -55,7 +63,7 @@ npx @givolt/i3-composer-agent --prepare --codebuddy
 按宿主选择范围并启用后新建会话。兼容清单声明 `.claude/commands/` 与 `commands/`。
 插件命令示例为 `/i3-composer-agent:i3-spec`、`/i3-composer-agent:i3-plan`、
 `/i3-composer-agent:i3-build auto` 和 `/i3-composer-agent:i3-ship`。
-完整目录包含 Hook 与共享参考；原生文件安装不自动启用插件 Hook。
+默认安装和导出均包含完整评测、Hook 与脚本；Hook 不自动启用。
 文件落盘、宿主发现和模型实际执行应分别验证。
 
 目录遵循 [配置目录参考](https://www.codebuddy.cn/docs/cli/codebuddy-dir)，可参照

package/docs/codex-setup.md

@@ -8,9 +8,11 @@ npx @givolt/i3-composer-agent --codex
 
 项目范围写入 `.agents/skills/`，全局写入 `~/.agents/skills/`，并安装同级 `references/`。
 提供全部 25 个 `i3-` 技能，中文选择说明与默认中文回复在每个入口独立生效。
-此模式不安装短生命周期命令，也不自动启用插件 Hook。
+同级 `i3-composer-agent/` 默认提供完整评测、Hook、脚本及依赖资料。
+进入该配套目录执行 `npm test` 可进行结构和中英文触发检查，不调用模型；详见
+[评测说明](../evals/README.md)。原生调用使用技能 ID，Hook 文件需按宿主能力单独启用。
 
-## 完整插件
+## 通过插件管理器安装
 
 ```bash
 npx @givolt/i3-composer-agent --prepare --codex
@@ -18,7 +20,8 @@ codex plugin marketplace add ./i3-composer-agent
 codex plugin add i3-composer-agent@i3-composer-agent
 ```
 
-准备模式产生持久目录并显示注册命令。注册启用后新建会话，
+准备模式另行导出持久目录并显示注册命令，不自动注册或启用 Hook。
+已完成原生安装时无需再次准备。选择插件安装方式并注册启用后新建会话，
 通过 `/skills`、`$i3-spec-driven-development` 等技能名称，或在聊天中明确指定技能调用。
 插件适配清单指向 `skills/`；共享资料保留相对链接可解析的 `references/` 布局。
 

package/docs/workbuddy-setup.md

@@ -15,11 +15,18 @@ npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope global --yes
 - `~/.workbuddy/agents/`：4 个专业角色。
 - `~/.workbuddy/references/`：共享参考和标准 MIT 许可。
 - `~/.workbuddy/docs/agents.md`：角色说明。
+- `~/.workbuddy/i3-composer-agent/`：完整评测、Hook、脚本及依赖资料。
 - `~/.workbuddy/.i3-composer-agent.json`：安装内容所有权及客户端清单。
 
 自定义 profile 可设置 `WORKBUDDY_CONFIG_DIR`，安装后打开对应 profile。
 WorkBuddy 的目录选择使用自己的配置，不借用 `CODEBUDDY_CONFIG_DIR`。
 
+## 配套检查
+
+进入 `~/.workbuddy/i3-composer-agent/` 运行 `npm test`，检查技能格式及中英文触发，
+不会调用模型。项目安装对应 `.codebuddy/i3-composer-agent/`。行为评测用例、样例和
+脚本用法见 [评测说明](../evals/README.md)。Hook 文件默认提供，启用需适配宿主事件协议。
+
 ## 发现和调用
 
 安装后新建会话，查看 Skills 列表并输入 `/` 查看命令：
@@ -66,7 +73,7 @@ npx @givolt/i3-composer-agent --workbuddy --scope global --yes --force
 ```
 
 升级、修改内容和未登记同名冲突需要确认；成功替换后清理旧文件与所属历史备份，失败恢复。
-原生安装提供 Skills、Commands、Agents；完整插件注册另按宿主能力处理。
+原生安装同时提供 Skills、Commands、Agents 和完整 evals/hooks/scripts 配套。
 `--prepare --workbuddy` 不支持，原生安装不会启用插件 Hook。
 
 可参照 [任务栏命令说明](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Task-Bar)、