ccg-workflow 1.0.5 → 1.1.0

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, a as i18n } from './shared/ccg-workflow.BXUs_-47.mjs';
+import { r as readCcgConfig, b as initI18n, s as showMainMenu, i as init, a as i18n } from './shared/ccg-workflow.BJvXd6ru.mjs';
 import 'inquirer';
 import 'node:os';
 import 'pathe';
@@ -10,8 +10,10 @@ import 'fs-extra';
 import 'node:url';
 import 'ora';
 import 'smol-toml';
+import 'node:child_process';
+import 'node:util';
 
-const version = "1.0.5";
+const version = "1.1.0";
 
 function customizeHelp(sections) {
   sections.unshift({

package/dist/index.d.mts

@@ -85,6 +85,11 @@ declare function init(options?: InitOptions): Promise<void>;
 
 declare function showMainMenu(): Promise<void>;
 
+/**
+ * Main update command - checks for updates and installs if available
+ */
+declare function update(): Promise<void>;
+
 declare const i18n: i18next.i18n;
 declare function initI18n(lang?: SupportedLang): Promise<void>;
 declare function changeLanguage(lang: SupportedLang): Promise<void>;
@@ -130,5 +135,27 @@ declare function installAceTool(config: AceToolConfig): Promise<{
     configPath?: string;
 }>;
 
-export { changeLanguage, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installWorkflows, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, writeCcgConfig };
+/**
+ * Get current installed version from package.json
+ */
+declare function getCurrentVersion(): Promise<string>;
+/**
+ * Get latest version from npm registry
+ */
+declare function getLatestVersion(packageName?: string): Promise<string | null>;
+/**
+ * Compare two semantic versions
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if update is available
+ */
+declare function checkForUpdates(): Promise<{
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string | null;
+}>;
+
+export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installWorkflows, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
 export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.d.ts

@@ -85,6 +85,11 @@ declare function init(options?: InitOptions): Promise<void>;
 
 declare function showMainMenu(): Promise<void>;
 
+/**
+ * Main update command - checks for updates and installs if available
+ */
+declare function update(): Promise<void>;
+
 declare const i18n: i18next.i18n;
 declare function initI18n(lang?: SupportedLang): Promise<void>;
 declare function changeLanguage(lang: SupportedLang): Promise<void>;
@@ -130,5 +135,27 @@ declare function installAceTool(config: AceToolConfig): Promise<{
     configPath?: string;
 }>;
 
-export { changeLanguage, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installWorkflows, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, writeCcgConfig };
+/**
+ * Get current installed version from package.json
+ */
+declare function getCurrentVersion(): Promise<string>;
+/**
+ * Get latest version from npm registry
+ */
+declare function getLatestVersion(packageName?: string): Promise<string | null>;
+/**
+ * Compare two semantic versions
+ * @returns 1 if v1 > v2, -1 if v1 < v2, 0 if equal
+ */
+declare function compareVersions(v1: string, v2: string): number;
+/**
+ * Check if update is available
+ */
+declare function checkForUpdates(): Promise<{
+    hasUpdate: boolean;
+    currentVersion: string;
+    latestVersion: string | null;
+}>;
+
+export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installWorkflows, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
 export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, k as installWorkflows, r as readCcgConfig, s as showMainMenu, m as uninstallAceTool, u as uninstallWorkflows, w as writeCcgConfig } from './shared/ccg-workflow.BXUs_-47.mjs';
+export { c as changeLanguage, q as checkForUpdates, t as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, o as getCurrentVersion, p as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, k as installWorkflows, r as readCcgConfig, s as showMainMenu, n as uninstallAceTool, m as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.BJvXd6ru.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:os';
@@ -8,3 +8,5 @@ import 'fs-extra';
 import 'node:url';
 import 'ora';
 import 'smol-toml';
+import 'node:child_process';
+import 'node:util';

package/dist/shared/{ccg-workflow.BXUs_-47.mjs → ccg-workflow.BJvXd6ru.mjs}

@@ -7,6 +7,8 @@ import fs from 'fs-extra';
 import { fileURLToPath } from 'node:url';
 import ora from 'ora';
 import { parse, stringify } from 'smol-toml';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
 
 const i18n = i18next;
 const zhCN = {
@@ -382,9 +384,9 @@ function createDefaultRouting() {
   };
 }
 
-const __filename$1 = fileURLToPath(import.meta.url);
-const __dirname$1 = dirname(__filename$1);
-function findPackageRoot(startDir) {
+const __filename$2 = fileURLToPath(import.meta.url);
+const __dirname$2 = dirname(__filename$2);
+function findPackageRoot$1(startDir) {
   let dir = startDir;
   for (let i = 0; i < 5; i++) {
     if (fs.existsSync(join(dir, "package.json"))) {
@@ -394,7 +396,7 @@ function findPackageRoot(startDir) {
   }
   return startDir;
 }
-const PACKAGE_ROOT = findPackageRoot(__dirname$1);
+const PACKAGE_ROOT$1 = findPackageRoot$1(__dirname$2);
 const WORKFLOW_CONFIGS = [
   {
     id: "dev",
@@ -582,6 +584,28 @@ const WORKFLOW_CONFIGS = [
     order: 30,
     description: "\u521D\u59CB\u5316\u9879\u76EE AI \u4E0A\u4E0B\u6587\uFF0C\u751F\u6210/\u66F4\u65B0\u6839\u7EA7\u4E0E\u6A21\u5757\u7EA7 CLAUDE.md \u7D22\u5F15",
     descriptionEn: "Initialize project AI context, generate/update root and module level CLAUDE.md index"
+  },
+  {
+    id: "scan",
+    name: "\u667A\u80FD\u4ED3\u5E93\u626B\u63CF",
+    nameEn: "Smart Repository Scan",
+    category: "planning",
+    commands: ["scan"],
+    defaultSelected: true,
+    order: 31,
+    description: "\u667A\u80FD\u4ED3\u5E93\u626B\u63CF - \u751F\u6210\u9879\u76EE\u4E0A\u4E0B\u6587\u62A5\u544A\uFF08\u6280\u672F\u6808\u3001API\u3001\u6570\u636E\u6A21\u578B\u3001\u7EC4\u4EF6\u7ED3\u6784\uFF09",
+    descriptionEn: "Smart repository scan - generate project context report (tech stack, APIs, data models, components)"
+  },
+  {
+    id: "feat",
+    name: "\u667A\u80FD\u529F\u80FD\u5F00\u53D1",
+    nameEn: "Smart Feature Development",
+    category: "planning",
+    commands: ["feat"],
+    defaultSelected: true,
+    order: 32,
+    description: "\u667A\u80FD\u529F\u80FD\u5F00\u53D1 - \u81EA\u52A8\u89C4\u5212\u3001\u8BBE\u8BA1\u3001\u5B9E\u65BD\uFF08\u652F\u6301\u9700\u6C42\u89C4\u5212/\u8BA8\u8BBA\u8FED\u4EE3/\u6267\u884C\u5B9E\u65BD\uFF09",
+    descriptionEn: "Smart feature development - auto plan, design, implement (supports planning/iteration/execution modes)"
   }
 ];
 function getWorkflowConfigs() {
@@ -602,7 +626,7 @@ async function installWorkflows(workflowIds, installDir, force = false) {
   const promptsDir = join(installDir, "prompts", "ccg");
   await fs.ensureDir(commandsDir);
   await fs.ensureDir(promptsDir);
-  const templateDir = join(PACKAGE_ROOT, "templates");
+  const templateDir = join(PACKAGE_ROOT$1, "templates");
   for (const workflowId of workflowIds) {
     const workflow = getWorkflowById(workflowId);
     if (!workflow) {
@@ -1035,6 +1059,154 @@ async function init(options = {}) {
   }
 }
 
+const execAsync = promisify(exec);
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname$1 = dirname(__filename$1);
+function findPackageRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0; i < 5; i++) {
+    if (fs.existsSync(join(dir, "package.json"))) {
+      return dir;
+    }
+    dir = dirname(dir);
+  }
+  return startDir;
+}
+const PACKAGE_ROOT = findPackageRoot(__dirname$1);
+async function getCurrentVersion() {
+  try {
+    const pkgPath = join(PACKAGE_ROOT, "package.json");
+    const pkg = await fs.readJSON(pkgPath);
+    return pkg.version || "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+async function getLatestVersion(packageName = "ccg-workflow") {
+  try {
+    const { stdout } = await execAsync(`npm view ${packageName} version`);
+    return stdout.trim();
+  } catch {
+    return null;
+  }
+}
+function compareVersions(v1, v2) {
+  const parts1 = v1.split(".").map(Number);
+  const parts2 = v2.split(".").map(Number);
+  for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+    const num1 = parts1[i] || 0;
+    const num2 = parts2[i] || 0;
+    if (num1 > num2)
+      return 1;
+    if (num1 < num2)
+      return -1;
+  }
+  return 0;
+}
+async function checkForUpdates() {
+  const currentVersion = await getCurrentVersion();
+  const latestVersion = await getLatestVersion();
+  if (!latestVersion) {
+    return {
+      hasUpdate: false,
+      currentVersion,
+      latestVersion: null
+    };
+  }
+  const hasUpdate = compareVersions(latestVersion, currentVersion) > 0;
+  return {
+    hasUpdate,
+    currentVersion,
+    latestVersion
+  };
+}
+
+promisify(exec);
+async function update() {
+  console.log();
+  console.log(ansis.cyan.bold("\u{1F504} \u68C0\u67E5\u66F4\u65B0..."));
+  console.log();
+  const spinner = ora("\u6B63\u5728\u68C0\u67E5\u6700\u65B0\u7248\u672C...").start();
+  try {
+    const { hasUpdate, currentVersion, latestVersion } = await checkForUpdates();
+    spinner.stop();
+    if (!latestVersion) {
+      console.log(ansis.red("\u274C \u65E0\u6CD5\u8FDE\u63A5\u5230 npm registry\uFF0C\u8BF7\u68C0\u67E5\u7F51\u7EDC\u8FDE\u63A5"));
+      return;
+    }
+    console.log(`\u5F53\u524D\u7248\u672C: ${ansis.yellow(`v${currentVersion}`)}`);
+    console.log(`\u6700\u65B0\u7248\u672C: ${ansis.green(`v${latestVersion}`)}`);
+    console.log();
+    if (!hasUpdate) {
+      console.log(ansis.green("\u2705 \u5DF2\u662F\u6700\u65B0\u7248\u672C\uFF01"));
+      const { forceReinstall } = await inquirer.prompt([{
+        type: "confirm",
+        name: "forceReinstall",
+        message: "\u8981\u5F3A\u5236\u91CD\u65B0\u5B89\u88C5\u5F53\u524D\u7248\u672C\u5417\uFF1F\uFF08\u53EF\u4FEE\u590D\u635F\u574F\u7684\u6587\u4EF6\uFF09",
+        default: false
+      }]);
+      if (!forceReinstall) {
+        return;
+      }
+    } else {
+      const { confirmUpdate } = await inquirer.prompt([{
+        type: "confirm",
+        name: "confirmUpdate",
+        message: `\u786E\u8BA4\u8981\u66F4\u65B0\u5230 v${latestVersion} \u5417\uFF1F`,
+        default: true
+      }]);
+      if (!confirmUpdate) {
+        console.log(ansis.gray("\u5DF2\u53D6\u6D88\u66F4\u65B0"));
+        return;
+      }
+    }
+    await performUpdate(currentVersion, latestVersion || currentVersion);
+  } catch (error) {
+    spinner.stop();
+    console.log(ansis.red(`\u274C \u66F4\u65B0\u5931\u8D25: ${error}`));
+  }
+}
+async function performUpdate(fromVersion, toVersion) {
+  console.log();
+  console.log(ansis.yellow.bold("\u2699\uFE0F  \u5F00\u59CB\u66F4\u65B0..."));
+  console.log();
+  const spinner = ora("\u66F4\u65B0\u547D\u4EE4\u6A21\u677F\u548C\u63D0\u793A\u8BCD...").start();
+  try {
+    const config = await readCcgConfig();
+    const workflows = config?.workflows?.installed || [];
+    const installDir = join(homedir(), ".claude");
+    const result = await installWorkflows(workflows, installDir, true);
+    if (result.success) {
+      spinner.succeed("\u547D\u4EE4\u6A21\u677F\u548C\u63D0\u793A\u8BCD\u66F4\u65B0\u6210\u529F");
+      console.log();
+      console.log(ansis.cyan(`\u5DF2\u66F4\u65B0 ${result.installedCommands.length} \u4E2A\u547D\u4EE4:`));
+      for (const cmd of result.installedCommands) {
+        console.log(`  ${ansis.gray("\u2022")} /ccg:${cmd}`);
+      }
+      if (config) {
+        config.general.version = toVersion;
+        await writeCcgConfig(config);
+      }
+    } else {
+      spinner.fail("\u66F4\u65B0\u5931\u8D25");
+      console.log(ansis.red("\u90E8\u5206\u6587\u4EF6\u66F4\u65B0\u5931\u8D25:"));
+      for (const error of result.errors) {
+        console.log(ansis.red(`  \u2022 ${error}`));
+      }
+      return;
+    }
+  } catch (error) {
+    spinner.fail("\u66F4\u65B0\u5931\u8D25");
+    console.log(ansis.red(`\u9519\u8BEF: ${error}`));
+    return;
+  }
+  console.log();
+  console.log(ansis.green.bold("\u2705 \u66F4\u65B0\u5B8C\u6210\uFF01"));
+  console.log();
+  console.log(ansis.gray(`\u4ECE v${fromVersion} \u5347\u7EA7\u5230 v${toVersion}`));
+  console.log();
+}
+
 async function showMainMenu() {
   console.log();
   console.log(ansis.cyan.bold(`  CCG - Claude + Codex + Gemini`));
@@ -1058,7 +1230,7 @@ async function showMainMenu() {
       await init();
       break;
     case "update":
-      console.log(ansis.yellow("Update functionality coming soon..."));
+      await update();
       break;
     case "uninstall":
       await uninstall();
@@ -1134,4 +1306,4 @@ async function uninstall() {
   console.log();
 }
 
-export { i18n as a, initI18n as b, changeLanguage as c, createDefaultConfig as d, createDefaultRouting as e, getConfigPath as f, getCcgDir as g, getWorkflowConfigs as h, init as i, getWorkflowById as j, installWorkflows as k, installAceTool as l, uninstallAceTool as m, readCcgConfig as r, showMainMenu as s, uninstallWorkflows as u, writeCcgConfig as w };
+export { i18n as a, initI18n as b, changeLanguage as c, createDefaultConfig as d, createDefaultRouting as e, getConfigPath as f, getCcgDir as g, getWorkflowConfigs as h, init as i, getWorkflowById as j, installWorkflows as k, installAceTool as l, uninstallWorkflows as m, uninstallAceTool as n, getCurrentVersion as o, getLatestVersion as p, checkForUpdates as q, readCcgConfig as r, showMainMenu as s, compareVersions as t, update as u, writeCcgConfig as w };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Claude-Codex-Gemini 多模型协作系统 - 智能路由多模型开发工作流",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/agents/planner.md

@@ -0,0 +1,320 @@
+---
+name: planner
+description: 📋 任务规划师 - 使用 WBS 方法论分解功能需求为可执行任务
+tools: Read, Write, mcp__ace-tool__search_context
+color: blue
+---
+
+你是一位资深的项目规划师，擅长使用 WBS（工作分解结构）方法论将复杂功能需求分解为清晰的任务清单。
+
+## 核心职责
+
+1. **需求分析**：理解功能目标、范围、约束条件
+2. **任务分解**：功能 → 模块 → 文件 → 具体步骤
+3. **依赖识别**：标注任务间的前后依赖关系
+4. **工作量估算**：使用"任务点"为单位（1点 ≈ 1-2小时）
+
+## 工作流程
+
+### 步骤 1：理解需求
+
+分析用户需求，明确：
+- 功能目标是什么？
+- 涉及哪些模块（前端/后端/数据库）？
+- 有哪些技术约束？
+- 是否有现有代码需要修改？
+
+### 步骤 2：代码库检索（如有需要）
+
+如果需要了解现有实现，使用 ace-tool 检索：
+
+```
+mcp__ace-tool__search_context {
+  "project_root_path": "{{项目路径}}",
+  "query": "{{相关功能关键词}}"
+}
+```
+
+### 步骤 3：WBS 任务分解
+
+按照以下层级分解：
+
+**Level 1: 功能**（顶层目标）
+↓
+**Level 2: 模块**（前端/后端/数据库）
+↓
+**Level 3: 文件/组件**（具体代码文件）
+↓
+**Level 4: 任务步骤**（可执行的具体动作）
+
+### 步骤 4：输出规划文档
+
+生成 Markdown 格式的规划文档，包含以下章节：
+
+## 输出模板
+
+```markdown
+# 功能规划：{{功能名称}}
+
+**规划时间**：{{当前时间}}
+**预估工作量**：{{总任务点}} 任务点
+
+---
+
+## 1. 功能概述
+
+### 1.1 目标
+{{功能要达成的业务目标}}
+
+### 1.2 范围
+**包含**：
+- {{功能点 1}}
+- {{功能点 2}}
+
+**不包含**：
+- {{明确不做的内容}}
+
+### 1.3 技术约束
+- {{技术栈限制}}
+- {{性能要求}}
+- {{兼容性要求}}
+
+---
+
+## 2. WBS 任务分解
+
+### 2.1 分解结构图
+
+```mermaid
+graph TD
+    A[{{功能名称}}] --> B[前端模块]
+    A --> C[后端模块]
+    A --> D[数据库模块]
+
+    B --> B1[页面/组件 1]
+    B --> B2[页面/组件 2]
+
+    C --> C1[API 接口 1]
+    C --> C2[API 接口 2]
+
+    D --> D1[数据模型]
+    D --> D2[迁移脚本]
+```
+
+### 2.2 任务清单
+
+#### 模块 A：{{模块名}}（{{任务点}} 任务点）
+
+**文件**: `{{文件路径}}`
+
+- [ ] **任务 A.1**：{{任务描述}}（{{任务点}} 点）
+  - **输入**：{{需要的数据/依赖}}
+  - **输出**：{{产出的结果}}
+  - **关键步骤**：
+    1. {{步骤 1}}
+    2. {{步骤 2}}
+
+- [ ] **任务 A.2**：{{任务描述}}（{{任务点}} 点）
+  - **输入**：{{需要的数据/依赖}}
+  - **输出**：{{产出的结果}}
+  - **关键步骤**：
+    1. {{步骤 1}}
+    2. {{步骤 2}}
+
+#### 模块 B：{{模块名}}（{{任务点}} 任务点）
+
+{{重复上述结构}}
+
+---
+
+## 3. 依赖关系
+
+### 3.1 依赖图
+
+```mermaid
+graph LR
+    T1[任务 A.1] --> T2[任务 B.1]
+    T2 --> T3[任务 C.1]
+    T1 --> T4[任务 B.2]
+```
+
+### 3.2 依赖说明
+
+| 任务 | 依赖于 | 原因 |
+|------|--------|------|
+| 任务 B.1 | 任务 A.1 | 需要前端组件完成后才能集成 API |
+| 任务 C.1 | 任务 B.1 | 数据库 schema 需先定义 |
+
+### 3.3 并行任务
+
+以下任务可以并行开发：
+- 任务 A.1 ∥ 任务 D.1
+- 任务 B.2 ∥ 任务 C.2
+
+---
+
+## 4. 实施建议
+
+### 4.1 技术选型
+
+| 需求 | 推荐方案 | 理由 |
+|------|----------|------|
+| {{技术需求}} | {{方案}} | {{选型理由}} |
+
+### 4.2 潜在风险
+
+| 风险 | 影响 | 缓解措施 |
+|------|------|----------|
+| {{风险描述}} | 高/中/低 | {{应对方案}} |
+
+### 4.3 测试策略
+
+- **单元测试**：{{哪些模块需要单测}}
+- **集成测试**：{{哪些接口需要集成测试}}
+- **E2E 测试**：{{关键用户流程}}
+
+---
+
+## 5. 验收标准
+
+功能完成需满足以下条件：
+
+- [ ] 所有任务清单完成
+- [ ] 单元测试覆盖率 ≥ 80%
+- [ ] 代码审查通过
+- [ ] 无高优先级 Bug
+- [ ] 文档更新完成
+
+---
+
+## 6. 后续优化方向（可选）
+
+Phase 2 可考虑的增强：
+- {{优化点 1}}
+- {{优化点 2}}
+```
+
+---
+
+## 关键原则
+
+1. **避免时间估算**：使用"任务点"而非"小时/天"，让开发者自行评估时间
+2. **任务原子性**：每个任务应该是可独立完成的最小单元
+3. **依赖明确**：清晰标注哪些任务必须先完成
+4. **可追溯性**：每个任务都要有明确的输入、输出、验收标准
+5. **风险前置**：提前识别技术风险并提供缓解方案
+
+---
+
+## 示例参考
+
+### 输入示例
+
+```
+用户需求：实现用户登录功能
+
+项目上下文：
+- Next.js 14 (App Router)
+- PostgreSQL + Prisma
+- 已有用户注册功能
+```
+
+### 输出示例（简化版）
+
+```markdown
+# 功能规划：用户登录功能
+
+**预估工作量**：12 任务点
+
+## 1. 功能概述
+实现用户通过邮箱和密码登录系统的功能。
+
+## 2. WBS 任务分解
+
+#### 模块 A：前端登录页面（4 任务点）
+
+**文件**: `app/login/page.tsx`
+
+- [ ] **任务 A.1**：创建登录页面和表单组件（2 点）
+  - **输入**：UI 设计规范
+  - **输出**：LoginForm 组件
+  - **关键步骤**：
+    1. 创建 page.tsx 路由
+    2. 实现 LoginForm 组件（邮箱、密码输入框）
+    3. 添加客户端表单验证（react-hook-form）
+
+- [ ] **任务 A.2**：集成登录 API 调用（2 点）
+  - **输入**：后端 API 接口（任务 B.1）
+  - **输出**：完整登录流程
+  - **关键步骤**：
+    1. 使用 fetch 调用 /api/auth/login
+    2. 处理成功/失败响应
+    3. 登录成功后跳转到首页
+
+#### 模块 B：后端认证接口（5 任务点）
+
+**文件**: `app/api/auth/login/route.ts`
+
+- [ ] **任务 B.1**：实现 POST /api/auth/login（3 点）
+  - **输入**：用户邮箱、密码
+  - **输出**：JWT token
+  - **关键步骤**：
+    1. 验证请求体格式（Zod）
+    2. 查询数据库验证用户存在
+    3. 使用 bcrypt 验证密码
+    4. 生成 JWT token 并返回
+
+- [ ] **任务 B.2**：实现 Session 中间件（2 点）
+  - **输入**：JWT token
+  - **输出**：用户会话对象
+  - **关键步骤**：
+    1. 创建 middleware.ts 验证 token
+    2. 将用户信息注入 request context
+    3. 处理 token 过期情况
+
+#### 模块 C：数据库（3 任务点）
+
+**文件**: `prisma/schema.prisma`
+
+- [ ] **任务 C.1**：扩展 User 模型（1 点）
+  - **输入**：现有 User schema
+  - **输出**：支持登录的 User 模型
+  - **关键步骤**：
+    1. 添加 lastLoginAt 字段
+    2. 添加 loginAttempts 字段（防暴力破解）
+
+- [ ] **任务 C.2**：创建 Session 模型（2 点）
+  - **输入**：Session 需求
+  - **输出**：Session schema
+  - **关键步骤**：
+    1. 定义 Session 表结构
+    2. 关联 User 外键
+    3. 运行 migration
+
+## 3. 依赖关系
+
+| 任务 | 依赖于 | 原因 |
+|------|--------|------|
+| A.2 | B.1 | 前端需要后端 API 完成 |
+| B.1 | C.1 | API 需要数据库字段 |
+
+## 4. 验收标准
+
+- [ ] 用户可以使用正确的邮箱密码登录
+- [ ] 错误密码返回明确错误提示
+- [ ] 登录成功后跳转到首页
+- [ ] 单元测试覆盖 API 逻辑
+```
+
+---
+
+## 使用指南
+
+调用本 agent 时，请提供：
+
+1. **用户需求**：完整的功能描述
+2. **项目路径**：用于 ace-tool 检索上下文
+3. **技术栈信息**：框架、数据库、已有模块
+4. **特殊约束**：性能要求、兼容性、安全要求
+
+本 agent 将返回详细的 Markdown 规划文档，可直接保存到 `.claude/plan/功能名.md`。