sillyspec 3.9.1 → 3.10.0

package/src/run.js

@@ -10,57 +10,59 @@ import { stageRegistry, auxiliaryStages } from './stages/index.js'
 import { buildExecuteSteps } from './stages/execute.js'
 import { buildPlanSteps } from './stages/plan.js'
 
+/**
+ * 统一查找变更目录
+ */
+function resolveChangeDir(cwd, progress) {
+  const changesDir = join(cwd, '.sillyspec', 'changes')
+  if (!existsSync(changesDir)) return null
+
+  // 1. 优先用 currentChange
+  if (progress.currentChange) {
+    const target = join(changesDir, progress.currentChange)
+    if (existsSync(target)) return target
+  }
+
+  // 2. fallback：唯一非 archive 目录
+  const entries = readdirSync(changesDir, { withFileTypes: true })
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+  if (entries.length === 1) return join(changesDir, entries[0].name)
+
+  return null
+}
+
+/**
+ * 自动探测并设置 currentChange（唯一变更目录时）
+ * @returns {boolean} 是否设置了 currentChange
+ */
+function autoDetectChange(progress, cwd) {
+  if (progress.currentChange) return false
+  const changesDir = join(cwd, '.sillyspec', 'changes')
+  if (!existsSync(changesDir)) return false
+  const entries = readdirSync(changesDir, { withFileTypes: true })
+    .filter(e => e.isDirectory() && e.name !== 'archive')
+  if (entries.length === 1) {
+    progress.currentChange = entries[0].name
+    return true
+  }
+  return false
+}
+
 /**
  * 获取阶段的步骤定义（execute 需要动态构建）
  */
 async function getStageSteps(stageName, cwd, progress) {
   if (stageName === 'execute') {
-    const changesDir = join(cwd, '.sillyspec', 'changes')
+    const changeDir = resolveChangeDir(cwd, progress)
     let planFile = null
-    // 优先用 currentChange 指定的变更名
-    if (progress.currentChange) {
-      const target = join(changesDir, progress.currentChange, 'plan.md')
-      if (existsSync(target)) planFile = target
-    }
-    // fallback：扫描 changes/ 非 archive 目录下的 plan.md
-    if (!planFile && existsSync(changesDir)) {
-      const candidates = []
-      for (const entry of readdirSync(changesDir, { withFileTypes: true })) {
-        if (!entry.isDirectory() || entry.name === 'archive') continue
-        const p = join(changesDir, entry.name, 'plan.md')
-        if (existsSync(p)) candidates.push({ name: entry.name, path: p })
-      }
-      if (candidates.length === 1) {
-        planFile = candidates[0].path
-      } else if (candidates.length > 1) {
-        console.log('⚠️  检测到多个变更，请选择：')
-        candidates.forEach((c, i) => console.log(`  ${i + 1}. ${c.name}`))
-        const readline = await import('readline')
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-        const answer = await new Promise(resolve => {
-          rl.question(`\n请输入编号（默认 1）：`, input => {
-            rl.close()
-            const num = parseInt(input) || 1
-            resolve(num >= 1 && num <= candidates.length ? num - 1 : 0)
-          })
-        })
-        planFile = candidates[answer].path
-        console.log(`✅ 已选择：${candidates[answer].name}\n`)
-      }
+    if (changeDir) {
+      const p = join(changeDir, 'plan.md')
+      if (existsSync(p)) planFile = p
     }
     return buildExecuteSteps(planFile)
   }
   if (stageName === 'plan') {
-    const changesDir = join(cwd, '.sillyspec', 'changes')
-    let changeDir = null
-    if (progress.currentChange) {
-      const target = join(changesDir, progress.currentChange)
-      if (existsSync(target)) changeDir = target
-    }
-    if (!changeDir && existsSync(changesDir)) {
-      const entries = readdirSync(changesDir, { withFileTypes: true }).filter(e => e.isDirectory() && e.name !== 'archive')
-      if (entries.length === 1) changeDir = join(changesDir, entries[0].name)
-    }
+    const changeDir = resolveChangeDir(cwd, progress)
     return buildPlanSteps(changeDir)
   }
   const def = stageRegistry[stageName]
@@ -119,7 +121,9 @@ function outputStep(stageName, stepIndex, steps, cwd) {
     verify: `### 🔍 你的角色：QA 专家
 你是一位吹毛求疵的 QA 专家。假设所有代码都有 bug，用最坏情况测试。关注边界、异常、并发。有问题直说，用证据说话，不写"看起来没问题"。`,
     quick: `### 💻 你的角色：全栈老兵
-你是一位实战经验丰富的全栈工程师。不纠结架构和流程，理解需求就直接干。不确定的地方先问清楚再动手，先读后写，改完就收。问题排查思路开阔，前端报错不一定是前端问题——可能是后端数据、浏览器兼容、甚至设备硬件。解决方案实用接地气，用户描述有误敢于直接指出。`
+你是一位实战经验丰富的全栈工程师。不纠结架构和流程，理解需求就直接干。不确定的地方先问清楚再动手，先读后写，改完就收。问题排查思路开阔，前端报错不一定是前端问题——可能是后端数据、浏览器兼容、甚至设备硬件。解决方案实用接地气，用户描述有误敢于直接指出。`,
+    explore: `### 🧭 你的角色：技术探索伙伴
+你帮助用户澄清问题、调查代码库、比较方案和暴露风险。探索阶段不写实现代码，不安装依赖，不把讨论强行推进成开发。`
   }
 
   console.log(`---`)
@@ -252,6 +256,12 @@ export async function runCommand(args, cwd) {
 }
 
 async function runStage(pm, progress, stageName, cwd) {
+  // 自动探测 currentChange
+  if (autoDetectChange(progress, cwd)) {
+    progress.lastActive = new Date().toLocaleString('zh-CN', { hour12: false })
+    pm._write(cwd, progress)
+  }
+
   const stageData = progress.stages[stageName]
   if (!stageData || !stageData.steps) {
     console.error(`❌ 阶段 ${stageName} 未初始化`)
@@ -352,25 +362,26 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     }
   }
 
-  // plan 阶段 "展开任务" 完成后，动态插入 task 蓝图步骤
-  if (stageName === 'plan' && steps[currentIdx]?.name === '展开任务并分组' && progress.currentChange) {
-    const planFile = join(cwd, '.sillyspec', 'changes', progress.currentChange, 'plan.md')
-    if (existsSync(planFile)) {
-      const planContent = readFileSync(planFile, 'utf8')
-      const { buildPlanSteps, fixedPrefix, fixedSuffix } = await import('./stages/plan.js')
-      const fullSteps = buildPlanSteps(join(cwd, '.sillyspec', 'changes', progress.currentChange), planContent)
-      const prefixLen = fixedPrefix.length
-      const suffixLen = fixedSuffix.length
-      const taskSteps = fullSteps.slice(prefixLen, suffixLen > 0 ? -suffixLen : undefined)
-      if (taskSteps.length > 0) {
-        const oldSteps = [...steps]
-        const rebuilt = fullSteps.map(stepDef => {
-          const existing = oldSteps.find(s => s.name === stepDef.name && s.status !== 'pending')
-          if (existing) return existing
-          return { name: stepDef.name, status: 'pending' }
-        })
-        steps.splice(0, steps.length, ...rebuilt)
-        console.log(`  📝 已动态插入 ${taskSteps.length} 个任务蓝图步骤`)
+  // plan 阶段 "展开任务" 完成后，动态插入任务蓝图协调器步骤
+  if (stageName === 'plan' && steps[currentIdx]?.name === '展开任务并分组') {
+    const changeDir = resolveChangeDir(cwd, progress)
+    if (changeDir) {
+      const planFile = join(changeDir, 'plan.md')
+      if (existsSync(planFile)) {
+        const planContent = readFileSync(planFile, 'utf8')
+        const { buildPlanSteps, fixedPrefix, fixedSuffix } = await import('./stages/plan.js')
+        const fullSteps = buildPlanSteps(changeDir, planContent)
+        const prefixLen = fixedPrefix.length
+        const suffixLen = fixedSuffix.length
+        // 提取协调器步骤（prefix 和 suffix 之间）
+        const coordinatorSteps = fullSteps.slice(prefixLen, suffixLen > 0 ? -suffixLen : undefined)
+        if (coordinatorSteps.length > 0) {
+          // 在当前步骤之后插入协调器步骤
+          for (let i = 0; i < coordinatorSteps.length; i++) {
+            steps.splice(currentIdx + 1 + i, 0, { name: coordinatorSteps[i].name, status: 'pending' })
+          }
+          console.log(`  📝 已动态插入 ${coordinatorSteps.length} 个任务蓝图步骤（${coordinatorSteps.map(s => s.name).join(', ')}）`)
+        }
       }
     }
   }

package/src/stages/brainstorm.js

@@ -31,7 +31,7 @@ export const definition = {
 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
+5. 棕地项目：读取 .sillyspec/docs/<project>/scan/ 下的 STRUCTURE.md、CONVENTIONS.md、ARCHITECTURE.md
 6. 查看进行中的变更：\`ls .sillyspec/changes/ | grep -v archive\`
 
 ### 输出
@@ -173,22 +173,47 @@ export const definition = {
 2. 复杂项目：每段 200-300 字，逐段展示
 3. 每段展示后等待用户确认
 4. 收集修改意见，调整设计
+5. 确认设计后，确定变更名（格式：\`YYYY-MM-DD-<简短描述>\`，例如 \`2026-05-13-user-auth\`）
 
 ### 输出
-用户确认的完整设计方案
+用户确认的完整设计方案 + 变更名
 
 ### 注意
 - 不要一次输出大段文字
-- 逐段确认，确保用户跟上`,
+- 逐段确认，确保用户跟上
+- 变更名必须以当天日期开头（YYYY-MM-DD-），后跟英文短横线分隔的简短描述`,
       outputHint: '用户确认的设计方案',
       optional: false
     },
+    {
+      name: 'HTML 原型生成',
+      prompt: `为设计方案生成可交互的 HTML 原型，帮助用户可视化确认。
+
+### 操作
+1. 判断本次设计是否适合生成 HTML 原型：
+   - 适合：有 UI 组件/布局/交互流程/状态转换/架构图
+   - 不适合：纯后端逻辑/配置修改/无可视化意义
+2. 如果适合，生成一个独立的 HTML 文件（内联 CSS + JS），保存到：
+   \`.sillyspec/changes/<变更名>/prototype-<名称>.html\`（变更名格式：YYYY-MM-DD-<简短描述>）
+3. 原型要求：
+   - 单文件，浏览器直接打开
+   - 展示关键布局结构和交互流程
+   - 不需要完整功能，重点是让用户确认设计方向
+   - 使用 ASCII/流程图/线框图风格，不需要精美 UI
+4. 展示给用户确认设计方向
+
+### 输出
+HTML 原型文件路径（或"跳过"如果不适合）`,
+      outputHint: '原型文件路径或跳过',
+      optional: true
+    },
     {
       name: '写设计文档并自审',
       prompt: `撰写 design 文档并进行 AI 自审。
 
 ### 操作
 1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<变更名>\`（Windows 用 \`mkdir .sillyspec\\changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path .sillyspec/changes/<变更名>\`）
+   - 变更名格式必须为 \`YYYY-MM-DD-<简短描述>\`（如 \`2026-05-13-user-auth\`）
 2. 将确认的设计写入 \`.sillyspec/changes/<变更名>/design.md\`
 3. 自审检查：
    - 需求覆盖：是否完整覆盖 Step 6 确认的需求

package/src/stages/execute.js

@@ -168,38 +168,67 @@ function parseWavesFromPlan(planContent) {
 }
 
 /**
- * 为 Wave 生成 prompt
+ * 为 Wave 生成 prompt（强制子代理执行）
  */
 function buildWavePrompt(wave, waveIndex, changeDir) {
-  const taskList = wave.tasks.map((t, ti) => {
+  // 构建子代理 prompt 模板（每个任务的蓝图内容）
+  const subagentTemplates = wave.tasks.map((t, ti) => {
     const taskNum = String(t.index || (ti + 1)).padStart(2, '0')
     const taskFile = changeDir ? `${changeDir}/tasks/task-${taskNum}.md` : ''
     const taskFileExists = taskFile && existsSync(taskFile)
-    let s = `- [ ] ${t.name}`
-    if (t.file) s += ` (${t.file})`
+    let taskContent = ''
     if (taskFileExists) {
-      let taskContent = ''
       try { taskContent = readFileSync(taskFile, 'utf8').trim() } catch { taskContent = '（无法读取任务蓝图文件）' }
-      s += `
-\n### 📋 任务蓝图（task-${taskNum}.md）\n${taskContent}`
     }
-    if (t.reference) s += `\n  参考: ${t.reference}`
-    if (t.steps) s += `\n  步骤: ${t.steps}`
+    const fileInfo = t.file ? ` (${t.file})` : ''
+    return `\`\`\`
+任务：${t.name}${fileInfo}
+${taskContent ? `蓝图内容：\n${taskContent}` : '（无蓝图文件，按任务描述执行）'}
+
+操作：
+1. 先读后写 — 读取要修改的文件，理解现有结构
+2. 按 TDD 步骤实现
+3. 运行对应测试确认通过
+4. 报告改动文件和测试结果
+
+铁律：
+- 只做蓝图/任务描述里写的事，不增不减
+- 蓝图有问题 → 报告问题，不要自己改
+- 先写测试，再写代码
+- grep 确认方法存在，不要编造
+\`\`\``
+  }).join('\n\n')
+
+  const taskList = wave.tasks.map((t, ti) => {
+    const taskNum = String(t.index || (ti + 1)).padStart(2, '0')
+    let s = `- [ ] ${t.name}`
+    if (t.file) s += ` (${t.file})`
     return s
   }).join('\n')
