sillyspec 3.9.0 → 3.10.0

package/src/init.js

@@ -1,61 +1,36 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
-import { join, resolve, dirname } from 'path';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, statSync } from 'fs';
+import { join, resolve, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
-import { homedir } from 'os';
-import { checkbox, select, confirm, input } from '@inquirer/prompts';
+import { checkbox, confirm, input } from '@inquirer/prompts';
+import { ProgressManager } from './progress.js';
 import chalk from 'chalk';
-import ora from 'ora';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const TEMPLATE_DIR = resolve(__dirname, '..', 'templates');
+
+// ── 递归复制目录 ──
+function copyDirSync(src, dst) {
+  mkdirSync(dst, { recursive: true });
+  for (const entry of readdirSync(src, { withFileTypes: true })) {
+    if (entry.name === 'node_modules' || entry.name === '.git') continue;
+    const srcPath = join(src, entry.name);
+    const dstPath = join(dst, entry.name);
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, dstPath);
+    } else if (entry.name.endsWith('.md')) {
+      writeFileSync(dstPath, readFileSync(srcPath));
+    }
+  }
+}
 
 // ── 元数据映射 ──
 
-const DESCRIPTIONS = {
-  init: '绿地项目初始化 — 深度提问、调研、需求文档、路线图',
-  scan: '代码库扫描 — 支持快速扫描和深度扫描两阶段',
-  explore: '自由思考模式 — 讨论、画图、调研，不写代码',
-  brainstorm: '需求探索 — 结构化头脑风暴，生成设计文档（创建性工作前必用）',
-  plan: '编写实现计划 — 任务拆分与实现路径',
-  execute: '波次执行 — 子代理并行 + 强制 TDD + 两阶段审查',
-  verify: '验证实现 — 对照规范检查 + 测试套件',
-  archive: '归档变更 — 规范沉淀，可追溯',
-  commit: '智能提交 — 自动收集变更信息，生成 commit message',
-  status: '查看项目进度和状态',
-  continue: '自动判断并执行下一步',
-  state: '查看当前工作状态 — 显示 STATE.md 内容',
-
-  quick: '快速任务 — 跳过完整流程，直接做',
-  workspace: '工作区管理 — 初始化、管理多项目工作区，查看子项目状态',
-  export: '导出成功方案为可复用模板',
-};
 
-const ARG_HINTS = {
-  init: '[项目名]',
-  scan: '[可选：指定区域，如 \'api\' 或 \'auth\'] [--deep 深度扫描]',
-  explore: '[探索主题]',
-  brainstorm: '[需求或想法描述]',
-
-  plan: '[计划名]',
-  execute: '[任务编号或 \'all\']',
-  verify: '[可选：指定验证范围]',
-  archive: '[变更名]',
-  commit: '[可选：自定义 commit message]',
-  status: '',
-  continue: '',
-  state: '[可选备注]',
-
-  quick: '[任务描述]',
-  workspace: '[可选：add/remove/status/info]',
-  export: '<change-name> [--to <path>]',
-};
 
