@localsummer/incspec 0.2.2 → 0.2.3

package/README.md

@@ -160,7 +160,7 @@ AI 编程助手在处理复杂前端代码库时常常力不从心，因为 API
 | 工具 | 命令 |
 |------|------|
 | **Cursor** | `/incspec/inc-analyze`、`/incspec/inc-collect-req`、`/incspec/inc-collect-dep`、`/incspec/inc-design`、`/incspec/inc-apply`、`/incspec/inc-merge`、`/incspec/inc-archive` |
-| **Claude Code** | 使用 `inc-spec-skill` Skill |
+| **Claude Code** | 同 Cursor，使用相同的 `/incspec/inc-*` 命令 |
 
 </details>
 
@@ -226,8 +226,8 @@ incspec sync --all        # 全部
 
 **设置完成后：**
 - 运行 `incspec status` 验证设置
-- Cursor 用户可直接触发 `/incspec/inc-*` 命令
-- Claude Code 用户可使用 `inc-spec-skill` Skill
+- Cursor 和 Claude Code 用户都可直接使用 `/incspec/inc-*` 命令
+- 命令生成到 `.cursor/commands/incspec/` 或 `.claude/commands/incspec/` 目录
 
 ### 创建你的第一个增量
 

package/commands/analyze.mjs

@@ -223,9 +223,9 @@ export async function analyzeCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-analyze ${sourcePath} --module=${moduleName}`, colors.bold, colors.white));
   print('');
-  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用斜杠命令:', colors.cyan));
   print('');
-  print(colorize(`  请分析 ${sourcePath} 的代码流程，生成基线报告到 ${path.join(projectRoot, INCSPEC_DIR, DIRS.baselines)}`, colors.dim));
+  print(colorize(`  /incspec/inc-analyze ${sourcePath} --module=${moduleName}`, colors.bold, colors.white));
   print('');
   printInfo(`完成后运行 'incspec status' 查看进度`);
   print('');

package/commands/apply.mjs

@@ -159,9 +159,9 @@ export async function applyCommand(ctx) {
     print('');
     print(colorize(`  /incspec/inc-apply ${inputPath}`, colors.bold, colors.white));
     print('');
-    print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+    print(colorize('或在 Claude Code 中使用斜杠命令:', colors.cyan));
     print('');
-    print(colorize(`  请按照 ${inputPath} 的增量设计，应用代码变更到 ${path.join(projectRoot, sourceDir)}`, colors.dim));
+    print(colorize(`  /incspec/inc-apply ${inputPath}`, colors.bold, colors.white));
     print('');
     print(colorize('该命令将:', colors.dim));
     print(colorize('  1. 解析增量设计文件中的变更计划', colors.dim));

package/commands/collect-dep.mjs

@@ -76,9 +76,9 @@ export async function collectDepCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-collect-dep`, colors.bold, colors.white));
   print('');
-  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用斜杠命令:', colors.cyan));
   print('');
-  print(colorize(`  请收集 UI 依赖，生成依赖报告到 ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.dim));
+  print(colorize(`  /incspec/inc-collect-dep`, colors.bold, colors.white));
   print('');
   print(colorize('该命令将交互式采集 6 维度 UI 依赖:', colors.dim));
   print(colorize('  - UI组件库 (Arco/Antd)', colors.dim));

package/commands/collect-req.mjs

@@ -71,9 +71,9 @@ export async function collectReqCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-collect-req`, colors.bold, colors.white));
   print('');
-  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用斜杠命令:', colors.cyan));
   print('');
-  print(colorize(`  请收集需求，生成结构化需求表格到 ${path.join(projectRoot, INCSPEC_DIR, DIRS.requirements)}`, colors.dim));
+  print(colorize(`  /incspec/inc-collect-req`, colors.bold, colors.white));
   print('');
   print(colorize('该命令将交互式收集需求，生成 5 列结构化表格:', colors.dim));
   print(colorize('  | 新增/修改功能 | 涉及UI组件 | 触发条件 | 影响的核心状态 | 预期数据流向 |', colors.dim));

package/commands/design.mjs