-  const { join } = path
-const hasTaskBlueprints = changeDir && existsSync(join(changeDir, 'tasks'))
-  const taskBlueprintRule = hasTaskBlueprints
-    ? '每个任务有独立的 task-N.md 蓝图——只做蓝图里写的事，不要实现蓝图之外的功能。如果蓝图有问题，**停下来反馈**，不要自己改。问题归因：实现困难 → task 蓝图没写好 → plan 没做好 → design 有缺陷。'
-    : '如果发现 plan 不合理，**停下来反馈**，不要自己改方案。问题归因：实现困难 → plan 没做好 → design 有缺陷。'
+
   return `## Wave ${waveIndex}: 执行以下任务
 
+## 执行方式（必须严格遵守）
+
+**每个任务必须由独立子代理执行，你不要自己写代码。**
+
+你的角色是调度者 + 审查者：
+1. 为每个任务启动一个子代理（Agent tool），同 Wave 内可并行
+2. 子代理完成后审查结果
+3. 勾选 plan.md 中的 checkbox
+4. 记录改动文件和测试结果
+
+### 子代理 prompt 模板
+为每个任务使用以下 prompt 启动子代理：
+
+${subagentTemplates}
+
 ### Wave 开始前
 1. 读取 design.md 的「编码铁律」章节（如果存在），严格遵守
 2. 读取 plan.md 了解全局任务划分和依赖关系
-2. 确认本 Wave 的输入/输出契约（前置 Wave 产出了什么，本 Wave 需要消费什么）
-3. 检查前置 Wave 的产出是否完整（文件是否存在、测试是否通过）
-4. **上下文分层加载**：
+3. 确认本 Wave 的输入/输出契约（前置 Wave 产出了什么，本 Wave 需要消费什么）
+4. 检查前置 Wave 的产出是否完整（文件是否存在、测试是否通过）
+5. **上下文分层加载**：
    - 🔥 热上下文：design.md 编码铁律 + 当前 Wave 任务（必须加载）
    - 🌡️ 温上下文：CONVENTIONS.md + ARCHITECTURE.md（需要时加载）
    - ❄️ 冷上下文：其他变更的 design.md、历史 plan.md（不要主动加载，除非明确需要）
@@ -207,21 +236,17 @@ const hasTaskBlueprints = changeDir && existsSync(join(changeDir, 'tasks'))
 ### 本 Wave 任务
 ${taskList}
 
-### 执行要求
-1. 按任务顺序执行，同一 Wave 内任务可并行
-2. 铁律：先读后写、grep 确认方法存在、不编造、TDD
-3. **禁止发散思维**：你是代码搬运工，严格按任务描述执行，不增不减不改。${taskBlueprintRule}
-4. **Reverse Sync**：发现 Bug 或实现与 design.md/task-N.md 不一致时，先检查是代码错了还是文档有遗漏，有遗漏则先修文档再修代码。
-4. **不要频繁编译！** 编译很慢，只在以下情况运行：
+### 调度要求
+1. 同一 Wave 内任务可并行启动子代理
+2. **Reverse Sync**：子代理报告实现与 design.md 不一致时，先检查是代码错了还是文档有遗漏
+3. **不要频繁编译！** 编译很慢，只在以下情况运行：
    - 写了大量代码后需要验证语法正确性
    - 最后一个 Wave 完成后做一次全量编译验证
    - 用户明确要求编译时
-5. 单个任务完成后只跑**对应模块的单元测试**（TDD 绿灯确认），不要跑全量编译
-6. 每个任务完成后：
-   - 勾选 task-N.md 中的验收标准 checkbox
+4. 每个任务完成后：
    - 勾选 plan.md / tasks.md 中对应任务的 checkbox
    - 记录改动文件和测试结果
-7. 遇到 BLOCKED → 记录原因，选择：重试/跳过/停止
+5. 遇到 BLOCKED → 记录原因，选择：重试/跳过/停止
 
 ### 完成后
 运行 sillyspec run execute --done --input "用户原始反馈" --output "Wave ${waveIndex} 结果摘要"`

