@localsummer/incspec 0.0.6 → 0.0.8

package/commands/list.mjs

@@ -15,6 +15,7 @@ import {
   print,
   printTable,
   printWarning,
+  formatLocalDateTime,
 } from '../lib/terminal.mjs';
 
 /**
@@ -47,7 +48,7 @@ export async function listCommand(ctx) {
     } else {
       specs.forEach(spec => {
         const info = getSpecInfo(spec.path);
-        const mtime = spec.mtime.toISOString().replace('T', ' ').slice(0, 16);
+        const mtime = formatLocalDateTime(spec.mtime);
         const versionStr = info.version ? colorize(`v${info.version}`, colors.cyan) : '';
         
         print(`  ${colorize(spec.name, colors.white)} ${versionStr}`);

package/commands/merge.mjs

@@ -12,6 +12,7 @@ import {
   readWorkflow,
   updateStep,
   STATUS,
+  isQuickMode,
 } from '../lib/workflow.mjs';
 import { listSpecs, getNextVersion } from '../lib/spec.mjs';
 import {
@@ -43,24 +44,7 @@ export async function mergeCommand(ctx) {
     return;
   }
 
-  // Get increment file
-  let incrementPath = args[0];
-  if (!incrementPath) {
-    const increments = listSpecs(projectRoot, 'increments');
-    if (increments.length > 0) {
-      const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
-      const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
-      if (matched) {
-        incrementPath = matched.path;
-      } else {
-        incrementPath = increments[0].path;
-        printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
-      }
-    } else {
-      printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
-      return;
-    }
-  }
+  const quickMode = isQuickMode(workflow);
 
   // Calculate output file
   const moduleName = workflow.currentWorkflow.replace(/^analyze-/, '');
@@ -70,12 +54,39 @@ export async function mergeCommand(ctx) {
   const outputFile = outputOverride || defaultOutputFile;
   const outputPath = path.join(INCSPEC_DIR, DIRS.baselines, outputFile);
 
+  // Get increment file (only needed for full mode)
+  let incrementPath = null;
+  if (!quickMode) {
+    incrementPath = args[0];
+    if (!incrementPath) {
+      const increments = listSpecs(projectRoot, 'increments');
+      if (increments.length > 0) {
+        const featureName = workflow.currentWorkflow.replace(/^analyze-/, '');
+        const matched = increments.find(spec => spec.name.startsWith(`${featureName}-increment-`));
+        if (matched) {
+          incrementPath = matched.path;
+        } else {
+          incrementPath = increments[0].path;
+          printWarning(`未找到与当前工作流匹配的增量文件，已使用最近文件: ${increments[0].name}`);
+        }
+      } else {
+        printWarning('未找到增量设计文件。请先运行步骤 4 (design)。');
+        return;
+      }
+    }
+  }
+
   print('');
   print(colorize('步骤 6: 合并到基线', colors.bold, colors.cyan));
+  if (quickMode) {
+    print(colorize('(快速模式 - 重新分析生成新基线)', colors.yellow));
+  }
   print(colorize('─────────────────', colors.dim));
   print('');
   print(colorize(`当前工作流: ${workflow.currentWorkflow}`, colors.dim));
-  print(colorize(`增量设计文件: ${incrementPath}`, colors.dim));
+  if (!quickMode) {
+    print(colorize(`增量设计文件: ${incrementPath}`, colors.dim));
+  }
   print(colorize(`输出基线文件: ${outputPath}`, colors.dim));
   print('');
 
@@ -84,20 +95,40 @@ export async function mergeCommand(ctx) {
 
   print(colorize('使用说明:', colors.bold));
   print('');
-  print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
-  print('');
-  print(colorize(`  /incspec/inc-merge ${incrementPath}`, colors.bold, colors.white));
-  print('');
-  print(colorize('或使用 Claude Code 命令:', colors.cyan));
-  print('');
-  const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines);
-  print(colorize(`  /ai-increment:merge-to-baseline ${incrementPath} ${outDir}`, colors.bold, colors.white));
-  print('');
-  print(colorize('该命令将:', colors.dim));
-  print(colorize('  1. 解析增量设计文件中的时序图和依赖图', colors.dim));
-  print(colorize('  2. 清理增量标记 (🆕/✏️/❌)', colors.dim));
-  print(colorize('  3. 重新编号为 S1-Sxx, D1-Dxx', colors.dim));
-  print(colorize('  4. 生成新的基线快照', colors.dim));
+
+  if (quickMode) {
+    // Quick mode instructions
+    print(colorize('快速模式下，将重新分析当前代码生成新基线:', colors.cyan));
+    print('');
+    print(colorize('在 Cursor 中:', colors.dim));
+    print(colorize(`  /incspec/inc-merge --output=${outputFile}`, colors.bold, colors.white));
+    print('');
+    print(colorize('在 Claude Code 中:', colors.dim));
+    print(colorize(`  请分析当前代码状态，生成新的基线报告到 ${outputPath}`, colors.dim));
+    print('');
+    print(colorize('该命令将:', colors.dim));
+    print(colorize('  1. 分析当前代码的完整流程', colors.dim));
+    print(colorize('  2. 生成 API 调用时序图', colors.dim));
+    print(colorize('  3. 生成依赖关系图', colors.dim));
+    print(colorize('  4. 保存为新版本基线快照', colors.dim));
+  } else {
+    // Full mode instructions
+    print(colorize('请在 Cursor 中运行以下命令:', colors.cyan));
+    print('');
+    print(colorize(`  /incspec/inc-merge ${incrementPath}`, colors.bold, colors.white));
+    print('');
+    print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+    print('');
+    const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines);
+    print(colorize(`  请将 ${incrementPath} 的增量合并到基线 ${outDir}`, colors.dim));
+    print('');
+    print(colorize('该命令将:', colors.dim));
+    print(colorize('  1. 解析增量设计文件中的时序图和依赖图', colors.dim));
+    print(colorize('  2. 清理增量标记', colors.dim));
+    print(colorize('  3. 重新编号为 S1-Sxx, D1-Dxx', colors.dim));
+    print(colorize('  4. 生成新的基线快照', colors.dim));
+  }
+
   print('');
   print(colorize('新基线将作为下一轮增量开发的起点。', colors.dim));
   print('');

package/commands/reset.mjs

@@ -0,0 +1,166 @@
+/**
+ * reset command - Reset current workflow
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import {
+  ensureInitialized,
+  INCSPEC_DIR,
+  DIRS,
+} from '../lib/config.mjs';
+import {
+  readWorkflow,
+  archiveWorkflow,
+  STATUS,
+} from '../lib/workflow.mjs';
+import { archiveSpec } from '../lib/spec.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printInfo,
+  printWarning,
+} from '../lib/terminal.mjs';
+
+/**
+ * Extract module name from workflow name
+ * e.g., "analyze-incspec-cli" -> "incspec-cli"
+ * @param {string} workflowName
+ * @returns {string}
+ */
+function extractModuleName(workflowName) {
+  if (!workflowName) {
+    return 'unknown';
+  }
+
+  // Remove common prefixes like "analyze-"
+  const prefixes = ['analyze-', 'feature-', 'fix-', 'refactor-'];
+  let moduleName = workflowName;
+
+  for (const prefix of prefixes) {
+    if (moduleName.startsWith(prefix)) {
+      moduleName = moduleName.slice(prefix.length);
+      break;
+    }
+  }
+
+  return moduleName || workflowName;
+}
+
+/**
+ * Get output directory for a step index
+ * @param {number} stepIndex - 0-based step index
+ * @returns {string|null}
+ */
+function getOutputDirForStepIndex(stepIndex) {
+  // Step 1 (index 0) and Step 6 (index 5) -> baselines
+  if (stepIndex === 0 || stepIndex === 5) {
+    return DIRS.baselines;
+  }
+
+  // Step 2-3 (index 1-2) -> requirements
+  if (stepIndex === 1 || stepIndex === 2) {
+    return DIRS.requirements;
+  }
+
+  // Step 4 (index 3) -> increments
+  if (stepIndex === 3) {
+    return DIRS.increments;
+  }
+
+  return null;
+}
+
+/**
+ * Collect output files from workflow steps
+ * @param {string} projectRoot
+ * @param {Object} workflow
+ * @returns {Array<{path: string, name: string}>}
+ */
+function collectWorkflowOutputs(projectRoot, workflow) {
+  const outputs = [];
+
+  if (!workflow?.steps) {
+    return outputs;
+  }
+
+  workflow.steps.forEach((step, index) => {
+    // Only collect completed steps with output
+    if (step.status !== STATUS.COMPLETED || !step.output || step.output === '-') {
+      return;
+    }
+
+    const dir = getOutputDirForStepIndex(index);
+    if (!dir) {
+      return;
+    }
+
+    const outputPath = path.join(projectRoot, INCSPEC_DIR, dir, step.output);
+    if (fs.existsSync(outputPath)) {
+      outputs.push({
+        path: outputPath,
+        name: step.output,
+      });
+    }
+  });
+
+  return outputs;
+}
+
+/**
+ * Execute reset command
+ * @param {Object} ctx - Command context
+ */
+export async function resetCommand(ctx) {
+  const { cwd } = ctx;
+
+  // Ensure initialized
+  const projectRoot = ensureInitialized(cwd);
+
+  // Read current workflow
+  const workflow = readWorkflow(projectRoot);
+
+  if (!workflow?.currentWorkflow) {
+    print('');
+    printInfo('当前无活跃工作流，无需重置');
+    return;
+  }
+
+  const workflowName = workflow.currentWorkflow;
+  const moduleName = extractModuleName(workflowName);
+
+  print('');
+  print(colorize('  incspec 工作流重置', colors.bold, colors.cyan));
+  print(colorize('  ─────────────────', colors.dim));
+  print('');
+  print(colorize(`工作流: ${workflowName}`, colors.dim));
+  print('');
+
+  // Collect output files
+  const outputs = collectWorkflowOutputs(projectRoot, workflow);
+
+  // Archive output files
+  if (outputs.length > 0) {
+    print(colorize('归档产出文件:', colors.dim));
+
+    for (const output of outputs) {
+      try {
+        const archivePath = archiveSpec(projectRoot, output.path, true, moduleName);
+        print(colorize(`  - ${output.name}`, colors.dim));
+      } catch (e) {
+        printWarning(`归档失败: ${output.name} - ${e.message}`);
+      }
+    }
+
+    print('');
+    printSuccess(`已归档 ${outputs.length} 个产出文件到 archives/${new Date().toISOString().slice(0, 7)}/${moduleName}/`);
+  } else {
+    printInfo('无产出文件需要归档');
+  }
+
+  // Reset workflow state
+  archiveWorkflow(projectRoot);
+  printSuccess('工作流已重置');
+}

