sillyspec 3.8.7 → 3.9.1

package/src/setup.js

@@ -1,25 +1,9 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync, cpSync } from 'fs';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
 import { execSync } from 'child_process';
 import chalk from 'chalk';
 import ora from 'ora';
-import { checkbox, confirm, input, select } from '@inquirer/prompts';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// ── Skill 定义 ──
-
-const SKILLS = [
-  {
-    id: 'playwright-e2e',
-    name: 'Playwright E2E 测试参考',
-    description: 'E2E 测试编写最佳实践，AI 执行测试任务时自动读取',
-    source: join(__dirname, '..', 'templates', 'skills', 'playwright-e2e'),
-    target: 'playwright-e2e',
-  },
-];
+import { checkbox, input } from '@inquirer/prompts';
 
 // ── MCP 工具定义 ──
 
@@ -298,21 +282,6 @@ export async function cmdSetup(dir, options = {}) {
     ...dbChoices,
     ...globalChoices.length > 0 ? [{ name: chalk.bold('── 全局工具 ──'), value: '_global_header', disabled: true }] : [],
     ...globalChoices,
-    ...[{ name: chalk.bold('── AI Skills（编写参考）──'), value: '_skill_header', disabled: true }],
-    ...(() => {
-      const installed = new Set();
-      for (const { path } of availableTools) {
-        const skillDir = join(dir, dirname(path), 'skills');
-        for (const s of SKILLS) {
-          if (existsSync(join(skillDir, s.target, 'SKILL.md'))) installed.add(s.id);
-        }
-      }
-      return SKILLS.filter(s => !installed.has(s.id)).map(s => ({
-        name: `${s.name} — ${s.description}`,
-        value: `skill:${s.id}`,
-        checked: false,
-      }));
-    })(),
   ];
 
   if (allChoices.length === 0) {
@@ -402,41 +371,6 @@ export async function cmdSetup(dir, options = {}) {
     }
   }
 
-  // ── 安装 Skills ──
-
-  const selectedSkills = SKILLS.filter(s => selected.includes(`skill:${s.id}`));
-
-  if (selectedSkills.length > 0) {
-    // 跟 MCP 一样，选择安装到哪些 AI 工具
-    const skillTargets = availableTools.map(t => ({
-      name: t.tool,
-      value: t.key,
-      checked: true,
-    }));
-
-    const selectedTools = await checkbox({
-      message: 'Skill 安装到哪些 AI 工具？',
-      choices: skillTargets,
-    });
-
-    const targets = availableTools.filter(t => selectedTools.includes(t.key));
-
-    console.log('');
-    for (const { tool, path } of targets) {
-      const spinner = ora(`安装 Skills 到 ${tool}...`).start();
-      for (const skill of selectedSkills) {
-        try {
-          const targetDir = join(dir, dirname(path), 'skills', skill.target);
-          mkdirSync(targetDir, { recursive: true });
-          cpSync(skill.source, targetDir, { recursive: true });
-          spinner.succeed(`${tool} → ${dirname(path)}/skills/${skill.target}/SKILL.md`);
-        } catch (err) {
-          spinner.fail(`${skill.name} 安装失败: ${err.message}`);
-        }
-      }
-    }
-  }
-
   // ── 总结 ──
 
   console.log('');
@@ -456,10 +390,6 @@ export async function cmdSetup(dir, options = {}) {
     console.log(`  🛠️  ${chalk.cyan(g.name)} — ${g.description}`);
     console.log(chalk.dim(`     ${g.url}`));
   }
