sillyspec 3.6.0 → 3.7.0

package/README.md

@@ -86,7 +86,7 @@ claude --dangerously-skip-permissions
 | `/sillyspec:brainstorm` | 需求探索+规范生成：直接产出 design.md + tasks.md |
 | `/sillyspec:plan` | 实现计划：文件路径+任务描述+Wave 分组 |
 | `/sillyspec:execute` | TDD 执行：子代理并行+用户自选确认频率 |
-| `/sillyspec:verify` | 验证（可选）：对照规范+测试套件 |
+| `/sillyspec:verify` | 验证（可选）：对照规范+测试套件+代码审查+E2E |
 | `/sillyspec:archive` | 归档：规范沉淀到 knowledge/ |
 
 ### 辅助工具
@@ -97,11 +97,44 @@ claude --dangerously-skip-permissions
 | `/sillyspec:continue` | 自动下一步 |
 | `/sillyspec:explore` | 自由思考：画图、讨论、调研 |
 | `/sillyspec:quick` | 快速模式：跳过完整流程 |
-| `/sillyspec:handoff` | 保存状态，下班走人 |
+| `/sillyspec:commit` | 智能提交 |
+| `/sillyspec:state` | 查看当前工作状态 |
 | `/sillyspec:resume` | 恢复工作：支持大模块阶段进度 |
 | `/sillyspec:workspace` | 工作区管理：多项目子项目 |
 | `/sillyspec:export` | 导出成功方案为可复用模板 |
 
+## CLI 命令
+
+```bash
+sillyspec status [--json]    显示当前项目状态
+sillyspec next [--json]      显示下一步命令
+sillyspec check [--json]     检查文档完整性
+sillyspec setup              安装推荐 MCP 工具（交互式）
+sillyspec setup --list       查看已安装 MCP 状态
+sillyspec init               初始化（零交互，自动检测工具）
+sillyspec init --tool <name> 指定工具安装
+sillyspec init --workspace   工作区模式
+sillyspec init --interactive 交互式引导
+```
+
+## MCP 增强
+
+通过 `sillyspec setup` 安装 MCP 工具增强 AI 能力：
+
+- **Context7** — 查询最新库文档和 API 参考
+- **grep.app** — 搜索开源代码实现
+- **Chrome DevTools** — 浏览器自动化，支持 E2E 验证
+
+## E2E 测试流程
+
+```
+plan:  识别 UI 功能 → 检测测试能力（E2E框架 > 通用测试 > 浏览器MCP）→ 添加 E2E 任务
+execute: 编码完成后编写 E2E 测试（测试文件或 e2e-steps.md）
+verify: 按优先级执行 → 用户确认修复策略 → 自动修复循环（quick）→ 结果记录
+```
+
+自动修复支持跨会话：测试结果持久化在 `.sillyspec/local.yaml`，按变更名隔离。
+
 ## 可靠性保障
 
 SillySpec 不仅仅是 prompt，还有硬校验：
@@ -126,23 +159,13 @@ SillySpec 不仅仅是 prompt，还有硬校验：
 
 ```
 sillyspec/
-├── cli/                              # Node.js CLI（npx sillyspec）
-│   ├── bin/sillyspec.js              # 入口
-│   ├── src/
-│   │   ├── index.js                  # status/next/check/init 命令
-│   │   └── init.js                   # init 逻辑 + 工具适配器
-│   └── templates/                    # 内置命令模板
-├── commands/sillyspec/              # slash commands（Claude Code）
-├── templates/                       # 纯 prompt 模板（工具无关）
-├── adapters/
-│   └── adapters.sh                  # 多工具格式转换函数（bash 版，已废弃）
-├── scripts/
-│   ├── init.sh                      # init 入口（转发给 CLI）
-│   ├── validate-proposal.sh         # 校验 propose 输出
-│   ├── validate-plan.sh             # 校验 plan 输出
-│   ├── validate-scan.sh             # 校验 scan 输出
-│   └── validate-all.sh              # 综合校验
-├── 操作文档.md                       # 详细操作指南
+├── bin/sillyspec.js              # CLI 入口
+├── src/
+│   ├── index.js                  # status/next/check 命令
+│   ├── init.js                   # init 逻辑 + 工具适配器
+│   └── setup.js                  # MCP 工具安装
+├── templates/                    # 命令模板（19 个）
+├── SKILL.md                      # 技能描述
 └── README.md
 ```
 

package/SKILL.md

@@ -1,12 +1,13 @@
 ---
 name: sillyspec
-description: "规范驱动开发工具包。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。可用命令：init、scan、explore、brainstorm、plan、execute、verify、archive、status、resume、continue、quick、workspace。"
-version: "2.0.0"
+description: "规范驱动开发工具包 v3.6。绿地项目用 /sillyspec:init，棕地项目用 /sillyspec:scan。可用命令：init、scan、scan-quick、explore、brainstorm、plan、execute、verify、archive、commit、export、status、resume、continue、quick、state、workspace、workspace-sync。"
+version: "3.6.1"
 ---
 