@@ -116,13 +116,9 @@ export async function designCommand(ctx) {
   print('');
   print(colorize(`  /incspec/inc-design --feature=${featureName}`, colors.bold, colors.white));
   print('');
-  print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+  print(colorize('或在 Claude Code 中使用斜杠命令:', colors.cyan));
   print('');
-  const baselinePath = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines, latestBaseline);
-  const reqPath = path.join(projectRoot, INCSPEC_DIR, DIRS.requirements, 'structured-requirements.md');
-  const depPath = path.join(projectRoot, INCSPEC_DIR, DIRS.requirements, 'ui-dependencies.md');
-  const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.increments);
-  print(colorize(`  请基于基线 ${latestBaseline} 和需求/依赖文件，设计增量方案到 ${outDir}`, colors.dim));
+  print(colorize(`  /incspec/inc-design --feature=${featureName}`, colors.bold, colors.white));
   print('');
   print(colorize('该命令将生成包含 7 大模块的增量设计蓝图:', colors.dim));
   print(colorize('  1. 一句话摘要', colors.dim));

package/commands/help.mjs

@@ -137,7 +137,7 @@ const COMMANDS = {
     description: '同步集成到 IDE/AI 工具 (Cursor, Claude Code)',
     options: [
       ['--cursor', '仅同步 Cursor 命令'],
-      ['--claude', '仅同步 Claude Code Skill'],
+      ['--claude', '仅同步 Claude Code 命令'],
       ['--all', '同步所有目标'],
       ['--project', '同步到当前目录'],
       ['--global', '同步到全局目录'],

package/commands/merge.mjs

@@ -146,10 +146,9 @@ export async function mergeCommand(ctx) {
     print('');
     print(colorize(`  /incspec/inc-merge ${incrementPath}`, colors.bold, colors.white));
     print('');
-    print(colorize('或在 Claude Code 中使用 inc-spec-skill 技能:', colors.cyan));
+    print(colorize('或在 Claude Code 中使用斜杠命令:', colors.cyan));
     print('');
-    const outDir = path.join(projectRoot, INCSPEC_DIR, DIRS.baselines);
-    print(colorize(`  请将 ${incrementPath} 的增量合并到基线 ${outDir}`, colors.dim));
+    print(colorize(`  /incspec/inc-merge ${incrementPath}`, colors.bold, colors.white));
     print('');
     print(colorize('该命令将:', colors.dim));
     print(colorize('  1. 解析增量设计文件中的时序图和依赖图', colors.dim));

package/commands/sync.mjs

@@ -3,13 +3,10 @@
  */
 
 import {
-  syncToProject as syncCursorToProject,
-  syncToGlobal as syncCursorToGlobal,
-} from '../lib/cursor.mjs';
-import {
-  syncToProjectClaude,
-  syncToGlobalClaude,
-} from '../lib/claude.mjs';
+  syncToProject,
+  syncToGlobal,
+  getIDEConfig,
+} from '../lib/ide-sync.mjs';
 import {
   colors,
   colorize,
@@ -110,14 +107,15 @@ async function syncCursor(ctx) {
   } else if (options.global) {
     syncTarget = 'global';
   } else {
+    const config = getIDEConfig('cursor');
     const choices = [
       {
-        name: `当前目录 (${cwd}/.cursor/commands/incspec/)`,
+        name: `当前目录 (${cwd}/${config.projectDir}/)`,
         value: 'project',
         description: colorize('仅对当前目录生效', colors.blue),
       },
       {
-        name: '全局目录 (~/.cursor/commands/incspec/)',
+        name: `全局目录 (${config.globalDir}/)`,
         value: 'global',
         description: colorize('对所有项目生效', colors.blue),
       },
@@ -131,12 +129,14 @@ async function syncCursor(ctx) {
 
   // Execute sync
   if (syncTarget === 'project') {
-    const count = syncCursorToProject(cwd);
-    printSuccess(`Cursor: 已同步 ${count} 个命令到 .cursor/commands/incspec/`);
+    const count = syncToProject('cursor', cwd);
+    const config = getIDEConfig('cursor');
+    printSuccess(`Cursor: 已同步 ${count} 个命令到 ${config.projectDir}/`);
     printCursorCommands();
   } else if (syncTarget === 'global') {
-    const count = syncCursorToGlobal();
-    printSuccess(`Cursor: 已同步 ${count} 个命令到 ~/.cursor/commands/incspec/`);
+    const count = syncToGlobal('cursor');
+    const config = getIDEConfig('cursor');
+    printSuccess(`Cursor: 已同步 ${count} 个命令到 ${config.globalDir}/`);
     printCursorCommands();
   }
 }
@@ -161,13 +161,13 @@ function printCursorCommands() {
 }
 
 /**
- * Sync Claude Code skill
+ * Sync Claude Code commands
  * @param {Object} ctx
  */
 async function syncClaude(ctx) {
   const { cwd, options } = ctx;
 
-  print(colorize('=== Claude Code Skill 同步 ===', colors.bold));
+  print(colorize('=== Claude Code 命令同步 ===', colors.bold));
   print('');
 
   // Determine sync target
@@ -178,14 +178,15 @@ async function syncClaude(ctx) {
   } else if (options.global) {
     syncTarget = 'global';
   } else {
+    const config = getIDEConfig('claude');
     const choices = [
       {
-        name: `当前目录 (${cwd}/.claude/skills/inc-spec-skill/)`,
+        name: `当前目录 (${cwd}/${config.projectDir}/)`,
         value: 'project',
         description: colorize('仅对当前目录生效', colors.blue),
       },
       {
-        name: '全局目录 (~/.claude/skills/inc-spec-skill/)',
+        name: `全局目录 (${config.globalDir}/)`,
         value: 'global',
         description: colorize('对所有项目生效（推荐）', colors.blue),
       },
@@ -199,12 +200,33 @@ async function syncClaude(ctx) {
 
   // 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));
+    const count = syncToProject('claude', cwd);
+    const config = getIDEConfig('claude');
+    printSuccess(`Claude Code: 已同步 ${count} 个命令到 ${config.projectDir}/`);
+    printClaudeCommands();
   } else if (syncTarget === 'global') {
-    const { count } = syncToGlobalClaude();
-    printSuccess(`Claude Code: 已同步 ${count} 个文件到 ~/.claude/skills/inc-spec-skill/`);
-    print(colorize('  包含: SKILL.md + references/', colors.dim));
+    const count = syncToGlobal('claude');
+    const config = getIDEConfig('claude');
+    printSuccess(`Claude Code: 已同步 ${count} 个命令到 ${config.globalDir}/`);
+    printClaudeCommands();
   }
 }
+
+/**
+ * Print Claude commands list
+ */
+function printClaudeCommands() {
+  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('请重启 Claude Code 以加载新命令。');
+}

package/lib/{cursor.mjs → ide-sync.mjs}

@@ -1,31 +1,43 @@
 /**
- * Cursor integration utilities
- * - Generate Cursor slash commands
- * - Sync to project or global
+ * Unified IDE integration utilities
+ * - Generate IDE slash commands from templates
+ * - Support multiple IDEs through configuration
  */
 
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 import { fileURLToPath } from 'url';
-import { INCSPEC_DIR, DIRS } from './config.mjs';
-
-/** Cursor commands directory */
-const CURSOR_COMMANDS_DIR = '.cursor/commands/incspec';
-
-/** Global Cursor commands directory */
-const GLOBAL_CURSOR_DIR = path.join(os.homedir(), '.cursor', 'commands', 'incspec');
-
-/** Claude commands source directory (user local) */
-const CLAUDE_COMMANDS_DIR = path.join(os.homedir(), '.claude', 'commands', 'ai-increment');
+import { INCSPEC_DIR } from './config.mjs';
 
 /** Built-in templates directory */
 const TEMPLATES_DIR = fileURLToPath(new URL('../templates/commands', import.meta.url));
 
 /**
- * Command mapping from Claude to Cursor
+ * IDE-specific configurations
+ */
+const IDE_CONFIGS = {
+  cursor: {
+    name: 'Cursor',
+    projectDir: '.cursor/commands/incspec',
+    globalDir: path.join(os.homedir(), '.cursor', 'commands', 'incspec'),
+    fallbackDirs: [
+      // Support old ai-incremental-coding commands for backward compatibility
+      path.join(os.homedir(), '.claude', 'commands', 'ai-increment'),
+    ],
+  },
+  claude: {
+    name: 'Claude Code',
+    projectDir: '.claude/commands/incspec',
+    globalDir: path.join(os.homedir(), '.claude', 'commands', 'incspec'),
+    fallbackDirs: [],
+  },
+};
+
+/**
+ * Command mapping (shared across all IDEs)
  */
-const COMMAND_MAP = [
+export const COMMAND_MAP = [
   {
     source: 'analyze-codeflow.md',
     target: 'inc-analyze.md',
@@ -78,80 +90,38 @@ const COMMAND_MAP = [
 ];
 
 /**
- * Generate Cursor command content
- * Templates already contain complete Cursor command format with CLI sync instructions,
- * so we just pass through the source content directly.
- * @param {Object} cmd - Command definition
- * @param {string} sourceContent - Original template content (already complete)
- * @param {string} projectRoot - Project root path (optional, unused)
- * @returns {string}
- */
-function generateCursorCommand(cmd, sourceContent, projectRoot = null) {
-  // Templates are already complete Cursor commands, pass through directly
-  return sourceContent;
-}
-
-/**
- * Get source file path with fallback to user local commands
+ * Get source file path with optional fallback directories
  * @param {string} fileName - Source file name
+ * @param {Array<string>} fallbackDirs - Optional fallback directories to search
  * @returns {string|null} Path to source file or null if not found
  */
-function getSourcePath(fileName) {
+function getSourcePath(fileName, fallbackDirs = []) {
   // Try built-in templates first (preferred)
   const templatePath = path.join(TEMPLATES_DIR, fileName);
   if (fs.existsSync(templatePath)) {
     return templatePath;
   }
 
-  // Fallback to user local Claude commands
-  const claudePath = path.join(CLAUDE_COMMANDS_DIR, fileName);
-  if (fs.existsSync(claudePath)) {
-    return claudePath;
+  // Try fallback directories
+  for (const dir of fallbackDirs) {
+    const fallbackPath = path.join(dir, fileName);
+    if (fs.existsSync(fallbackPath)) {
+      return fallbackPath;
+    }
   }
 
   return null;
 }
 
 /**
- * Generate all Cursor commands
- * @param {string} projectRoot - Optional project root for customization
+ * Generate utility commands content
  * @returns {Array<{name: string, content: string}>}
  */
-export function generateCursorCommands(projectRoot = null) {
-  const commands = [];
-
-  for (const cmd of COMMAND_MAP) {
-    const sourcePath = getSourcePath(cmd.source);
-
-    let content;
-    if (sourcePath) {
-      const sourceContent = fs.readFileSync(sourcePath, 'utf-8');
-      content = generateCursorCommand(cmd, sourceContent, projectRoot);
-    } else {
-      // Generate placeholder if source doesn't exist
-      content = `---
-description: ${cmd.description}
----
-
-# ${cmd.label}
-
-> 源命令文件不存在: ${cmd.source}
-> 请确保已正确安装 incspec-cli 或 ai-incremental-coding 技能。
-
-请参考 incspec 文档手动执行此步骤。
-`;
-    }
-
-    commands.push({
-      name: cmd.target,
-      content,
-    });
-  }
-
-  // Add utility commands
-  commands.push({
-    name: 'inc-status.md',
-    content: `---
+function generateUtilityCommands() {
+  return [
+    {
+      name: 'inc-status.md',
+      content: `---
 description: [incspec] 查看当前工作流状态
 ---
 
@@ -169,11 +139,10 @@ incspec status
 cat ${INCSPEC_DIR}/WORKFLOW.md
 \`\`\`
 `,
-  });
-
-  commands.push({
-    name: 'inc-help.md',
-    content: `---
+    },
+    {
+      name: 'inc-help.md',
+      content: `---
 description: [incspec] 显示帮助信息
 ---
 
@@ -225,25 +194,79 @@ ${INCSPEC_DIR}/
 └── archives/         # 历史归档 (YYYY-MM/{module}/)
 \`\`\`
 `,
-  });
+    },
+  ];
+}
+
+/**
+ * Generate all IDE commands
+ * @param {string} ide - IDE type ('cursor' or 'claude')
+ * @param {Object} options - Additional options
+ * @param {string} options.projectRoot - Optional project root for customization
+ * @returns {Array<{name: string, content: string}>}
+ */
+export function generateCommands(ide, { projectRoot = null } = {}) {
+  const config = IDE_CONFIGS[ide];
+  if (!config) {
+    throw new Error(`Unknown IDE: ${ide}`);
+  }
+
+  const commands = [];
+
+  // Generate workflow commands
+  for (const cmd of COMMAND_MAP) {
+    const sourcePath = getSourcePath(cmd.source, config.fallbackDirs);
+
+    let content;
+    if (sourcePath) {
+      content = fs.readFileSync(sourcePath, 'utf-8');
+    } else {
+      // Generate placeholder if source doesn't exist
+      content = `---
+description: ${cmd.description}
+---
+
+# ${cmd.label}
+
+> 源命令文件不存在: ${cmd.source}
+> 请确保已正确安装 incspec-cli。
+
+请参考 incspec 文档手动执行此步骤。
+`;
+    }
+
+    commands.push({
+      name: cmd.target,
+      content,
+    });
+  }
+
+  // Add utility commands
+  commands.push(...generateUtilityCommands());
 
   return commands;
 }
 
 /**
  * Sync commands to project directory
- * @param {string} projectRoot
+ * @param {string} ide - IDE type ('cursor' or 'claude')
+ * @param {string} projectRoot - Project root path
  * @returns {number} Number of files written
  */
-export function syncToProject(projectRoot) {
-  const targetDir = path.join(projectRoot, CURSOR_COMMANDS_DIR);
+export function syncToProject(ide, projectRoot) {
+  const config = IDE_CONFIGS[ide];
+  if (!config) {
+    throw new Error(`Unknown IDE: ${ide}`);
+  }
+
+  const targetDir = path.join(projectRoot, config.projectDir);
 
   // Create directory
   if (!fs.existsSync(targetDir)) {
     fs.mkdirSync(targetDir, { recursive: true });
   }
 
-  const commands = generateCursorCommands(projectRoot);
+  const commands = generateCommands(ide, { projectRoot });
 
   for (const cmd of commands) {
     const filePath = path.join(targetDir, cmd.name);
@@ -254,19 +277,27 @@ export function syncToProject(projectRoot) {
 }
 
 /**
- * Sync commands to global Cursor directory
+ * Sync commands to global directory
+ * @param {string} ide - IDE type ('cursor' or 'claude')
  * @returns {number} Number of files written
  */
-export function syncToGlobal() {
+export function syncToGlobal(ide) {
+  const config = IDE_CONFIGS[ide];
+  if (!config) {
+    throw new Error(`Unknown IDE: ${ide}`);
+  }
+
+  const targetDir = config.globalDir;
+
   // Create directory
-  if (!fs.existsSync(GLOBAL_CURSOR_DIR)) {
-    fs.mkdirSync(GLOBAL_CURSOR_DIR, { recursive: true });
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
   }
 
-  const commands = generateCursorCommands();
+  const commands = generateCommands(ide);
 
   for (const cmd of commands) {
-    const filePath = path.join(GLOBAL_CURSOR_DIR, cmd.name);
+    const filePath = path.join(targetDir, cmd.name);
     fs.writeFileSync(filePath, cmd.content, 'utf-8');
   }
 
@@ -274,16 +305,43 @@ export function syncToGlobal() {
 }
 
 /**
- * Check if Cursor commands exist
- * @param {string} projectRoot
+ * Check if IDE commands exist
+ * @param {string} ide - IDE type ('cursor' or 'claude')
+ * @param {string} projectRoot - Project root path
  * @returns {{project: boolean, global: boolean}}
  */
-export function checkCursorCommands(projectRoot) {
-  const projectDir = path.join(projectRoot, CURSOR_COMMANDS_DIR);
-  const globalDir = GLOBAL_CURSOR_DIR;
+export function checkCommands(ide, projectRoot) {
+  const config = IDE_CONFIGS[ide];
+  if (!config) {
+    throw new Error(`Unknown IDE: ${ide}`);
+  }
+
+  const projectDir = path.join(projectRoot, config.projectDir);
+  const globalDir = config.globalDir;
 
   return {
     project: fs.existsSync(projectDir) && fs.readdirSync(projectDir).length > 0,
     global: fs.existsSync(globalDir) && fs.readdirSync(globalDir).length > 0,
   };
 }
+
+/**
+ * Get IDE configuration
+ * @param {string} ide - IDE type ('cursor' or 'claude')
+ * @returns {Object} IDE configuration
+ */
+export function getIDEConfig(ide) {
+  const config = IDE_CONFIGS[ide];
+  if (!config) {
+    throw new Error(`Unknown IDE: ${ide}`);
+  }
+  return config;
+}
+
+/**
+ * Get list of supported IDEs
+ * @returns {Array<string>}
+ */
+export function getSupportedIDEs() {
+  return Object.keys(IDE_CONFIGS);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localsummer/incspec",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "面向 AI 编程助手的增量规范驱动开发工具",
   "bin": {
     "incspec": "index.mjs"