sillyspec 2.4.4 → 2.6.0

package/src/init.js

@@ -2,6 +2,9 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from
 import { join, resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
+import { checkbox, select, confirm, input } from '@inquirer/prompts';
+import chalk from 'chalk';
+import ora from 'ora';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -49,6 +52,15 @@ const ARG_HINTS = {
 
 const VALID_TOOLS = ['claude', 'claude_skills', 'cursor', 'codex', 'opencode', 'openclaw'];
 
+const TOOL_LABELS = {
+  claude: 'Claude Code',
+  claude_skills: 'Claude Skills',
+  cursor: 'Cursor',
+  codex: 'Codex CLI',
+  opencode: 'OpenCode',
+  openclaw: 'OpenClaw',
+};
+
 // ── 适配器 ──
 
 function generateClaude(projectDir, name, desc, body, argHint) {
@@ -92,7 +104,6 @@ ${body}`
 }
 
 function generateCodex(projectDir, name, desc, body, argHint) {
-  // codex outputs to user home directory
   const outDir = join(homedir(), '.agents', 'skills', `sillyspec-${name}`);
   mkdirSync(outDir, { recursive: true });
   writeFileSync(join(outDir, 'SKILL.md'),
@@ -154,46 +165,26 @@ function detectTools(projectDir) {
   return found;
 }
 
-// ── 主命令 ──
-
-export function cmdInit(projectDir, options = {}) {
-  const { tool, workspace } = options;
+// ── TTY 工具函数 ──
 
-  // 确定要安装的工具
-  let tools;
-  if (tool) {
-    if (!VALID_TOOLS.includes(tool)) {
-      console.error(`❌ 未知工具: ${tool}`);
-      console.error(`支持的工具: ${VALID_TOOLS.join(', ')}`);
-      process.exit(1);
-    }
-    tools = [tool];
-  } else {
-    tools = detectTools(projectDir);
-  }
+function isTTY() {
+  return process.stdin.isTTY && process.stdout.isTTY;
+}
 
-  console.log('🤪 SillySpec v2.2 — 规范驱动开发');
-  console.log('====================================');
-  console.log('');
-  console.log(`📦 安装工具: ${tools.join(', ')}`);
-  if (workspace) console.log('📦 工作区模式');
-  console.log('');
+// ── 核心安装逻辑 ──
 
+async function doInstall(projectDir, tools, isWorkspace, subprojects = []) {
   // 创建基础目录
-  const dirs = [
-    '.sillyspec/codebase',
-    '.sillyspec/changes/archive',
-    '.sillyspec/plans',
-    '.sillyspec/specs',
-    '.sillyspec/phases',
-  ];
-  if (workspace) {
-    dirs.push('.sillyspec/shared', '.sillyspec/workspace');
-  }
-  for (const d of dirs) {
-    mkdirSync(join(projectDir, d), { recursive: true });
+  // 不预创建子目录，由各命令按需创建
+  // .sillyspec/codebase/    → scan
+  // .sillyspec/changes/     → brainstorm/propose
+  // .sillyspec/changes/archive/ → archive
+  // .sillyspec/plans/        → plan
+  // .sillyspec/specs/        → propose
+  if (isWorkspace) {
+    mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
+    mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });
   }
-  mkdirSync(join(homedir(), '.sillyspec', 'templates'), { recursive: true });
 
   // .gitignore
   const gitignorePath = join(projectDir, '.gitignore');
@@ -201,69 +192,243 @@ export function cmdInit(projectDir, options = {}) {
     writeFileSync(gitignorePath, '.sillyspec/STATE.md\n');
   }
 
-  // 为每个工具生成文件
+  // 生成文件
   const templateFiles = readdirSync(TEMPLATE_DIR).filter(f => f.endsWith('.md'));
   let count = 0;
 
-  for (const toolName of tools) {
-    console.log(`🔧 安装 ${toolName}...`);
-    const gen = GENERATORS[toolName];
-    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);
-      count++;
+  for (let i = 0; i < tools.length; i++) {
+    const toolName = tools[i];
+    const label = TOOL_LABELS[toolName] || toolName;
+    const spinner = ora(`安装 ${label}... (${i + 1}/${tools.length})`).start();
+    try {
+      const gen = GENERATORS[toolName];
+      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);
+        count++;
+      }
+      spinner.succeed(`${label} 完成`);
+    } catch (err) {
+      spinner.fail(`${label} 失败: ${err.message}`);
+      throw err;
     }
-    console.log(`  ✅ ${toolName} 完成`);
   }
 
-  console.log('');
-  console.log(`📄 ${count} 个命令已安装`);
-
   // 工作区配置
-  if (workspace) {
+  if (isWorkspace) {
     const configPath = join(projectDir, '.sillyspec', 'config.yaml');
     if (!existsSync(configPath)) {
+      let projectsYaml = '';
+      if (subprojects.length > 0) {
+        projectsYaml = subprojects.map(p =>
+          `  ${p.name}:\n    path: ${p.path}\n    role: ${p.role || p.name}`
+        ).join('\n');
+      }
+
       writeFileSync(configPath,
 `# SillySpec 工作区配置
 # 修改此文件后运行 /sillyspec:workspace 更新
 
-projects: {}
-  # 示例：
-  # frontend:
-  #   path: ./frontend
-  #   role: 前端 - Vue3 + TypeScript
-  # backend:
-  #   path: ./backend
-  #   role: 后端 - Node.js + PostgreSQL
+projects:
+${projectsYaml || '  # 运行 /sillyspec:workspace add 添加子项目'}
 
 shared: []
 `
       );
-      console.log('📄 .sillyspec/config.yaml → 工作区配置 ✓');
     }
   }
 
+  return count;
+}
+
+// ── 安装完成总结 ──
+
+function showSummary(version, tools, isWorkspace, count) {
+  const toolLabels = tools.map(t => TOOL_LABELS[t] || t);
+  const mode = isWorkspace ? '多项目工作区' : '单项目';
+
+  console.log('');
+  console.log(chalk.green('  ═══════════════════════════════════════'));
+  console.log(chalk.green(`  ✅  SillySpec v${version} 安装完成！`));
+  console.log(chalk.green('  ═══════════════════════════════════════'));
   console.log('');
-  console.log('=====================================');
-  if (workspace) {
-    console.log('✅ SillySpec v2.2 安装完成！（工作区模式）');
+  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('');
+}
+
+// ── 读取版本号 ──
+
+function getVersion() {
+  try {
+    const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf8'));
+    return pkg.version;
+  } catch {
+    return '?.?.?';
+  }
+}
+
+// ── 主命令 ──
+
+export async function cmdInit(projectDir, options = {}) {
+  const { tool, workspace } = options;
+  const version = getVersion();
+
+  // CLI 参数模式（非交互）
+  if (tool) {
+    if (!VALID_TOOLS.includes(tool)) {
+      console.error(`❌ 未知工具: ${tool}`);
+      console.error(`支持的工具: ${VALID_TOOLS.join(', ')}`);
+      process.exit(1);
+    }
+
+    console.log(chalk.cyan(`🤪 SillySpec v${version}`));
+    console.log(chalk.cyan(`📦 安装工具: ${tool}`));
     console.log('');
-    console.log(`已安装工具: ${tools.join(', ')}`);
+
+    const count = await doInstall(projectDir, [tool], workspace);
+    showSummary(version, [tool], workspace, count);
+    return;
+  }
+
+  // 非交互模式
+  if (!isTTY()) {
+    const tools = detectTools(projectDir);
+    console.log(chalk.cyan(`🤪 SillySpec v${version} (非交互模式)`));
+    console.log(chalk.cyan(`📦 自动检测工具: ${tools.join(', ')}`));
     console.log('');
-    console.log('工作区命令：');
-    console.log('  /sillyspec:workspace add    — 添加子项目');
-    console.log('  /sillyspec:workspace status — 查看工作区状态');
-  } else {
-    console.log('✅ SillySpec v2.2 安装完成！');
+    const count = await doInstall(projectDir, tools, workspace);
+    showSummary(version, tools, workspace, count);
+    return;
+  }
+
+  // ── 交互式引导 ──
+
+  // 欢迎画面
+  console.log('');
+  console.log(chalk.cyan('🤪 SillySpec v' + version + ' — 规范驱动开发'));
+  console.log(chalk.cyan('  ===================================='));
+  console.log('');
+  console.log('  让 AI 像高级工程师一样工作：');
+  console.log('  先思考、先规划、先验证，再写代码。');
+  console.log('');
+  console.log(chalk.gray('  支持的 AI 工具：'));
+  console.log(chalk.gray('    Claude Code · Claude Skills · Cursor · Codex CLI · OpenCode · OpenClaw'));
+  console.log('');
+
+  await confirm({ message: '按回车开始设置...', default: true });
+
+  // 工具多选
+  const detected = detectTools(projectDir);
+
+  const toolChoices = VALID_TOOLS.map(v => ({
+    name: `${TOOL_LABELS[v]}${v === 'claude' ? ' (slash commands)' : v === 'claude_skills' ? ' (skills 目录)' : ''}`,
+    value: v,
+    checked: detected.includes(v),
+  }));
+
+  const selectedTools = await checkbox({
+    message: '选择要安装的 AI 工具',
+    choices: toolChoices,
+    validate: (answer) => answer.length > 0 || '至少选择一个工具',
+  });
+
+  // 工作区模式
+  const isWorkspace = await select({
+    message: '选择项目模式',
+    choices: [
+      { name: '单项目模式', value: 'false' },
+      { name: '多项目工作区', value: 'true' },
+    ],
+  }) === 'true';
+
+  // 工作区子项目引导
+  if (isWorkspace) {
     console.log('');
-    console.log(`已安装工具: ${tools.join(', ')}`);
+    console.log(chalk.yellow('📋 工作区模式 — 添加子项目'));
+    console.log(chalk.dim('   子项目是工作区中的独立项目目录（如 frontend/、backend/）'));
     console.log('');
-    console.log('入口选择：');
-    console.log('  绿地项目：/sillyspec:init');
-    console.log('  棕地项目：/sillyspec:scan');
-    console.log('  自由思考：/sillyspec:explore "你的想法"');
+
+    const addMore = await confirm({ message: '现在添加子项目？', default: true });
+    if (addMore) {
+      // 读取当前目录下的子目录作为建议
+      let suggestions = [];
+      try {
+        const entries = readdirSync(projectDir, { withFileTypes: true });
+        suggestions = entries
+          .filter(e => e.isDirectory() && !e.name.startsWith('.') && e.name !== 'node_modules')
+          .map(e => e.name)
+          .sort();
+      } catch {}
+
+      if (suggestions.length > 0) {
+        console.log('');
+        console.log(chalk.dim(`   检测到以下目录：${suggestions.join(', ')}`));
+        console.log('');
+      }
+
+      const subprojects = [];
+      let adding = true;
+
+      while (adding) {
+        const name = await input({
+          message: '子项目名称（如 frontend）',
+          default: suggestions.find(s => !subprojects.find(p => p.name === s)) || '',
+        });
+
+        if (!name.trim()) {
+          adding = false;
+          break;
+        }
+
+        const pathHint = suggestions.includes(name.trim()) ? `./${name.trim()}` : '';
+        const subPath = await input({
+          message: `子项目目录路径`,
+          default: pathHint,
+        });
+
+        const role = await input({
+          message: '子项目描述（如 前端 - Vue3 + TypeScript）',
+          default: '',
+        });
+
+        subprojects.push({
+          name: name.trim(),
+          path: subPath.trim() || `./${name.trim()}`,
+          role: role.trim(),
+        });
+
+        // 从建议中移除已添加的
+        const idx = suggestions.indexOf(name.trim());
+        if (idx >= 0) suggestions.splice(idx, 1);
+
+        const again = await confirm({ message: '继续添加子项目？', default: subprojects.length < suggestions.length });
+        if (!again) adding = false;
+      }
+
+      // 保存子项目到临时变量，安装后写入 config.yaml
+      // 存到全局变量让 doInstall 后使用
+      global.__sillyspec_subprojects = subprojects;
+    }
   }
+
+  // 安装
+  console.log('');
+  const count = await doInstall(projectDir, selectedTools, isWorkspace, global.__sillyspec_subprojects || []);
+
+  // 总结
+  showSummary(version, selectedTools, isWorkspace, count);
 }

package/templates/archive.md

@@ -1,69 +1,62 @@
 ## 交互规范
-
 **当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
 
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
-你现在是 SillySpec 的归档器。
+## 核心约束（必须遵守）
+- ❌ 未经验证就归档（必须先确认验证通过）
+- ❌ 未勾选的 checkbox 未告知用户就归档
+- ❌ 归档后留下活跃变更的残留状态
+- ❌ 覆盖已存在的归档目录
 
 ## 变更名称
 $ARGUMENTS
 
+---
+
 ## 流程
 
-### 1. 确认验证通过
+### 1. 前置检查（门禁）
+
+读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
 
-检查是否执行过验证。如果没有 → 提示先运行 `/sillyspec:verify`。
+- [ ] **verify 状态：** 检查是否有验证记录，无则提示先执行 `/sillyspec:verify`
+- [ ] **文件完整性：** 检查 `proposal.md` 和 `design.md` 是否存在，缺失则警告
+- [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
+  - ① 继续归档（未完成任务将被标记完成）
+  - ② 取消，回去完成任务
 
-### 2. 归档
+> 任一门禁不通过且用户选择取消 → 终止流程。
 
-### 3. 确认归档
+### 2. 展示归档清单
 
-在移动文件之前，展示即将归档的内容：
+展示即将归档的内容摘要：
 - 变更目录名
 - 包含的文件列表
-- 生成总结
+- 任务完成统计（✅ 已完成 / ⬜ 未完成）
+- 一句话总结本次变更
 
-**归档前确认：**
+### 3. Spec 沉淀
 
-请确认是否执行归档：
-1. 确认归档
-2. 取消
+将 `.sillyspec/changes/<change-name>/specs/` 下的设计文档**复制到 `.sillyspec/specs/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
 
-将 `.sillyspec/changes/<change-name>/` 移动到 `.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`。
+### 4. 用户确认
 
-### 3. 更新 tasks.md
+用 AskUserQuestion 让用户确认：
+- ① 确认归档
+- ② 取消
 
-确保所有 checkbox 都已勾选。如有遗漏 → 打勾。
+### 5. 执行归档
 
-### 4. 更新路线图（如存在）
+- 目标路径：`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`
+- **检查目标路径是否已存在**，存在则中止并报错，防止覆盖
+- 移动变更目录到归档路径
 
-如果 `.sillyspec/ROADMAP.md` 存在，标记对应 Phase 为已完成。
+### 6. 归档后更新
 
-### 5. Git 提交
-
-```bash
-git add .sillyspec/
-git commit -m "docs: archive sillyspec change <change-name>"
-```
+- **tasks.md：** 确保所有 checkbox 都已勾选 `[x]`
+- **ROADMAP.md**（如存在）：标记对应 Phase 已完成
+- **STATE.md：** 清除当前变更信息，历史记录追加归档完成
+- **Git 提交：** `git add .sillyspec/ && git commit -m "docs: archive sillyspec change <change-name>"`
 
 ### 最后说：
 
-> ✅ 变更 `<change-name>` 已归档。
->
-> 累积规范：
-> - `.sillyspec/changes/archive/` — X 个已归档变更
-> - `.sillyspec/specs/` — X 份设计文档
-> - `.sillyspec/plans/` — X 份实现计划
->
-> 继续下一个：`/sillyspec:brainstorm "新想法"`
-
-### 更新 STATE.md
-
-archive 完成后，**必须自动更新** `.sillyspec/STATE.md`：
-
-- 清除当前变更信息（归档后不再活跃）
-- 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
-- 历史记录追加时间 + 归档完成
-- 下一步改为 `/sillyspec:brainstorm "新想法"` 或留空
+> ✅ 变更 `<change-name>` 已归档到 `archive/YYYY-MM-DD-<change-name>/`。继续：`/sillyspec:brainstorm "新想法"`