-# SillySpec v2.0
+# SillySpec v3.6
 
-融合 Superpowers + OpenSpec + GSD，14 个真实 slash commands。
+融合 Superpowers + OpenSpec + GSD，从"你说要啥"到"代码能跑"的完整流程。
+Claude Code / Cursor / Codex / OpenCode / OpenClaw 都能用。
 
 ## 入口选择
 
@@ -25,21 +26,62 @@ version: "2.0.0"
 工作区：workspace → (init/scan per project) → brainstorm → ...
 ```
 
-## 15 个命令
+## 19 个命令
+
+### 核心流程
 
 | 命令 | 用途 |
 |---|---|
 | `/sillyspec:init` | 绿地项目初始化 |
 | `/sillyspec:scan` | 棕地项目扫描（7 份文档） |
+| `/sillyspec:brainstorm` | 需求探索 + 生成设计文档 |
+| `/sillyspec:plan` | 编写实现计划（Wave 分组） |
+| `/sillyspec:execute` | TDD 执行 + 子代理并行 |
+| `/sillyspec:verify` | 验证（测试 + 代码审查 + E2E） |
+| `/sillyspec:archive` | 归档变更 |
+
+### 辅助工具
+
+| 命令 | 用途 |
+|---|---|
+| `/sillyspec:status` | 查看项目进度和状态 |
+| `/sillyspec:continue` | 自动判断并执行下一步 |
 | `/sillyspec:explore` | 自由思考模式 |
-| `/sillyspec:brainstorm` | 需求探索+规范生成 |
-| `/sillyspec:plan` | 实现计划 |
-| `/sillyspec:execute` | TDD 执行 |
-| `/sillyspec:verify` | 验证（可选） |
-| `/sillyspec:archive` | 归档 |
-| `/sillyspec:status` | 查看进度 |
-| `/sillyspec:continue` | 自动下一步 |
-| `/sillyspec:handoff` | 保存状态 |
+| `/sillyspec:quick` | 快速任务，跳过完整流程 |
 | `/sillyspec:resume` | 恢复工作 |
-| `/sillyspec:quick` | 快速模式 |
-| `/sillyspec:workspace` | 多项目工作区管理（add/remove/status） |
+| `/sillyspec:state` | 查看当前工作状态 |
+| `/sillyspec:commit` | 智能提交 |
+| `/sillyspec:export` | 导出成功方案为可复用模板 |
+| `/sillyspec:scan-quick` | 快速扫描（STACK + STRUCTURE） |
+| `/sillyspec:workspace` | 多项目工作区管理 |
+| `/sillyspec:workspace-sync` | 同步工作区子项目状态 |
+
+## CLI 命令
+
+```bash
+sillyspec status [--json]    显示当前项目状态
+sillyspec next [--json]      显示下一步命令
+sillyspec check [--json]     检查文档完整性
+sillyspec setup              安装推荐 MCP 工具
+sillyspec setup --list       查看已安装 MCP 状态
+sillyspec init               初始化（零交互，自动检测工具）
+sillyspec init --tool <name> 指定工具安装
+sillyspec init --workspace   工作区模式
+sillyspec init --interactive 交互式引导
+```
+
+## MCP 增强
+
+通过 `sillyspec setup` 安装 MCP 工具增强 AI 能力：
+
+- **Context7** — 查询最新库文档和 API 参考
+- **grep.app** — 搜索开源代码实现
+- **Chrome DevTools** — 浏览器自动化，支持 E2E 验证
+
+## E2E 测试流程
+
+```
+plan: 识别 UI 功能 → 检测测试框架/浏览器 MCP → 添加 E2E 任务
+execute: 编码完成后编写 E2E 测试（测试文件或 e2e-steps.md）
+verify: 按优先级执行（E2E框架 > 通用测试 > 浏览器MCP）→ 自动修复循环
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "type": "module",
   "bin": {

package/src/index.js

@@ -481,9 +481,11 @@ SillySpec CLI — 流程状态机
   sillyspec status [--json]    显示当前项目状态
   sillyspec next [--json]      显示下一步该执行的命令
   sillyspec check [--json]     检查文档完整性和路径
-  sillyspec init               初始化 SillySpec（安装到各工具）
+  sillyspec setup [--list]     安装推荐 MCP 工具（Context7、grep.app、浏览器）
+  sillyspec init               初始化 SillySpec（自动检测工具，零交互）
     [--tool <name>]            只安装指定工具
     [--workspace]              工作区模式
+    [--interactive]            交互式引导（选择工具、配置工作区）
     [--dir <path>]             指定目录
 
 选项:
@@ -495,6 +497,8 @@ SillySpec CLI — 流程状态机
   sillyspec status --json
   sillyspec next --json
   sillyspec check
+  sillyspec setup
+  sillyspec setup --list
 `);
 }
 
@@ -516,6 +520,7 @@ async function main() {
   let targetDir = process.cwd();
   let tool = null;
   let workspace = false;
+  let interactive = false;
   const filteredArgs = [];
   
   for (let i = 0; i < args.length; i++) {
@@ -529,6 +534,10 @@ async function main() {
       i++;
     } else if (args[i] === '--workspace' || args[i] === '-w') {
       workspace = true;
+    } else if (args[i] === '--interactive' || args[i] === '-i') {
+      interactive = true;
+    } else if (args[i] === '--list' || args[i] === '-l') {
+      filteredArgs.push('--list');
     } else {
       filteredArgs.push(args[i]);
     }
@@ -553,7 +562,11 @@ async function main() {
       cmdCheck(dir, { json });
       break;
     case 'init':
-      await cmdInit(dir, { tool, workspace });
+      await cmdInit(dir, { tool, workspace, interactive });
+      break;
+    case 'setup':
+      const setupList = filteredArgs.includes('--list') || filteredArgs.includes('-l');
+      await (await import('./setup.js')).cmdSetup(dir, { json, list: setupList });
       break;
     default:
       console.error(`❌ 未知命令: ${command}`);

package/src/init.js

@@ -215,6 +215,18 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
     mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });
   }
 
+  // 创建知识库骨架（所有模式）
+  const knowledgeDir = join(projectDir, '.sillyspec', 'knowledge');
+  mkdirSync(knowledgeDir, { recursive: true });
+  const indexPath = join(knowledgeDir, 'INDEX.md');
+  if (!existsSync(indexPath)) {
+    writeFileSync(indexPath, `# Knowledge Index\n\n> 子代理任务开始前查询此文件，按关键词匹配，只读命中的知识文件。\n> execute/quick 执行中发现的坑自动追加到 uncategorized.md，经用户确认后归类到对应文件。\n\n<!-- 格式：关键词1|关键词2|关键词3 → 文件路径 -->\n<!-- 示例：mybatis-plus|分页|Page → pagination.md -->\n<!-- 示例：跨域|CORS|preflight → cors.md -->\n`);
+  }
+  const uncatPath = join(knowledgeDir, 'uncategorized.md');
+  if (!existsSync(uncatPath)) {
+    writeFileSync(uncatPath, `# 未分类知识\n\n> execute/quick 执行中发现的坑暂存于此，用户审阅后归类到对应文件并更新 INDEX.md。\n`);
+  }
+
   const gitignorePath = join(projectDir, '.gitignore');
   const ignoreRules = ['.sillyspec/STATE.md', '.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml'];
   if (existsSync(gitignorePath)) {
@@ -332,6 +344,9 @@ function showSummary(version, tools, isWorkspace, count) {
   console.log('');
   console.log(chalk.gray('  重启你的 AI 工具以使 slash commands 生效。'));
   console.log('');
+  console.log(chalk.dim('  💡 推荐安装 MCP 工具增强 AI 能力：sillyspec setup'));
+  console.log(chalk.dim('     Context7 — 查最新文档 | grep.app — 搜开源实现 | Chrome DevTools — 浏览器自动化'));
+  console.log('');
 }
 
 // ── 读取版本号 ──
@@ -348,160 +363,150 @@ export function getVersion() {
 // ── 主命令 ──
 
 export async function cmdInit(projectDir, options = {}) {
-  const { tool, workspace } = options;
+  const { tool, workspace, interactive } = options;
   const version = getVersion();
 
-  // CLI 参数模式（非交互）
-  if (tool) {
-    if (!VALID_TOOLS.includes(tool)) {
-      console.error(`❌ 未知工具: ${tool}`);
-      console.error(`支持的工具: ${VALID_TOOLS.join(', ')}`);
-      process.exit(1);
-    }
-
-    console.log(chalk.cyan(`🤪 SillySpec v${version}`));
-    console.log(chalk.cyan(`📦 安装工具: ${tool}`));
+  // ── 交互式模式（--interactive 或 -i）──
+  if (interactive && isTTY()) {
+    // 欢迎画面
     console.log('');
-
-    const count = await doInstall(projectDir, [tool], workspace);
-    showSummary(version, [tool], workspace, count);
-    return;
-  }
-
-  // 非交互模式
-  if (!isTTY()) {
-    const tools = detectTools(projectDir);
-    console.log(chalk.cyan(`🤪 SillySpec v${version} (非交互模式)`));
-    console.log(chalk.cyan(`📦 自动检测工具: ${tools.join(', ')}`));
+    console.log(chalk.cyan('🤪 SillySpec v' + version + ' — 规范驱动开发'));
+    console.log(chalk.cyan('  ===================================='));
     console.log('');
-    const count = await doInstall(projectDir, tools, workspace);
-    showSummary(version, tools, workspace, count);
-    return;
-  }
-
-  // ── 交互式引导 ──
-
-  // 欢迎画面
-  console.log('');
-  console.log(chalk.cyan('🤪 SillySpec v' + version + ' — 规范驱动开发'));
-  console.log(chalk.cyan('  ===================================='));
-  console.log('');
-  console.log('  让 AI 像高级工程师一样工作：');
-  console.log('  先思考、先规划、先验证，再写代码。');
-  console.log('');
-  console.log(chalk.gray('  支持的 AI 工具：'));
-  console.log(chalk.gray('    Claude Code · Claude Skills · Cursor · Codex CLI · OpenCode · OpenClaw'));
-  console.log('');
-
-  await confirm({ message: '按回车开始设置...', default: true });
-
-  // 工具多选
-  const detected = detectTools(projectDir);
-
-  const toolChoices = VALID_TOOLS.map(v => ({
-    name: `${TOOL_LABELS[v]}${v === 'claude' ? ' (推荐)' : ''}`,
-    value: v,
-    checked: detected.includes(v),
-  }));
-
-  const selectedTools = await checkbox({
-    message: '选择要安装的 AI 工具',
-    choices: toolChoices,
-    validate: (answer) => answer.length > 0 || '至少选择一个工具',
-  });
-
-  // 工作区模式
-  const isWorkspace = await select({
-    message: '选择项目模式',
-    choices: [
-      { name: '单项目模式', value: 'false' },
-      { name: '多项目工作区', value: 'true' },
-    ],
-  }) === 'true';
-
-  // 工作区子项目引导
-  if (isWorkspace) {
+    console.log('  让 AI 像高级工程师一样工作：');
+    console.log('  先思考、先规划、先验证，再写代码。');
     console.log('');
-    console.log(chalk.yellow('📋 工作区模式 — 添加子项目'));
-    console.log(chalk.dim('   子项目是工作区中的独立项目目录（如 frontend/、backend/）'));
+    console.log(chalk.gray('  支持的 AI 工具：'));
+    console.log(chalk.gray('    Claude Code · Claude Skills · Cursor · Codex CLI · OpenCode · OpenClaw'));
     console.log('');
 
-    const addMore = await confirm({ message: '现在添加子项目？', default: true });
-    if (addMore) {
-      // 读取当前目录下的子目录作为建议
-      let suggestions = [];
-      try {
-        const entries = readdirSync(projectDir, { withFileTypes: true });
-        suggestions = entries
-          .filter(e => e.isDirectory() && !e.name.startsWith('.') && e.name !== 'node_modules')
-          .map(e => e.name)
-          .sort();
-      } catch {}
-
-      if (suggestions.length > 0) {
-        console.log('');
-        console.log(chalk.dim(`   检测到以下目录：${suggestions.join(', ')}`));
-        console.log('');
-      }
+    // 工具多选
+    const detected = detectTools(projectDir);
+
+    const toolChoices = VALID_TOOLS.map(v => ({
+      name: `${TOOL_LABELS[v]}${v === 'claude' ? ' (推荐)' : ''}`,
+      value: v,
+      checked: detected.includes(v),
+    }));
+
+    const selectedTools = await checkbox({
+      message: '选择要安装的 AI 工具（空格选择，回车确认）',
+      choices: toolChoices,
+      validate: (answer) => answer.length > 0 || '至少选择一个工具',
+    });
+
+    // 工作区模式
+    const isWorkspace = await select({
+      message: '选择项目模式',
+      choices: [
+        { name: '单项目模式', value: 'false' },
+        { name: '多项目工作区', value: 'true' },
+      ],
+    }) === 'true';
+
+    // 工作区子项目引导
+    let subprojects = [];
+    if (isWorkspace) {
+      console.log('');
+      console.log(chalk.yellow('📋 工作区模式 — 添加子项目'));
+      console.log(chalk.dim('   子项目是工作区中的独立项目目录（如 frontend/、backend/）'));
+      console.log('');
+
+      const addMore = await confirm({ message: '现在添加子项目？', default: true });
+      if (addMore) {
+        let suggestions = [];
+        try {
+          const entries = readdirSync(projectDir, { withFileTypes: true });
+          suggestions = entries
+            .filter(e => e.isDirectory() && !e.name.startsWith('.') && e.name !== 'node_modules')
+            .map(e => e.name)
+            .sort();
+        } catch {}
 
-      const subprojects = [];
-      let adding = true;
+        if (suggestions.length > 0) {
+          console.log('');
+          console.log(chalk.dim(`   检测到以下目录：${suggestions.join(', ')}`));
+          console.log('');
+        }
 
-      while (adding) {
-        const name = await input({
-          message: '子项目名称（如 frontend）',
-          default: suggestions.find(s => !subprojects.find(p => p.name === s)) || '',
-        });
+        let adding = true;
+        while (adding) {
+          const name = await input({
+            message: '子项目名称（如 frontend，留空结束）',
+            default: suggestions.find(s => !subprojects.find(p => p.name === s)) || '',
+          });
 
-        if (!name.trim()) {
-          adding = false;
-          break;
-        }
+          if (!name.trim()) {
+            adding = false;
+            break;
+          }
 
-        const pathHint = suggestions.includes(name.trim()) ? `./${name.trim()}` : '';
-        const subPath = await input({
-          message: `子项目目录路径`,
-          default: pathHint,
-        });
+          const pathHint = suggestions.includes(name.trim()) ? `./${name.trim()}` : '';
+          const subPath = await input({
+            message: '子项目目录路径',
+            default: pathHint,
+          });
 
-        const role = await input({
-          message: '子项目描述（如 前端 - Vue3 + TypeScript）',
-          default: '',
-        });
+          const role = await input({
+            message: '子项目描述（如 前端 - Vue3 + TypeScript）',
+            default: '',
+          });
 
-        // 检测 git 远程地址
-        let repo = '';
-        try {
-          const { execSync } = require('child_process');
-          const absPath = resolve(projectDir, subPath.trim() || `./${name.trim()}`);
-          repo = execSync('git remote get-url origin', { cwd: absPath, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-        } catch {}
+          let repo = '';
+          try {
+            const { execSync } = await import('child_process');
+            const absPath = resolve(projectDir, subPath.trim() || `./${name.trim()}`);
+            repo = execSync('git remote get-url origin', { cwd: absPath, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+          } catch {}
 
-        subprojects.push({
-          name: name.trim(),
-          path: subPath.trim() || `./${name.trim()}`,
-          role: role.trim(),
-          repo,
-        });
+          subprojects.push({ name: name.trim(), path: subPath.trim() || `./${name.trim()}`, role: role.trim(), repo });
 
-        // 从建议中移除已添加的
-        const idx = suggestions.indexOf(name.trim());
-        if (idx >= 0) suggestions.splice(idx, 1);
+          const idx = suggestions.indexOf(name.trim());
+          if (idx >= 0) suggestions.splice(idx, 1);
 
-        const again = await confirm({ message: '继续添加子项目？', default: subprojects.length < suggestions.length });
-        if (!again) adding = false;
+          const again = await confirm({ message: '继续添加子项目？', default: subprojects.length < suggestions.length });
+          if (!again) adding = false;
+        }
       }
+    }
 
-      // 保存子项目到临时变量，安装后写入 config.yaml
-      // 存到全局变量让 doInstall 后使用
-      global.__sillyspec_subprojects = subprojects;
+    console.log('');
+    const count = await doInstall(projectDir, selectedTools, isWorkspace, subprojects);
+    showSummary(version, selectedTools, isWorkspace, count);
+    return;
+  }
+
+  // ── 默认快速模式：检测 → 安装 → 结束 ──
+
+  let tools = [];
+  if (tool) {
+    if (!VALID_TOOLS.includes(tool)) {
+      console.error(`❌ 未知工具: ${tool}`);
+      console.error(`支持的工具: ${VALID_TOOLS.join(', ')}`);
+      process.exit(1);
     }
+    tools = [tool];
+  } else {
+    tools = detectTools(projectDir);
   }
 
-  // 安装
-  console.log('');
-  const count = await doInstall(projectDir, selectedTools, isWorkspace, global.__sillyspec_subprojects || []);
+  const count = await doInstall(projectDir, tools, !!workspace);
 
-  // 总结
-  showSummary(version, selectedTools, isWorkspace, count);
+  console.log('');
+  console.log(chalk.green(`  ✅ SillySpec v${version} 安装完成！`));
+  console.log('');
+  console.log(`  📄 ${count} 个命令已就绪`);
+  console.log('  📁 .sillyspec/ — 项目规范目录');
+  console.log('');
+  console.log('  下一步：');
+  console.log(`    全新项目 → ${chalk.bold('/sillyspec:init')}`);
+  console.log(`    已有代码 → ${chalk.bold('/sillyspec:scan')}`);
+  console.log(`    自由探索 → ${chalk.bold('/sillyspec:explore "你的想法"')}`);
+  if (workspace) {
+    console.log(`    管理子项目 → ${chalk.bold('/sillyspec:workspace add')}`);
+  }
+  console.log('');
+  console.log(chalk.dim('  💡 增强能力：sillyspec setup（安装 MCP 工具）'));
+  console.log(chalk.dim('  💡 完整配置：sillyspec init --interactive'));
+  console.log('');
 }

package/src/setup.js

@@ -0,0 +1,214 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { checkbox, confirm } from '@inquirer/prompts';
+
+// ── MCP 工具定义 ──
+
+const MCP_TOOLS = [
+  {
+    id: 'context7',
+    name: 'Context7',
+    description: '查询最新库文档和 API 参考',
+    command: 'npx',
+    args: ['-y', '@upstash/context7-mcp@latest'],
+    url: 'https://github.com/upstash/context7-mcp',
+  },
+  {
+    id: 'grep-app',
+    name: 'grep.app',
+    description: '搜索开源代码实现和参考',
+    command: 'npx',
+    args: ['-y', '@nicobailon/grep-app-mcp'],
+    url: 'https://grep.app',
+  },
+  {
+    id: 'chrome-devtools',
+    name: 'Chrome DevTools MCP',
+    description: '浏览器自动化，支持 E2E 测试（需 Chrome 已运行）',
+    command: 'npx',
+    args: ['-y', '@nicholasxjy/chrome-devtools-mcp'],
+    url: 'https://github.com/ChromeDevTools/chrome-devtools-mcp',
+  },
+];
+
+// ── MCP 配置文件路径 ──
+
+const MCP_CONFIG_PATHS = [
+  { tool: 'Claude Code', path: '.claude/mcp.json', key: 'claude' },
+  { tool: 'Cursor', path: '.cursor/mcp.json', key: 'cursor' },
+];
+
+// ── 工具函数 ──
+
+function readMcpConfig(dir, configPath) {
+  const fullPath = join(dir, configPath);
+  if (!existsSync(fullPath)) return null;
+  try {
+    return JSON.parse(readFileSync(fullPath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeMcpConfig(dir, configPath, config) {
+  const fullPath = join(dir, configPath);
+  mkdirSync(join(dir, configPath).replace(/[^/]+$/, ''), { recursive: true });
+  writeFileSync(fullPath, JSON.stringify(config, null, 2) + '\n');
+}
+
+function installMcp(config, mcpTool) {
+  if (!config.mcpServers) config.mcpServers = {};
+  config.mcpServers[mcpTool.id] = {
+    command: mcpTool.command,
+    args: mcpTool.args,
+  };
+  return config;
+}
+
+function hasMcpInstalled(config, mcpId) {
+  return config?.mcpServers?.[mcpId] != null;
+}
+
+// ── 命令实现 ──
+
+export async function cmdSetup(dir, options = {}) {
+  const { json } = options;
+
+  // 检查哪些 AI 工具有配置文件
+  const availableTools = MCP_CONFIG_PATHS.filter(({ path }) => {
+    return existsSync(join(dir, path));
+  });
+
+  if (availableTools.length === 0) {
+    if (json) {
+      console.log(JSON.stringify({ installed: [], message: '未检测到 AI 工具配置文件，请先运行 sillyspec init' }));
+    } else {
+      console.log(chalk.yellow('⚠️  未检测到 AI 工具配置文件（.claude/mcp.json 或 .cursor/mcp.json）'));
+      console.log(chalk.dim('   请先运行 sillyspec init 初始化项目'));
+    }
+    return;
+  }
+
+  // --list 模式：只查看状态
+  if (options.list) {
+    const results = {};
+    for (const { tool, path } of availableTools) {
+      const config = readMcpConfig(dir, path);
+      const installed = {};
+      for (const mcp of MCP_TOOLS) {
+        installed[mcp.id] = hasMcpInstalled(config, mcp.id);
+      }
+      results[tool] = { configPath: path, mcp: installed };
+    }
+
+    if (json) {
+      console.log(JSON.stringify(results, null, 2));
+    } else {
+      console.log('');
+      for (const [tool, data] of Object.entries(results)) {
+        console.log(chalk.bold(`📋 ${tool} (${data.configPath})`));
+        for (const mcp of MCP_TOOLS) {
+          const status = data.mcp[mcp.id] ? chalk.green('✅') : chalk.gray('⬜');
+          console.log(`  ${status} ${mcp.name} — ${mcp.description}`);
+        }
+        console.log('');
+      }
+    }
+    return;
+  }
+
+  // 非交互模式
+  if (!process.stdin.isTTY) {
+    if (json) {
+      console.log(JSON.stringify({ message: '交互模式需要 TTY，请运行 sillyspec setup' }));
+    } else {
+      console.log(chalk.yellow('⚠️  请在交互式终端运行 sillyspec setup'));
+    }
+    return;
+  }
+
+  // ── 交互式安装 ──
+
+  console.log('');
+  console.log(chalk.cyan('🔧 SillySpec Setup — 安装推荐 MCP 工具'));
+  console.log('');
+  console.log('  MCP 工具让 AI 能力增强：查文档、搜代码、控制浏览器。');
+  console.log('  选择要安装的工具（已安装的会跳过）：');
+  console.log('');
+
+  // 检测已安装状态（从所有配置文件合并）
+  const installedSet = new Set();
+  for (const { path } of availableTools) {
+    const config = readMcpConfig(dir, path);
+    for (const mcp of MCP_TOOLS) {
+      if (hasMcpInstalled(config, mcp.id)) installedSet.add(mcp.id);
+    }
+  }
+
+  const choices = MCP_TOOLS.filter(m => !installedSet.has(m.id)).map(m => ({
+    name: `${m.name} — ${m.description}`,
+    value: m.id,
+    checked: false,
+  }));
+
+  if (choices.length === 0) {
+    console.log(chalk.green('  ✅ 所有推荐的 MCP 工具已安装！'));
+    return;
+  }
+
+  const selected = await checkbox({
+    message: '选择要安装的 MCP 工具',
+    choices,
+  });
+
+  if (selected.length === 0) {
+    console.log(chalk.dim('  未选择任何工具，退出。'));
+    return;
+  }
+
+  const selectedTools = MCP_TOOLS.filter(m => selected.includes(m.id));
+
+  // 选择安装到哪些 AI 工具
+  const toolChoices = availableTools.map(t => ({
+    name: t.tool,
+    value: t.key,
+    checked: true,
+  }));
+
+  const targetTools = await checkbox({
+    message: '安装到哪些 AI 工具？',
+    choices: toolChoices,
+  });
+
+  const targets = availableTools.filter(t => targetTools.includes(t.key));
+
+  // 安装
+  console.log('');
+  for (const { tool, path } of targets) {
+    const spinner = ora(`安装到 ${tool}...`).start();
+    let config = readMcpConfig(dir, path) || { mcpServers: {} };
+
+    for (const mcp of selectedTools) {
+      config = installMcp(config, mcp);
+    }
+
+    writeMcpConfig(dir, path, config);
+    spinner.succeed(`${tool} 完成 (${selected.length} 个工具)`);
+  }
+
+  // 总结
+  console.log('');
+  console.log(chalk.green('  ═══════════════════════════════════════'));
+  console.log(chalk.green('  ✅ MCP 工具安装完成！'));
+  console.log(chalk.green('  ═══════════════════════════════════════'));
+  console.log('');
+  for (const mcp of selectedTools) {
+    console.log(`  🔌 ${chalk.cyan(mcp.name)} — ${mcp.description}`);
+    console.log(chalk.dim(`     ${mcp.url}`));
+  }
+  console.log('');
+  console.log(chalk.dim('  重启你的 AI 工具以使 MCP 配置生效。'));
+  console.log('');
+}

package/templates/brainstorm.md

@@ -117,6 +117,8 @@ git add .sillyspec/changes/<变更名>/MASTER.md
 3. 探索顺序按需：目的 → 约束 → 边界 → 成功标准
 4. **大多数 brainstorm 2-3 轮就应进入方案讨论**
 
+探索阶段可使用项目已配置的 MCP 工具或 web search 调研技术方案和 API 用法，不要凭记忆写方案。检测可用工具：`cat .claude/mcp.json .cursor/mcp.json 2>/dev/null`
+
 ### Step 4: 提出 2-3 种方案
 
 每种方案列优劣，给出推荐和理由。
@@ -157,6 +159,9 @@ git add .sillyspec/changes/<变更名>/MASTER.md
 - 范围控制：是否包含不必要功能（YAGNI）？
 - 验收标准：是否具体、可测试？
 - 变更冲突：是否与 Step 1.5 检测到的已有变更冲突？
+- 缺口：模糊表述（"适当的"/"必要时"等）是否已明确化
+- 缺口：隐含假设（登录态、数据量、并发预期）是否已显式写出
+- 缺口：边界场景（空数据、并发、服务不可用）是否已考虑
 
 发现问题 → 修改文档，重新自审。不确定的标注「⚠️ 自审存疑」让用户判断。
 

package/templates/execute.md

@@ -52,6 +52,8 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 ```
 根据当前 task 描述中的关键词（技术名词、模块名、文件路径等）匹配 INDEX.md 条目。命中时读取对应 knowledge 文件，将内容注入子代理 prompt 的「相关知识」段。未命中则跳过，不注入空段。
 
+子代理遇到不熟悉的库或 API 时，优先使用已配置的 MCP 工具（Context7 等）或 web search 查最新文档，不要凭记忆猜测用法。
+
 如果 `$ARGUMENTS` 指定范围（如 `wave-1`、`task-3`），只执行对应部分。
 
 ---
@@ -108,8 +110,9 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 4. **不自行补全：** 发现缺失接口/方法，不自己写，报告 BLOCKED
 5. **TDD 不跳步：** 按任务步骤逐步执行，每步必须运行测试命令并确认结果
 6. **测试直接通过 = 测了已有行为，重写测试**
-7. **暂存：** 完成后在工作目录执行 git add -A（不要 commit，由用户通过 /sillyspec:commit 统一提交）
-8. **不修改计划外的文件**，如必须修改则在报告中说明
+7. **E2E 任务：** 如果任务描述包含"E2E"或"端到端"，先 cat 相关功能代码和页面组件，理解交互逻辑。有测试框架则编写测试文件，无框架则编写 `.sillyspec/changes/<变更名>/e2e-steps.md` 结构化测试步骤（每条包含操作和断言）
+8. **暂存：** 完成后在工作目录执行 git add -A（不要 commit，由用户通过 /sillyspec:commit 统一提交）
+9. **不修改计划外的文件**，如必须修改则在报告中说明
 
 ## 完成后报告（严格按此格式）
 

package/templates/plan.md

@@ -98,12 +98,33 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 
 **直接覆盖** `.sillyspec/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。
 
-### 5. 自检门控
+### 5. E2E 测试规划
+
+识别 design.md 中是否有 UI 交互功能（页面跳转、表单提交、按钮操作等），如有则：
+
+**检测测试能力（按优先级）：**
+```bash
+# 优先级 1：专业 E2E 框架
+cat package.json 2>/dev/null | grep -E "playwright|cypress" ; ls node_modules/playwright node_modules/cypress 2>/dev/null
+# 优先级 2：通用测试框架
+cat package.json 2>/dev/null | grep -E "jest|vitest|mocha" ; ls node_modules/jest node_modules/vitest 2>/dev/null
+# 优先级 3：浏览器 MCP
+cat .claude/mcp.json .cursor/mcp.json 2>/dev/null | grep -i "browser\|chrome\|devtools"
+```
+
+- **有 E2E/测试框架** → tasks.md 中添加 E2E 测试任务（同波次，编码后编写）
+- **无框架但有浏览器 MCP** → tasks.md 中添加"编写 e2e-steps.md 测试步骤"任务
+- **什么都没有** → 提示用户运行 `sillyspec setup` 安装 MCP 工具，或手动安装测试框架
+
+纯后端/无 UI 的变更跳过此步骤。
+
+### 6. 自检门控
 
 - [ ] 每个 task 有具体文件路径？
 - [ ] 标注了 Wave 和依赖关系？
+- [ ] 涉及 UI 的任务是否有对应的 E2E 测试任务？
 
-### 6. 完成
+### 7. 完成
 
 ```bash
 sillyspec status --json && sillyspec next

package/templates/verify.md

@@ -65,12 +65,62 @@ cat "$CHANGE_DIR"/{design,tasks}.md 2>/dev/null
 pnpm test 2>/dev/null || npm test 2>/dev/null || pytest 2>/dev/null || go test ./... 2>/dev/null
 ```
 
+### 4b. E2E 测试
+
+检测项目中是否有 E2E 测试或测试步骤文件：
+```bash
+ls tests/e2e/ e2e/ cypress/e2e/ 2>/dev/null | head -5
+cat .sillyspec/changes/*/e2e-steps.md 2>/dev/null | head -5
+```
+
+**无任何测试** → 跳过此步骤。
+
+**有测试** → 确认修复策略（AskUserQuestion）：
+1. 自动修复，同一用例最多 5 次（超过停止，提示人工介入）
+2. 一直修复直到全绿
+3. 只报告，不自动修复
+
+**按优先级执行：**
+
+**优先级 1：专业 E2E 框架（Playwright/Cypress）**
+```bash
+npx playwright test 2>/dev/null || npx cypress run 2>/dev/null
+```
+
+**优先级 2：通用测试框架（jest/vitest）**
+```bash
+npx vitest run 2>/dev/null || npx jest 2>/dev/null
+```
+
+**优先级 3：浏览器 MCP + e2e-steps.md（兜底）**
+读取 `.sillyspec/changes/<变更名>/e2e-steps.md`，按步骤逐条执行。每条标注 ✅/❌，断言失败记为 FAILED。
+> ⚠️ 使用 MCP 执行时 AI 判断可能不如测试框架精确。追求可靠性建议安装 Playwright。
+
+**自动修复循环（选了策略 1 或 2 时）：**
+读取 `.sillyspec/local.yaml` 中当前变更的 `fixAttempts`，对每个失败测试：
+- fixAttempts 未达上限 → 调 `/sillyspec:quick "修复 E2E 失败：<失败描述>"` → 重跑该测试 → 更新 local.yaml
+- fixAttempts 达到上限 → 停止，报告失败详情，提示人工介入
+
+**更新测试结果到 `.sillyspec/local.yaml`（按变更名隔离，覆盖写入）：**
+```yaml
+e2e:
+  {变更名}:
+    login.spec.ts:
+      status: passed
+      fixAttempts: 0
+    form-submit.spec.ts:
+      status: failed
+      fixAttempts: 3
+```
+
 ### 5. 代码质量扫描
 
 ```bash
 grep -r "TODO\|FIXME\|HACK\|XXX" src/ lib/ app/ --include="*.ts" --include="*.tsx" --include="*.py" --include="*.js" 2>/dev/null | head -20
 ```
 
+审查 design.md「文件变更」中列出的文件：安全问题（输入校验、SQL拼接、硬编码敏感信息）、潜在 bug（空值、边界条件）、与 CONVENTIONS.md 一致性。每个问题标 🔴必须 / 🟡建议 / 🔵优化。
+
 ### 6. 输出验证报告
 
 ```markdown
@@ -79,6 +129,8 @@ grep -r "TODO\|FIXME\|HACK\|XXX" src/ lib/ app/ --include="*.ts" --include="*.ts
 ## 设计一致性
 ## 测试结果：passed N, failed N
 ## 技术债务标记
+## 代码审查：🔴 N / 🟡 N / 🔵 N
+## E2E 测试：passed N / failed N / fixAttempts 详情
 ## 结论：✅ PASS / ⚠️ PASS WITH NOTES / ❌ FAIL
 ```