sillyspec 3.7.1 → 3.7.3

package/src/setup.js

@@ -1,8 +1,9 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 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 = [
@@ -60,10 +107,12 @@ function writeMcpConfig(dir, configPath, config) {
 
 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,60 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 
 子代理遇到不熟悉的库或 API 时，优先使用已配置的 MCP 工具（Context7 等）或 web search 查最新文档，不要凭记忆猜测用法。
 
+**编码规范扫描（主代理执行）：**
+主代理在 dispatch 子代理前，扫描项目中常见的编码规范配置文件，将关键规则注入子代理 prompt 的「编码规范约束」段。
+
+```bash
+# 检测存在的配置文件
+for f in .eslintrc .eslintrc.js .eslintrc.cjs .eslintrc.json .eslintrc.yml \
+         .prettierrc .prettierrc.js .prettierrc.json .prettierrc.yml \
+         tsconfig.json tsconfig.base.json \
+         .editorconfig \
+         .tailwind.config.js .tailwind.config.ts \
+         .stylelintrc .stylelintrc.js .stylelintrc.json \
+         CONTRIBUTING.md CODE_STYLE.md; do
+  [ -f "$f" ] && echo "=== $f ===" && cat "$f"
+done
+# 也检查 package.json 中的 lint/format 脚本
+cat package.json 2>/dev/null | grep -A5 '"lint\|"format\|"typecheck\|"type-check'
+```
+
+扫描后，主代理根据检测结果生成**编码规范摘要**（不是原文粘贴，是提炼关键约束），格式如下。如果某个类别未检测到对应配置文件，则省略该段：
+
+```
+## 编码规范约束（自动扫描）
+
+### ESLint
+{提取的关键规则，如：禁止 var、要求分号、禁止未使用变量、特定插件规则等}
+
+### Prettier
+{提取的格式化规则，如：单引号、2空格缩进、无分号、行宽 80 等}
+
+### TypeScript
+{从 tsconfig 提取的严格模式设置，如：strict: true、noUncheckedIndexedAccess 等}
+
+### Import / 命名约定
+{从 eslint/import 插件或 editorconfig 提取的导入排序、命名风格等}
+
+### 框架约定
+{检测到的框架特定约定，如：Next.js App Router、Tailwind 类名风格等}
+```
+
+将此摘要注入到每个子代理 prompt 的「项目约定」段之后，并追加一条铁律：
+> **10. 遵守编码规范：** 以上「编码规范约束」中的所有规则必须严格遵守。如规则与任务描述冲突，优先遵守规范约束并报告。
+
+**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`），只执行对应部分。
 
 ---
@@ -91,6 +145,9 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 ## 项目约定
 {CONVENTIONS.md 全文}
 
+## 编码规范约束（自动扫描）
+{主代理扫描项目配置文件后生成的规范摘要，见上方「编码规范扫描」步骤}
+
 ## 项目架构
 {ARCHITECTURE.md 全文}
 
@@ -103,6 +160,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
@@ -113,6 +177,7 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 7. **E2E 任务：** 如果任务描述包含"E2E"或"端到端"，先 cat 相关功能代码和页面组件，理解交互逻辑。有测试框架则编写测试文件，无框架则编写 `.sillyspec/changes/<变更名>/e2e-steps.md` 结构化测试步骤（每条包含操作和断言）
 8. **暂存：** 完成后在工作目录执行 git add -A（不要 commit，由用户通过 /sillyspec:commit 统一提交）
 9. **不修改计划外的文件**，如必须修改则在报告中说明
+10. **遵守编码规范：** prompt 中「编码规范约束」段的所有规则必须严格遵守。如规范与任务描述冲突，优先遵守规范并报告
 
 ## 完成后报告（严格按此格式）
 
@@ -147,6 +212,20 @@ cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 
 ## 完成后
 
+**任务勾选自检（必须执行）：**
+所有任务完成后，主代理必须执行以下检查：
+
+```bash
+cat .sillyspec/changes/*/tasks.md 2>/dev/null
+```
+
+逐条验证：
+1. **所有返回 DONE/DONE_WITH_CONCERNS 的任务是否已勾选 `- [x]`？**
+2. **勾选的任务是否都记录了精确到秒的时间戳 `[YYYY-MM-DD HH:MM:SS]`？**
+3. **tasks.md 中是否还有未勾选 `- [ ]` 的已完成任务？**
+
+发现遗漏 → 立即补勾选 + 补时间戳，不要等用户提醒。
+
 **知识库审阅：** 检查是否有待确认的知识条目：
 ```bash
 grep -c '^\### \[待确认\]' .sillyspec/knowledge/uncategorized.md 2>/dev/null

package/templates/explore.md

@@ -29,10 +29,34 @@ $ARGUMENTS
 ```bash
 ls .sillyspec/changes/ 2>/dev/null | grep -v archive
 cat .sillyspec/{REQUIREMENTS,ROADMAP}.md 2>/dev/null
+cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+cat .sillyspec/knowledge/INDEX.md 2>/dev/null
 ```
 
 有进行中变更时读取其 design/tasks，自然引用。发现重要决策时可提议保存（不自动保存）。
 
+## MCP 能力（按需使用）
+
+```bash
+cat .claude/mcp.json .cursor/mcp.json 2>/dev/null
+```
+
+- 有 Context7 → 探索时查询最新文档，验证技术方案的可行性
+- 有浏览器 MCP → 可浏览相关网站、查竞品实现
+- 有搜索 MCP → 搜索技术方案、最佳实践
+- 无 MCP → 使用 web search
+
+## 话题升级提示
+
+探索过程中，当对话达到一定深度时（讨论了 5+ 轮、或涉及具体实现方案、或用户表达"试试看"/"能不能做"/"怎么搞"），主动用 AskUserQuestion 提示用户：
+
+1. **🧠 头脑风暴** — `/sillyspec:brainstorm` 深度探索需求和方案
+2. **⚡ 快速执行** — `/sillyspec:quick` 直接动手做
+3. **📋 创建规范** — `/sillyspec:propose` 生成结构化规范
+4. **🔍 继续探索** — 还没聊透，继续
+
+不需要每次都提示，只在对话**明显转向执行意图**时触发。纯讨论、提问、查资料时不要打断。
+
 ## 没有必需的结束
 
 探索可以创建变更提案、产出文档、继续探索或结束。

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 → 提示用户当前阶段
 
 ---
 
@@ -123,11 +123,35 @@ cat .claude/mcp.json .cursor/mcp.json 2>/dev/null | grep -i "browser\|chrome\|de
 - [ ] 每个 task 有具体文件路径？
 - [ ] 标注了 Wave 和依赖关系？
 - [ ] 涉及 UI 的任务是否有对应的 E2E 测试任务？
+- [ ] **design.md 中的每个功能点是否都在 tasks.md 中有对应任务？**
 
-### 7. 完成
+### 6.5 设计完整性对照（必须完成）
 
-```bash
-sillyspec status --json && sillyspec next
+逐条检查 design.md 中的功能描述，确保每个功能点都有对应的 task。特别关注：
+
+1. **逐功能点扫描：** 将 design.md 中描述的每个功能点（含子功能）列出，与 tasks.md 逐条对照
+2. **前后端覆盖检查：** 涉及前后端协作的功能，确认前端和后端各有独立 task
+3. **遗漏项处理：** 发现未覆盖的功能点 → 追加 task 到对应 Wave，并提示用户确认
+
+**执行方式：**
+```
+从 design.md 提取功能点清单：
+  功能 A（后端接口）
+  功能 B（前端页面）
+  功能 C（前后端联动）
+
+与 tasks.md 对照：
+  ✅ 功能 A → task-3
+  ❌ 功能 B → 无对应 task → 追加
+  ⚠️ 功能 C → 只有后端 task，缺少前端 task → 追加
 ```
 
+发现遗漏时用 AskUserQuestion 确认追加内容，用户确认后再写入 tasks.md。
+
+### 7. 完成
+
 更新 `.sillyspec/STATE.md`：阶段改为 `plan ✅`，下一步 `/sillyspec:execute`。
+
+```bash
+cat .sillyspec/STATE.md 2>/dev/null
+```

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

@@ -21,12 +21,21 @@ $ARGUMENTS
 1. **解析参数：** 检查是否携带 `--change <变更名>`，确定记录方式
 2. **理解任务：** 模糊则问一个问题确认
 3. **加载上下文：** `cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null`
+3b. **编码规范扫描：** 检测项目中的编码规范配置文件（`.eslintrc*`、`.prettierrc*`、`tsconfig.json`、`.editorconfig`、`tailwind.config.*`、`CONTRIBUTING.md`），提取关键规则生成摘要。写作代码时必须严格遵守这些规则（分号/引号/缩进/命名风格等），如不确定优先遵守规范约束。
 4. **知识库查询（强制步骤）：**
    ```bash
    cat .sillyspec/knowledge/INDEX.md 2>/dev/null
    ```
    根据当前任务描述中的关键词匹配 INDEX.md 条目，命中时 `cat` 对应知识文件，将内容纳入后续开发考量。未命中则跳过。
+   **MCP 检测：** `cat .claude/mcp.json .cursor/mcp.json 2>/dev/null`，根据检测结果动态利用：
+   - 有 Context7 → 查询不熟悉库/API 的最新文档
+   - 有浏览器 MCP → 验证页面改动效果
+   - 有数据库 MCP → 查询表结构和数据验证（只读）
+   - 有搜索 MCP → 搜索最佳实践和解决方案
+   - 有其他 MCP → 按任务需要灵活使用
+   - 无 MCP → 使用 web search
 5. **先读后写：** 调用已有方法前 `cat` 源文件确认签名，`grep` 确认方法存在
+6. **数据操作安全：** 任何改变现有数据的操作（非 SELECT 的数据库操作）必须暂停并报告给用户确认，不得自动执行。新建表不受此限制
 6. **TDD 执行：**
    ```
    🔴 RED    → 先写测试，运行确认失败