sillyspec 3.9.0 → 3.9.1

package/src/step.js

@@ -1,543 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync, unlinkSync, statSync, rmSync } from 'fs';
-import { join, resolve } from 'path';
-import { randomBytes } from 'crypto';
-
-// ── 简易 YAML 工具 ──
-
-function parseYaml(text) {
-  const result = {};
-  for (const line of text.split('\n')) {
-    const trimmed = line.trimStart();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const m = trimmed.match(/^(\w[\w-]*):\s*(.*)/);
-    if (m) {
-      const key = m[1];
-      const val = m[2].trim();
-      if (val === '' || val === '[]') result[key] = val === '[]' ? [] : '';
-      else if (val.startsWith('[')) result[key] = val.slice(1, -1).split(',').map(s => s.trim()).filter(Boolean);
-      else if (/^\d+$/.test(val)) result[key] = parseInt(val, 10);
-      else result[key] = val;
-    }
-  }
-  return result;
-}
-
-function parseManifest(text) {
-  const lines = text.split('\n');
-  const result = { phase: '', description: '', requires: [], steps: [] };
-  let inSteps = false;
-  let currentStep = null;
-
-  for (const line of lines) {
-    const trimmed = line.trimStart();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-
-    if (inSteps && trimmed.startsWith('- file:')) {
-      if (currentStep) result.steps.push(currentStep);
-      currentStep = { file: '', name: '' };
-      currentStep.file = trimmed.match(/^- file:\s*(.+)/)?.[1]?.trim() || '';
-      continue;
-    }
-    if (inSteps && currentStep && trimmed.startsWith('name:')) {
-      currentStep.name = trimmed.match(/^name:\s*(.+)/)?.[1]?.trim() || '';
-      continue;
-    }
-    if (inSteps && !trimmed.startsWith('-') && !trimmed.startsWith(' ')) {
-      if (currentStep) result.steps.push(currentStep);
-      currentStep = null;
-      inSteps = false;
-    }
-
-    if (trimmed.startsWith('phase:')) result.phase = trimmed.match(/^phase:\s*(.+)/)?.[1]?.trim() || '';
-    else if (trimmed.startsWith('description:')) result.description = trimmed.match(/^description:\s*(.+)/)?.[1]?.trim() || '';
-    else if (trimmed.startsWith('requires:')) {
-      const m = trimmed.match(/^requires:\s*\[?(.*?)\]?$/);
-      result.requires = m ? m[1].split(',').map(s => s.trim()).filter(Boolean) : [];
-    }
-    else if (trimmed.startsWith('steps:')) inSteps = true;
-  }
-  if (currentStep) result.steps.push(currentStep);
-  return result;
-}
-
-function toYaml(obj) {
-  return Object.entries(obj).map(([k, v]) => {
-    if (Array.isArray(v)) return `${k}: []`;
-    return `${k}: ${v}`;
-  }).join('\n') + '\n';
-}
-
-// ── 文件操作 ──
-
-function atomicWrite(filePath, content) {
-  const tmpPath = filePath + '.tmp.' + process.pid;
-  writeFileSync(tmpPath, content, 'utf8');
-  writeFileSync(filePath, content, 'utf8');
-  try { unlinkSync(tmpPath); } catch {}
-}
-
-function findSillyspecDir(dir) {
-  const p = join(dir, '.sillyspec');
-  if (existsSync(p)) return p;
-  return null;
-}
-
-function getAvailablePhases(sillyDir) {
-  const stepsDir = join(sillyDir, 'steps');
-  if (!existsSync(stepsDir)) return [];
-  return readdirSync(stepsDir, { withFileTypes: true })
-    .filter(d => d.isDirectory() && existsSync(join(stepsDir, d.name, 'manifest.yaml')))
-    .map(d => d.name);
-}
-
-// ── 会话管理 ──
-
-function getSessionId(dir, explicitId) {
-  if (explicitId) return explicitId;
-  if (process.env.SILLYSPEC_SESSION) return process.env.SILLYSPEC_SESSION;
-  const markerFile = join(dir, '.sillyspec', '.session');
-  if (existsSync(markerFile)) return readFileSync(markerFile, 'utf8').trim();
-  // 生成新 ID 并原子写入
-  const id = randomBytes(4).toString('hex');
-  const sillyDir = join(dir, '.sillyspec');
-  try {
-    writeFileSync(markerFile, id + '\n', { flag: 'wx' });
-  } catch {
-    // 已存在，读取
-    return readFileSync(markerFile, 'utf8').trim();
-  }
-  return id;
-}
-
-function getProgress(sillyDir, sessionId) {
-  const pFile = join(sillyDir, 'sessions', sessionId, 'progress.yaml');
-  if (!existsSync(pFile)) return {};
-  return parseYaml(readFileSync(pFile, 'utf8'));
-}
-
-function saveProgress(sillyDir, sessionId, progress) {
-  const pDir = join(sillyDir, 'sessions', sessionId);
-  mkdirSync(pDir, { recursive: true });
-  atomicWrite(join(pDir, 'progress.yaml'), toYaml(progress));
-}
-
-function updateLastActive(sillyDir, sessionId) {
-  const pDir = join(sillyDir, 'sessions', sessionId);
-  mkdirSync(pDir, { recursive: true });
-  atomicWrite(join(pDir, 'last-active'), Date.now().toString());
-}
-
-function getLastActive(sillyDir, sessionId) {
-  const f = join(sillyDir, 'sessions', sessionId, 'last-active');
-  if (!existsSync(f)) return null;
-  try { return parseInt(readFileSync(f, 'utf8').trim(), 10); } catch { return null; }
-}
-
-// ── 时间格式化 ──
-
-function timeAgo(ts) {
-  if (!ts) return '未知';
-  const diff = Date.now() - ts;
-  const mins = Math.floor(diff / 60000);
-  if (mins < 60) return `${mins}m ago`;
-  const hours = Math.floor(mins / 60);
-  if (hours < 24) return `${hours}h ago`;
-  const days = Math.floor(hours / 24);
-  return `${days}d ago`;
-}
-
-// ── 核心逻辑 ──
-
-function getManifest(sillyDir, phase) {
-  const mFile = join(sillyDir, 'steps', phase, 'manifest.yaml');
-  if (!existsSync(mFile)) return null;
-  return parseManifest(readFileSync(mFile, 'utf8'));
-}
-
-function checkPhaseComplete(sillyDir, phase, progress) {
-  const m = getManifest(sillyDir, phase);
-  if (!m) return false;
-  const p = parseInt(progress[phase], 10) || 0;
-  return p >= m.steps.length;
-}
-
-function formatNextOutput(manifest, stepNum, stepFile) {
-  return `---\nphase: ${manifest.phase}\nstep: ${stepNum}/${manifest.steps.length}\nname: ${manifest.steps[stepNum - 1].name}\n---\n\n${stepFile}\n\n---\n完成后请执行: sillyspec step ${manifest.phase} --next\n`;
-}
-
-function handleNext(dir, sillyDir, phase, sessionId, json) {
-  const manifest = getManifest(sillyDir, phase);
-  if (!manifest) {
-    return { ok: false, error: `❌ 阶段 "${phase}" 不存在`, available: getAvailablePhases(sillyDir) };
-  }
-
-  // 前置依赖提醒
-  for (const req of manifest.requires) {
-    const progress = getProgress(sillyDir, sessionId);
-    if (!checkPhaseComplete(sillyDir, req, progress)) {
-      console.log(`⚠️  建议先完成 ${req} 阶段`);
-    }
-  }
-
-  const progress = getProgress(sillyDir, sessionId);
-  let p = parseInt(progress[phase], 10);
-  if (isNaN(p) || p < 0) {
-    console.log(`⚠️  progress 值非法，已重置为 0`);
-    p = 0;
-    progress[phase] = 0;
-    saveProgress(sillyDir, sessionId, progress);
-  }
-
-  const total = manifest.steps.length;
-
-  if (p >= total) {
-    if (json) return { ok: true, done: true, phase, total };
-    console.log(`DONE ✅`);
-    return { ok: true, done: true, phase, total };
-  }
-
-  // 确定要分发的步骤
-  let nextStep;
-  if (p === 0) {
-    nextStep = 1;
-  } else {
-    nextStep = p + 1;
-  }
-
-  if (nextStep > total) {
-    if (json) return { ok: true, done: true, phase, total };
-    console.log(`DONE ✅`);
-    return { ok: true, done: true, phase, total };
-  }
-
-  // 标记进度
-  progress[phase] = nextStep;
-  saveProgress(sillyDir, sessionId, progress);
-  updateLastActive(sillyDir, sessionId);
-
-  // 读取步骤文件
-  const stepFile = join(sillyDir, 'steps', phase, manifest.steps[nextStep - 1].file);
-  if (!existsSync(stepFile)) {
-    return { ok: false, error: `❌ 步骤文件不存在: ${manifest.steps[nextStep - 1].file}` };
-  }
-  const content = readFileSync(stepFile, 'utf8');
-
-  if (json) {
-    return { ok: true, done: false, phase, step: nextStep, total, name: manifest.steps[nextStep - 1].name, content };
-  }
-
-  console.log(formatNextOutput(manifest, nextStep, content));
-  return { ok: true, done: false, phase, step: nextStep, total, name: manifest.steps[nextStep - 1].name };
-}
-
-function handleJump(dir, sillyDir, phase, target, sessionId, json) {
-  const manifest = getManifest(sillyDir, phase);
-  if (!manifest) {
-    return { ok: false, error: `❌ 阶段 "${phase}" 不存在`, available: getAvailablePhases(sillyDir) };
-  }
-
-  const total = manifest.steps.length;
-  if (target < 1 || target > total) {
-    return { ok: false, error: `❌ 步骤 ${target} 越界（有效范围: 1-${total}）` };
-  }
-
-  const progress = getProgress(sillyDir, sessionId);
-  progress[phase] = target;
-  saveProgress(sillyDir, sessionId, progress);
-  updateLastActive(sillyDir, sessionId);
-
-  const stepFile = join(sillyDir, 'steps', phase, manifest.steps[target - 1].file);
-  if (!existsSync(stepFile)) {
-    return { ok: false, error: `❌ 步骤文件不存在: ${manifest.steps[target - 1].file}` };
-  }
-  const content = readFileSync(stepFile, 'utf8');
-
-  if (json) {
-    return { ok: true, phase, step: target, total, name: manifest.steps[target - 1].name, content };
-  }
-
-  console.log(formatNextOutput(manifest, target, content));
-  return { ok: true, phase, step: target, total, name: manifest.steps[target - 1].name };
-}
-
-function handleStatus(sillyDir, sessionId, json) {
-  const phases = getAvailablePhases(sillyDir);
-  const progress = getProgress(sillyDir, sessionId);
-  const results = [];
-
-  for (const phase of phases) {
-    const manifest = getManifest(sillyDir, phase);
-    const p = parseInt(progress[phase], 10) || 0;
-    const total = manifest ? manifest.steps.length : 0;
-    const name = manifest ? (manifest.steps[Math.max(0, p - 1)]?.name || '') : '';
-    results.push({ phase, progress: p, total, name });
-  }
-
-  if (json) return { ok: true, phases: results };
-
-  for (const r of results) {
-    if (r.total === 0) {
-      console.log(`${r.phase}: 未开始`);
-    } else if (r.progress === 0) {
-      console.log(`${r.phase}: 未开始`);
-    } else if (r.progress >= r.total) {
-      console.log(`${r.phase}: 已完成 ✅`);
-    } else {
-      console.log(`${r.phase}: 步骤 ${r.progress}/${r.total}（${r.name}）`);
-    }
-  }
-  return { ok: true, phases: results };
-}
-
-function handleList(sillyDir, phase, sessionId, json) {
-  const manifest = getManifest(sillyDir, phase);
-  if (!manifest) {
-    return { ok: false, error: `❌ 阶段 "${phase}" 不存在`, available: getAvailablePhases(sillyDir) };
-  }
-
-  const progress = getProgress(sillyDir, sessionId);
-  const current = parseInt(progress[phase], 10) || 0;
-  const results = [];
-
-  if (!json) console.log(`# ${phase} — ${manifest.description}`);
-
-  for (let i = 0; i < manifest.steps.length; i++) {
-    const num = i + 1;
-    const s = manifest.steps[i];
-    let status = '';
-    if (num < current) status = '✅';
-    else if (num === current) status = '← 当前';
-    results.push({ step: num, name: s.name, status: num < current ? 'done' : num === current ? 'current' : 'pending' });
-
-    if (!json) {
-      console.log(`  ${num}. ${s.name.padEnd(16)}${status}`);
-    }
-  }
-  return { ok: true, phase, description: manifest.description, steps: results };
-}
-
-function handleSessions(sillyDir, json) {
-  const sessionsDir = join(sillyDir, 'sessions');
-  if (!existsSync(sessionsDir)) {
-    if (json) return { ok: true, sessions: [] };
-    console.log('暂无会话');
-    return { ok: true, sessions: [] };
-  }
-
-  const dirs = readdirSync(sessionsDir, { withFileTypes: true })
-    .filter(d => d.isDirectory())
-    .map(d => d.name);
-
-  if (dirs.length === 0) {
-    if (json) return { ok: true, sessions: [] };
-    console.log('暂无会话');
-    return { ok: true, sessions: [] };
-  }
-
-  const phases = getAvailablePhases(sillyDir);
-  const results = [];
-
-  for (const sid of dirs) {
-    const progress = getProgress(sillyDir, sid);
-    const last = getLastActive(sillyDir, sid);
-    const phaseSummaries = phases.map(ph => {
-      const manifest = getManifest(sillyDir, ph);
-      const p = parseInt(progress[ph], 10) || 0;
-      const total = manifest ? manifest.steps.length : 0;
-      return { phase: ph, progress: p, total };
-    });
-    const allDone = phaseSummaries.every(ps => ps.total > 0 && ps.progress >= ps.total);
-    results.push({ sessionId: sid, phases: phaseSummaries, lastActive: last, allDone });
-  }
-
-  if (json) return { ok: true, sessions: results };
-
-  for (const r of results) {
-    const phaseStr = r.phases.map(ps => `${ps.phase} ${ps.progress}/${ps.total}`).join('  ');
-    const done = r.allDone ? ' ✅' : '';
-    console.log(`${r.sessionId}  ${phaseStr}  (last: ${timeAgo(r.lastActive)})${done}`);
-  }
-  return { ok: true, sessions: results };
-}
-
-function handleClean(sillyDir, options, json) {
-  const { allDone, olderThan, sessionId: targetSession } = options;
-  const sessionsDir = join(sillyDir, 'sessions');
-  if (!existsSync(sessionsDir)) {
-    if (json) return { ok: true, cleaned: [], dryRun: !targetSession && !allDone && !olderThan };
-    console.log('暂无会话');
-    return { ok: true, cleaned: [], dryRun: true };
-  }
-
-  const dirs = readdirSync(sessionsDir, { withFileTypes: true })
-    .filter(d => d.isDirectory())
-    .map(d => d.name);
-
-  const phases = getAvailablePhases(sillyDir);
-  const toClean = [];
-
-  for (const sid of dirs) {
-    const progress = getProgress(sillyDir, sid);
-    const last = getLastActive(sillyDir, sid);
-    const isAllDone = phases.every(ph => {
-      const manifest = getManifest(sillyDir, ph);
-      const p = parseInt(progress[ph], 10) || 0;
-      return manifest && p >= manifest.steps.length;
-    });
-    const ageMs = last ? Date.now() - last : Infinity;
-    const ageDays = ageMs / (1000 * 60 * 60 * 24);
-
-    let match = false;
-    if (targetSession) match = sid === targetSession;
-    else if (allDone) match = true;
-    else if (olderThan !== null) match = ageDays >= olderThan;
-
-    toClean.push({ sessionId: sid, allDone: isAllDone, lastActive: last, ageDays, match });
-  }
-
-  // 无参数 = dry-run
-  const isDryRun = !targetSession && !allDone && olderThan === null;
-
-  if (isDryRun) {
-    if (json) return { ok: true, dryRun: true, sessions: toClean.map(s => ({ sessionId: s.sessionId, allDone: s.allDone, lastActive: s.lastActive, ageDays: Math.floor(s.ageDays) })) };
-    console.log('📋 会话列表（dry-run，未执行清理）：');
-    console.log('');
-    for (const s of toClean) {
-      const status = s.allDone ? '✅ 全部完成' : `进行中（${Math.floor(s.ageDays)}天前活跃）`;
-      console.log(`  ${s.sessionId}  ${status}  (last: ${timeAgo(s.lastActive)})`);
-    }
-    return { ok: true, dryRun: true, sessions: toClean };
-  }
-
-  // 执行清理
-  const cleaned = toClean.filter(s => s.match);
-  if (cleaned.length === 0) {
-    if (json) return { ok: true, cleaned: [] };
-    console.log('没有匹配的会话需要清理');
-    return { ok: true, cleaned: [] };
-  }
-
-  for (const s of cleaned) {
-    rmSync(join(sessionsDir, s.sessionId), { recursive: true });
-  }
-
-  if (json) return { ok: true, cleaned: cleaned.map(s => s.sessionId) };
-  console.log(`🗑️  已清理 ${cleaned.length} 个会话:`);
-  for (const s of cleaned) console.log(`  - ${s.sessionId}`);
-  return { ok: true, cleaned: cleaned.map(s => s.sessionId) };
-}
-
-// ── 主入口 ──
-
-export async function cmdStep(dir, args = []) {
-  const sillyDir = findSillyspecDir(dir);
-  if (!sillyDir) {
-    console.log('❌ 未找到 .sillyspec/ 目录，请先执行 sillyspec init');
-    process.exit(1);
-  }
-
-  // 解析参数
-  let json = false;
-  let sessionId = null;
-  let action = null;
-  let phase = null;
-  let jumpTarget = null;
-  let cleanAllDone = false;
-  let cleanOlderThan = null;
-  let cleanSession = null;
-
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === '--json') json = true;
-    else if (a === '--session' && args[i + 1]) { sessionId = args[++i]; }
-    else if (a === '--next') action = 'next';
-    else if (a === '--status') action = 'status';
-    else if (a === '--list') action = 'list';
-    else if (a === '--jump' && args[i + 1]) { action = 'jump'; jumpTarget = parseInt(args[++i], 10); }
-    else if (a === '--sessions') action = 'sessions';
-    else if (a === '--clean') {
-      action = 'clean';
-      // 检查后续选项
-      if (args[i + 1] === '--all-done') { cleanAllDone = true; i++; }
-      else if (args[i + 1] === '--session' && args[i + 2]) { cleanSession = args[i + 2]; i += 2; }
-      else if (args[i + 1] === '--older-than' && args[i + 2]) { cleanOlderThan = parseFloat(args[i + 2]); i += 2; }
-    }
-    else if (!a.startsWith('-')) {
-      if (!phase) phase = a;
-    }
-  }
-
-  const sid = getSessionId(dir, sessionId);
-
-  // 如果 phase 提供但步骤目录不存在
-  if (phase && action && action !== 'sessions' && action !== 'clean') {
-    const stepsDir = join(sillyDir, 'steps');
-    if (!existsSync(stepsDir) || !existsSync(join(stepsDir, phase, 'manifest.yaml'))) {
-      const available = getAvailablePhases(sillyDir);
-      if (json) {
-        console.log(JSON.stringify({ ok: false, error: `阶段 "${phase}" 不存在`, available }));
-        process.exit(1);
-      }
-      console.log(`❌ 阶段 "${phase}" 不存在`);
-      if (available.length > 0) {
-        console.log(`可用阶段: ${available.join(', ')}`);
-      } else {
-        console.log('暂无可用阶段（.sillyspec/steps/ 下无 manifest.yaml）');
-      }
-      process.exit(1);
-    }
-  }
-
-  let result;
-  switch (action) {
-    case 'next':
-      result = handleNext(dir, sillyDir, phase, sid, json);
-      break;
-    case 'jump':
-      result = handleJump(dir, sillyDir, phase, jumpTarget, sid, json);
-      break;
-    case 'status':
-      result = handleStatus(sillyDir, sid, json);
-      break;
-    case 'list':
-      result = handleList(sillyDir, phase, sid, json);
-      break;
-    case 'sessions':
-      result = handleSessions(sillyDir, json);
-      break;
-    case 'clean':
-      result = handleClean(sillyDir, { allDone: cleanAllDone, olderThan: cleanOlderThan, sessionId: cleanSession }, json);
-      break;
-    default:
-      console.log('❌ 请指定操作: --next, --status, --list, --jump <n>, --sessions, --clean');
-      console.log('');
-      console.log('用法:');
-      console.log('  sillyspec step <phase> --next          获取步骤 + 自动推进');
-      console.log('  sillyspec step <phase> --status        查看进度');
-      console.log('  sillyspec step <phase> --list          查看步骤列表');
-      console.log('  sillyspec step <phase> --jump <n>      跳到指定步骤');
-      console.log('  sillyspec step --sessions              查看所有会话');
-      console.log('  sillyspec step --clean                 dry-run 列出可清理会话');
-      console.log('  sillyspec step --clean --all-done      清理所有阶段完成的会话');
-      console.log('  sillyspec step --clean --session <id>  清理指定会话');
-      console.log('  sillyspec step --clean --older-than <days>  清理 N 天前的会话');
-      console.log('');
-      console.log('选项:');
-      console.log('  --session <id>    指定会话 ID');
-      console.log('  --json            输出 JSON');
-      process.exit(1);
-  }
-
-  if (result && !result.ok) {
-    if (json) {
-      console.log(JSON.stringify(result));
-    } else if (result.error) {
-      console.log(result.error);
-    }
-    process.exit(1);
-  }
-
-  if (json && result) {
-    console.log(JSON.stringify(result));
-  }
-}

