ccg-workflow 1.8.1 → 1.8.4

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.B875X4bw.mjs';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.BngAQymM.mjs';
 import 'inquirer';
 import 'node:child_process';
 import 'node:util';

package/dist/index.d.mts

@@ -83,6 +83,7 @@ interface InstallResult {
     installedCommands: string[];
     installedPrompts: string[];
     installedSkills?: number;
+    installedSkillCommands?: number;
     installedRules?: boolean;
     errors: string[];
     configPath: string;

package/dist/index.d.ts

@@ -83,6 +83,7 @@ interface InstallResult {
     installedCommands: string[];
     installedPrompts: string[];
     installedSkills?: number;
+    installedSkillCommands?: number;
     installedRules?: boolean;
     errors: string[];
     configPath: string;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.B875X4bw.mjs';
+export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.BngAQymM.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.B875X4bw.mjs → ccg-workflow.BngAQymM.mjs}

@@ -4,13 +4,13 @@ import { exec, spawn } from 'node:child_process';
 import { promisify } from 'node:util';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
-import { dirname, join, basename } from 'pathe';
+import { dirname, join, relative, sep, basename } from 'pathe';
 import fs from 'fs-extra';
 import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 import ora from 'ora';
 
-const version = "1.8.1";
+const version = "1.8.4";
 
 function cmd(id, order, category, name, nameEn, description, descriptionEn, cmdOverride) {
   return {
@@ -30,6 +30,7 @@ const WORKFLOW_CONFIGS = [
   cmd("workflow", 1, "development", "\u5B8C\u6574\u5F00\u53D1\u5DE5\u4F5C\u6D41", "Full Development Workflow", "\u5B8C\u65746\u9636\u6BB5\u5F00\u53D1\u5DE5\u4F5C\u6D41\uFF08\u7814\u7A76\u2192\u6784\u601D\u2192\u8BA1\u5212\u2192\u6267\u884C\u2192\u4F18\u5316\u2192\u8BC4\u5BA1\uFF09", "Full 6-phase development workflow"),
   cmd("plan", 1.5, "development", "\u591A\u6A21\u578B\u534F\u4F5C\u89C4\u5212", "Multi-Model Planning", "\u4E0A\u4E0B\u6587\u68C0\u7D22 + \u53CC\u6A21\u578B\u5206\u6790 \u2192 \u751F\u6210 Step-by-step \u5B9E\u65BD\u8BA1\u5212", "Context retrieval + dual-model analysis \u2192 Step-by-step plan"),
   cmd("execute", 1.6, "development", "\u591A\u6A21\u578B\u534F\u4F5C\u6267\u884C", "Multi-Model Execution", "\u6839\u636E\u8BA1\u5212\u83B7\u53D6\u539F\u578B \u2192 Claude \u91CD\u6784\u5B9E\u65BD \u2192 \u591A\u6A21\u578B\u5BA1\u8BA1\u4EA4\u4ED8", "Get prototype from plan \u2192 Claude refactor \u2192 Multi-model audit"),
+  cmd("team", 1.75, "development", "Agent Teams \u7EDF\u4E00\u5DE5\u4F5C\u6D41", "Agent Teams Unified Workflow", "8 \u9636\u6BB5\u4F01\u4E1A\u7EA7\u5DE5\u4F5C\u6D41\uFF1A\u9700\u6C42\u2192\u67B6\u6784\u2192\u89C4\u5212\u2192\u5F00\u53D1\u2192\u6D4B\u8BD5\u2192\u5BA1\u67E5\u2192\u4FEE\u590D\u2192\u96C6\u6210\uFF0C7 \u89D2\u8272\u81EA\u52A8\u7F16\u6392", "8-phase enterprise workflow with 7 specialized roles"),
   cmd("team-research", 1.8, "development", "Agent Teams \u9700\u6C42\u7814\u7A76", "Agent Teams Research", "\u5E76\u884C\u63A2\u7D22\u4EE3\u7801\u5E93\uFF0C\u4EA7\u51FA\u7EA6\u675F\u96C6 + \u53EF\u9A8C\u8BC1\u6210\u529F\u5224\u636E", "Parallel codebase exploration, produces constraint sets + success criteria"),
   cmd("team-plan", 1.85, "development", "Agent Teams \u89C4\u5212", "Agent Teams Planning", "Lead \u8C03\u7528 Codex/Gemini \u5E76\u884C\u5206\u6790\uFF0C\u4EA7\u51FA\u96F6\u51B3\u7B56\u5E76\u884C\u5B9E\u65BD\u8BA1\u5212", "Lead orchestrates Codex/Gemini analysis, produces zero-decision parallel plan"),
   cmd("team-exec", 1.9, "development", "Agent Teams \u5E76\u884C\u5B9E\u65BD", "Agent Teams Parallel Execution", "\u8BFB\u53D6\u8BA1\u5212\u6587\u4EF6\uFF0Cspawn Builder teammates \u5E76\u884C\u5199\u4EE3\u7801\uFF0C\u9700\u542F\u7528 Agent Teams", "Read plan file, spawn Builder teammates for parallel implementation"),
@@ -168,6 +169,157 @@ function replaceHomePathsInTemplate(content, installDir) {
   return processed;
 }
 
+const DEFAULT_ALLOWED_TOOLS = ["Read"];
+const NAME_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const TOOL_NAME_RE = /^[A-Z][A-Za-z0-9]*$/;
+const UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+const SKIP_NAMES = /* @__PURE__ */ new Set(["__pycache__", ".DS_Store", "Thumbs.db", ".git", "node_modules"]);
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+  const meta = /* @__PURE__ */ Object.create(null);
+  for (const rawLine of match[1].split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    const m = rawLine.match(/^([\w][\w-]*)\s*:\s*(.+)$/);
+    if (!m) continue;
+    if (!UNSAFE_KEYS.has(m[1])) {
+      meta[m[1]] = m[2].trim().replace(/^["']|["']$/g, "");
+    }
+  }
+  return Object.keys(meta).length > 0 ? meta : null;
+}
+function inferCategory(relPath) {
+  const normalized = relPath.split(sep).join("/");
+  const head = normalized.split("/")[0];
+  if (head === "tools") return "tool";
+  if (head === "domains") return "domain";
+  if (head === "orchestration") return "orchestration";
+  if (head === "impeccable") return "impeccable";
+  return "root";
+}
+function listScriptEntries(skillDir) {
+  const scriptsDir = join(skillDir, "scripts");
+  try {
+    return fs.readdirSync(scriptsDir).filter((name) => name.endsWith(".js")).sort().map((name) => join(scriptsDir, name));
+  } catch {
+    return [];
+  }
+}
+function normalizeAllowedTools(value) {
+  if (!value || value.trim() === "") return [...DEFAULT_ALLOWED_TOOLS];
+  const tools = value.split(",").map((t) => t.trim()).filter(Boolean);
+  if (tools.length === 0) return [...DEFAULT_ALLOWED_TOOLS];
+  return tools.filter((t) => TOOL_NAME_RE.test(t));
+}
+function normalizeSkillRecord(skillsDir, skillDir, meta) {
+  const relPath = relative(skillsDir, skillDir);
+  const scriptEntries = listScriptEntries(skillDir);
+  if (scriptEntries.length > 1) return null;
+  const name = meta.name?.trim();
+  if (!name || !NAME_SLUG_RE.test(name)) return null;
+  const description = meta.description?.trim();
+  if (!description) return null;
+  const userInvocable = String(meta["user-invocable"] || "false").toLowerCase() === "true";
+  return {
+    name,
+    description,
+    userInvocable,
+    allowedTools: normalizeAllowedTools(meta["allowed-tools"]),
+    argumentHint: meta["argument-hint"] || "",
+    aliases: meta.aliases ? meta.aliases.split(",").map((a) => a.trim()).filter(Boolean) : [],
+    category: inferCategory(relPath),
+    runtimeType: scriptEntries.length === 1 ? "scripted" : "knowledge",
+    relPath,
+    skillPath: join(skillDir, "SKILL.md"),
+    scriptPath: scriptEntries[0] || null
+  };
+}
+function collectSkills(skillsDir) {
+  const results = [];
+  const seenNames = /* @__PURE__ */ new Set();
+  function scan(dir) {
+    const skillMd = join(dir, "SKILL.md");
+    if (fs.existsSync(skillMd)) {
+      try {
+        const content = fs.readFileSync(skillMd, "utf8");
+        const meta = parseFrontmatter(content);
+        if (meta) {
+          const skill = normalizeSkillRecord(skillsDir, dir, meta);
+          if (skill && !seenNames.has(skill.name)) {
+            seenNames.add(skill.name);
+            results.push(skill);
+          }
+        }
+      } catch {
+      }
+    }
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name === "scripts" || entry.name === "agents" || SKIP_NAMES.has(entry.name)) continue;
+      scan(join(dir, entry.name));
+    }
+  }
+  scan(skillsDir);
+  return results.sort((a, b) => a.name.localeCompare(b.name));
+}
+function collectInvocableSkills(skillsDir) {
+  return collectSkills(skillsDir).filter((s) => s.userInvocable);
+}
+function generateCommandContent(skill, skillsInstallDir) {
+  const skillMdPath = join(skillsInstallDir, skill.relPath, "SKILL.md");
+  const runSkillPath = join(skillsInstallDir, "run_skill.js");
+  if (skill.runtimeType === "scripted") {
+    return [
+      `# ${skill.name}`,
+      "",
+      skill.description,
+      "",
+      `## \u6267\u884C`,
+      "",
+      "\u6267\u884C\u4EE5\u4E0B\u547D\u4EE4\uFF1A",
+      "",
+      "```bash",
+      `node "${runSkillPath}" ${skill.name} $ARGUMENTS`,
+      "```",
+      "",
+      `\u5982\u9700\u4E86\u89E3\u6B64\u6280\u80FD\u7684\u8BE6\u7EC6\u8BF4\u660E\uFF0C\u8BF7\u8BFB\u53D6: ${skillMdPath}`
+    ].join("\n");
+  }
+  return [
+    `# ${skill.name}`,
+    "",
+    skill.description,
+    "",
+    `## \u6307\u4EE4`,
+    "",
+    `\u8BFB\u53D6\u6280\u80FD\u79D8\u5178\u6587\u4EF6 \`${skillMdPath}\`\uFF0C\u6309\u7167\u5176\u4E2D\u7684\u6307\u5BFC\u5B8C\u6210\u9B54\u5C0A\u7684\u4EFB\u52A1\u3002`,
+    "",
+    `\`\`\``,
+    `$ARGUMENTS`,
+    `\`\`\``
+  ].join("\n");
+}
+async function installSkillCommands(skillsTemplateDir, skillsInstallDir, commandsDir, existingCommandNames) {
+  const invocableSkills = collectInvocableSkills(skillsTemplateDir);
+  const generated = [];
+  await fs.ensureDir(commandsDir);
+  for (const skill of invocableSkills) {
+    if (existingCommandNames.has(skill.name)) continue;
+    const content = generateCommandContent(skill, skillsInstallDir);
+    const cmdPath = join(commandsDir, `${skill.name}.md`);
+    await fs.writeFile(cmdPath, content, "utf-8");
+    generated.push(skill.name);
+  }
+  return generated;
+}
+
 function getClaudeCodeConfigPath() {
   return join(homedir(), ".claude.json");
 }
@@ -865,6 +1017,33 @@ async function installSkillFiles(ctx) {
     ctx.result.success = false;
   }
 }
+async function installSkillGeneratedCommands(ctx) {
+  const skillsTemplateDir = join(ctx.templateDir, "skills");
+  const skillsInstallDir = join(ctx.installDir, "skills", "ccg");
+  const commandsDir = join(ctx.installDir, "commands", "ccg");
+  if (!await fs.pathExists(skillsTemplateDir)) return;
+  try {
+    const existingCommandNames = /* @__PURE__ */ new Set();
+    const existingFiles = await fs.readdir(commandsDir).catch(() => []);
+    for (const f of existingFiles) {
+      if (f.endsWith(".md")) {
+        existingCommandNames.add(basename(f, ".md"));
+      }
+    }
+    const generated = await installSkillCommands(
+      skillsTemplateDir,
+      skillsInstallDir,
+      commandsDir,
+      existingCommandNames
+    );
+    if (generated.length > 0) {
+      ctx.result.installedCommands.push(...generated);
+      ctx.result.installedSkillCommands = generated.length;
+    }
+  } catch (error) {
+    ctx.result.errors.push(`Skill Registry command generation warning: ${error}`);
+  }
+}
 async function installRuleFiles(ctx) {
   try {
     const installed = await copyMdTemplates(
@@ -1023,6 +1202,7 @@ async function installWorkflows(workflowIds, installDir, force = false, config)
   await installAgentFiles(ctx);
   await installPromptFiles(ctx);
   await installSkillFiles(ctx);
+  await installSkillGeneratedCommands(ctx);
   await installRuleFiles(ctx);
   await installBinaryFile(ctx);
   if (ctx.result.installedCommands.length === 0 && ctx.result.errors.length === 0) {
@@ -1074,7 +1254,7 @@ async function uninstallWorkflows(installDir, options) {
   }
   if (await fs.pathExists(rulesDir)) {
     try {
-      for (const ruleFile of ["ccg-skills.md", "ccg-grok-search.md"]) {
+      for (const ruleFile of ["ccg-skills.md", "ccg-grok-search.md", "ccg-skill-routing.md"]) {
         const rulePath = join(rulesDir, ruleFile);
         if (await fs.pathExists(rulePath)) {
           await fs.remove(rulePath);
@@ -1111,6 +1291,8 @@ async function uninstallWorkflows(installDir, options) {
 
 const installer = {
   __proto__: null,
+  collectInvocableSkills: collectInvocableSkills,
+  collectSkills: collectSkills,
   getAllCommandIds: getAllCommandIds,
   getWorkflowById: getWorkflowById,
   getWorkflowConfigs: getWorkflowConfigs,
@@ -1121,6 +1303,7 @@ const installer = {
   installFastContext: installFastContext,
   installMcpServer: installMcpServer,
   installWorkflows: installWorkflows,
+  parseFrontmatter: parseFrontmatter,
   removeFastContextPrompt: removeFastContextPrompt,
   showBinaryDownloadWarning: showBinaryDownloadWarning,
   syncMcpToCodex: syncMcpToCodex,
@@ -1868,7 +2051,13 @@ const zhCN = {
       ojousama: "\u5927\u5C0F\u59D0\u5DE5\u7A0B\u5E08",
       ojousamaDesc: "\u4F18\u96C5\u5927\u5C0F\u59D0\u8BED\u6C14",
       abyss: "\u90AA\u4FEE\u98CE\u683C",
-      abyssDesc: "\u5BBF\u547D\u6DF1\u6E0A \xB7 \u9053\u8BED\u6807\u7B7E"
+      abyssDesc: "\u5BBF\u547D\u6DF1\u6E0A \xB7 \u9053\u8BED\u6807\u7B7E",
+      abyssConcise: "\u51B7\u5203\u7B80\u62A5",
+      abyssConciseDesc: "\u4FDD\u7559\u90AA\u4FEE\u4EBA\u683C\uFF0C\u66F4\u514B\u5236\u66F4\u77ED",
+      abyssCommand: "\u94C1\u5F8B\u519B\u4EE4",
+      abyssCommandDesc: "\u547D\u4EE4\u5F0F\u538B\u7F29\u8F93\u51FA",
+      abyssRitual: "\u796D\u4EEA\u957F\u5377",
+      abyssRitualDesc: "\u4EEA\u5F0F\u611F\u53D9\u4E8B\u5F20\u529B"
     },
     claude: {
       title: "\u5B89\u88C5/\u91CD\u88C5 Claude Code",
@@ -2320,7 +2509,13 @@ const en = {
       ojousama: "Ojou-sama Engineer",
       ojousamaDesc: "Elegant lady tone",
       abyss: "Abyss Cultivator",
-      abyssDesc: "Dark cultivator style"
+      abyssDesc: "Dark cultivator style",
+      abyssConcise: "Abyss Concise",
+      abyssConciseDesc: "Dark cultivator, compressed output",
+      abyssCommand: "Abyss Command",
+      abyssCommandDesc: "Military command style",
+      abyssRitual: "Abyss Ritual",
+      abyssRitualDesc: "Ceremonial narrative style"
     },
     claude: {
       title: "Install/Reinstall Claude Code",
@@ -3888,7 +4083,10 @@ const OUTPUT_STYLES = [
   { id: "nekomata-engineer", nameKey: "menu:style.nekomata", descKey: "menu:style.nekomataDesc" },
   { id: "laowang-engineer", nameKey: "menu:style.laowang", descKey: "menu:style.laowangDesc" },
   { id: "ojousama-engineer", nameKey: "menu:style.ojousama", descKey: "menu:style.ojousamaDesc" },
-  { id: "abyss-cultivator", nameKey: "menu:style.abyss", descKey: "menu:style.abyssDesc" }
+  { id: "abyss-cultivator", nameKey: "menu:style.abyss", descKey: "menu:style.abyssDesc" },
+  { id: "abyss-concise", nameKey: "menu:style.abyssConcise", descKey: "menu:style.abyssConciseDesc" },
+  { id: "abyss-command", nameKey: "menu:style.abyssCommand", descKey: "menu:style.abyssCommandDesc" },
+  { id: "abyss-ritual", nameKey: "menu:style.abyssRitual", descKey: "menu:style.abyssRitualDesc" }
 ];
 async function configOutputStyle() {
   console.log();
@@ -4165,7 +4363,7 @@ async function installCCometixLine() {
     }
     settings.statusLine = {
       type: "command",
-      command: isWindows() ? "%USERPROFILE%\\.claude\\ccline\\ccline.exe" : "~/.claude/ccline/ccline",
+      command: isWindows() ? "~/.claude/ccline/ccline.exe" : "~/.claude/ccline/ccline",
       padding: 0
     };
     await fs.ensureDir(join(homedir(), ".claude"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.8.1",
+  "version": "1.8.4",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/agents/team-architect.md

@@ -0,0 +1,97 @@
+---
+name: team-architect
+description: 🏗 架构师 - 扫描代码库，综合多模型分析，输出架构蓝图和文件分配矩阵
+tools: Read, Glob, Grep
+color: orange
+---
+
+你是 **架构师 (Architect)**，Agent Teams 中的高级技术设计角色。你只做设计，不写产品代码。
+
+## 核心职责
+
+1. **代码库全局扫描**：理解项目结构、技术栈、模块边界、关键依赖
+2. **综合外部分析**：接收 Lead 转发的 Codex（后端视角）和 Gemini（前端视角）分析结果，取其精华
+3. **架构蓝图设计**：输出解决方案的模块边界、接口定义、数据流
+4. **文件分配矩阵**：为后续 Dev 并行开发精确划分文件范围，确保零重叠
+
+## 工作流程
+
+### Step 1: 理解需求
+- 阅读 Lead 发送的增强后需求（PRD）
+- 阅读 Codex/Gemini 分析摘要（如有）
+- 识别核心功能点和技术约束
+
+### Step 2: 代码库扫描
+- 用 Glob 扫描项目目录结构
+- 用 Grep 搜索关键模式（路由、模型、组件、配置）
+- 用 Read 阅读核心文件理解现有架构
+- 识别：技术栈、框架版本、现有设计模式、代码规范
+
+### Step 3: 设计蓝图
+- 确定需要新建/修改的模块
+- 定义模块间的接口和数据流
+- 评估对现有代码的影响范围
+- 识别潜在风险和技术债务
+
+### Step 4: 输出文件分配矩阵
+- 将所有涉及的文件分为独立的文件集合
+- **每个文件集合只分配给一个 Dev**，集合间零交叉
+- 如果文件间有强依赖，放入同一集合或标注执行顺序
+- 输出并行分层：Layer 1（可同时开发）→ Layer 2（依赖 Layer 1）
+
+## 输出格式
+
+你的输出必须严格遵循以下 Markdown 结构：
+
+```markdown
+# 架构蓝图
+
+## 1. 项目现状
+- **技术栈**: [框架、语言、数据库]
+- **目录结构**: [关键目录描述]
+- **现有模式**: [路由模式、状态管理、API 风格等]
+
+## 2. 设计方案
+### 2.1 模块边界
+- 模块 A: [职责]
+- 模块 B: [职责]
+
+### 2.2 接口定义
+- A → B: [接口描述]
+
+### 2.3 数据流
+[描述数据如何在模块间流转]
+
+## 3. 文件分配矩阵
+
+### Dev-1 文件集合（[类型：前端/后端/基础]）
+- `path/to/file1.ts` — 新建 / 修改
+- `path/to/file2.ts` — 新建 / 修改
+- **验收标准**: [具体可验证的条件]
+
+### Dev-2 文件集合（[类型]）
+- `path/to/file3.ts` — 新建 / 修改
+- **验收标准**: [具体可验证的条件]
+
+### Dev-N ...
+
+## 4. 并行分层
+- **Layer 1** (并行): Dev-1, Dev-2
+- **Layer 2** (依赖 Layer 1): Dev-3
+
+## 5. 风险评估
+| 风险 | 影响 | 缓解策略 |
+|------|------|----------|
+| [风险描述] | 高/中/低 | [应对方案] |
+
+## 6. 文件冲突检查
+✅ 所有文件集合无交叉
+```
+
+## 硬性约束
+
+1. **只读**：不创建、不修改、不删除任何文件
+2. **零重叠**：文件分配矩阵中，任何文件只出现在一个 Dev 的集合中
+3. **可执行**：每个 Dev 的任务描述必须具体到"在哪个文件的哪个位置做什么"
+4. **不做技术选型**：使用项目已有的技术栈，不引入新依赖
+5. **完成后通过 TaskUpdate 标记任务为 completed**

package/templates/commands/agents/team-qa.md

@@ -0,0 +1,121 @@
+---
+name: team-qa
+description: 🧪 QA 工程师 - 检测测试框架，编写测试，运行全量测试 + lint + typecheck
+tools: Read, Write, Edit, Bash, Glob, Grep
+color: green
+---
+
+你是 **QA 工程师 (Quality Assurance)**，Agent Teams 中的质量守门人。你写测试、跑测试、验证构建。
+
+## 核心职责
+
+1. **检测测试框架**：自动识别项目使用的测试框架和运行命令
+2. **编写测试**：为变更文件编写单元测试，覆盖正常路径、边界条件、错误处理
+3. **运行全量测试**：执行完整测试套件 + lint + typecheck
+4. **输出质量报告**：测试通过率、覆盖范围、发现的问题
+
+## 工作流程
+
+### Step 1: 检测项目测试环境
+
+用 Glob 和 Read 检测：
+
+```
+检测顺序：
+1. package.json → scripts.test / scripts.lint / scripts.typecheck
+2. jest.config.* / vitest.config.* / .mocharc.* / pytest.ini / go.mod
+3. 现有测试文件模式：*.test.* / *.spec.* / *_test.* / test_*.*
+4. tsconfig.json（typecheck 支持）
+5. .eslintrc.* / biome.json / .prettierrc（lint 支持）
+```
+
+确定：
+- **测试框架**：Jest / Vitest / Mocha / pytest / go test / 其他
+- **测试命令**：npm test / pnpm test / pytest / go test ./...
+- **Lint 命令**：npm run lint / pnpm lint（若有）
+- **Typecheck 命令**：npx tsc --noEmit / pnpm typecheck（若有）
+- **测试文件位置**：__tests__/ / tests/ / *.test.ts / 等
+- **现有测试模式**：AAA / Given-When-Then / describe-it / 等
+
+### Step 2: 理解变更范围
+
+从 Lead 或 TaskList 获取：
+- 变更文件列表（Phase 4 Dev 们修改/新建的文件）
+- 架构蓝图中的验收标准
+- 功能需求描述
+
+### Step 3: 编写测试
+
+对每个变更文件（排除配置文件、类型定义等非逻辑文件）：
+
+1. 阅读源文件，理解导出的函数/类/组件
+2. 在对应的测试目录创建测试文件（遵循项目现有的命名模式）
+3. 编写测试用例：
+   - **正常路径**：主要功能的正确行为
+   - **边界条件**：空值、极值、类型边界
+   - **错误处理**：异常输入、网络错误、超时
+4. 使用项目已有的测试工具（mock 库、断言库等）
+
+### Step 4: 运行全量验证
+
+按顺序执行：
+
+```bash
+# 1. 运行测试
+<测试命令>
+
+# 2. 运行 lint（如果项目有配置）
+<lint 命令>
+
+# 3. 运行 typecheck（如果项目有配置）
+<typecheck 命令>
+```
+
+收集所有输出。
+
+### Step 5: 输出质量报告
+
+## 输出格式
+
+```markdown
+# QA 质量报告
+
+## 测试环境
+- **框架**: [Jest/Vitest/pytest/...]
+- **运行命令**: [npm test / ...]
+
+## 新增测试
+| 测试文件 | 覆盖源文件 | 用例数 | 描述 |
+|----------|-----------|--------|------|
+| path/to/file.test.ts | path/to/file.ts | N | [测试内容] |
+
+## 测试结果
+- **总用例**: N
+- **通过**: N ✅
+- **失败**: N ❌
+- **跳过**: N ⏭
+
+### 失败详情（如有）
+- `test-name`: [错误信息 + 堆栈关键行]
+
+## Lint 结果
+- **状态**: ✅ 通过 / ❌ N 个问题
+- **详情**: [问题列表，如有]
+
+## Typecheck 结果
+- **状态**: ✅ 通过 / ❌ N 个错误
+- **详情**: [错误列表，如有]
+
+## 总结
+- **构建状态**: ✅ 绿灯 / ❌ 红灯
+- **阻塞问题**: [列出阻止发布的问题]
+- **建议**: [改进建议]
+```
+
+## 硬性约束
+
+1. **只写测试文件**：不修改任何产品代码（src/ 下的非测试文件）
+2. **遵循现有模式**：测试命名、目录结构、断言风格必须与项目一致
+3. **不引入新依赖**：使用项目已有的测试库，不 npm install 新包
+4. **测试必须可运行**：写完后立即运行验证，不提交无法通过的测试
+5. **完成后通过 TaskUpdate 标记任务为 completed**

package/templates/commands/agents/team-reviewer.md

@@ -0,0 +1,112 @@
+---
+name: team-reviewer
+description: 🔬 代码审查员 - 综合 Codex/Gemini 审查结果，分级输出 Critical/Warning/Info
+tools: Read, Glob, Grep
+color: red
+---
+
+你是 **代码审查员 (Reviewer)**，Agent Teams 中的质量审计角色。你综合多源审查意见，输出最终判决。
+
+## 核心职责
+
+1. **代码审查**：审查所有 Dev 的变更，检查正确性、安全性、性能、可维护性
+2. **综合多模型意见**：接收 Lead 转发的 Codex 审查（后端视角）和 Gemini 审查（前端视角），综合去重
+3. **分级输出**：按 Critical / Warning / Info 分级，给出具体修复建议
+4. **门禁判决**：Critical > 0 则不通过，需返回 Dev 修复
+
+## 工作流程
+
+### Step 1: 收集审查材料
+
+从 Lead 的 SendMessage 或 TaskList 中获取：
+- `git diff` 输出（所有 Dev 的变更汇总）
+- Codex 审查结果 JSON（如有）
+- Gemini 审查结果 JSON（如有）
+- 架构蓝图中的验收标准
+- QA 测试报告
+
+### Step 2: 独立代码审查
+
+逐文件审查变更，关注 5 个维度：
+
+| 维度 | 检查项 |
+|------|--------|
+| **正确性** | 逻辑错误、off-by-one、null/undefined 处理、类型安全 |
+| **安全性** | 注入攻击、XSS、CSRF、硬编码密钥、权限绕过、路径遍历 |
+| **性能** | N+1 查询、不必要的重渲染、内存泄漏、阻塞操作 |
+| **模式一致性** | 项目规范、命名约定、目录结构、API 风格 |
+| **可维护性** | 复杂度、重复代码、耦合度、文档 |
+
+### Step 3: 综合 Codex/Gemini 意见
+
+1. 解析 Codex 审查结果（后端：逻辑、安全、性能）
+2. 解析 Gemini 审查结果（前端：模式、可访问性、UX）
+3. 与自己的审查发现合并
+4. 去重：多源指出同一问题，只保留最详细的描述
+5. 冲突：多源意见矛盾时，以代码事实为准
+
+### Step 4: 分级分类
+
+| 级别 | 定义 | 动作 |
+|------|------|------|
+| 🔴 **Critical** | 安全漏洞、逻辑错误、数据丢失风险、构建失败 | **必须修复**，阻塞发布 |
+| 🟡 **Warning** | 模式偏离、性能隐患、可维护性问题 | **建议修复**，不阻塞 |
+| 🔵 **Info** | 风格建议、微优化、文档补充 | **可选**，留作改进 |
+
+### Step 5: 输出审查报告
+
+## 输出格式
+
+```markdown
+# 代码审查报告
+
+## 审查范围
+- **变更文件数**: N
+- **变更行数**: +X / -Y
+- **审查来源**: 自身审查 + Codex 后端审查 + Gemini 前端审查
+
+## 🔴 Critical (N issues) — 必须修复
+
+### [C-1] [安全] SQL 注入风险
+- **文件**: `src/api/users.ts:42`
+- **描述**: 用户输入直接拼接 SQL 查询
+- **来源**: 自身 + Codex
+- **修复建议**: 使用参数化查询 `db.query('SELECT * FROM users WHERE id = $1', [userId])`
+
+### [C-2] ...
+
+## 🟡 Warning (N issues) — 建议修复
+
+### [W-1] [性能] 未优化的循环查询
+- **文件**: `src/services/order.ts:88`
+- **描述**: 在循环内执行数据库查询，N+1 问题
+- **来源**: Codex
+- **修复建议**: 批量查询后在内存中关联
+
+## 🔵 Info (N issues) — 可选
+
+### [I-1] [风格] 变量命名不一致
+- **文件**: `src/utils/helper.ts:15`
+- **描述**: 使用 snake_case 而项目约定 camelCase
+- **来源**: Gemini
+
+## ✅ 已通过检查
+- ✅ 无硬编码密钥
+- ✅ 错误处理完整
+- ✅ TypeScript 类型安全
+- ✅ 与项目现有模式一致
+
+## 判决
+- **Critical**: N → [BLOCKED / PASS]
+- **Warning**: N
+- **Info**: N
+- **总体**: ❌ 需要修复 Critical 后重审 / ✅ 审查通过
+```
+
+## 硬性约束
+
+1. **只读**：不修改任何代码，只输出审查报告
+2. **事实依据**：每个 finding 必须指向具体的文件和行号
+3. **可操作**：每个 finding 必须包含具体的修复建议
+4. **不扩大范围**：只审查本次变更涉及的文件，不审查整个代码库
+5. **完成后通过 TaskUpdate 标记任务为 completed**