package/src/stages/explore.js

@@ -0,0 +1,34 @@
+export const definition = {
+  name: 'explore',
+  title: '自由探索',
+  description: '讨论、调研、画图，不写实现代码',
+  auxiliary: true,
+  steps: [
+    {
+      name: '自由探索',
+      prompt: `围绕用户给出的话题做技术探索，不进入实现。
+
+### 操作
+1. 明确探索边界：这次只讨论、调研、画图和识别风险
+2. 如果需要代码库上下文，可以读取：
+   - \`.sillyspec/projects/*.yaml\`
+   - \`.sillyspec/docs/<project>/scan/ARCHITECTURE.md\`
+   - \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\`
+   - \`.sillyspec/changes/<change-name>/design.md\`
+3. 可以用 \`rg\` / \`ls\` / \`cat\` 调查已有结构和集成点
+4. 输出 2-3 个有价值方向、关键风险和下一步建议
+5. 如果用户要求保存结论，先明确保存位置，再写入对应文档
+
+### 输出
+探索结论、选项对比、风险清单或 ASCII 图
+
+### 铁律
+- 不写实现代码
+- 不安装依赖
+- 不修改文件，除非用户明确要求保存探索结论
+- 不强行推进到 brainstorm/plan/execute`,
+      outputHint: '探索结论',
+      optional: false
+    }
+  ]
+}