package/templates/archive.md

@@ -1,120 +0,0 @@
-## 交互规范
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-## 核心约束（必须遵守）
-- ❌ 未经验证就归档（必须先确认验证通过）
-- ❌ 未勾选的 checkbox 未告知用户就归档
-- ❌ 归档后留下活跃变更的残留状态
-- ❌ 覆盖已存在的归档目录
-
-## 变更名称
-$ARGUMENTS
-
----
-
-## 流程
-
-### 1. 前置检查（门禁）
-
-读取 `.sillyspec/changes/<change-name>/` 下所有必要文件，逐项检查：
-
-- [ ] **文件完整性：** 检查 `design.md` 是否存在，缺失则警告
-- [ ] **任务完成度：** 读取 `tasks.md`，统计已完成/未完成任务数。**有未完成的 → 用 AskUserQuestion 询问：**
-  - ① 继续归档（未完成任务将被标记完成）
-  - ② 取消，回去完成任务
-
-> 任一门禁不通过且用户选择取消 → 终止流程。
-
-### 2. 展示归档清单
-
-展示即将归档的内容摘要：
-- 变更目录名
-- 包含的文件列表
-- 任务完成统计（✅ 已完成 / ⬜ 未完成）
-- 一句话总结本次变更
-- quicklog 修改记录（如有 `.sillyspec/changes/<change-name>/quicklog/` 目录）
-
-### 3. Spec 沉淀
-
-将 `.sillyspec/changes/<change-name>/` 下的设计文档**复制到 `.sillyspec/knowledge/` 主目录**，确保已完成的设计规范可被后续变更参考。如目标已存在同名文件则跳过并提示。
-
-### 4. 用户确认
-
-用 AskUserQuestion 让用户确认：
-- ① 确认归档
-- ② 取消
-
-### 4.5 生成归档摘要
-
-在变更目录下自动生成 `SUMMARY.md`：
-
-```markdown
-# <变更名> 归档
-
-- 创建：YYYY-MM-DD
-- 完成：YYYY-MM-DD
-- 涉及阶段：brainstorm → plan → execute → verify
-
-## 关键决策
-- （从 design.md 提取 3-5 条核心决策）
-
-## 产出文件
-- design.md — 设计文档
-- tasks.md — 任务清单
-- quicklog/ — 关联 quick 修改（N次）
-  - quick1: 描述
-  - quick2: 描述
-
-## 代码变更统计
-- 新增 X 文件，修改 Y 文件，删除 Z 文件
-- 详见 CHANGELOG.md
-```
-
-在变更目录下自动生成 `CHANGELOG.md`：
-
-```bash
-# 收集该变更相关的 git commit（按变更名过滤或按时间范围）
-git log --oneline --no-merges -- .sillyspec/changes/<change-name>/ 2>/dev/null
-# 以及变更目录创建后的所有 commit
-git log --oneline --no-merges --since="<创建时间>" -- "*.ts" "*.js" "*.vue" "*.java" 2>/dev/null
-```
-
-写入 CHANGELOG.md，格式：
-```markdown
-# <变更名> 变更日志
-
-## brainstorm 阶段
-- (相关 commit)
-
-## plan 阶段
-- (相关 commit)
-
-## execute 阶段
-- (相关 commit)
-
-## quick 修改
-- (相关 commit)
-
-## verify 阶段
-- (相关 commit)
-```
-
-### 5. 执行归档
-
-- 目标路径：`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/`
-- **检查目标路径是否已存在**，存在则中止并报错，防止覆盖
-- 移动变更目录到归档路径
-
-### 6. 归档后更新
-
-- **tasks.md：** 确保所有 checkbox 都已勾选 `[x]`
-- **ROADMAP.md**（如存在）：标记对应 Phase 已完成
-- **Git 暂存：** `git add .sillyspec/`
-
-**工作区模式下：** 如果变更属于某个子项目，cd 到子项目目录执行 git add。工作区根目录无 git 则跳过。
-
-💡 归档产出已暂存。准备好后用 `/sillyspec:commit` 提交。
-
-### 最后说：
-
-> ✅ 变更 `<change-name>` 已归档到 `archive/YYYY-MM-DD-<change-name>/`。继续：`/sillyspec:brainstorm "新想法"`