package/commands/status.mjs

@@ -10,6 +10,9 @@ import {
   readWorkflow,
   STEPS,
   STATUS,
+  MODE,
+  QUICK_MODE_SKIPPED,
+  isQuickMode,
 } from '../lib/workflow.mjs';
 import {
   colors,
@@ -49,7 +52,11 @@ export async function statusCommand(ctx) {
 
   // Current workflow
   if (workflow?.currentWorkflow) {
+    const quickMode = isQuickMode(workflow);
+    const modeLabel = quickMode ? '快速模式 (5步)' : '完整模式 (7步)';
+
     print(colorize(`当前工作流: `, colors.bold) + colorize(workflow.currentWorkflow, colors.cyan));
+    print(colorize(`工作流模式: ${modeLabel}`, colors.dim));
     print(colorize(`开始时间: ${workflow.startTime || '-'}`, colors.dim));
     print(colorize(`最后更新: ${workflow.lastUpdate || '-'}`, colors.dim));
     print('');
@@ -60,8 +67,14 @@ export async function statusCommand(ctx) {
 
     STEPS.forEach((step, index) => {
       const stepData = workflow.steps[index] || {};
-      const status = stepData.status || STATUS.PENDING;
+      let status = stepData.status || STATUS.PENDING;
       const isCurrent = workflow.currentStep === step.id;
+      const isSkipped = quickMode && QUICK_MODE_SKIPPED.includes(step.id);
+
+      // Quick mode: mark skipped steps
+      if (isSkipped && status !== STATUS.SKIPPED) {
+        status = STATUS.SKIPPED;
+      }
 
       // Determine display status
       let displayStatus = status;
@@ -69,7 +82,12 @@ export async function statusCommand(ctx) {
         displayStatus = STATUS.IN_PROGRESS;
       }
 
-      printStep(step.id, step.label, displayStatus);
+      // Use dimmed style for skipped steps
+      if (status === STATUS.SKIPPED) {
+        print(colorize(`  [-] ${step.id}. ${step.label}`, colors.dim) + colorize(' (已跳过)', colors.dim));
+      } else {
+        printStep(step.id, step.label, displayStatus);
+      }
 
       // Show output file if completed
       if (stepData.output && status === STATUS.COMPLETED) {
@@ -80,9 +98,14 @@ export async function statusCommand(ctx) {
     print('');
 
     // Next step hint
-    const nextStepIndex = workflow.steps.findIndex(
-      step => (step?.status || STATUS.PENDING) !== STATUS.COMPLETED
-    );
+    const nextStepIndex = workflow.steps.findIndex((step, index) => {
+      const stepNumber = index + 1;
+      // Skip excluded steps in quick mode
+      if (quickMode && QUICK_MODE_SKIPPED.includes(stepNumber)) {
+        return false;
+      }
+      return (step?.status || STATUS.PENDING) !== STATUS.COMPLETED;
+    });
     if (nextStepIndex >= 0) {
       const nextStep = STEPS[nextStepIndex];
       print(colorize('下一步:', colors.bold));
@@ -107,8 +130,8 @@ export async function statusCommand(ctx) {
 
     const recentHistory = workflow.history.slice(0, 5);
     recentHistory.forEach(item => {
-      const statusIcon = item.status === 'completed' 
-        ? colorize('✓', colors.green) 
+      const statusIcon = item.status === 'completed'
+        ? colorize('✓', colors.green)
         : colorize('○', colors.dim);
       print(`  ${statusIcon} ${item.name} (${item.startTime || '-'})`);
     });

package/commands/sync.mjs

@@ -0,0 +1,210 @@
+/**
+ * sync command - Sync incspec integrations to IDEs/AI tools
+ */
+
+import {
+  syncToProject as syncCursorToProject,
+  syncToGlobal as syncCursorToGlobal,
+} from '../lib/cursor.mjs';
+import {
+  syncToProjectClaude,
+  syncToGlobalClaude,
+} from '../lib/claude.mjs';
+import {
+  colors,
+  colorize,
+  print,
+  printSuccess,
+  printWarning,
+  printInfo,
+  select,
+  checkbox,
+} from '../lib/terminal.mjs';
+
+/** Sync target definitions */
+const SYNC_TARGETS = {
+  cursor: {
+    name: 'Cursor',
+    value: 'cursor',
+  },
+  claude: {
+    name: 'Claude Code',
+    value: 'claude',
+  },
+};
+
+/**
+ * Execute sync command
+ * @param {Object} ctx - Command context
+ */
+export async function syncCommand(ctx) {
+  const { cwd, options } = ctx;
+
+  print('');
+  print(colorize('  IncSpec 集成同步', colors.bold, colors.cyan));
+  print(colorize('  ────────────────', colors.dim));
+  print('');
+
+  // Determine sync targets
+  let targets = [];
+
+  // Command line args take priority
+  if (options.cursor) {
+    targets.push('cursor');
+  }
+  if (options.claude) {
+    targets.push('claude');
+  }
+  if (options.all) {
+    targets = ['cursor', 'claude'];
+  }
+
+  // If no args specified, use interactive checkbox
+  if (targets.length === 0) {
+    targets = await checkbox({
+      message: '选择要同步的目标:',
+      choices: [
+        { ...SYNC_TARGETS.cursor, checked: true },
+        { ...SYNC_TARGETS.claude, checked: false },
+      ],
+    });
+
+    if (targets.length === 0) {
+      printWarning('未选择任何同步目标。');
+      return;
+    }
+  }
+
+  print(colorize(`已选择: ${targets.map(t => SYNC_TARGETS[t].name).join(', ')}`, colors.dim));
+  print('');
+
+  // Execute sync for each target
+  for (const target of targets) {
+    if (target === 'cursor') {
+      await syncCursor(ctx);
+    } else if (target === 'claude') {
+      await syncClaude(ctx);
+    }
+    print('');
+  }
+
+  printInfo('同步完成。');
+  print('');
+}
+
+/**
+ * Sync Cursor commands
+ * @param {Object} ctx
+ */
+async function syncCursor(ctx) {
+  const { cwd, options } = ctx;
+
+  print(colorize('=== Cursor 命令同步 ===', colors.bold));
+  print('');
+
+  // Determine sync target
+  let syncTarget = null;
+
+  if (options.project) {
+    syncTarget = 'project';
+  } else if (options.global) {
+    syncTarget = 'global';
+  } else {
+    const choices = [
+      {
+        name: `当前目录 (${cwd}/.cursor/commands/incspec/)`,
+        value: 'project',
+        description: '仅对当前目录生效',
+      },
+      {
+        name: '全局目录 (~/.cursor/commands/incspec/)',
+        value: 'global',
+        description: '对所有项目生效',
+      },
+    ];
+
+    syncTarget = await select({
+      message: 'Cursor - 选择同步目标:',
+      choices,
+    });
+  }
+
+  // Execute sync
+  if (syncTarget === 'project') {
+    const count = syncCursorToProject(cwd);
+    printSuccess(`Cursor: 已同步 ${count} 个命令到 .cursor/commands/incspec/`);
+    printCursorCommands();
+  } else if (syncTarget === 'global') {
+    const count = syncCursorToGlobal();
+    printSuccess(`Cursor: 已同步 ${count} 个命令到 ~/.cursor/commands/incspec/`);
+    printCursorCommands();
+  }
+}
+
+/**
+ * Print Cursor commands list
+ */
+function printCursorCommands() {
+  print('');
+  print(colorize('已创建的命令:', colors.bold));
+  print(colorize('  /incspec/inc-analyze      步骤1: 分析代码流程', colors.dim));
+  print(colorize('  /incspec/inc-collect-req  步骤2: 收集结构化需求', colors.dim));
+  print(colorize('  /incspec/inc-collect-dep  步骤3: UI依赖采集', colors.dim));
+  print(colorize('  /incspec/inc-design       步骤4: 增量设计', colors.dim));
+  print(colorize('  /incspec/inc-apply        步骤5: 应用代码变更', colors.dim));
+  print(colorize('  /incspec/inc-merge        步骤6: 合并到基线', colors.dim));
+  print(colorize('  /incspec/inc-archive      归档规范文件', colors.dim));
+  print(colorize('  /incspec/inc-status       查看工作流状态', colors.dim));
+  print(colorize('  /incspec/inc-help         显示帮助', colors.dim));
+  print('');
+  printInfo('请重启 Cursor 以加载新命令。');
+}
+
+/**
+ * Sync Claude Code skill
+ * @param {Object} ctx
+ */
+async function syncClaude(ctx) {
+  const { cwd, options } = ctx;
+
+  print(colorize('=== Claude Code Skill 同步 ===', colors.bold));
+  print('');
+
+  // Determine sync target
+  let syncTarget = null;
+
+  if (options.project) {
+    syncTarget = 'project';
+  } else if (options.global) {
+    syncTarget = 'global';
+  } else {
+    const choices = [
+      {
+        name: `当前目录 (${cwd}/.claude/skills/inc-spec-skill/)`,
+        value: 'project',
+        description: '仅对当前目录生效',
+      },
+      {
+        name: '全局目录 (~/.claude/skills/inc-spec-skill/)',
+        value: 'global',
+        description: '对所有项目生效（推荐）',
+      },
+    ];
+
+    syncTarget = await select({
+      message: 'Claude Code - 选择同步目标:',
+      choices,
+    });
+  }
+
+  // Execute sync
+  if (syncTarget === 'project') {
+    const { count } = syncToProjectClaude(cwd);
+    printSuccess(`Claude Code: 已同步 ${count} 个文件到 .claude/skills/inc-spec-skill/`);
+    print(colorize('  包含: SKILL.md + references/', colors.dim));
+  } else if (syncTarget === 'global') {
+    const { count } = syncToGlobalClaude();
+    printSuccess(`Claude Code: 已同步 ${count} 个文件到 ~/.claude/skills/inc-spec-skill/`);
+    print(colorize('  包含: SKILL.md + references/', colors.dim));
+  }
+}

package/commands/update.mjs

@@ -20,6 +20,7 @@ import {
   printWarning,
   printInfo,
   confirm,
+  formatLocalDateTime,
 } from '../lib/terminal.mjs';
 
 /**
@@ -71,7 +72,7 @@ function updateIncspecWorkflow(projectRoot) {
     return { updated: false, path: targetPath, reason: '保留用户工作流数据' };
   }
 
-  const now = new Date().toISOString().replace('T', ' ').slice(0, 16);
+  const now = formatLocalDateTime(new Date());
   let templateContent = fs.readFileSync(templatePath, 'utf-8');
   templateContent = templateContent.replace(/\{\{last_update\}\}/g, now);
 

package/index.mjs

@@ -17,7 +17,8 @@ import { mergeCommand } from './commands/merge.mjs';
 import { listCommand } from './commands/list.mjs';
 import { validateCommand } from './commands/validate.mjs';
 import { archiveCommand } from './commands/archive.mjs';
-import { cursorSyncCommand } from './commands/cursor-sync.mjs';
+import { resetCommand } from './commands/reset.mjs';
+import { syncCommand } from './commands/sync.mjs';
 import { helpCommand } from './commands/help.mjs';
 import { colors, colorize } from './lib/terminal.mjs';
 
@@ -156,7 +157,7 @@ async function main() {
         await statusCommand(commandContext);
         break;
 
-      // Workflow commands (Step 1-6)
+      // Workflow commands (Step 1-6, Step 7 archive is separate)
       case 'analyze':
       case 'a':
         await analyzeCommand(commandContext);
@@ -203,10 +204,16 @@ async function main() {
         await archiveCommand(commandContext);
         break;
 
-      // Cursor integration
-      case 'cursor-sync':
-      case 'cs':
-        await cursorSyncCommand(commandContext);
+      // Reset workflow
+      case 'reset':
+      case 'rs':
+        await resetCommand(commandContext);
+        break;
+
+      // Sync integrations
+      case 'sync':
+      case 's':
+        await syncCommand(commandContext);
         break;
 
       // Help

package/lib/agents.mjs

@@ -43,7 +43,7 @@ export function getIncspecBlockTemplate() {
 - 请求含义模糊，需要先了解规范工作流再编码
 
 通过 \`@/incspec/AGENTS.md\` 可以了解：
-- 如何使用 6 步增量编码工作流
+- 如何使用 7 步增量编码工作流
 - 规范格式与约定
 - 项目结构与指南