package/src/stages/index.js

@@ -5,6 +5,7 @@ import { definition as execute } from './execute.js'
 import { definition as verify } from './verify.js'
 import { definition as scan } from './scan.js'
 import { definition as quick } from './quick.js'
+import { definition as explore } from './explore.js'
 import { definition as archive } from './archive.js'
 import { definition as status } from './status.js'
 import { definition as doctor } from './doctor.js'
@@ -17,10 +18,11 @@ export const stageRegistry = {
   verify,
   scan,
   quick,
+  explore,
   archive,
   status,
   doctor
 }
 
 // 辅助命令（在没有 progress.json 时也可执行）
-export const auxiliaryStages = ['scan', 'quick', 'archive', 'status', 'doctor']
+export const auxiliaryStages = ['scan', 'quick', 'explore', 'archive', 'status', 'doctor']

package/src/stages/plan.js

@@ -218,6 +218,88 @@ ${taskName}
 任务蓝图内容摘要`
 }
 
+/**
+ * 构建任务蓝图协调器步骤（单步，子代理并行写蓝图）
+ */
+export function buildCoordinatorStep(changeDir, taskNames) {
+  const taskList = taskNames.map((name, i) => {
+    const num = String(i + 1).padStart(2, '0')
+    return `- task-${num}: ${name}`
+  }).join('\n')
+
+  const subagentPrompts = taskNames.map((name, i) => {
+    const num = String(i + 1).padStart(2, '0')
+    return `\`\`\`
+任务编号：task-${num}
+任务名称：${name}
+文件路径：${changeDir}/tasks/task-${num}.md
+
+操作：
+1. 读取 ${changeDir}/design.md 和 ${changeDir}/plan.md 了解上下文
+2. 读取相关源文件了解现有代码
+3. 按以下格式编写任务蓝图并保存到 ${changeDir}/tasks/task-${num}.md：
+
+# task-${num}: ${name}
+
+## 修改文件
+- 文件路径列表
+
+## 实现要求
+1. 具体做什么
+
+## 接口定义
+（代码类任务必填）
+
+## 边界处理
+- 异常场景
+
+## 参考
+- 可参考的模式
+
+## TDD 步骤
+1. 写测试 → 2. 确认失败 → 3. 写代码 → 4. 确认通过
+
+## 验收标准
+- [ ] 具体可测试的条件
+
+关键规则：
+- 必须独立完整，execute 子代理只读这一个文件就能干活
+- 不要依赖其他 task-N.md 的内容
+- 接口定义写到"搬砖工照着做"的程度
+- 写完后用 Write tool 保存到文件
+\`\`\``
+  }).join('\n\n')
+
+  return {
+    name: '生成任务蓝图（子代理并行）',
+    prompt: `为 plan.md 中的每个任务生成独立蓝图文件。
+
+## 任务清单
+${taskList}
+
+## 执行方式（必须严格遵守）
+
+**你必须使用 Agent tool 启动子代理来写每个蓝图，不要自己写。**
+
+1. 确认 \`${changeDir}/tasks/\` 目录存在（不存在则创建）
+2. 为每个任务启动一个独立子代理（Agent tool），可并行启动多个
+3. 每个子代理使用对应的 prompt（见下方模板）
+4. 等待所有子代理完成
+5. 验证每个 task-N.md 文件已生成且非空
+
+### 子代理 prompt 模板
+为每个任务使用以下 prompt 启动子代理：
+
+${subagentPrompts}
+
+## 验收
+- 每个 task-N.md 文件存在且非空
+- 包含所有必要章节：修改文件、实现要求、接口定义、边界处理、TDD 步骤、验收标准`,
+    outputHint: '蓝图生成结果',
+    optional: false
+  }
+}
+
 /**
  * 从 plan.md 解析任务名列表
  */
