sillyspec 3.7.0 → 3.7.2

package/src/setup.js

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { join, dirname } from 'path';
+import { execSync } from 'child_process';
 import chalk from 'chalk';
 import ora from 'ora';
-import { checkbox, confirm } from '@inquirer/prompts';
+import { checkbox, confirm, input, select } from '@inquirer/prompts';
 
 // ── MCP 工具定义 ──
 
@@ -15,24 +16,70 @@ const MCP_TOOLS = [
     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'],
+    args: ['chrome-devtools-mcp@latest'],
     url: 'https://github.com/ChromeDevTools/chrome-devtools-mcp',
   },
 ];
 
+// ── 数据库 MCP 定义（需要连接信息）──
+
+const DB_MCP_TOOLS = [
+  {
+    id: 'postgres',
+    name: 'PostgreSQL',
+    description: '只读访问 PostgreSQL 数据库',
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-postgres'],
+    envTemplate: { POSTGRES_CONNECTION_STRING: 'postgresql://user:password@localhost:5432/dbname' },
+    url: 'https://github.com/modelcontextprotocol/servers/tree/main/src/postgres',
+  },
+  {
+    id: 'sqlite',
+    name: 'SQLite',
+    description: '访问 SQLite 数据库文件',
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-sqlite'],
+    envTemplate: { SQLITE_DB_PATH: './data.db' },
+    url: 'https://github.com/modelcontextprotocol/servers/tree/main/src/sqlite',
+  },
+  {
+    id: 'mysql',
+    name: 'MySQL / MariaDB',
+    description: '访问 MySQL / MariaDB 数据库',
+    command: 'npx',
+    args: ['-y', '@nicobailon/mysql-mcp-server'],
+    envTemplate: { MYSQL_HOST: 'localhost', MYSQL_PORT: '3306', MYSQL_USER: 'root', MYSQL_PASSWORD: '', MYSQL_DATABASE: '' },
+    url: 'https://github.com/modelcontextprotocol/servers',
+  },
+  {
+    id: 'redis',
+    name: 'Redis',
+    description: '访问 Redis 数据库，查看缓存和键值数据',
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-redis'],
+    envTemplate: { REDIS_URL: 'redis://localhost:6379' },
+    url: 'https://github.com/modelcontextprotocol/servers/tree/main/src/redis',
+  },
+];
+
+// ── 全局工具定义 ──
+
+const GLOBAL_TOOLS = [
+  {
+    id: 'playwright',
+    name: 'Playwright',
+    description: 'E2E 测试框架，支持浏览器自动化测试',
+    checkCommand: 'npx playwright --version',
+    installCommand: 'npm install -g @playwright/test && npx playwright install chromium',
+    url: 'https://playwright.dev',
+  },
+];
+
 // ── MCP 配置文件路径 ──
 
 const MCP_CONFIG_PATHS = [
@@ -54,16 +101,18 @@ function readMcpConfig(dir, configPath) {
 
 function writeMcpConfig(dir, configPath, config) {
   const fullPath = join(dir, configPath);
-  mkdirSync(join(dir, configPath).replace(/[^/]+$/, ''), { recursive: true });
+  mkdirSync(dirname(fullPath), { recursive: true });
   writeFileSync(fullPath, JSON.stringify(config, null, 2) + '\n');
 }
 
 function installMcp(config, mcpTool) {
   if (!config.mcpServers) config.mcpServers = {};
-  config.mcpServers[mcpTool.id] = {
+  const entry = {
     command: mcpTool.command,
     args: mcpTool.args,
   };
+  if (mcpTool.env) entry.env = mcpTool.env;
+  config.mcpServers[mcpTool.id] = entry;
   return config;
 }
 
@@ -81,26 +130,32 @@ export async function cmdSetup(dir, options = {}) {
     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 模式：只查看状态
+  // --list 模式：只查看状态（不依赖 AI 工具配置）
   if (options.list) {
     const results = {};
+
+    // MCP 状态
     for (const { tool, path } of availableTools) {
       const config = readMcpConfig(dir, path);
-      const installed = {};
+      const mcpStatus = {};
       for (const mcp of MCP_TOOLS) {
-        installed[mcp.id] = hasMcpInstalled(config, mcp.id);
+        mcpStatus[mcp.id] = hasMcpInstalled(config, mcp.id);
+      }
+      for (const db of DB_MCP_TOOLS) {
+        mcpStatus[db.id] = hasMcpInstalled(config, db.id);
+      }
+      results[tool] = { configPath: path, mcp: mcpStatus };
+    }
+
+    // 全局工具状态
+    results['全局工具'] = {};
+    for (const g of GLOBAL_TOOLS) {
+      try {
+        execSync(g.checkCommand, { stdio: 'pipe', encoding: 'utf8' });
+        results['全局工具'][g.id] = true;
+      } catch {
+        results['全局工具'][g.id] = false;
       }
-      results[tool] = { configPath: path, mcp: installed };
     }
 
     if (json) {
@@ -108,10 +163,22 @@ export async function cmdSetup(dir, options = {}) {
     } 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}`);
+        if (data.mcp) {
+          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}`);
+          }
+          for (const db of DB_MCP_TOOLS) {
+            const status = data.mcp[db.id] ? chalk.green('✅') : chalk.gray('⬜');
+            console.log(`  ${status} ${db.name} — ${db.description}`);
+          }
+        } else {
+          console.log(chalk.bold(`🛠️  ${tool}`));
+          for (const g of GLOBAL_TOOLS) {
+            const status = data[g.id] ? chalk.green('✅') : chalk.gray('⬜');
+            console.log(`  ${status} ${g.name} — ${g.description}`);
+          }
         }
         console.log('');
       }
@@ -119,7 +186,7 @@ export async function cmdSetup(dir, options = {}) {
     return;
   }
 
-  // 非交互模式
+  // 非交互模式（或没有 AI 工具但有全局工具要装）
   if (!process.stdin.isTTY) {
     if (json) {
       console.log(JSON.stringify({ message: '交互模式需要 TTY，请运行 sillyspec setup' }));
@@ -132,13 +199,20 @@ export async function cmdSetup(dir, options = {}) {
   // ── 交互式安装 ──
 
   console.log('');
-  console.log(chalk.cyan('🔧 SillySpec Setup — 安装推荐 MCP 工具'));
+  console.log(chalk.cyan('🔧 SillySpec Setup — 增强工具安装'));
   console.log('');
-  console.log('  MCP 工具让 AI 能力增强：查文档、搜代码、控制浏览器。');
+
+  if (availableTools.length === 0) {
+    console.log(chalk.dim('  未检测到 AI 工具配置文件，MCP 工具将跳过。'));
+    console.log(chalk.dim('  请先运行 sillyspec init 初始化项目。'));
+    console.log('');
+  }
+
   console.log('  选择要安装的工具（已安装的会跳过）：');
   console.log('');
 
-  // 检测已安装状态（从所有配置文件合并）
+  // ── MCP 工具选择 ──
+
   const installedSet = new Set();
   for (const { path } of availableTools) {
     const config = readMcpConfig(dir, path);
@@ -147,20 +221,61 @@ export async function cmdSetup(dir, options = {}) {
     }
   }
 
-  const choices = MCP_TOOLS.filter(m => !installedSet.has(m.id)).map(m => ({
+  const mcpChoices = MCP_TOOLS.filter(m => !installedSet.has(m.id)).map(m => ({
     name: `${m.name} — ${m.description}`,
-    value: m.id,
+    value: `mcp:${m.id}`,
+    checked: false,
+  }));
+
+  // ── 全局工具选择 ──
+
+  const globalInstalled = new Set();
+  for (const tool of GLOBAL_TOOLS) {
+    try {
+      execSync(tool.checkCommand, { stdio: 'pipe', encoding: 'utf8' });
+      globalInstalled.add(tool.id);
+    } catch {}
+  }
+
+  const globalChoices = GLOBAL_TOOLS.filter(t => !globalInstalled.has(t.id)).map(t => ({
+    name: `${t.name} — ${t.description}（全局安装）`,
+    value: `global:${t.id}`,
     checked: false,
   }));
 
-  if (choices.length === 0) {
-    console.log(chalk.green('  ✅ 所有推荐的 MCP 工具已安装！'));
+  // ── 数据库 MCP 选择 ──
+
+  const dbInstalled = new Set();
+  for (const { path } of availableTools) {
+    const config = readMcpConfig(dir, path);
+    for (const db of DB_MCP_TOOLS) {
+      if (hasMcpInstalled(config, db.id)) dbInstalled.add(db.id);
+    }
+  }
+
+  const dbChoices = DB_MCP_TOOLS.filter(d => !dbInstalled.has(d.id)).map(d => ({
+    name: `${d.name} — ${d.description}（需要连接信息）`,
+    value: `db:${d.id}`,
+    checked: false,
+  }));
+
+  const allChoices = [
+    ...mcpChoices.length > 0 ? [{ name: chalk.bold('── MCP 工具（AI 能力增强）──'), value: '_mcp_header', disabled: true }] : [],
+    ...mcpChoices,
+    ...dbChoices.length > 0 ? [{ name: chalk.bold('── 数据库 MCP ──'), value: '_db_header', disabled: true }] : [],
+    ...dbChoices,
+    ...globalChoices.length > 0 ? [{ name: chalk.bold('── 全局工具 ──'), value: '_global_header', disabled: true }] : [],
+    ...globalChoices,
+  ];
+
+  if (allChoices.length === 0) {
+    console.log(chalk.green('  ✅ 所有推荐工具已安装！'));
     return;
   }
 
   const selected = await checkbox({
-    message: '选择要安装的 MCP 工具',
-    choices,
+    message: '选择要安装的工具',
+    choices: allChoices,
   });
 
   if (selected.length === 0) {
@@ -168,47 +283,100 @@ export async function cmdSetup(dir, options = {}) {
     return;
   }
 
-  const selectedTools = MCP_TOOLS.filter(m => selected.includes(m.id));
+  const selectedMcp = MCP_TOOLS.filter(m => selected.includes(`mcp:${m.id}`));
+  const selectedDb = DB_MCP_TOOLS.filter(d => selected.includes(`db:${d.id}`));
+  const selectedGlobal = GLOBAL_TOOLS.filter(t => selected.includes(`global:${t.id}`));
 
-  // 选择安装到哪些 AI 工具
-  const toolChoices = availableTools.map(t => ({
-    name: t.tool,
-    value: t.key,
-    checked: true,
-  }));
+  // ── 收集数据库连接信息 ──
 
-  const targetTools = await checkbox({
-    message: '安装到哪些 AI 工具？',
-    choices: toolChoices,
-  });
+  if (selectedDb.length > 0) {
+    console.log('');
+    console.log(chalk.yellow('📡 数据库连接配置'));
+    console.log('');
 
-  const targets = availableTools.filter(t => targetTools.includes(t.key));
+    for (const db of selectedDb) {
+      console.log(chalk.cyan(`  ${db.name}：`));
+      const dbWithEnv = { ...db, env: {} };
+      for (const [key, placeholder] of Object.entries(db.envTemplate)) {
+        const value = await input({
+          message: `    ${key}`,
+          default: placeholder,
+        });
+        dbWithEnv.env[key] = value;
+      }
+      // 用带 env 的版本替换
+      const idx = selectedDb.indexOf(db);
+      selectedDb[idx] = dbWithEnv;
+    }
+  }
 
-  // 安装
-  console.log('');
-  for (const { tool, path } of targets) {
-    const spinner = ora(`安装到 ${tool}...`).start();
-    let config = readMcpConfig(dir, path) || { mcpServers: {} };
+  // ── 安装 MCP 工具 ──
+
+  const allMcp = [...selectedMcp, ...selectedDb];
+
+  if (allMcp.length > 0) {
+    const toolChoices = availableTools.map(t => ({
+      name: t.tool,
+      value: t.key,
+      checked: true,
+    }));
+
+    const targetTools = await checkbox({
+      message: 'MCP 工具安装到哪些 AI 工具？',
+      choices: toolChoices,
+    });
+
+    const targets = availableTools.filter(t => targetTools.includes(t.key));
 
-    for (const mcp of selectedTools) {
-      config = installMcp(config, mcp);
+    console.log('');
+    for (const { tool, path } of targets) {
+      const spinner = ora(`安装 MCP 到 ${tool}...`).start();
+      let config = readMcpConfig(dir, path) || { mcpServers: {} };
+      for (const mcp of allMcp) {
+        config = installMcp(config, mcp);
+      }
+      writeMcpConfig(dir, path, config);
+      spinner.succeed(`${tool} MCP 完成 (${allMcp.length} 个工具)`);
     }
+  }
+
+  // ── 安装全局工具 ──
 
-    writeMcpConfig(dir, path, config);
-    spinner.succeed(`${tool} 完成 (${selected.length} 个工具)`);
+  if (selectedGlobal.length > 0) {
+    console.log('');
+    for (const tool of selectedGlobal) {
+      const spinner = ora(`安装 ${tool.name}...`).start();
+      try {
+        execSync(tool.installCommand, { stdio: 'pipe', encoding: 'utf8', timeout: 120000 });
+        spinner.succeed(`${tool.name} 安装完成`);
+      } catch (err) {
+        spinner.fail(`${tool.name} 安装失败: ${err.message}`);
+      }
+    }
   }
 
-  // 总结
+  // ── 总结 ──
+
   console.log('');
   console.log(chalk.green('  ═══════════════════════════════════════'));
-  console.log(chalk.green('  ✅ MCP 工具安装完成！'));
+  console.log(chalk.green('  ✅ 工具安装完成！'));
   console.log(chalk.green('  ═══════════════════════════════════════'));
   console.log('');
-  for (const mcp of selectedTools) {
+  for (const mcp of selectedMcp) {
     console.log(`  🔌 ${chalk.cyan(mcp.name)} — ${mcp.description}`);
     console.log(chalk.dim(`     ${mcp.url}`));
   }
+  for (const db of selectedDb) {
+    console.log(`  🗄️  ${chalk.cyan(db.name)} — ${db.description}`);
+    console.log(chalk.dim(`     ${db.url}`));
+  }
+  for (const g of selectedGlobal) {
+    console.log(`  🛠️  ${chalk.cyan(g.name)} — ${g.description}`);
+    console.log(chalk.dim(`     ${g.url}`));
+  }
   console.log('');
-  console.log(chalk.dim('  重启你的 AI 工具以使 MCP 配置生效。'));
+  if (selectedMcp.length > 0) {
+    console.log(chalk.dim('  重启你的 AI 工具以使 MCP 配置生效。'));
+  }
   console.log('');
 }

package/templates/brainstorm.md

@@ -15,10 +15,10 @@
 ## 状态检查（必须先执行）
 
 ```bash
-sillyspec status --json
+cat .sillyspec/STATE.md 2>/dev/null
 ```
 
-- `phase: "brainstorm"` → ✅ 继续
+- phase 为 `brainstorm` 或无 STATE.md → ✅ 继续
 - 其他 phase → 提示用户当前阶段，建议先完成
 
 ## 用户想法
@@ -167,10 +167,6 @@ git add .sillyspec/changes/<变更名>/MASTER.md
 
 ### Step 8: 用户确认（⛔ 门禁）
 
-```bash
-sillyspec status --json
-```
-
 展示设计方案，AskUserQuestion：确认 / 需要修改 / 推翻重来。
 
 ### Step 9: 输出技术方案

package/templates/execute.md

@@ -54,6 +54,18 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 
 子代理遇到不熟悉的库或 API 时，优先使用已配置的 MCP 工具（Context7 等）或 web search 查最新文档，不要凭记忆猜测用法。
 
+**MCP 能力检测（主代理执行）：**
+```bash
+for cfg in .claude/mcp.json .cursor/mcp.json; do
+  [ -f "$cfg" ] && echo "=== $cfg ===" && cat "$cfg"
+done
+```
+根据检测结果，在子代理 prompt 的「文档查询指引」段动态注入：
+- 有 `context7` → `遇到不熟悉的库/API，使用 Context7 MCP（resolve-library-id → query-docs）查询最新文档`
+- 无 `context7` → `遇到不熟悉的库/API，使用 web search 查询最新官方文档`
+- 有数据库 MCP（postgres/sqlite/mysql/redis）→ 在「数据操作」段注入对应 MCP 可用
+- 检测为空 → 不注入额外提示
+
 如果 `$ARGUMENTS` 指定范围（如 `wave-1`、`task-3`），只执行对应部分。
 
 ---
@@ -103,6 +115,13 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 ## 相关知识（如有）
 {主代理从 knowledge/ 中按任务关键词匹配到的内容，未命中则删除此段}
 
+## 文档查询指引
+{主代理根据 MCP 检测结果动态注入：有 Context7 提示用 MCP，无则提示用 web search}
+
+## 数据操作
+{主代理根据 MCP 检测结果动态注入：如检测到数据库 MCP，提示可用}
+⛔ 任何改变现有数据的操作（DML: INSERT/UPDATE/DELETE/DML、DDL: ALTER/DROP/TRUNCATE/RENAME，以及所有非 SELECT 的数据库操作）必须暂停并报告给用户确认，不得自动执行。新建表不受此限制。
+
 ## 铁律（必须遵守）
 1. **先读后写：** 先 cat 要修改的文件和参考文件，确认风格和方法签名后再写
 2. **grep 确认：** 调用已有方法前必须 grep 确认存在，grep 不到 → 报告 BLOCKED

package/templates/plan.md

@@ -9,11 +9,11 @@
 ## 状态检查（必须先执行）
 
 ```bash
-sillyspec status --json
+cat .sillyspec/STATE.md 2>/dev/null
 ```
 
-- `phase: "plan"` → ✅ 继续
-- 其他 phase → 提示 `sillyspec next`
+- phase 为 `plan` 或 STATE.md 中下一步为 `/sillyspec:plan` → ✅ 继续
+- 其他 phase → 提示用户当前阶段
 
 ---
 
@@ -126,8 +126,8 @@ cat .claude/mcp.json .cursor/mcp.json 2>/dev/null | grep -i "browser\|chrome\|de
 
 ### 7. 完成
 
+更新 `.sillyspec/STATE.md`：阶段改为 `plan ✅`，下一步 `/sillyspec:execute`。
+
 ```bash
-sillyspec status --json && sillyspec next
+cat .sillyspec/STATE.md 2>/dev/null
 ```
-
-更新 `.sillyspec/STATE.md`：阶段改为 `plan ✅`，下一步 `/sillyspec:execute`。

package/templates/propose.md

@@ -11,11 +11,11 @@
 ## 状态检查（必须先执行）
 
 ```bash
-sillyspec status --json
+cat .sillyspec/STATE.md 2>/dev/null
 ```
 
-- `phase: "propose"` → ✅ 继续
-- 其他 phase → 提示 `sillyspec next`
+- phase 为 `propose` 或 STATE.md 中下一步为 `/sillyspec:propose` → ✅ 继续
+- 其他 phase → 提示用户当前阶段
 
 ## 变更名称
 $ARGUMENTS
@@ -70,8 +70,4 @@ bash scripts/validate-proposal.sh .sillyspec/changes/$ARGUMENTS 2>/dev/null
 
 ### 6. 完成
 
-```bash
-sillyspec status --json && sillyspec next
-```
-
 更新 `.sillyspec/STATE.md`：阶段改为 `propose ✅`，下一步 `/sillyspec:plan`。

package/templates/quick.md

@@ -26,7 +26,9 @@ $ARGUMENTS
    cat .sillyspec/knowledge/INDEX.md 2>/dev/null
    ```
    根据当前任务描述中的关键词匹配 INDEX.md 条目，命中时 `cat` 对应知识文件，将内容纳入后续开发考量。未命中则跳过。
+   **MCP 检测：** `cat .claude/mcp.json .cursor/mcp.json 2>/dev/null`，有 Context7 则用 MCP 查文档，无则用 web search。
 5. **先读后写：** 调用已有方法前 `cat` 源文件确认签名，`grep` 确认方法存在
+6. **数据操作安全：** 任何改变现有数据的操作（非 SELECT 的数据库操作）必须暂停并报告给用户确认，不得自动执行。新建表不受此限制
 6. **TDD 执行：**
    ```
    🔴 RED    → 先写测试，运行确认失败

package/templates/scan.md

@@ -11,10 +11,11 @@
 ## 流程控制（必须先执行）
 
 ```bash
-sillyspec status --json
+cat .sillyspec/STATE.md 2>/dev/null
 ```
 
-非 `init` phase → 以 CLI 返回为准决定下一步。
+有 STATE.md 且 phase 为 `scan` 或未记录 → 继续。
+其他 phase → STATE.md 中记录的下一步命令为准。
 
 ---
 
@@ -135,9 +136,20 @@ if [ ! -f ".sillyspec/knowledge/uncategorized.md" ]; then
 EOF
 fi
 
-# 验证 CLI
-sillyspec status --json   # 应返回 phase: "brainstorm"
-sillyspec next            # 推荐给用户
+# 更新状态
+cat > .sillyspec/STATE.md << 'EOF'
+# 项目状态
+
+## 当前阶段
+- 阶段：scan ✅
+- 下一步：/sillyspec:brainstorm
+
+## 关键决策
+- （扫描中发现的技术决策）
+
+## 历史记录
+- $(date '+%Y-%m-%d %H:%M:%S') scan 完成
+EOF
 
 # 清理
 rm -f .sillyspec/codebase/_env-detect.md

package/.claude/commands/sillyspec/archive.md

@@ -1,63 +0,0 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-## 核心约束（必须遵守）
-- ❌ 未经验证就归档（必须先确认验证通过）
-- ❌ 未勾选的 checkbox 未告知用户就归档
-- ❌ 归档后留下活跃变更的残留状态
-- ❌ 覆盖已存在的归档目录
-
-## 变更名称
-$ARGUMENTS
-
----
-
-## 流程
-
-### 1. 前置检查（门禁）
-
-读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
-
-- [ ] **文件完整性：** 检查 `design.md` 是否存在，缺失则警告
-- [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
-  - ① 继续归档（未完成任务将被标记完成）
-  - ② 取消，回去完成任务
-
-> 任一门禁不通过且用户选择取消 → 终止流程。
-
-### 2. 展示归档清单
-
-展示即将归档的内容摘要：
-- 变更目录名
-- 包含的文件列表
-- 任务完成统计（✅ 已完成 / ⬜ 未完成）
-- 一句话总结本次变更
-
-### 3. Spec 沉淀
-
-将 `.sillyspec/changes/<change-name>/` 下的设计文档**复制到 `.sillyspec/knowledge/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
-
-### 4. 用户确认
-
-用 AskUserQuestion 让用户确认：
-- ① 确认归档
-- ② 取消
-
-### 5. 执行归档
-
-- 目标路径：`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`
-- **检查目标路径是否已存在**，存在则中止并报错，防止覆盖
-- 移动变更目录到归档路径
-
-### 6. 归档后更新
-
-- **tasks.md：** 确保所有 checkbox 都已勾选 `[x]`
-- **ROADMAP.md**（如存在）：标记对应 Phase 已完成
-- **STATE.md：** 清除当前变更信息，历史记录追加归档完成（含精确到秒的时间戳）
-- **Git 提交：** `git add .sillyspec/ && git commit -m "docs: archive sillyspec change <change-name>"`
-
-**工作区模式下：** 如果变更属于某个子项目，cd 到子项目目录执行 git commit。工作区根目录无 git 则跳过。
-
-### 最后说：
-
-> ✅ 变更 `<change-name>` 已归档到 `archive/YYYY-MM-DD-<change-name>/`。继续：`/sillyspec:brainstorm "新想法"`