airail 0.1.6 → 0.1.8

package/dist/cli/add.js

@@ -38,27 +38,24 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
+const prompts_1 = require("@inquirer/prompts");
 const utils_1 = require("../utils");
 const colors_1 = require("./colors");
 async function cmdAdd(arg) {
     const claudeDir = path.join(process.cwd(), '.claude');
     const config = (0, utils_1.requireAirailJson)(claudeDir);
-    if (!arg) {
-        console.error((0, colors_1.err)('用法: airail add <包名[@版本]|路径>'));
-        throw new Error('');
-    }
-    if (config.pack) {
-        console.log((0, colors_1.warn)(`当前已安装 pack: ${config.pack}`));
-        console.log((0, colors_1.warn)('一个项目只能安装一个 pack，新 pack 将覆盖现有内容。'));
-    }
     // 本地路径（用于开发测试）
-    if (arg.startsWith('./') || arg.startsWith('../') || path.isAbsolute(arg)) {
+    if (arg && (arg.startsWith('./') || arg.startsWith('../') || path.isAbsolute(arg))) {
+        if (config.pack) {
+            console.log((0, colors_1.warn)(`当前已安装 pack: ${config.pack}`));
+            console.log((0, colors_1.warn)('一个项目只能安装一个 pack，新 pack 将覆盖现有内容。'));
+        }
         const localPath = path.resolve(arg);
         if (!fs.existsSync(localPath)) {
             console.error((0, colors_1.err)(`路径不存在: ${localPath}`));
             throw new Error('');
         }
-        const packName = readPackName(localPath);
+        const packName = path.basename(localPath);
         (0, utils_1.installPackFromDir)(localPath, packName, claudeDir);
         config.pack = packName;
         (0, utils_1.writeAirailJson)(claudeDir, config);
@@ -71,29 +68,58 @@ async function cmdAdd(arg) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
         throw new Error('');
     }
-    await installPackFromConfigCenter(arg, claudeDir, config, rc);
-    (0, utils_1.writeAirailJson)(claudeDir, config);
-}
-function readPackName(dir) {
-    const p = path.join(dir, 'pack.json');
-    if (fs.existsSync(p)) {
-        try {
-            return JSON.parse(fs.readFileSync(p, 'utf-8')).name || path.basename(dir);
-        }
-        catch { }
+    // 同步本地配置仓库（静默）
+    try {
+        (0, utils_1.ensureConfigRepo)(rc.configServer, rc.configToken);
     }
-    return path.basename(dir);
+    catch (e) {
+        console.error((0, colors_1.err)(e.message));
+        throw new Error('');
+    }
+    // 读取本地 packs/index.json
+    const indexPath = path.join(utils_1.CONFIG_REPO_DIR, 'packs', 'index.json');
+    if (!fs.existsSync(indexPath)) {
+        console.error((0, colors_1.err)('配置仓库中未找到 packs/index.json'));
+        throw new Error('');
+    }
+    let packs;
+    try {
+        packs = JSON.parse(fs.readFileSync(indexPath, 'utf-8'));
+    }
+    catch (e) {
+        console.error((0, colors_1.err)(`读取规范包列表失败: ${e.message}`));
+        throw new Error('');
+    }
+    if (packs.length === 0) {
+        console.log((0, colors_1.warn)('暂无可用规范包。'));
+        return;
+    }
+    // 无包名时交互选择
+    let packNameWithVersion = arg;
+    if (!packNameWithVersion) {
+        packNameWithVersion = await (0, prompts_1.select)({
+            message: '选择要安装的规范包',
+            choices: packs.map(p => ({
+                name: `${p.name}${p.version ? ` (v${p.version})` : ''}  ${p.description}`,
+                value: p.name,
+            })),
+        });
+    }
+    if (config.pack) {
+        console.log((0, colors_1.warn)(`当前已安装 pack: ${config.pack}`));
+        console.log((0, colors_1.warn)('一个项目只能安装一个 pack，新 pack 将覆盖现有内容。'));
+    }
+    await installPackFromConfigCenter(packNameWithVersion, claudeDir, config, packs);
+    (0, utils_1.writeAirailJson)(claudeDir, config);
 }
-async function installGitPack(url, claudeDir, config) {
+async function installGitPack(url, packName, claudeDir, config) {
     const [repoUrl, ref] = url.split('#');
     const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'airail-git-'));
     try {
-        console.log((0, colors_1.info)(`正在克隆 ${repoUrl}${ref ? ` (${ref})` : ''}...`));
         const cloneCmd = ref
-            ? `git clone --depth 1 --branch ${ref} ${repoUrl} ${tmpDir}`
-            : `git clone --depth 1 ${repoUrl} ${tmpDir}`;
+            ? `git clone --depth 1 --branch ${ref} "${repoUrl}" "${tmpDir}"`
+            : `git clone --depth 1 "${repoUrl}" "${tmpDir}"`;
         (0, child_process_1.execSync)(cloneCmd, { stdio: 'pipe' });
-        const packName = readPackName(tmpDir);
         (0, utils_1.installPackFromDir)(tmpDir, packName, claudeDir);
         config.pack = packName;
         console.log((0, colors_1.ok)(`已安装: ${packName} (来自 ${repoUrl})`));
@@ -102,35 +128,34 @@ async function installGitPack(url, claudeDir, config) {
         fs.rmSync(tmpDir, { recursive: true, force: true });
     }
 }
-async function installPackFromConfigCenter(packNameWithVersion, claudeDir, config, rc) {
-    // 解析包名和版本号
+async function installPackFromConfigCenter(packNameWithVersion, claudeDir, config, packs) {
     const [packName, userVersion] = packNameWithVersion.split('@');
-    const indexUrl = `${rc.configServer}/packs/index.json`;
-    console.log((0, colors_1.info)(`正在从配置仓库获取规范包列表...`));
-    let packs;
-    try {
-        packs = JSON.parse(await (0, utils_1.fetchText)(indexUrl, rc.configToken));
-    }
-    catch (e) {
-        console.error((0, colors_1.err)(`获取规范包列表失败: ${e.message}`));
-        throw new Error('');
-    }
     const pack = packs.find(p => p.name === packName);
     if (!pack) {
         console.error((0, colors_1.err)(`规范包 "${packName}" 不存在。`));
         console.log((0, colors_1.info)(`可用规范包: ${packs.map(p => p.name).join(', ')}`));
         throw new Error('');
     }
-    // 使用用户指定的版本，如果没有指定则使用配置仓库的版本
+    // 本地规范包（gitUrl 为空）
+    if (!pack.gitUrl) {
+        const packDir = path.join(utils_1.CONFIG_REPO_DIR, 'packs', packName);
+        if (!fs.existsSync(packDir)) {
+            console.error((0, colors_1.err)(`配置仓库中不存在本地规范包: packs/${packName}/`));
+            throw new Error('');
+        }
+        (0, utils_1.installPackFromDir)(packDir, packName, claudeDir);
+        config.pack = packName;
+        console.log((0, colors_1.ok)(`已安装: ${pack.name}${pack.version ? ` v${pack.version}` : ''} (来自配置仓库)`));
+        return;
+    }
+    // 第三方规范包（有 gitUrl）
     const gitRef = userVersion || pack.gitRef;
     const gitUrl = gitRef ? `${pack.gitUrl}#${gitRef}` : pack.gitUrl;
     const versionInfo = userVersion
         ? `v${userVersion} (用户指定)`
         : pack.version
-            ? `v${pack.version} (配置仓库默认)`
+            ? `v${pack.version}`
             : '(默认分支)';
-    console.log((0, colors_1.ok)(`找到规范包: ${pack.name} ${versionInfo}`));
-    console.log((0, colors_1.info)(`${pack.description}`));
-    console.log((0, colors_1.info)(`正在从 Git 仓库安装...`));
-    await installGitPack(gitUrl, claudeDir, config);
+    console.log((0, colors_1.info)(`正在安装: ${pack.name} ${versionInfo}`));
+    await installGitPack(gitUrl, packName, claudeDir, config);
 }

package/dist/cli/config.js

@@ -37,49 +37,9 @@ exports.cmdConfig = cmdConfig;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const child_process_1 = require("child_process");
 const prompts_1 = require("@inquirer/prompts");
 const utils_1 = require("../utils");
 const colors_1 = require("./colors");
-// ─── 本地配置仓库管理 ──────────────────────────────────────────────────────────
-const CONFIG_REPO_DIR = path.join(os.homedir(), '.airail', 'config-repo');
-/** 确保本地配置仓库存在且是最新的 */
-function ensureConfigRepo(gitUrl, token) {
-    // 构建带认证的 Git URL（如果有 token）
-    let authUrl = gitUrl;
-    if (token && gitUrl.startsWith('https://')) {
-        authUrl = gitUrl.replace('https://', `https://oauth2:${token}@`);
-    }
-    if (!fs.existsSync(CONFIG_REPO_DIR)) {
-        // 首次克隆
-        console.log((0, colors_1.info)('正在克隆配置仓库...'));
-        try {
-            (0, child_process_1.execSync)(`git clone "${authUrl}" "${CONFIG_REPO_DIR}"`, {
-                stdio: 'inherit',
-                encoding: 'utf-8'
-            });
-            console.log((0, colors_1.ok)('配置仓库克隆成功'));
-        }
-        catch (e) {
-            throw new Error(`克隆失败: ${e.message}`);
-        }
-    }
-    else {
-        // 更新现有仓库
-        console.log((0, colors_1.info)('正在更新配置仓库...'));
-        try {
-            (0, child_process_1.execSync)('git pull', {
-                cwd: CONFIG_REPO_DIR,
-                stdio: 'inherit',
-                encoding: 'utf-8'
-            });
-            console.log((0, colors_1.ok)('配置仓库已更新'));
-        }
-        catch (e) {
-            console.log((0, colors_1.warn)(`更新失败，使用本地缓存: ${e.message}`));
-        }
-    }
-}
 // ─── 子命令 ───────────────────────────────────────────────────────────────────
 async function setup() {
     const rc = (0, utils_1.readRc)();
@@ -93,9 +53,9 @@ async function setup() {
         default: rc.configToken,
     });
     // 清理旧的本地仓库（如果 URL 变了）
-    if (rc.configServer && rc.configServer !== server && fs.existsSync(CONFIG_REPO_DIR)) {
+    if (rc.configServer && rc.configServer !== server && fs.existsSync(utils_1.CONFIG_REPO_DIR)) {
         console.log((0, colors_1.info)('检测到仓库地址变更，清理旧仓库...'));
-        fs.rmSync(CONFIG_REPO_DIR, { recursive: true, force: true });
+        fs.rmSync(utils_1.CONFIG_REPO_DIR, { recursive: true, force: true });
     }
     (0, utils_1.writeRc)({ configServer: server.replace(/\/$/, ''), configToken: token || undefined });
     console.log((0, colors_1.ok)('配置已保存到 ~/.airailrc'));
@@ -107,13 +67,13 @@ async function listConfigs() {
         throw new Error('');
     }
     try {
-        ensureConfigRepo(rc.configServer, rc.configToken);
+        (0, utils_1.ensureConfigRepo)(rc.configServer, rc.configToken);
     }
     catch (e) {
         console.error((0, colors_1.err)(e.message));
         throw new Error('');
     }
-    const indexPath = path.join(CONFIG_REPO_DIR, 'settings', 'index.json');
+    const indexPath = path.join(utils_1.CONFIG_REPO_DIR, 'settings', 'index.json');
     if (!fs.existsSync(indexPath)) {
         console.error((0, colors_1.err)('配置仓库中未找到 settings/index.json'));
         throw new Error('');
@@ -142,14 +102,14 @@ async function useConfig(name) {
         throw new Error('');
     }
     try {
-        ensureConfigRepo(rc.configServer, rc.configToken);
+        (0, utils_1.ensureConfigRepo)(rc.configServer, rc.configToken);
     }
     catch (e) {
         console.error((0, colors_1.err)(e.message));
         throw new Error('');
     }
     // 获取配置清单
-    const indexPath = path.join(CONFIG_REPO_DIR, 'settings', 'index.json');
+    const indexPath = path.join(utils_1.CONFIG_REPO_DIR, 'settings', 'index.json');
     if (!fs.existsSync(indexPath)) {
         console.error((0, colors_1.err)('配置仓库中未找到 settings/index.json'));
         throw new Error('');
@@ -185,7 +145,7 @@ async function useConfig(name) {
         });
     }
     // 读取配置文件
-    const settingsPath = path.join(CONFIG_REPO_DIR, 'settings', `${chosen}.json`);
+    const settingsPath = path.join(utils_1.CONFIG_REPO_DIR, 'settings', `${chosen}.json`);
     if (!fs.existsSync(settingsPath)) {
         console.error((0, colors_1.err)(`配置文件不存在: settings/${chosen}.json`));
         throw new Error('');
@@ -203,7 +163,33 @@ async function useConfig(name) {
     if (!fs.existsSync(globalClaudeDir)) {
         fs.mkdirSync(globalClaudeDir, { recursive: true });
     }
-    fs.writeFileSync(path.join(globalClaudeDir, 'settings.json'), content);
+    const settingsFilePath = path.join(globalClaudeDir, 'settings.json');
+    const settings = JSON.parse(content);
+    // 检查 ANTHROPIC_AUTH_TOKEN，为空时强制输入，有值时可选修改
+    if (settings?.env?.ANTHROPIC_AUTH_TOKEN !== undefined) {
+        const currentToken = settings.env.ANTHROPIC_AUTH_TOKEN;
+        if (!currentToken) {
+            console.log((0, colors_1.warn)('配置中 ANTHROPIC_AUTH_TOKEN 为空，需要设置 API Key 才能正常使用。'));
+            const apiKey = await (0, prompts_1.input)({
+                message: '请输入 API Key:',
+                validate: (v) => v.trim().length > 0 || '不能为空',
+            });
+            settings.env.ANTHROPIC_AUTH_TOKEN = apiKey.trim();
+            content = JSON.stringify(settings, null, 2);
+        }
+        else {
+            const masked = currentToken.slice(0, 8) + '****' + currentToken.slice(-4);
+            const newKey = await (0, prompts_1.input)({
+                message: `API Key (当前: ${masked}，直接回车保留，输入新值则替换):`,
+            });
+            if (newKey.trim()) {
+                settings.env.ANTHROPIC_AUTH_TOKEN = newKey.trim();
+                content = JSON.stringify(settings, null, 2);
+                console.log((0, colors_1.ok)('API Key 已更新'));
+            }
+        }
+    }
+    fs.writeFileSync(settingsFilePath, content);
     console.log((0, colors_1.ok)(`已应用配置 "${chosen}" → ~/.claude/settings.json`));
     // 检查并处理 config.json
     const configPath = path.join(globalClaudeDir, 'config.json');

package/dist/cli/init.js

@@ -52,7 +52,7 @@ async function cmdInit() {
     fs.mkdirSync(path.join(claudeDir, 'hooks'), { recursive: true });
     fs.mkdirSync(path.join(claudeDir, 'skills'), { recursive: true });
     (0, utils_1.copyHooks)(claudeDir);
-    (0, utils_1.copyBuiltinSkills)('universal', claudeDir);
+    (0, utils_1.copyBuiltinSkills)(claudeDir);
     (0, utils_1.copyTemplateDir)('commands', claudeDir);
     (0, utils_1.copyTemplateDir)('agents', claudeDir);
     (0, utils_1.copyTemplateDir)('templates', claudeDir);

package/dist/utils.js

@@ -33,8 +33,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PKG_ROOT = void 0;
+exports.CONFIG_REPO_DIR = exports.PKG_ROOT = void 0;
 exports.fetchText = fetchText;
+exports.ensureConfigRepo = ensureConfigRepo;
 exports.readAirailJson = readAirailJson;
 exports.writeAirailJson = writeAirailJson;
 exports.requireAirailJson = requireAirailJson;
@@ -43,7 +44,7 @@ exports.writeRc = writeRc;
 exports.installPackFromDir = installPackFromDir;
 exports.installSkillsFromDir = installSkillsFromDir;
 exports.copyBuiltinSkills = copyBuiltinSkills;
-exports.removeNonUniversalSkills = removeNonUniversalSkills;
+exports.removePackSkills = removePackSkills;
 exports.copyDir = copyDir;
 exports.copyHooks = copyHooks;
 exports.copyTemplateDir = copyTemplateDir;
@@ -55,6 +56,7 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const https = __importStar(require("https"));
 const http = __importStar(require("http"));
+const child_process_1 = require("child_process");
 exports.PKG_ROOT = path.join(__dirname, '..');
 // ─── HTTP 工具 ────────────────────────────────────────────────────────────────
 function fetchText(url, token) {
@@ -83,6 +85,34 @@ function fetchText(url, token) {
         }).on('error', reject);
     });
 }
+// ─── 配置仓库工具 ──────────────────────────────────────────────────────────────
+exports.CONFIG_REPO_DIR = path.join(os.homedir(), '.airail', 'config-repo');
+/**
+ * 确保本地配置仓库存在且是最新的（静默模式，不输出 git 日志）
+ * 克隆失败时抛出错误；pull 失败时静默使用本地缓存
+ */
+function ensureConfigRepo(gitUrl, token) {
+    let authUrl = gitUrl;
+    if (token && gitUrl.startsWith('https://')) {
+        authUrl = gitUrl.replace('https://', `https://oauth2:${token}@`);
+    }
+    if (!fs.existsSync(exports.CONFIG_REPO_DIR)) {
+        try {
+            (0, child_process_1.execSync)(`git clone "${authUrl}" "${exports.CONFIG_REPO_DIR}"`, { stdio: 'pipe' });
+        }
+        catch (e) {
+            throw new Error(`克隆配置仓库失败: ${e.stderr?.toString().trim() || e.message}`);
+        }
+    }
+    else {
+        try {
+            (0, child_process_1.execSync)('git pull', { cwd: exports.CONFIG_REPO_DIR, stdio: 'pipe' });
+        }
+        catch {
+            // 更新失败时静默使用本地缓存
+        }
+    }
+}
 function readAirailJson(claudeDir) {
     const p = path.join(claudeDir, 'airail.json');
     return JSON.parse(fs.readFileSync(p, 'utf-8'));
@@ -92,8 +122,7 @@ function writeAirailJson(claudeDir, data) {
 }
 function requireAirailJson(claudeDir) {
     if (!fs.existsSync(path.join(claudeDir, 'airail.json'))) {
-        console.error('未初始化，请先执行 "airail init"。');
-        process.exit(1);
+        throw new Error('未初始化，请先执行 "airail init"。');
     }
     return readAirailJson(claudeDir);
 }
@@ -121,7 +150,7 @@ function writeRc(patch) {
  */
 function installPackFromDir(packDir, packName, claudeDir) {
     // 删除旧 pack 的 skills
-    removeNonUniversalSkills(claudeDir);
+    removePackSkills(claudeDir);
     // 安装新 pack 的 skills
     installSkillsFromDir(packDir, packName, claudeDir);
     // 覆盖 commands / agents / hooks / templates
@@ -135,7 +164,7 @@ function installPackFromDir(packDir, packName, claudeDir) {
     }
 }
 // ─── skills ───────────────────────────────────────────────────────────────────
-/** 将 pack/skills/ 平铺复制到 .claude/skills/（universal 不加前缀） */
+/** 将 pack/skills/ 平铺复制到 .claude/skills/（带 packName 前缀） */
 function installSkillsFromDir(packDir, packName, claudeDir) {
     const skillsSrc = path.join(packDir, 'skills');
     if (!fs.existsSync(skillsSrc)) {
@@ -147,14 +176,14 @@ function installSkillsFromDir(packDir, packName, claudeDir) {
     for (const entry of fs.readdirSync(skillsSrc, { withFileTypes: true })) {
         if (!entry.isDirectory())
             continue;
-        const destName = packName === 'universal' ? entry.name : `${packName}-${entry.name}`;
-        copyDir(path.join(skillsSrc, entry.name), path.join(skillsDest, destName));
+        copyDir(path.join(skillsSrc, entry.name), path.join(skillsDest, `${packName}-${entry.name}`));
     }
 }
-function copyBuiltinSkills(packName, claudeDir) {
-    const src = path.join(exports.PKG_ROOT, 'src/templates/skills', packName);
+/** 复制内置 skills（templates/skills/ 下的所有子目录）到 .claude/skills/ */
+function copyBuiltinSkills(claudeDir) {
+    const src = path.join(exports.PKG_ROOT, 'src/templates/skills');
     if (!fs.existsSync(src)) {
-        console.warn(`内置规范包 "${packName}" 不存在。`);
+        console.warn('内置技能目录不存在。');
         return;
     }
     const skillsDest = path.join(claudeDir, 'skills');
@@ -162,12 +191,11 @@ function copyBuiltinSkills(packName, claudeDir) {
     for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
         if (!entry.isDirectory())
             continue;
-        const destName = packName === 'universal' ? entry.name : `${packName}-${entry.name}`;
-        copyDir(path.join(src, entry.name), path.join(skillsDest, destName));
+        copyDir(path.join(src, entry.name), path.join(skillsDest, entry.name));
     }
 }
-/** 删除所有非 universal 的 skills（即带 - 前缀的） */
-function removeNonUniversalSkills(claudeDir) {
+/** 删除所有 pack 安装的 skills（即带 - 前缀的） */
+function removePackSkills(claudeDir) {
     const skillsDir = path.join(claudeDir, 'skills');
     if (!fs.existsSync(skillsDir))
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airail",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "AI coding assistant framework - enforce coding standards via Claude hooks & skills",
   "bin": {
     "airail": "./bin/airail.js"

package/src/templates/agents/bugfix-verify.md

@@ -1,6 +1,6 @@
 ---
 name: bugfix-verify
-description: Bug 修复质量验证者。独立评估修复质量，只读代码库，不做任何修改。由 /bugfix 命令调用。
+description: Read-only bug fix quality verifier. Use proactively after bugfix agent completes a fix to independently evaluate fix quality. Also use when user says "验证修复", "检查修复质量".
 tools: Read, Grep, Glob
 ---
 

package/src/templates/agents/bugfix.md

@@ -1,6 +1,6 @@
 ---
 name: bugfix
-description: Bug 修复执行者，分析根本原因并实现修复。由 /bugfix 命令调用，或用户说"修复bug"、"fix bug"时触发。
+description: Bug fix specialist that analyzes root causes and implements fixes. Use when encountering bugs, errors, test failures, or when user says "修复bug", "fix bug", "修复问题".
 tools: Read, Edit, Write, Bash, Grep, Glob
 ---
 

package/src/templates/agents/code-reviewer.md

@@ -1,16 +1,22 @@
 ---
 name: code-reviewer
-description: 自动代码审查助手，在完成功能开发后自动检查代码是否符合项目规范。当使用 /dev 命令完成代码生成后，或用户说"审查代码"、"检查代码"时自动调用。
+description: Expert code review specialist. Use proactively after writing or modifying code, especially after /dev completes. Also use when user says "审查代码", "检查代码", or "review".
 model: opus
 tools: Read, Grep, Glob
 ---
 
 # 代码审查专家
 
-## 角色定位
-
 你是一位严格的代码审查专家，熟悉本项目的所有规范。你的职责是在代码合并前发现问题，而不是帮助实现功能。
 
+## 执行工作流
+
+当被调用时，按以下步骤执行：
+
+1. **查看最近变更** - 运行 `git diff` 查看最近修改的文件
+2. **聚焦修改文件** - 只审查新增或修改的文件
+3. **立即开始审查** - 不需要等待，直接分析代码
+
 ## 核心职责
 
 在以下场景自动执行代码审查：

package/src/templates/agents/debug.md

@@ -1,6 +1,6 @@
 ---
 name: debug
-description: 系统化调试协调器，通过多维度分析和验证方法进行问题诊断和修复
+description: Systematic debugging coordinator for multi-dimensional problem diagnosis and resolution. Use when encountering complex issues requiring structured analysis, or when user says "调试", "debug", "排查问题".
 tools: Read, Edit, Write, Bash, Grep, Glob, WebFetch, TodoWrite
 ---
 

package/src/templates/agents/optimize.md

@@ -1,6 +1,6 @@
 ---
 name: optimize
-description: 性能优化协调员，领导优化专家团队进行系统性能改进。由 /optimize 命令调用，或用户说"性能优化"、"优化性能"时触发。
+description: Performance optimization coordinator for systematic performance improvement. Use when user says "性能优化", "优化性能", "optimize", or when performance bottlenecks are identified.
 tools: Read, Edit, Write, Bash, Grep, Glob
 ---
 

package/src/templates/agents/refactor.md

@@ -1,6 +1,6 @@
 ---
 name: refactor
-description: 重构协调员，领导重构专家团队改善代码质量和架构。由 /refactor 命令调用，或用户说"重构代码"、"代码重构"时触发。
+description: Refactoring coordinator for improving code quality and architecture. Use when user says "重构代码", "代码重构", "refactor", or when code smells and technical debt are identified.
 tools: Read, Edit, Write, Bash, Grep, Glob
 ---
 

package/src/templates/commands/bugfix.md

@@ -27,10 +27,11 @@
 
 ### 2️⃣ 修复执行（bugfix agent）
 
-调用 bugfix agent，传入：
-- Bug 描述：$ARGUMENTS
-- 收集到的上下文信息
-- 上轮验证反馈（迭代时）
+使用 Agent 工具委托 `bugfix` agent：
+
+```
+Agent(subagent_type="bugfix", prompt="修复以下 bug：<bug描述>。上下文信息：<收集到的信息>。[迭代时]上轮验证反馈：<反馈内容>")
+```
 
 期望输出：
 - 根本原因分析
@@ -41,10 +42,11 @@
 
 ### 3️⃣ 质量验证（bugfix-verify agent）
 
-调用 bugfix-verify agent，传入：
-- 修复后的代码
-- 原始 bug 描述
-- bugfix agent 的输出
+使用 Agent 工具委托 `bugfix-verify` agent：
+
+```
+Agent(subagent_type="bugfix-verify", prompt="验证以下 bug 修复的质量。原始 bug：<bug描述>。修复方案：<bugfix agent 输出>。修复后的代码：<变更文件列表>")
+```
 
 期望输出：
 - 总体评估（通过/有条件通过/需要改进/失败）

package/src/templates/commands/debug.md

@@ -16,11 +16,20 @@
    - 记录关键假设和未知因素
    - 生成 5-7 个可能的问题来源
 
-2. **多维度调研**：
+2. **多维度调研（debug agent）**：
+
+使用 Agent 工具委托 `debug` agent：
+
+```
+Agent(subagent_type="debug", prompt="调试以下问题：<问题描述>。复现步骤：<步骤>。相关日志：<日志信息>")
+```
+
+期望输出：
    - 架构层面：分析系统设计和模块交互
    - 代码层面：检查相关代码逻辑和数据流
    - 环境层面：检查配置、依赖和运行环境
    - 历史层面：查看相关代码变更历史
+   - 综合分析：精炼为 1-2 个最可能的原因
 
 3. **假设验证**：
    - 整合所有分析结果

package/src/templates/commands/dev-frontend.md

@@ -19,7 +19,8 @@
    - 支持格式：Swagger/OpenAPI、Apifox、手写文档、接口截图
 4. **方案设计**：列出要创建/修改的文件清单（组件、页面、路由、状态），等待确认
 5. **代码生成**：逐层实现（技能会根据开发内容自动激活）
-6. **完成报告**：列出所有变更文件，提示测试和联调事项
+6. **代码审查**：代码生成完成后，使用 Agent 工具委托 `code-reviewer` agent 对所有变更文件进行审查
+7. **完成报告**：列出所有变更文件，提示测试和联调事项
 
 ## AI 执行规则
 
@@ -33,6 +34,16 @@
 - 遵循项目的状态管理方案（Vuex/Pinia/Redux 等）
 - 禁止修改框架核心代码和公共组件库
 
+## Agent 委托
+
+代码生成完成后，**必须**调用 Agent 工具，按以下方式委托审查：
+
+```
+Agent(subagent_type="code-reviewer", prompt="审查以下前端变更文件：<变更文件列表>。检查是否符合项目规范，是否有安全漏洞、代码重复、性能问题等。")
+```
+
+审查未通过的问题需在当前流程中修复后，再输出完成报告。
+
 ## 技能自动激活说明
 
 开发过程中，AI 会根据触发词自动激活相关技能：

package/src/templates/commands/dev.md

@@ -14,7 +14,8 @@
 3. **数据库分析**：检查是否需要新建表或修改现有表
 4. **方案设计**：列出要创建/修改的文件清单，等待确认
 5. **代码生成**：逐层实现（技能会根据开发内容自动激活）
-6. **完成报告**：列出所有变更文件，提示下一步操作
+6. **代码审查**：代码生成完成后，使用 Agent 工具委托 `code-reviewer` agent 对所有变更文件进行审查
+7. **完成报告**：列出所有变更文件，提示下一步操作
 
 ## AI 执行规则
 
@@ -26,6 +27,16 @@
 - 优先复用项目中已有的工具类和组件
 - 禁止修改框架核心代码
 
+## Agent 委托
+
+代码生成完成后，**必须**调用 Agent 工具，按以下方式委托审查：
+
+```
+Agent(subagent_type="code-reviewer", prompt="审查以下变更文件：<变更文件列表>。检查是否符合项目规范，是否有安全漏洞、代码重复等问题。")
+```
+
+审查未通过的问题需在当前流程中修复后，再输出完成报告。
+
 ## 技能自动激活说明
 
 开发过程中，AI 会根据触发词自动激活相关技能：