@@ -255,8 +337,7 @@ export function buildPlanSteps(changeDir = null, planContent = null) {
     return [...fixedPrefix, ...fixedSuffix]
   }
 
-  // 动态生成每个任务的蓝图写作步骤
-  // 尝试从 plan.md 解析任务名
+  // 解析任务名
   let taskNames = []
   if (planContent) {
     taskNames = parseTaskNames(planContent)
@@ -267,16 +348,7 @@ export function buildPlanSteps(changeDir = null, planContent = null) {
     }
   }
 
-  const taskSteps = []
-  for (let i = 1; i <= taskCount; i++) {
-    const taskName = taskNames[i - 1] || '（从 plan.md 读取任务名）'
-    taskSteps.push({
-      name: `写任务蓝图 task-${String(i).padStart(2, '0')}`,
-      prompt: `### 注意\n这是第 ${i}/${taskCount} 个任务蓝图。focus 在这一个任务上，不要写其他任务的内容。\n\n${buildTaskPrompt(i, taskName, changeDir)}`,
-      outputHint: `task-${String(i).padStart(2, '0')} 蓝图`,
-      optional: false
-    })
-  }
-
-  return [...fixedPrefix, ...taskSteps, ...fixedSuffix]
+  // 生成单个协调器步骤（子代理并行写蓝图）
+  const coordinatorStep = buildCoordinatorStep(changeDir, taskNames)
+  return [...fixedPrefix, coordinatorStep, ...fixedSuffix]
 }