-  for (const s of selectedSkills) {
-    console.log(`  📚 ${chalk.cyan(s.name)} — ${s.description}`);
-    console.log(chalk.dim(`     → ${s.target}/SKILL.md`));
-  }
   console.log('');
   if (selectedMcp.length > 0) {
     console.log(chalk.dim('  重启你的 AI 工具以使 MCP 配置生效。'));

package/src/stages/archive.js

@@ -0,0 +1,54 @@
+export const definition = {
+  name: 'archive',
+  title: '归档变更',
+  description: '规范沉淀，可追溯',
+  auxiliary: true,
+  steps: [
+    {
+      name: '任务完成度检查',
+      prompt: `检查 tasks.md 中所有 checkbox 是否已勾选。
+
+### 操作
+1. 读取 \`.sillyspec/changes/<change-name>/tasks.md\`
+2. 检查所有 checkbox 是否已勾选
+3. 如有遗漏 → 询问用户是否继续归档
+
+### 输出
+完成度报告`,
+      outputHint: '完成度报告',
+      optional: false
+    },
+    {
+      name: '确认归档',
+      prompt: `展示即将归档的内容，请用户确认。
+
+### 操作
+1. 展示：变更目录名、包含的文件列表、生成总结
+2. 请用户确认是否执行归档
+3. 确认后：将 \`.sillyspec/changes/<change-name>/\` 移动到 \`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/\`
+4. 确保所有 checkbox 都已勾选
+
+### 输出
+归档确认`,
+      outputHint: '归档确认',
+      optional: false
+    },
+    {
+      name: '更新路线图和提交',
+      prompt: `更新路线图并暂存变更。
+
+### 操作
+1. 如果 \`.sillyspec/ROADMAP.md\` 存在，标记对应 Phase 为已完成
+2. \`git add .sillyspec/\` — **不要 commit**，由用户通过统一提交工具处理
+3. 更新 progress.json：
+   - 清除当前变更信息（归档后不再活跃）
+   - 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
+   - 历史记录追加时间 + 归档完成
+
+### 输出
+归档完成确认 + 累积规范统计`,
+      outputHint: '归档完成',
+      optional: false
+    }
+  ]
+}

package/src/stages/brainstorm.js

@@ -0,0 +1,239 @@
+export const definition = {
+  name: 'brainstorm',
+  title: '头脑风暴',
+  description: '探索需求、分析技术方案、识别风险',
+  steps: [
+    {
+      name: '状态检查',
+      prompt: `检查 .sillyspec/.runtime/progress.json 确认当前状态。
+
+### 操作
+1. 运行 \`sillyspec progress show\`
+2. 确认 currentStage 为 "brainstorm"
+3. 如果有进行中的 brainstorm，提示选择继续或重新开始
+4. 如果未初始化，提示先运行 sillyspec init
+
+### 输出
+当前状态摘要（1-2 句话）
+
+### 注意
+- 以 CLI 返回为准，不要自行推断阶段
+- 如果阶段不对，输出正确提示并停止`,
+      outputHint: '状态摘要',
+      optional: false
+    },
+    {
+      name: '加载项目上下文',
+      prompt: `加载项目现有上下文，理解代码结构和约定。
+
+### 操作
+1. 读取 CODEBASE-OVERVIEW.md + 共享规范 + 子项目上下文
+2. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
+3. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`
+4. 询问本次需求属于哪个子项目
+5. 棕地项目：读取 docs/<project>/scan/ 下的 STRUCTURE.md、CONVENTIONS.md、ARCHITECTURE.md
+6. 查看进行中的变更：\`ls .sillyspec/changes/ | grep -v archive\`
+
+### 输出
+项目现状理解摘要（3-5 句话，关键约定和架构决策）
+
+### 注意
+- 始终询问本次需求属于哪个子项目
+- 棕地项目必须读取数据模型章节`,
+      outputHint: '上下文摘要',
+      optional: false
+    },
+    {
+      name: '协作与复用检查',
+      prompt: `检查是否有同名变更或可复用模板。
+
+### 操作
+1. 检查已有变更：\`ls .sillyspec/changes/ | grep -v archive\`
+   - 有相关变更 → 提示用户，避免重复
+2. 检查全局模板：\`ls ~/.sillyspec/templates/\`
+   - 有匹配模板 → 询问是否基于模板
+3. 无相关内容 → 跳过，不输出
+
+### 输出
+检测到的相关变更和可用模板（无则输出"无冲突，继续"）`,
+      outputHint: '已有变更和可用模板',
+      optional: true
+    },
+    {
+      name: '原型/设计图分析',
+      prompt: `如果用户提供了截图、图片或 HTML 原型，分析提取结构。
+
+### 操作
+1. 识别图片中的页面结构（区域、组件、布局）
+2. 提取表单字段（名称、类型、必填、选项）
+3. 提取交互流程（页面跳转、按钮行为）
+4. 提取标注和备注（业务规则、权限说明）
+5. 展示分析结果，请用户确认遗漏
+
+### 输出
+页面结构树 + 字段列表 + 交互流程图
+
+### 注意
+- 没有原型则跳过此步骤
+- 多页面时逐页分析，不要一次全部输出
+- 图片信息 > 文字描述，不要忽略视觉信息`,
+      outputHint: '页面结构和交互流程',
+      optional: true
+    },
+    {
+      name: '需求范围评估',
+      prompt: `评估需求复杂度，判断是否需要拆分或走批量模式。
+
+### 操作
+1. 根据分析结果判断复杂度
+2. 满足以下任意 2 条建议拆分：
+   - 3+ 个可独立交付的功能模块
+   - 3+ 种角色有不同权限和视图
+   - 跨页面状态流转（审批流、多步表单）
+   - 模块间耦合度低可独立开发
+3. 满足以下条件建议走**批量模式**：
+   - 任务数量 > 10 且任务间有重复模式（如 100 个报表、50 个表单、N 个相似页面）
+   - 本质是「模板 × 数据」而非 N 个独立功能
+   - 直接逐个开发会导致 plan.md 膨胀和上下文溢出
+4. 需要拆分 → 生成 MASTER.md，规划子阶段
+5. 检测到批量模式 → 输出提示并建议用户确认
+6. 都不需要 → 继续
+
+### 批量模式指引
+确认后，后续 plan/execute 按以下原则调整：
+- **不要**把每个实例列为独立任务（不要写 100 个 checkbox）
+- plan 设计通用架构（引擎/模板/配置格式），任务数控制在 10 个以内
+- 数据转换用脚本完成（Excel → 配置文件），不消耗 AI 上下文
+- execute 每个 Wave 独立模块，Wave 间通过接口定义解耦
+- verify 用脚本全量验证 + AI 抽查边界案例
+
+### 半批量场景
+如果任务中大部分相似但有少量特殊任务（如 20 个任务中 15 个相似、5 个特殊）：
+- **主簇**（>10 个相似）→ 走批量模式（引擎 + 配置）
+- **小簇**（2-5 个相似）→ 走简化版批量（基于主簇模板扩展）
+- **孤立任务**（1 个）→ 走标准开发流程
+- 建议用「继承 + override」配置解决特殊任务，配置解决不了的才写定制代码
+- 架构设计时预留扩展点（hooks/overrides），让特殊任务能"挂上去"而不是"另起炉灶"
+
+### 输出
+拆分方案 / 批量模式确认 / "无需拆分"确认
+
+### 注意
+- 简单 CRUD 不拆
+- 拆分方案需用户确认
+- 批量模式需用户确认`,
+      outputHint: '拆分方案或无需拆分确认',
+      optional: true
+    },
+    {
+      name: '对话式探索',
+      prompt: `通过对话探索需求细节。
+
+### 操作
+1. 从最核心的一个问题开始（用户到底想要什么？）
+2. 等待用户回答后再问下一个
+3. 根据回答判断：信息够了 → 进入方案 / 需要追问 → 只问一个
+4. 探索顺序（按需）：目的 → 约束 → 边界 → 成功标准
+
+### 输出
+需求理解摘要（用户确认的需求点列表）
+
+### 铁律
+- 一次只问一个问题
+- 2-3 轮问答就应进入方案讨论
+- 多选题优于开放式问题
+- YAGNI — 砍掉不需要的功能`,
+      outputHint: '需求理解摘要',
+      optional: false
+    },
+    {
+      name: '提出 2-3 种方案',
+      prompt: `基于需求理解，提出 2-3 种实现方案。
+
+### 操作
+1. 每种方案列出：核心思路、优势、劣势
+2. 给出推荐方案和理由
+3. 等待用户选择或调整
+
+### 输出
+方案对比表 + 推荐方案
+
+### 注意
+- 方案差异要实质性的，不要为了凑数
+- 推荐理由要具体`,
+      outputHint: '方案对比和推荐',
+      optional: false
+    },
+    {
+      name: '分段展示设计',
+      prompt: `按复杂度分段展示设计方案，逐段确认。
+
+### 操作
+1. 简单项目：几句话整体描述
+2. 复杂项目：每段 200-300 字，逐段展示
+3. 每段展示后等待用户确认
+4. 收集修改意见，调整设计
+
+### 输出
+用户确认的完整设计方案
+
+### 注意
+- 不要一次输出大段文字
+- 逐段确认，确保用户跟上`,
+      outputHint: '用户确认的设计方案',
+      optional: false
+    },
+    {
+      name: '写设计文档并自审',
+      prompt: `撰写 design 文档并进行 AI 自审。
+
+### 操作
+1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<变更名>\`（Windows 用 \`mkdir .sillyspec\\changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path .sillyspec/changes/<变更名>\`）
+2. 将确认的设计写入 \`.sillyspec/changes/<变更名>/design.md\`
+3. 自审检查：
+   - 需求覆盖：是否完整覆盖 Step 6 确认的需求
+   - 约束一致性：是否与 CONVENTIONS.md、ARCHITECTURE.md 一致
+   - 真实性：表名/字段名来自真实 schema 或标注"新增"
+   - YAGNI：是否包含不必要功能
+   - 验收标准：是否具体可测试
+3. 自审发现问题 → 修改后重新检查
+4. 全部通过 → 进入下一步
+
+### 输出
+design.md 文件路径 + 自审结果
+
+### 注意
+- 自审不通过不要进入下一步
+- 不确定的问题标注「⚠️ 自审存疑」`,
+      outputHint: 'design.md 路径 + 自审结果',
+      optional: false
+    },
+    {
+      name: '用户确认并生成规范文件',
+      prompt: `用户确认设计方案，生成规范文件。
+
+### 操作
+1. 展示 design.md 摘要给用户
+2. 请用户选择：✅ 确认 / ✏️ 修改 / ❌ 推翻重来
+3. 确认后，在 \`.sillyspec/changes/<变更名>/\` 下生成所有规范文件：
+   - **design.md**：架构决策、文件变更清单、数据模型、API 设计、代码风格参照
+   - **proposal.md**：动机、变更范围、不在范围内、成功标准
+   - **requirements.md**：功能需求、用户场景（Given/When/Then 格式）、非功能需求
+   - **tasks.md**：任务列表（只列名称和对应文件路径，细节在 plan 阶段展开）
+   - \`git add .sillyspec/\` — **不要 commit**
+
+### 输出
+所有规范文件路径
+
+### 注意
+- 必须等待用户明确确认
+- 禁止在确认前推进到后续阶段
+- 禁止自动 commit
+- 推翻重来回到 Step 6
+- 表名/字段名必须来自真实 schema 或标注"新增"
+- tasks.md 只列任务名，细节在 plan 阶段展开`,
+      outputHint: '规范文件路径',
+      optional: false
+    }
+  ]
+}

package/src/stages/doctor.js

@@ -0,0 +1,303 @@
+// SillySpec Doctor — 项目自检阶段
+// 检查项通过 prompt 中的 bash 命令执行，此文件仅定义步骤结构
+
+
+export const definition = {
+  name: 'doctor',
+  title: '项目自检',
+  description: '检查 SillySpec 配置、构建环境和外部依赖',
+  auxiliary: true,
+  steps: [
+    {
+      name: 'SillySpec 内部检查',
+      prompt: `运行 SillySpec 内部检查。逐项执行以下命令并汇总结果：
+
+### 1. 目录结构完整性
+\`\`\`bash
+# 检查 .sillyspec/ 及子目录
+for d in .sillyspec .sillyspec/projects .sillyspec/docs .sillyspec/changes .sillyspec/.runtime; do
+  [ -d "$d" ] && echo "✅ $d" || echo "❌ $d"
+done
+# 检查 progress.json
+[ -f .sillyspec/.runtime/progress.json ] && echo "✅ progress.json 存在" || echo "❌ progress.json 不存在"
+node -e "JSON.parse(require('fs').readFileSync('.sillyspec/.runtime/progress.json','utf8')); console.log('✅ progress.json 可解析')" 2>/dev/null || echo "⚠️ progress.json 不可解析"
+\`\`\`
+
+### 2. 项目配置检查
+\`\`\`bash
+ls .sillyspec/projects/*.yaml 2>/dev/null
+# 对每个 yaml 文件，检查 name 和 path 字段，验证 path 存在
+for f in .sillyspec/projects/*.yaml; do
+  [ -f "$f" ] || continue
+  name=$(grep '^name:' "$f" | head -1 | sed 's/^name:[[:space:]]*//')
+  p=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
+  [ -z "$name" ] && echo "⚠️ $(basename $f) — 缺少 name"
+  [ -z "$p" ] && echo "⚠️ $(basename $f) — 缺少 path"
+  [ -n "$p" ] && [ ! -d "$p" ] && echo "❌ $(basename $f) — path 不存在: $p"
+  [ -n "$name" ] && [ -n "$p" ] && [ -d "$p" ] && echo "✅ $(basename $f) — $name ($p)"
+done
+\`\`\`
+
+### 3. 进度数据一致性
+\`\`\`bash
+# 读取 currentChange 并检查目录存在性
+node -e "
+const p = JSON.parse(require('fs').readFileSync('.sillyspec/.runtime/progress.json','utf8'));
+const cc = p.currentChange;
+if (!cc) { console.log('ℹ️ 无当前变更'); process.exit(0); }
+const dir = '.sillyspec/changes/' + cc;
+const exists = require('fs').existsSync(dir);
+console.log(exists ? '✅ currentChange 目录存在: ' + cc : '❌ currentChange 目录不存在: ' + cc);
+// 检查各阶段产出
+const stages = p.stages || {};
+for (const [name, sd] of Object.entries(stages)) {
+  if (sd.status === 'completed' && sd.steps.length > 0) {
+    const hasOutput = sd.steps.some(s => s.output && s.output.trim());
+    console.log('  ' + name + ': ' + (hasOutput ? '✅ 有产出' : '⚠️ 已完成但无产出记录'));
+  }
+}
+" 2>/dev/null || echo "⚠️ 无法读取 progress.json"
+\`\`\`
+
+### 4. 孤儿文件检查
+\`\`\`bash
+node -e "
+const fs = require('fs');
+const dir = '.sillyspec/changes';
+if (!fs.existsSync(dir)) { console.log('ℹ️ changes/ 目录不存在'); process.exit(0); }
+const subs = fs.readdirSync(dir).filter(f => fs.statSync(dir+'/'+f).isDirectory());
+if (subs.length === 0) { console.log('ℹ️ 无变更目录'); process.exit(0); }
+let progress;
+try { progress = JSON.parse(fs.readFileSync('.sillyspec/.runtime/progress.json','utf8')); } catch { console.log('⚠️ 无法读取 progress.json'); subs.forEach(s => console.log('❓ ' + s)); process.exit(0); }
+const known = new Set();
+if (progress.currentChange) known.add(progress.currentChange);
+for (const sd of Object.values(progress.stages || {})) {
+  (sd.steps || []).forEach(s => { if (s.output) known.add(s.output); });
+}
+subs.forEach(s => {
+  console.log(known.has(s) ? '✅ ' + s + ' — 已关联' : '⚠️ ' + s + ' — 孤儿目录（可清理）');
+});
+"
+\`\`\`
+
+### 5. 配置文件检查
+\`\`\`bash
+# 检查 local.yaml 和 STACK.md
+for f in .sillyspec/projects/*.yaml; do
+  [ -f "$f" ] || continue
+  name=$(grep '^name:' "$f" | head -1 | sed 's/^name:[[:space:]]*//')
+  p=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
+  [ -z "$p" ] && continue
+  local_yaml="$p/.sillyspec/local.yaml"
+  stack_md="$p/.sillyspec/STACK.md"
+  [ -f "$local_yaml" ] && echo "✅ local.yaml ($name)" || echo "⚠️ local.yaml ($name) — 不存在"
+  if [ -f "$local_yaml" ]; then
+    grep -q 'build:' "$local_yaml" && echo "  ✅ build 命令已配置" || echo "  ⚠️ 缺少 build 命令"
+    grep -q 'test:' "$local_yaml" && echo "  ✅ test 命令已配置" || echo "  ⚠️ 缺少 test 命令"
+  fi
+  [ -f "$stack_md" ] && echo "✅ STACK.md ($name)" || echo "⚠️ STACK.md ($name) — 不存在"
+done
+\`\`\`
+
+### 输出
+汇总所有检查结果，按以下格式：
+\`\`\`
+## SillySpec 内部
+✅/⚠️/❌ 各项状态
+\`\`\`
+
+### 注意
+- 不要编造路径或结果，严格基于命令输出
+- 如果 .sillyspec/ 不存在，直接输出 ❌ 并跳过后续检查`,
+      outputHint: 'SillySpec 内部检查结果',
+      optional: false
+    },
+    {
+      name: '构建环境检查',
+      prompt: `检查项目构建环境。先探测项目使用的构建工具，再逐项检查可用性。
+
+### 1. 探测构建工具
+\`\`\`bash
+# 确定项目路径（使用 progress.json 中的项目或当前目录）
+PROJECT_DIR=$(node -e "
+const fs=require('fs');
+try{const p=JSON.parse(fs.readFileSync('.sillyspec/.runtime/progress.json','utf8'));if(p.project){console.log(p.project);process.exit(0)}}catch{}
+const files=fs.readdirSync('.sillyspec/projects').filter(f=>f.endsWith('.yaml'));
+if(files.length>0){const c=fs.readFileSync('.sillyspec/projects/'+files[0],'utf8');const m=c.match(/^path:\\s*(.+)/m);console.log(m?m[1].trim():'.')}else console.log('.')
+" 2>/dev/null)
+echo "项目目录: $PROJECT_DIR"
+
+# 探测构建工具
+for f in pom.xml build.gradle package.json requirements.txt pyproject.toml go.mod Cargo.toml; do
+  [ -f "$PROJECT_DIR/$f" ] && echo "检测到: $f"
+done
+[ -f "$PROJECT_DIR/.sillyspec/STACK.md" ] && cat "$PROJECT_DIR/.sillyspec/STACK.md" | head -30
+\`\`\`
+
+### 2. 构建工具可用性
+根据上面检测到的工具，运行对应检查（未检测到的跳过）：
+
+**Maven 项目：**
+\`\`\`bash
+timeout 10 mvn -v 2>/dev/null | head -1 && echo "✅ Maven 可用" || echo "❌ Maven 不可用"
+[ -f ~/.m2/settings.xml ] && echo "✅ Maven settings.xml 存在" || echo "⚠️ Maven settings.xml 不存在"
+timeout 10 java -version 2>&1 | head -1
+\`\`\`
+
+**Gradle 项目：**
+\`\`\`bash
+timeout 10 gradle -v 2>/dev/null | head -1 && echo "✅ Gradle 可用" || echo "❌ Gradle 不可用"
+\`\`\`
+
+**Node.js 项目：**
+\`\`\`bash
+timeout 5 node -v 2>/dev/null && echo "✅ Node.js 可用" || echo "❌ Node.js 不可用"
+timeout 5 npm -v 2>/dev/null && echo "✅ npm 可用" || echo "❌ npm 不可用"
+timeout 5 pnpm -v 2>/dev/null && echo "✅ pnpm 可用" || echo "ℹ️ pnpm 未安装"
+# 检查 registry
+npm config get registry 2>/dev/null
+\`\`\`
+
+**Python 项目：**
+\`\`\`bash
+timeout 5 python3 --version 2>/dev/null && echo "✅ Python3 可用" || echo "❌ Python3 不可用"
+timeout 5 pip3 --version 2>/dev/null && echo "✅ pip3 可用" || echo "❌ pip3 不可用"
+\`\`\`
+
+### 3. Maven 私服检查（仅 Maven 项目）
+\`\`\`bash
+# 从 settings.xml 提取仓库地址
+if [ -f ~/.m2/settings.xml ]; then
+  grep -oP 'https?://[^<"]+:[0-9]+' ~/.m2/settings.xml 2>/dev/null | sort -u | while read url; do
+    timeout 5 curl -s -o /dev/null -w "%{http_code}" "$url" 2>/dev/null
+    echo " — $url"
+  done
+fi
+# 从 pom.xml 提取
+if [ -f "$PROJECT_DIR/pom.xml" ]; then
+  grep -oP 'https?://[^<"]+:[0-9]+' "$PROJECT_DIR/pom.xml" 2>/dev/null | sort -u | while read url; do
+    code=$(timeout 5 curl -s -o /dev/null -w "%{http_code}" "$url" 2>/dev/null)
+    [ "$code" = "000" ] && echo "❌ 私服不可达: $url（超时）" || echo "✅ 私服可达 ($code): $url"
+  done
+fi
+\`\`\`
+
+### 4. 运行时环境
+\`\`\`bash
+timeout 5 node -v 2>/dev/null && echo "Node.js: $(node -v)" || echo "❌ Node.js 未安装"
+timeout 5 git --version 2>/dev/null && echo "Git: $(git --version)" || echo "❌ Git 未安装"
+timeout 10 git remote -v 2>/dev/null | head -2
+timeout 5 git ls-remote --heads origin 2>/dev/null >/dev/null && echo "✅ Git remote 可达" || echo "⚠️ Git remote 不可达"
+timeout 5 java -version 2>&1 | head -1
+timeout 5 python3 --version 2>/dev/null
+\`\`\`
+
+### 输出
+汇总所有检查结果：
+\`\`\`
+## 构建环境
+✅/⚠️/❌ 各项状态
+\`\`\`
+
+### 注意
+- 未检测到的构建工具直接跳过，不要报错
+- timeout 超时的命令视为不可用
+- 不编造结果`,
+      outputHint: '构建环境检查结果',
+      optional: false
+    },
+    {
+      name: '外部依赖检查',
+      prompt: `检查外部依赖工具是否可用。
+
+### 1. Context7 MCP
+\`\`\`bash
+# 检查 MCP 配置
+for f in ~/.config/claude/claude_desktop_config.json ~/.cursor/mcp.json ~/.openclaw/mcp.json; do
+  [ -f "$f" ] && echo "MCP 配置文件: $f" && grep -i context7 "$f" 2>/dev/null && echo "✅ Context7 已配置" || true
+done
+# 也检查 sillyspec 自身的 setup
+node -e "
+try{const m=require(require('path').join(require('os').homedir(),'.sillyspec','config.json'));console.log('✅ sillyspec config 存在')}catch{console.log('ℹ️ 无 sillyspec 全局配置')}
+" 2>/dev/null
+\`\`\`
+
+### 2. grep.app
+\`\`\`bash
+timeout 5 curl -s -o /dev/null -w "%{http_code}" https://grep.app 2>/dev/null | grep -q "200" && echo "✅ grep.app 可达" || echo "⚠️ grep.app 不可达"
+\`\`\`
+
+### 3. 其他 AI 工具（可选）
+\`\`\`bash
+# 检查常用 AI/开发工具
+timeout 5 which gh 2>/dev/null && echo "✅ GitHub CLI 可用" || echo "ℹ️ GitHub CLI 未安装"
+timeout 5 which docker 2>/dev/null && echo "✅ Docker 可用" || echo "ℹ️ Docker 未安装"
+\`\`\`
+
+### 输出
+\`\`\`
+## 外部依赖
+✅/⚠️/❌ 各项状态
+\`\`\`
+
+### 注意
+- 不编造结果
+- 工具未安装用 ℹ️ 标记（非错误），不可达用 ⚠️`,
+      outputHint: '外部依赖检查结果',
+      optional: false
+    },
+    {
+      name: '汇总报告',
+      prompt: `汇总前三步的所有检查结果，生成最终的自检报告。
+
+### 输出格式
+\`\`\`
+🔍 SillySpec Doctor — 项目自检报告
+
+## SillySpec 内部
+✅ .sillyspec/ 目录结构 — 正常
+✅ projects/*.yaml — N 个项目已注册
+⚠️  local.yaml (xxx) — 缺少 test 命令
+❌ progress.json — brainstorm 标记完成但 design.md 不存在
+
+## 构建环境
+✅ Node.js v23.4.0 — 可用
+✅ npm 10.x — 可用
+✅ Java 17.0.2 — 可用
+❌ Maven 私服 (10.0.0.1:8081) — 不可达（超时）
+
+## 外部依赖
+✅ Context7 MCP — 已配置
+⚠️  grep.app — 不可达
+\`\`\`
+
+### 要求
+- 基于前 3 步的实际输出汇总，不要编造
+- 每类问题归入对应分区
+- 全部通过给出 🎉
+- 如果有 ❌ 或 ⚠️，在末尾逐项给出修复建议
+
+### 修复建议模板
+根据问题类型给出具体可操作的修复命令：
+
+**常见问题及修复：**
+- CLI 未安装 → \`npm install -g sillyspec\`
+- 缺少 local.yaml → \`sillyspec init\` 重新生成，或手动创建
+- local.yaml 缺少 build/test → 补充对应命令
+- 缺少 STACK.md → \`sillyspec run scan\` 重新扫描
+- progress.json 不一致 → \`sillyspec run <阶段> --reset\` 重置对应阶段
+- 孤儿目录 → 确认后 \`rm -rf .sillyspec/changes/<目录名>\`
+- Maven 私服不可达 → 检查 VPN、settings.xml 配置、私服状态
+- Git remote 不可达 → 检查网络、SSH key 或凭证
+- 工具未安装 → 给出安装命令（如 \`brew install maven\`）
+
+每条建议格式：
+\`\`\`
+💡 修复：<问题描述>
+   <具体命令或操作>
+\`\`\``,
+      outputHint: '完整自检报告',
+      optional: false
+    }
+  ]
+}