sillyspec 3.7.11 → 3.7.13

package/packages/dashboard/src/components/DocPreview.vue

@@ -0,0 +1,43 @@
+<template>
+  <div class="h-full overflow-y-auto px-6 py-4">
+    <div v-if="!content && !loading" class="flex items-center justify-center h-full">
+      <p class="text-[12px] font-[JetBrains_Mono,monospace]" style="color: #525252;">选择一个文档查看内容</p>
+    </div>
+    <div v-else-if="loading" class="flex items-center justify-center h-full">
+      <p class="text-[12px] font-[JetBrains_Mono,monospace]" style="color: #525252;">加载中...</p>
+    </div>
+    <div v-else class="doc-preview" v-html="renderedContent"></div>
+  </div>
+</template>
+
+<script setup>
+import { computed } from 'vue'
+
+const props = defineProps({
+  content: { type: String, default: '' },
+  loading: { type: Boolean, default: false }
+})
+
+const renderedContent = computed(() => {
+  if (!props.content) return ''
+  return simpleMarkdown(props.content)
+})
+
+function simpleMarkdown(md) {
+  let html = md
+    .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+    .replace(/^### (.+)$/gm, '<h3 style="color:#FBBF24;font-size:14px;font-weight:600;margin:16px 0 8px;">$1</h3>')
+    .replace(/^## (.+)$/gm, '<h2 style="color:#E5E5E5;font-size:15px;font-weight:600;margin:20px 0 10px;">$1</h2>')
+    .replace(/^# (.+)$/gm, '<h1 style="color:#FBBF24;font-size:18px;font-weight:700;margin:0 0 16px;">$1</h1>')
+    .replace(/```(\w*)\n([\s\S]*?)```/g, '<pre style="background:#0A0A0B;border:1px solid #1F1F22;border-radius:6px;padding:12px;overflow-x:auto;font-size:12px;margin:8px 0;"><code>$2</code></pre>')
+    .replace(/`([^`]+)`/g, '<code style="background:#0A0A0B;padding:1px 4px;border-radius:3px;font-size:11px;">$1</code>')
+    .replace(/\*\*([^*]+)\*\*/g, '<strong style="color:#E5E5E5;">$1</strong>')
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" style="color:#FBBF24;">$1</a>')
+    .replace(/^- \[x\] (.+)$/gm, '<div style="color:#34D399;">☑ $1</div>')
+    .replace(/^- \[ \] (.+)$/gm, '<div style="color:#8B8B8E;">☐ $1</div>')
+    .replace(/^- (.+)$/gm, '<div style="padding-left:12px;color:#8B8B8E;">• $1</div>')
+    .replace(/\n\n/g, '<br/><br/>')
+    .replace(/\n/g, '<br/>')
+  return html
+}
+</script>

package/packages/dashboard/src/components/DocTree.vue

@@ -0,0 +1,36 @@
+<template>
+  <div class="flex flex-col h-full">
+    <div v-if="groups.length === 0" class="flex items-center justify-center h-full">
+      <p class="text-[12px] font-[JetBrains_Mono,monospace]" style="color: #525252;">暂无文档</p>
+    </div>
+    <div v-else class="overflow-y-auto px-4 py-3 space-y-4">
+      <div v-for="group in groups" :key="group.key">
+        <div class="text-[10px] font-semibold uppercase tracking-[0.15em] font-[JetBrains_Mono,monospace] mb-2" style="color: #525252;">
+          {{ group.label }}
+        </div>
+        <div class="space-y-0.5">
+          <button
+            v-for="file in group.files"
+            :key="file.path"
+            @click="$emit('select-file', file)"
+            class="w-full text-left px-2.5 py-1.5 rounded text-[12px] font-[JetBrains_Mono,monospace] transition-colors"
+            :style="{
+              color: selectedFile?.path === file.path ? '#FBBF24' : '#8B8B8E',
+              background: selectedFile?.path === file.path ? 'rgba(251,191,36,0.08)' : 'transparent'
+            }"
+          >
+            📄 {{ file.title }}
+          </button>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script setup>
+defineProps({
+  groups: { type: Array, default: () => [] },
+  selectedFile: { type: Object, default: null }
+})
+defineEmits(['select-file'])
+</script>

package/packages/dashboard/src/components/PipelineView.vue

@@ -1,19 +1,36 @@
 <template>
   <div class="flex flex-col h-full" style="background: #0E0E10;">
-    <!-- Header -->
-    <div class="px-6 pt-6 pb-4" style="border-bottom: 1px solid #1F1F22;">
-      <h2 class="text-[11px] font-semibold uppercase tracking-[0.2em] font-[JetBrains_Mono,monospace]" style="color: #525252;">
-        项目流水线
-      </h2>
-      <p v-if="project" class="text-[12px] mt-1.5 font-[JetBrains_Mono,monospace]" style="color: #8B8B8E;">
-        {{ project.name }} <span style="color: #2A2A2D;">/</span> <span style="color: #FBBF24;">{{ currentStage }}</span>
-      </p>
+    <!-- Header with Tabs -->
+    <div class="px-6 pt-4 pb-0" style="border-bottom: 1px solid #1F1F22;">
+      <div class="flex items-center gap-6">
+        <h2 class="text-[11px] font-semibold uppercase tracking-[0.2em] font-[JetBrains_Mono,monospace]" style="color: #525252;">
+          {{ project?.name || '项目' }}
+        </h2>
+        <div class="flex gap-1">
+          <button
+            @click="$emit('switch-tab', 'pipeline')"
+            class="px-3 py-1.5 text-[11px] font-[JetBrains_Mono,monospace] transition-colors rounded"
+            :style="{ color: activeTab === 'pipeline' ? '#FBBF24' : '#525252', background: activeTab === 'pipeline' ? 'rgba(251,191,36,0.08)' : 'transparent' }"
+          >流水线</button>
+          <button
+            @click="$emit('switch-tab', 'docs')"
+            class="px-3 py-1.5 text-[11px] font-[JetBrains_Mono,monospace] transition-colors rounded"
+            :style="{ color: activeTab === 'docs' ? '#FBBF24' : '#525252', background: activeTab === 'docs' ? 'rgba(251,191,36,0.08)' : 'transparent' }"
+          >文档</button>
+        </div>
+      </div>
     </div>
 
-    <!-- Stages -->
-    <div class="flex-1 overflow-y-auto px-6 py-5">
+    <!-- Pipeline Tab -->
+    <div v-if="activeTab === 'pipeline'" class="flex flex-col flex-1 overflow-hidden">
+      <div class="px-6 pt-4 pb-2">
+        <p v-if="project" class="text-[12px] font-[JetBrains_Mono,monospace]" style="color: #8B8B8E;">
+          <span style="color: #FBBF24;">{{ currentStage }}</span>
+        </p>
+      </div>
+
       <!-- Empty state -->
-      <div v-if="!project || !project.state" class="flex items-center justify-center h-full">
+      <div v-if="!project || !project.state" class="flex items-center justify-center flex-1">
         <div class="text-center">
           <div class="w-14 h-14 mx-auto mb-4 rounded-md flex items-center justify-center" style="border: 1px dashed #2A2A2D; transform: rotate(45deg);">
             <svg class="w-5 h-5" style="color: #525252; transform: rotate(-45deg);" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -24,7 +41,8 @@
         </div>
       </div>
 
-      <div v-else class="space-y-5">
+      <!-- Stages -->
+      <div v-else class="flex-1 overflow-y-auto px-6 pb-5 space-y-5">
         <PipelineStage name="brainstorm" title="头脑风暴" :steps="getStageSteps('brainstorm')" :status="getStageStatus('brainstorm')" :is-active="currentStage === 'brainstorm'" :active-step="activeStep" @select-step="handleSelectStep" />
         <div v-if="hasStage('plan')" class="flex items-center pl-[3px]"><div class="w-px h-4" style="background: #1F1F22;" /></div>
         <PipelineStage name="plan" title="规划" :steps="getStageSteps('plan')" :status="getStageStatus('plan')" :is-active="currentStage === 'plan'" :active-step="activeStep" @select-step="handleSelectStep" />
@@ -33,21 +51,31 @@
         <div v-if="hasStage('verify')" class="flex items-center pl-[3px]"><div class="w-px h-4" style="background: #1F1F22;" /></div>
         <PipelineStage name="verify" title="验证" :steps="getStageSteps('verify')" :status="getStageStatus('verify')" :is-active="currentStage === 'verify'" :active-step="activeStep" @select-step="handleSelectStep" />
       </div>
+
+      <!-- Activity Log -->
+      <div v-if="project?.state?.progress" style="border-top: 1px solid #1F1F22; background: rgba(10,10,11,0.6);">
+        <div class="px-6 py-2.5 flex items-center justify-between">
+          <div class="text-[9px] font-semibold uppercase tracking-[0.25em] font-[JetBrains_Mono,monospace]" style="color: #525252;">活动日志</div>
+          <div class="text-[10px] font-mono-log" style="color: #3A3A3D;">{{ activityLogs.length }}</div>
+        </div>
+        <div class="px-6 pb-3 space-y-0.5 max-h-32 overflow-y-auto">
+          <div v-for="(log, i) in activityLogs" :key="i" class="flex items-start gap-2.5 text-[11px] py-0.5">
+            <span class="w-10 font-mono-log flex-shrink-0" style="color: #3A3A3D;">{{ log.time }}</span>
+            <span :style="{ color: log.status === 'completed' ? '#34D399' : '#FBBF24' }">›</span>
+            <span style="color: #8B8B8E;">{{ log.description }}</span>
+          </div>
+          <div v-if="activityLogs.length === 0" class="text-[10px] py-1" style="color: #3A3A3D;">暂无活动记录</div>
+        </div>
+      </div>
     </div>
 
-    <!-- Activity Log -->
-    <div v-if="project?.state?.progress" style="border-top: 1px solid #1F1F22; background: rgba(10,10,11,0.6);">
-      <div class="px-6 py-2.5 flex items-center justify-between">
-        <div class="text-[9px] font-semibold uppercase tracking-[0.25em] font-[JetBrains_Mono,monospace]" style="color: #525252;">活动日志</div>
-        <div class="text-[10px] font-mono-log" style="color: #3A3A3D;">{{ activityLogs.length }}</div>
+    <!-- Docs Tab -->
+    <div v-if="activeTab === 'docs'" class="flex-1 flex overflow-hidden">
+      <div class="w-[200px] flex-shrink-0 overflow-hidden" style="border-right: 1px solid #1F1F22;">
+        <DocTree :groups="docs.groups" :selected-file="selectedDocFile" @select-file="$emit('select-doc-file', $event)" />
       </div>
-      <div class="px-6 pb-3 space-y-0.5 max-h-32 overflow-y-auto">
-        <div v-for="(log, i) in activityLogs" :key="i" class="flex items-start gap-2.5 text-[11px] py-0.5">
-          <span class="w-10 font-mono-log flex-shrink-0" style="color: #3A3A3D;">{{ log.time }}</span>
-          <span :style="{ color: log.status === 'completed' ? '#34D399' : '#FBBF24' }">›</span>
-          <span style="color: #8B8B8E;">{{ log.description }}</span>
-        </div>
-        <div v-if="activityLogs.length === 0" class="text-[10px] py-1" style="color: #3A3A3D;">暂无活动记录</div>
+      <div class="flex-1 overflow-hidden">
+        <DocPreview :content="docContent" :loading="docLoading" />
       </div>
     </div>
   </div>
@@ -56,13 +84,20 @@
 <script setup>
 import { computed } from 'vue'
 import PipelineStage from './PipelineStage.vue'
+import DocTree from './DocTree.vue'
+import DocPreview from './DocPreview.vue'
 
 const props = defineProps({
   project: { type: Object, default: null },
-  activeStep: { type: Object, default: null }
+  activeStep: { type: Object, default: null },
+  activeTab: { type: String, default: 'pipeline' },
+  docs: { type: Object, default: () => ({ groups: [] }) },
+  selectedDocFile: { type: Object, default: null },
+  docContent: { type: String, default: '' },
+  docLoading: { type: Boolean, default: false }
 })
 
-const emit = defineEmits(['select-step'])
+const emit = defineEmits(['select-step', 'switch-tab', 'select-doc-file'])
 
 const currentStage = computed(() => props.project?.state?.currentStage || 'unknown')
 const progress = computed(() => props.project?.state?.progress || {})

package/packages/dashboard/src/composables/useDashboard.js

@@ -13,7 +13,12 @@ export function useDashboard() {
     logs: [],
     isPanelOpen: true,
     executingProject: null,
-    isLoading: true
+    isLoading: true,
+    activeTab: 'pipeline',
+    docs: { groups: [] },
+    selectedDocFile: null,
+    docContent: '',
+    docLoading: false
   })
 
   /**
@@ -38,6 +43,8 @@ export function useDashboard() {
       state.activeProject = proj
       state.activeStep = null
       state.logs = []
+      state.selectedDocFile = null
+      state.docContent = ''
 
       // Load initial logs from project state if available
       if (proj.state?.progress?.currentLogs) {
@@ -168,6 +175,11 @@ export function useDashboard() {
     activeProjectPath,
     activeProjectStage,
     hasProjects,
-    activeProjectSteps
+    activeProjectSteps,
+  setActiveTab(tab) { state.activeTab = tab },
+  updateDocs(docs) { state.docs = docs },
+  selectDocFile(file) { state.selectedDocFile = file },
+  setDocContent(content) { state.docContent = content },
+  setDocLoading(loading) { state.docLoading = loading }
   }
 }

package/src/index.js

@@ -31,7 +31,8 @@ SillySpec CLI — 规范驱动开发工具包
     validate                  校验并修复进度文件
     reset [--stage X]         重置进度（全部或指定阶段）
     complete --stage X        归档已完成阶段
-  sillyspec dashboard          启动 Dashboard Web UI
+  sillyspec docs migrate       迁移旧文档到统一结构
+    sillyspec dashboard          启动 Dashboard Web UI
     [--port <number>]          指定端口（默认 3456）
     [--no-open]                不自动打开浏览器
 
@@ -134,6 +135,16 @@ async function main() {
       }
       break;
     }
+    case 'docs': {
+      const docsSubCmd = filteredArgs[1];
+      if (docsSubCmd === 'migrate') {
+        const { migrateDocs } = await import('./migrate.js');
+        migrateDocs(dir);
+      } else {
+        console.log('用法: sillyspec docs migrate');
+      }
+      break;
+    }
     case 'dashboard': {
       // Parse dashboard options
       let port = 3456;

package/src/init.js

@@ -1,5 +1,5 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
-import { join, resolve, dirname } from 'path';
+import { join, resolve, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import { checkbox, select, confirm, input } from '@inquirer/prompts';
@@ -81,13 +81,13 @@ 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/changes/<变更名>/\` 下
+- 各阶段产出文件位于 \`.sillyspec/docs/<project>/changes/<变更名>/\` 下
 - 详细流程参考模板文件：\`.sillyspec/.templates/\`（brainstorm.md, plan.md, execute.md 等）
 `;
 
@@ -203,14 +203,30 @@ function isTTY() {
 
 async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
   // 创建基础目录
-  // .sillyspec/codebase/    → scan
-  // .sillyspec/codebase/details/ → scan (deep)
-  // .sillyspec/changes/     → brainstorm/propose
-  // .sillyspec/changes/archive/ → archive
-  // .sillyspec/quicklog/    → quick
-  // .sillyspec/knowledge/   → archive (spec 沉淀)
+  // .sillyspec/projects/    → 项目注册表
+  // .sillyspec/docs/<name>/ → 统一文档中心
+  // .sillyspec/knowledge/   → 跨项目共享知识库
   // .sillyspec/.runtime/    → progress (gitignored)
-  // (plan 内容已合并到 tasks.md)
+
+  // 注册当前项目到 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`);
+  }
+
+  // 创建 docs/<projectName>/ 子目录结构
+  const docsBase = join(projectDir, '.sillyspec', 'docs', projectName);
+  for (const sub of ['scan', 'brainstorm', 'plan', 'changes', 'archive', 'quicklog']) {
+    const subDir = join(docsBase, sub);
+    mkdirSync(subDir, { recursive: true });
+    const gitkeepPath = join(subDir, '.gitkeep');
+    if (!existsSync(gitkeepPath)) writeFileSync(gitkeepPath, '');
+  }
+
+  // 兼容：保留旧的 codebase/ changes/ quicklog/ 目录（如果已存在不删除）
   if (isWorkspace) {
     mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
     mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });

package/src/migrate.js

@@ -0,0 +1,134 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, copyFileSync } from 'fs';
+import { join, resolve } from 'path';
+import chalk from 'chalk';
+
+/**
+ * Migrate old .sillyspec/ structure to unified 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 = projectDir.split('/').pop();
+  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/ → 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/ → docs/<project>/brainstorm/
+  const specsDir = join(sillyspecDir, 'specs');
+  if (existsSync(specsDir)) {
+    const targetDir = join(docsBase, 'brainstorm');
+    mkdirSync(targetDir, { recursive: true });
+    const files = readdirSync(specsDir).filter(f => f.endsWith('.md'));
+    for (const file of files) {
+      const src = join(specsDir, file);
+      const dest = join(targetDir, file);
+      if (!existsSync(dest)) {
+        copyFileSync(src, dest);
+        console.log(chalk.green('  ✅') + ` brainstorm/${file}`);
+        migrated++;
+      } else {
+        console.log(chalk.yellow('  ⏭️') + ` brainstorm/${file} (已存在)`);
+      }
+    }
+  }
+
+  // 3. changes/archive/ → 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/ → 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/ → 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('  没有需要迁移的文件'));
+  }
+}

package/templates/archive.md

@@ -16,7 +16,7 @@ $ARGUMENTS
 
 ### 1. 前置检查（门禁）
 
-读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
+读取 `.sillyspec/docs/<project>/changes/<change-name>/` 下所有必要文件，逐项检查：
 
 - [ ] **文件完整性：** 检查 `design.md` 是否存在，缺失则警告
 - [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
@@ -32,11 +32,11 @@ $ARGUMENTS
 - 包含的文件列表
 - 任务完成统计（✅ 已完成 / ⬜ 未完成）
 - 一句话总结本次变更
-- quicklog 修改记录（如有 `.sillyspec/changes/<change-name>/quicklog/` 目录）
+- quicklog 修改记录（如有 `.sillyspec/docs/<project>/changes/<change-name>/quicklog/` 目录）
 
 ### 3. Spec 沉淀
 
-将 `.sillyspec/changes/<change-name>/` 下的设计文档**复制到 `.sillyspec/knowledge/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
+将 `.sillyspec/docs/<project>/changes/<change-name>/` 下的设计文档**复制到 `.sillyspec/knowledge/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
 
 ### 4. 用户确认
 
@@ -74,7 +74,7 @@ $ARGUMENTS
 
 ```bash
 # 收集该变更相关的 git commit（按变更名过滤或按时间范围）
-git log --oneline --no-merges -- .sillyspec/changes/<change-name>/ 2>/dev/null
+git log --oneline --no-merges -- .sillyspec/docs/<project>/changes/<change-name>/ 2>/dev/null
 # 以及变更目录创建后的所有 commit
 git log --oneline --no-merges --since="<创建时间>" -- "*.ts" "*.js" "*.vue" "*.java" 2>/dev/null
 ```
@@ -101,7 +101,7 @@ git log --oneline --no-merges --since="<创建时间>" -- "*.ts" "*.js" "*.vue"
 
 ### 5. 执行归档
 
-- 目标路径：`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`
+- 目标路径：`.sillyspec/docs/<project>/archive/YYYY-MM-DD-<change-name>/`
 - **检查目标路径是否已存在**，存在则中止并报错，防止覆盖
 - 移动变更目录到归档路径
 

package/templates/brainstorm.md

@@ -18,6 +18,12 @@
 cat .sillyspec/STATE.md 2>/dev/null
 ```
 
+**确定当前项目名：**
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null
+```
+从 projects/ 目录确定当前项目名。后续设计文档输出到 `.sillyspec/docs/<project>/brainstorm/`。
+
 - phase 为 `brainstorm` 或无 STATE.md → ✅ 继续
 - 其他 phase → 提示用户当前阶段，建议先完成
 
@@ -71,19 +77,19 @@ $ARGUMENTS
 cat .sillyspec/config.yaml 2>/dev/null
 ```
 
-**工作区模式：** AskUserQuestion 选子项目，**cd 到子项目目录执行**，加载子项目上下文 + 共享规范 + 工作区概览，设计文档保存到子项目 `.sillyspec/changes/`。修改在子项目目录中暂存。
+**工作区模式：** AskUserQuestion 选子项目，**cd 到子项目目录执行**，加载子项目上下文 + 共享规范 + 工作区概览，设计文档保存到子项目 `.sillyspec/docs/<project>/changes/`。修改在子项目目录中暂存。
 
-**单项目模式：**
+**加载项目上下文：**
 ```bash
 cat .sillyspec/{PROJECT,REQUIREMENTS,ROADMAP}.md 2>/dev/null
-cat .sillyspec/codebase/{STRUCTURE,CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
-ls .sillyspec/changes/ 2>/dev/null | grep -v archive
+cat .sillyspec/docs/<project>/scan/{STRUCTURE,CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+ls .sillyspec/docs/<project>/changes/ 2>/dev/null
 ls .sillyspec/knowledge/ 2>/dev/null
 ```
 
 ### Step 2: 协作与复用检查
 
-- **同名变更：** `ls .sillyspec/changes/ | grep -v archive` — 有相关变更则提示避免冲突
+- **同名变更：** `ls .sillyspec/docs/<project>/changes/ | grep -v archive` — 有相关变更则提示避免冲突
 - **全局模板：** `ls ~/.sillyspec/templates/ 2>/dev/null` — 有匹配模板则建议复用
 
 无匹配则跳过，不输出。
@@ -111,20 +117,20 @@ ls .sillyspec/knowledge/ 2>/dev/null
 确认拆分后生成 MASTER.md：
 
 ```bash
-mkdir -p .sillyspec/changes/<变更名>/stages
+mkdir -p .sillyspec/docs/<project>/changes/<变更名>/stages
 ```
 
 `MASTER.md` 内容：概述、拆分计划表（阶段/范围/状态）、整体技术方向、阶段间依赖、原型分析摘要、经验记录。
 
 ```bash
-git add .sillyspec/changes/<变更名>/MASTER.md
+git add .sillyspec/docs/<project>/changes/<变更名>/MASTER.md
 ```
 
 💡 大模块计划已暂存。准备好后用 `/sillyspec:commit` 提交。
 
 提示用户：`/sillyspec:brainstorm <变更名>/stage-1`
 
-**子阶段 brainstorm：** 读取 MASTER.md + 前序阶段经验 + 对应原型，设计文档保存到 `.sillyspec/changes/<变更名>/stages/<stage-N>/`。
+**子阶段 brainstorm：** 读取 MASTER.md + 前序阶段经验 + 对应原型，设计文档保存到 `.sillyspec/docs/<project>/changes/<变更名>/stages/<stage-N>/`。
 
 ### Step 5: 对话式探索
 
@@ -147,7 +153,7 @@ git add .sillyspec/changes/<变更名>/MASTER.md
 
 ### Step 8: 写设计文档
 
-保存到 `.sillyspec/changes/<变更名>/design.md`：
+保存到 `.sillyspec/docs/<project>/brainstorm/<变更名>.md`：
 
 ```markdown
 # [Feature Name] 设计

package/templates/execute.md

@@ -18,7 +18,7 @@ cat .sillyspec/STATE.md 2>/dev/null
 有 STATE.md 且 phase 为 execute → 继续。无 STATE.md 或 phase 不对 → 检查是否有未完成的 tasks.md：
 
 ```bash
-ls .sillyspec/changes/*/tasks.md 2>/dev/null | xargs grep -l '\- \[ \]' 2>/dev/null
+ls .sillyspec/docs/<project>/changes/*/tasks.md 2>/dev/null | xargs grep -l '\- \[ \]' 2>/dev/null
 ```
 
 有未完成的 tasks.md → 继续。没有 → 提示 `/sillyspec:continue`。
@@ -38,10 +38,10 @@ cat .sillyspec/config.yaml 2>/dev/null
 
 **加载以下文件（主代理读取，后续注入子代理）：**
 ```bash
-PLAN=$(ls -t .sillyspec/changes/*/tasks.md 2>/dev/null | head -1); cat "$PLAN"
-LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
+PLAN=$(ls -t .sillyspec/docs/<project>/changes/*/tasks.md 2>/dev/null | head -1); cat "$PLAN"
+LATEST=$(ls -d .sillyspec/docs/<project>/changes/*/ | grep -v archive | tail -1)
 cat "$LATEST"/{tasks,design}.md 2>/dev/null
-cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+cat .sillyspec/docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
 cat .sillyspec/local.yaml 2>/dev/null
 ```
 
@@ -242,7 +242,7 @@ done
    - 先 cat 相关功能代码和页面组件，理解交互逻辑
    - 参考 prompt 中「测试模式参考」段的已有测试风格
    - **查阅 Playwright 用法：** 优先使用已安装的 playwright skill（SKILL.md），不要凭记忆写 API。未安装则通过 Context7 MCP 或 web search 查最新文档
-   - 有测试框架则编写测试文件，无框架则编写 `.sillyspec/changes/<变更名>/e2e-steps.md` 结构化测试步骤
+   - 有测试框架则编写测试文件，无框架则编写 `.sillyspec/docs/<project>/changes/<变更名>/e2e-steps.md` 结构化测试步骤
    - **写完必须立即跑一遍确认通过**，失败则修复后重跑，不要"写了就算完成"
 8. **Lint 校验：** 完成后对修改的文件运行 lint 工具（与 quick 相同规则），自动修复可修复的问题，不可修复的标注在报告中
 9. **暂存：** lint 通过后执行 git add -A（不要 commit，由用户通过 /sillyspec:commit 统一提交）
@@ -286,7 +286,7 @@ done
 所有任务完成后，主代理必须执行以下检查：
 
 ```bash
-cat .sillyspec/changes/*/tasks.md 2>/dev/null
+cat .sillyspec/docs/<project>/changes/*/tasks.md 2>/dev/null
 ```
 
 逐条验证：

package/templates/plan.md

@@ -29,9 +29,9 @@ cat .sillyspec/config.yaml 2>/dev/null
 
 **单项目模式：**
 ```bash
-LATEST=$(ls -d .sillyspec/changes/*/ | grep -v archive | tail -1)
+LATEST=$(ls -d .sillyspec/docs/<project>/changes/*/ | grep -v archive | tail -1)
 cat "$LATEST"/{design,tasks}.md 2>/dev/null
-cat .sillyspec/codebase/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
+cat .sillyspec/docs/<project>/scan/{CONVENTIONS,ARCHITECTURE}.md 2>/dev/null
 cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 ```
 
@@ -96,7 +96,7 @@ cat .sillyspec/REQUIREMENTS.md 2>/dev/null
 
 ### 4. 保存
 
-**直接覆盖** `.sillyspec/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。
+**直接覆盖** `.sillyspec/docs/<project>/changes/<变更名>/tasks.md`。不再生成单独的 plan.md 文件。
 
 ### 5. E2E 测试规划