package/src/stages/scan.js

@@ -10,8 +10,8 @@ export const definition = {
 
 ### 操作
 1. \`ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .\` — 检查已有文档
-1. \`ls docs/*/scan/ 2>/dev/null\` — 检查已有文档
-2. \`wc -l docs/*/scan/*.md 2>/dev/null\` — 文档行数
+1. \`ls .sillyspec/docs/*/scan/ 2>/dev/null\` — 检查已有文档
+2. \`wc -l .sillyspec/docs/*/scan/*.md 2>/dev/null\` — 文档行数
 3. 已有 3 份 → 建议升级深度扫描；已有 7 份 → 建议刷新或跳过
 5. 显示子项目列表供选择扫描范围
 
@@ -27,7 +27,7 @@ export const definition = {
 ### 操作
 1. \`cat package.json pom.xml build.gradle go.mod Cargo.toml requirements.txt pyproject.toml Gemfile composer.json 2>/dev/null\`
 2. \`find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null\`
-3. 结果保存到 \`docs/<project>/scan/_env-detect.md\`（临时文件，扫描完删除）
+3. 结果保存到 \`.sillyspec/docs/<project>/scan/_env-detect.md\`（临时文件，扫描完删除）
 
 ### 输出
 环境探测结果摘要`,
@@ -56,7 +56,7 @@ export const definition = {
 ### 操作
 1. 用 grep/rg 搜索（\`@Entity\`、\`schema.prisma\`、\`models.py\` 等），**禁止读源码全文**
 2. Schema 只记表名+说明+字段数
-3. 写入 \`docs/<project>/scan/ARCHITECTURE.md\`
+3. 写入 \`.sillyspec/docs/<project>/scan/ARCHITECTURE.md\`
 4. 包含 \`## 技术栈\` \`## 架构概览\` \`## 数据模型（摘要）\`
 
 ### 输出
@@ -75,7 +75,7 @@ ARCHITECTURE.md 路径
 1. 用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段，**禁止读源码全文**
 2. 根据检测到的语言/框架自行决定搜索什么模式
 3. 提取 3-5 个典型示例
-4. 写入 \`docs/<project>/scan/CONVENTIONS.md\`
+4. 写入 \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\`
 5. 包含 \`## 框架隐形规则\` \`## 实体继承规范\` \`## 代码风格\`
 
 ### 输出
@@ -93,8 +93,8 @@ CONVENTIONS.md 路径
 ### 操作
 1. 用 find/ls/tree 和 grep，**禁止读源码全文**
 2. 搜索 API 调用、MQ 配置、缓存、第三方 SDK
-3. 写入 \`docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
-4. 写入 \`docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
+3. 写入 \`.sillyspec/docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
+4. 写入 \`.sillyspec/docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
 
 ### 输出
 STRUCTURE.md 和 INTEGRATIONS.md 路径
@@ -110,9 +110,9 @@ STRUCTURE.md 和 INTEGRATIONS.md 路径
 
 ### 操作
 1. 用 grep 搜索测试文件、TODO/FIXME、过时依赖，**禁止读源码全文**
-2. 写入 \`docs/<project>/scan/TESTING.md\`（测试结构）
-3. 写入 \`docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
-4. 写入 \`docs/<project>/scan/PROJECT.md\`（项目信息）
+2. 写入 \`.sillyspec/docs/<project>/scan/TESTING.md\`（测试结构）
+3. 写入 \`.sillyspec/docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
+4. 写入 \`.sillyspec/docs/<project>/scan/PROJECT.md\`（项目信息）
 
 ### 输出
 TESTING.md、CONCERNS.md、PROJECT.md 路径`,
@@ -126,7 +126,7 @@ TESTING.md、CONCERNS.md、PROJECT.md 路径`,
 ### 操作
 1. 检查 7 份文档是否全部生成
 2. 自检门控：ARCHITECTURE（技术栈+Schema摘要）、CONVENTIONS（隐形规则+代码风格）、STRUCTURE（目录结构）、INTEGRATIONS（外部依赖）、TESTING（测试现状）、CONCERNS（技术债务）、PROJECT（项目概览）
-3. 清理：\`rm -f docs/<project>/scan/_env-detect.md\`
+3. 清理：\`rm -f .sillyspec/docs/<project>/scan/_env-detect.md\`
 4. \`git add .\` — **不要 commit**，由用户通过统一提交工具处理
 
 ### 输出

package/src/stages/status.js

@@ -11,7 +11,7 @@ export const definition = {
 ### 操作
 1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
 2. 获取 project 名
-3. \`ls docs/<project>/scan/ 2>/dev/null | head -10\`
+3. \`ls .sillyspec/docs/<project>/scan/ 2>/dev/null | head -10\`
 4. \`cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20\`
 5. \`cat .sillyspec/ROADMAP.md 2>/dev/null\`