-const VALID_TOOLS = ['claude', 'claude_skills', 'cursor', 'openclaw', 'codex', 'gemini', 'opencode'];
+const VALID_TOOLS = ['claude', 'cursor', 'openclaw', 'codex', 'gemini', 'opencode'];
 
 const TOOL_LABELS = {
   claude: 'Claude Code',
-  claude_skills: 'Claude Skills',
   cursor: 'Cursor',
   openclaw: 'OpenClaw',
   codex: 'OpenAI Codex (通过 AGENTS.md)',
@@ -63,8 +38,6 @@ const TOOL_LABELS = {
   opencode: 'OpenCode (通过 INSTRUCTIONS.md)',
 };
 
-
-// 指令文件工具：注入规范引用到指令文件
 const INSTRUCTION_TOOLS = ['codex', 'gemini', 'opencode'];
 
 const INSTRUCTION_FILE_MAP = {
@@ -78,83 +51,16 @@ const INJECTION_CONTENT = `## SillySpec — 规范驱动开发
 在执行开发任务时，遵循以下规范：
 
 ### 代码规范
-- 写代码前先读取 \`.sillyspec/codebase/CONVENTIONS.md\`（代码风格）和 \`.sillyspec/codebase/ARCHITECTURE.md\`（架构）
+- 写代码前先读取 \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\`（代码风格）和 \`.sillyspec/docs/<project>/scan/ARCHITECTURE.md\`（架构）
 - 调用已有方法前，用 grep 确认方法存在，不许编造
-- 遵循 \`.sillyspec/codebase/CONVENTIONS.md\` 中的代码风格
+- 遵循 \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\` 中的代码风格
 
 ### 工作流程
-- 读取 \`.sillyspec/STATE.md\` 确认当前阶段
+- 读取 \`.sillyspec/.runtime/progress.json\` 确认当前阶段（使用 \`sillyspec progress show\`）
 - 各阶段产出文件位于 \`.sillyspec/changes/<变更名>/\` 下
-- 详细流程参考模板文件：\`.sillyspec/.templates/\`（brainstorm.md, plan.md, execute.md 等）
 `;
 
-// ── 适配器 ──
-
-function generateClaude(projectDir, name, desc, body, argHint, version) {
-  const outDir = join(projectDir, '.claude', 'commands', 'sillyspec');
-  mkdirSync(outDir, { recursive: true });
-  writeFileSync(join(outDir, `${name}.md`),
-`---
-description: ${desc}
-argument-hint: "${argHint}"
-version: "${version}"
----
-
-${body}`
-  );
-}
-
-function generateClaudeSkills(projectDir, name, desc, body, argHint, version) {
-  const outDir = join(projectDir, '.claude', 'skills', `sillyspec-${name}`);
-  mkdirSync(outDir, { recursive: true });
-  writeFileSync(join(outDir, 'SKILL.md'),
-`---
-name: sillyspec:${name}
-description: ${desc}
-version: "${version}"
----
-
-${body}`
-  );
-}
-
-function generateCursor(projectDir, name, desc, body, argHint, version) {
-  const outDir = join(projectDir, '.cursor', 'commands');
-  mkdirSync(outDir, { recursive: true });
-  writeFileSync(join(outDir, `sillyspec-${name}.md`),
-`---
-name: /sillyspec-${name}
-id: sillyspec-${name}
-description: ${desc}
-version: "${version}"
----
-
-${body}`
-  );
-}
-
-function generateOpenclaw(projectDir, name, desc, body, argHint, version) {
-  const outDir = join(projectDir, '.openclaw', 'skills', `sillyspec-${name}`);
-  mkdirSync(outDir, { recursive: true });
-  writeFileSync(join(outDir, 'SKILL.md'),
-`---
-name: sillyspec:${name}
-description: ${desc}
-version: "${version}"
----
-
-${body}`
-  );
-}
-
-const GENERATORS = {
-  claude: generateClaude,
-  claude_skills: generateClaudeSkills,
-  cursor: generateCursor,
-  openclaw: generateOpenclaw,
-};
-
-// ── 指令文件注入 ──
+// ── 注入指令文件 ──
 
 function injectInstructions(tool, projectDir) {
   const fileName = INSTRUCTION_FILE_MAP[tool];
@@ -180,7 +86,6 @@ function injectInstructions(tool, projectDir) {
 function detectTools(projectDir) {
   const found = [];
   if (existsSync(join(projectDir, '.claude'))) found.push('claude');
-  if (existsSync(join(projectDir, '.claude', 'skills'))) found.push('claude_skills');
   if (existsSync(join(projectDir, '.cursor'))) found.push('cursor');
   if (existsSync(join(projectDir, '.openclaw'))) found.push('openclaw');
   if (existsSync(join(projectDir, 'AGENTS.md'))) found.push('codex');
@@ -198,22 +103,33 @@ function isTTY() {
 
 // ── 核心安装逻辑 ──
 
-async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
+async function doInstall(projectDir, tools, subprojects = []) {
   // 创建基础目录
-  // .sillyspec/codebase/    → scan
-  // .sillyspec/codebase/details/ → scan (deep)
-  // .sillyspec/changes/     → brainstorm/plan
-  // .sillyspec/changes/archive/ → archive
-  // .sillyspec/quicklog/    → quick
-  // .sillyspec/knowledge/   → archive (spec 沉淀)
-  // .sillyspec/.runtime/    → runtime data (gitignored)
-  // (plan 内容已合并到 tasks.md)
-  if (isWorkspace) {
-    mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
-    mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });
+  // .sillyspec/projects/    → 项目注册表
+  // .sillyspec/docs/<name>/ → 统一文档中心
+  // .sillyspec/knowledge/   → 跨项目共享知识库
+  // .sillyspec/.runtime/    → progress (gitignored)
+
+  // 注册当前项目到 projects/
+  const projectName = basename(projectDir) || 'project';
+  const projectsDir = join(projectDir, '.sillyspec', 'projects');
+  mkdirSync(projectsDir, { recursive: true });
+  const projectYamlPath = join(projectsDir, `${projectName}.yaml`);
+  if (!existsSync(projectYamlPath)) {
+    writeFileSync(projectYamlPath, `name: ${projectName}\npath: .\nstatus: active\n`);
   }
 
-  // 创建知识库骨架（所有模式）
+  // 创建 .sillyspec/docs/<projectName>/scan/ 子目录（代码扫描结果）
+  const scanDir = join(projectDir, '.sillyspec', 'docs', projectName, 'scan');
+  mkdirSync(scanDir, { recursive: true });
+  const gitkeepPath = join(scanDir, '.gitkeep');
+  if (!existsSync(gitkeepPath)) writeFileSync(gitkeepPath, '');
+
+  // 创建 shared/workspace 目录
+  mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
+  mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });
+
+  // 创建知识库骨架
   const knowledgeDir = join(projectDir, '.sillyspec', 'knowledge');
   mkdirSync(knowledgeDir, { recursive: true });
   const indexPath = join(knowledgeDir, 'INDEX.md');
@@ -231,6 +147,13 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
     mkdirSync(join(runtimeDir, sub), { recursive: true });
   }
 
+  // 创建初始 progress.json
+  const progressPath = join(runtimeDir, 'progress.json');
+  if (!existsSync(progressPath)) {
+    const pm = new ProgressManager();
+    pm.init(projectDir);
+  }
+
   // 创建初始 user-inputs.md
   const inputsPath = join(runtimeDir, 'user-inputs.md');
   if (!existsSync(inputsPath)) {
@@ -238,7 +161,7 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
   }
 
   const gitignorePath = join(projectDir, '.gitignore');
-  const ignoreRules = ['.sillyspec/STATE.md', '.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/'];
+  const ignoreRules = ['.sillyspec/codebase/SCAN-RAW.md', '.sillyspec/local.yaml', '.sillyspec/.runtime/'];
   if (existsSync(gitignorePath)) {
     const content = readFileSync(gitignorePath, 'utf8');
     let updated = content.trimEnd();
@@ -252,83 +175,44 @@ async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
     writeFileSync(gitignorePath, ignoreRules.join('\n') + '\n');
   }
 
-  // 生成 slash command 文件
-  const templateFiles = readdirSync(TEMPLATE_DIR).filter(f => f.endsWith('.md'));
-  let count = 0;
-
+  // 注入指令文件（codex/gemini/opencode）
   for (let i = 0; i < tools.length; i++) {
     const toolName = tools[i];
-    const label = TOOL_LABELS[toolName] || toolName;
-
     if (INSTRUCTION_TOOLS.includes(toolName)) {
-      const spinner = ora(`安装 ${label}... (${i + 1}/${tools.length})`).start();
-      try {
-        injectInstructions(toolName, projectDir);
-        // 复制模板文件到 .sillyspec/.templates/
-        const templatesSourceDir = join(TEMPLATE_DIR);
-        const templatesDir = join(projectDir, '.sillyspec', '.templates');
-        if (!existsSync(templatesDir)) {
-          mkdirSync(templatesDir, { recursive: true });
-          for (const file of readdirSync(templatesSourceDir)) {
-            if (file.endsWith('.md')) {
-              copyFileSync(join(templatesSourceDir, file), join(templatesDir, file));
-            }
-          }
-        }
-        spinner.succeed(`${label} 完成`);
-        count++;
-      } catch (err) {
-        spinner.fail(`${label} 失败: ${err.message}`);
-        throw err;
-      }
-      continue;
-    }
-
-    const spinner = ora(`安装 ${label}... (${i + 1}/${tools.length})`).start();
-    try {
-      const gen = GENERATORS[toolName];
-      const ver = getVersion();
-      for (const file of templateFiles) {
-        const name = file.replace('.md', '');
-        const desc = DESCRIPTIONS[name] || `SillySpec ${name}`;
-        const argHint = ARG_HINTS[name] || '';
-        const body = readFileSync(join(TEMPLATE_DIR, file), 'utf8');
-        gen(projectDir, name, desc, body, argHint, ver);
-        count++;
-      }
-      spinner.succeed(`${label} 完成`);
-    } catch (err) {
-      spinner.fail(`${label} 失败: ${err.message}`);
-      throw err;
+      injectInstructions(toolName, projectDir);
     }
   }
 
-  // 工作区子项目配置 → projects/*.yaml
-  if (isWorkspace && subprojects.length > 0) {
-    const projectsDir = join(projectDir, '.sillyspec', 'projects');
-    mkdirSync(projectsDir, { recursive: true });
-    for (const p of subprojects) {
-      const pFile = join(projectsDir, `${p.name}.yaml`);
-      if (!existsSync(pFile)) {
-        writeFileSync(pFile,
-`# ${p.name}
-name: ${p.name}
-path: ${p.path}
-role: ${p.role || p.name}${p.repo ? `\nrepo: ${p.repo}` : ''}
-`
-        );
+  // 复制 skills 到各工具目录
+  const skillToolDirs = {
+    claude: '.claude/skills',
+    codex: '.codex/skills',
+    openclaw: '.openclaw/skills',
+    opencode: '.opencode/skills',
+  }
+  const skillsSource = join(__dirname, '..', '.claude', 'skills');
+  if (existsSync(skillsSource)) {
+    const sillyspecSkills = readdirSync(skillsSource).filter(f => f.startsWith('sillyspec-') && statSync(join(skillsSource, f)).isDirectory());
+    if (sillyspecSkills.length > 0) {
+      for (const [tool, dir] of Object.entries(skillToolDirs)) {
+        if (!tools.includes(tool)) continue
+        const targetDir = join(projectDir, dir)
+        mkdirSync(targetDir, { recursive: true })
+        for (const skill of sillyspecSkills) {
+          copyDirSync(join(skillsSource, skill), join(targetDir, skill))
+        }
+        console.log(chalk.green(`    ✓ ${TOOL_LABELS[tool]} skills 已同步 (${sillyspecSkills.length} 个)`))
       }
     }
+  } else {
+    console.log(chalk.yellow('    ⚠ 未找到 skills 目录（npm 包内无 .claude/skills/），跳过同步'));
   }
-
-  return count;
 }
 
 // ── 安装完成总结 ──
 
-function showSummary(version, tools, isWorkspace, count) {
+function showSummary(version, tools) {
   const toolLabels = tools.map(t => TOOL_LABELS[t] || t);
-  const mode = isWorkspace ? '多项目工作区' : '单项目';
 
   console.log('');
   console.log(chalk.green('  ═══════════════════════════════════════'));
@@ -336,20 +220,13 @@ function showSummary(version, tools, isWorkspace, count) {
   console.log(chalk.green('  ═══════════════════════════════════════'));
   console.log('');
   console.log(`  已安装工具: ${chalk.cyan(toolLabels.join(', '))}`);
-  console.log(`  模式: ${chalk.yellow(mode)}`);
-  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 "你的想法"'));
-  console.log('');
-  console.log(chalk.gray('  重启你的 AI 工具以使 slash commands 生效。'));
+  console.log('  下一步：使用 AI 技能开始工作');
+  console.log('    OpenClaw:    ' + chalk.bold('/sillyspec:brainstorm'));
+  console.log('    Claude Code: ' + chalk.bold('/sillyspec:brainstorm'));
   console.log('');
   console.log(chalk.dim('  💡 推荐安装 MCP 工具增强 AI 能力：sillyspec setup'));
-  console.log(chalk.dim('     Context7 — 查最新文档 | grep.app — 搜开源实现 | Chrome DevTools — 浏览器自动化'));
   console.log('');
 }
 
@@ -367,7 +244,7 @@ export function getVersion() {
 // ── 主命令 ──
 
 export async function cmdInit(projectDir, options = {}) {
-  const { tool, workspace, interactive } = options;
+  const { tool, interactive } = options;
   const version = getVersion();
 
   // ── 交互式模式（--interactive 或 -i）──
@@ -399,20 +276,11 @@ export async function cmdInit(projectDir, options = {}) {
       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.yellow('📋 添加子项目'));
       console.log(chalk.dim('   子项目是工作区中的独立项目目录（如 frontend/、backend/）'));
       console.log('');
 
@@ -475,8 +343,8 @@ export async function cmdInit(projectDir, options = {}) {
     }
 
     console.log('');
-    const count = await doInstall(projectDir, selectedTools, isWorkspace, subprojects);
-    showSummary(version, selectedTools, isWorkspace, count);
+    await doInstall(projectDir, selectedTools, subprojects);
+    showSummary(version, selectedTools);
     return;
   }
 
@@ -494,23 +362,17 @@ export async function cmdInit(projectDir, options = {}) {
     tools = detectTools(projectDir);
   }
 
-  const count = await doInstall(projectDir, tools, !!workspace);
+  await doInstall(projectDir, tools);
 
   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('  下一步：使用 AI 技能开始工作');
+  console.log(`    OpenClaw:    ${chalk.bold('/sillyspec:brainstorm')}`);
+  console.log(`    Claude Code: ${chalk.bold('/sillyspec:brainstorm')}`);
   console.log('');
   console.log(chalk.dim('  💡 增强能力：sillyspec setup（安装 MCP 工具）'));
-  console.log(chalk.dim('  💡 完整配置：sillyspec init --interactive'));
   console.log('');
 }

package/src/migrate.js

@@ -0,0 +1,117 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, copyFileSync } from 'fs';
+import { basename, join, resolve } from 'path';
+import chalk from 'chalk';
+
+/**
+ * Migrate old .sillyspec/ structure to unified .sillyspec/docs/<project>/ structure
+ * @param {string} projectDir - Path to the project directory
+ */
+export function migrateDocs(projectDir) {
+  const sillyspecDir = join(projectDir, '.sillyspec');
+  if (!existsSync(sillyspecDir)) {
+    console.error('❌ .sillyspec/ 目录不存在');
+    process.exit(1);
+  }
+
+  // Determine project name from projects/*.yaml or directory name
+  let projectName = basename(resolve(projectDir));
+  const projectsDir = join(sillyspecDir, 'projects');
+  if (existsSync(projectsDir)) {
+    const yamlFiles = readdirSync(projectsDir).filter(f => f.endsWith('.yaml'));
+    if (yamlFiles.length > 0) {
+      projectName = yamlFiles[0].replace('.yaml', '');
+    }
+  }
+
+  console.log(chalk.cyan(`📦 迁移项目: ${projectName}`));
+  console.log('');
+
+  const docsBase = join(sillyspecDir, 'docs', projectName);
+  let migrated = 0;
+
+  // 1. codebase/ → .sillyspec/docs/<project>/scan/
+  const codebaseDir = join(sillyspecDir, 'codebase');
+  if (existsSync(codebaseDir)) {
+    const targetDir = join(docsBase, 'scan');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(codebaseDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(codebaseDir, file);
+      const dest = join(targetDir, file);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` scan/${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` scan/${file} (已存在)`);
+      }
+    }
+  }
+
+  // 2. specs/ is deprecated — designs live in changes/<变更名>/design.md
+
+  // 3. changes/archive/ → .sillyspec/docs/<project>/archive/
+  const archiveDir = join(sillyspecDir, 'changes', 'archive');
+  if (existsSync(archiveDir)) {
+    const targetDir = join(docsBase, 'archive');
+    mkdirSync(targetDir, { recursive: true });
+    const entries = readdirSync(archiveDir);
+    for (const entry of entries) {
+      const src = join(archiveDir, entry);
+      const dest = join(targetDir, entry);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` archive/${entry}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` archive/${entry} (已存在)`);
+      }
+    }
+  }
+
+  // 4. knowledge/ → .sillyspec/docs/<project>/archive/ (append knowledge files)
+  const knowledgeDir = join(sillyspecDir, 'knowledge');
+  if (existsSync(knowledgeDir)) {
+    const targetDir = join(docsBase, 'archive');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(knowledgeDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(knowledgeDir, file);
+      const dest = join(targetDir, `knowledge-${file}`);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` archive/knowledge-${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` archive/knowledge-${file} (已存在)`);
+      }
+    }
+  }
+
+  // 5. quicklog/ → .sillyspec/docs/<project>/quicklog/
+  const quicklogDir = join(sillyspecDir, 'quicklog');
+  if (existsSync(quicklogDir)) {
+    const targetDir = join(docsBase, 'quicklog');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(quicklogDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(quicklogDir, file);
+      const dest = join(targetDir, file);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` quicklog/${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` quicklog/${file} (已存在)`);
+      }
+    }
+  }
+
+  console.log('');
+  if (migrated > 0) {
+    console.log(chalk.green(`  ✅ 迁移完成，共迁移 ${migrated} 个文件`));
+    console.log(chalk.dim('  旧文件保留在原位，确认无误后可手动删除'));
+  } else {
+    console.log(chalk.yellow('  没有需要迁移的文件'));
+  }
+}