speccrew 0.6.10 → 0.6.12

package/lib/commands/init.js

@@ -15,7 +15,7 @@ const {
 } = require('../utils');
 const { resolveIDE, transformAgentForIDE, transformSkillForIDE } = require('../ide-adapters');
 
-// 解析命令行参数
+// Parse command line arguments
 function parseArgs() {
   const args = process.argv.slice(2);
   let ide = null;
@@ -30,7 +30,7 @@ function parseArgs() {
   return { ide };
 }
 
-// 检查 Node.js 版本 >= 16
+// Check Node.js version >= 16
 function checkNodeVersion() {
   const version = process.version;
   const major = parseInt(version.slice(1).split('.')[0], 10);
@@ -39,7 +39,7 @@ function checkNodeVersion() {
   }
 }
 
-// 进度显示辅助函数
+// Progress display helper functions
 function printProgress(step, total, message) {
   process.stdout.write(`[${step}/${total}] ${message}... `);
 }
@@ -48,12 +48,12 @@ function printDone() {
   console.log('done');
 }
 
-// 获取 npm 包根目录
+// Get npm package root directory
 function getPackageRoot() {
   return path.resolve(__dirname, '..', '..');
 }
 
-// 复制 agents（speccrew-* 前缀文件，总是覆盖）
+// Copy agents (speccrew-* prefixed files, always overwrite)
 function copyAgents(sourceDir, destDir, ideConfig) {
   if (!fs.existsSync(sourceDir)) return { copied: 0, skipped: 0 };
   
@@ -70,7 +70,7 @@ function copyAgents(sourceDir, destDir, ideConfig) {
     const srcPath = path.join(sourceDir, entry.name);
     const destPath = path.join(destDir, entry.name);
     
-    // 如果 IDE 需要转换 frontmatter 且是 .md 文件
+    // If IDE needs frontmatter transformation and is .md file
     if (ideConfig && ideConfig.transformFrontmatter && entry.name.endsWith('.md')) {
       const originalContent = fs.readFileSync(srcPath, 'utf8');
       const transformedContent = transformAgentForIDE(originalContent, ideConfig);
@@ -84,7 +84,7 @@ function copyAgents(sourceDir, destDir, ideConfig) {
   return { copied, skipped };
 }
 
-// 复制 skills（speccrew-* 前缀目录，递归复制，总是覆盖）
+// Copy skills (speccrew-* prefixed directories, recursive copy, always overwrite)
 function copySkills(sourceDir, destDir, ideConfig) {
   if (!fs.existsSync(sourceDir)) return { copied: 0, skipped: 0 };
   
@@ -101,14 +101,14 @@ function copySkills(sourceDir, destDir, ideConfig) {
     const destPath = path.join(destDir, entry.name);
     
     if (entry.isDirectory()) {
-      // 构建 contentTransform 回调：只对 SKILL.md 文件转化
+      // Build contentTransform callback: only transform SKILL.md files
       let contentTransform = null;
       if (ideConfig && ideConfig.transformFrontmatter) {
         contentTransform = (content, fileName, filePath) => {
           if (fileName === 'SKILL.md') {
             return transformSkillForIDE(content, ideConfig);
           }
-          // 其他文件返回 null，表示按原方式复制
+          // Other files return null, indicating copy as-is
           return null;
         };
       }
@@ -124,7 +124,7 @@ function copySkills(sourceDir, destDir, ideConfig) {
   return { copied, skipped };
 }
 
-// 创建 workspace 目录结构
+// Create workspace directory structure
 function createWorkspaceStructure(workspaceDir) {
   const dirs = [
     'iterations',
@@ -143,7 +143,7 @@ function createWorkspaceStructure(workspaceDir) {
   ensureDirectories(workspaceDir, dirs);
 }
 
-// 复制 workspace 模板（仅复制不存在的文件）
+// Copy workspace template (only copy non-existent files)
 function copyWorkspaceTemplate(templateDir, workspaceDir) {
   if (!fs.existsSync(templateDir)) return { copied: 0, skipped: 0 };
   
@@ -169,7 +169,7 @@ function copyWorkspaceTemplate(templateDir, workspaceDir) {
     }
   }
   
-  // 遍历 workspace-template 下的所有一级子目录并复制
+  // Iterate over all first-level subdirectories in workspace-template and copy
   const entries = fs.readdirSync(templateDir, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.isDirectory()) {
@@ -183,11 +183,11 @@ function copyWorkspaceTemplate(templateDir, workspaceDir) {
   return { copied, skipped };
 }
 
-// 复制文档文件（仅复制不存在的文件）
+// Copy documentation files (only copy non-existent files)
 function copyDocs(packageRoot, workspaceDir) {
   let copied = 0;
   
-  // 复制 GETTING-STARTED*.md 到 workspace/docs/
+  // Copy GETTING-STARTED*.md to workspace/docs/
   const docsSourceDir = path.join(packageRoot, 'docs');
   const docsDestDir = path.join(workspaceDir, 'docs');
   
@@ -206,7 +206,7 @@ function copyDocs(packageRoot, workspaceDir) {
     }
   }
   
-  // 复制 README*.md 到 workspace/
+  // Copy README*.md to workspace/
   const entries = fs.readdirSync(packageRoot, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.name.startsWith('README') && entry.name.endsWith('.md')) {
@@ -223,7 +223,7 @@ function copyDocs(packageRoot, workspaceDir) {
   return { copied };
 }
 
-// 迁移旧的 .speccrewrc 到 workspace 目录
+// Migrate old .speccrewrc to workspace directory
 function migrateOldSpeccrewRC(projectRoot, workspaceDir) {
   const oldRcPath = path.join(projectRoot, '.speccrewrc');
   const newRcPath = path.join(workspaceDir, '.speccrewrc');
@@ -235,7 +235,7 @@ function migrateOldSpeccrewRC(projectRoot, workspaceDir) {
   return false;
 }
 
-// 统计 agents 和 skills 数量
+// Count agents and skills
 function countAgentsAndSkills(sourceRoot) {
   let agentCount = 0;
   let skillCount = 0;
@@ -256,7 +256,7 @@ function countAgentsAndSkills(sourceRoot) {
   return { agentCount, skillCount };
 }
 
-// 询问用户确认
+// Ask user for confirmation
 function askConfirm(message) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
@@ -272,7 +272,7 @@ function askConfirm(message) {
   });
 }
 
-// 核心安装逻辑
+// Core installation logic
 async function runInit(options = {}) {
   const {
     projectRoot = process.cwd(),
@@ -284,22 +284,22 @@ async function runInit(options = {}) {
   const log = silent ? () => {} : console.log;
   
   try {
-    // 1. 检查 Node.js 版本
+    // 1. Check Node.js version
     checkNodeVersion();
     
-    // 2. 确定源文件路径
+    // 2. Determine source file paths
     const sourceRoot = getSourceRoot();
     const packageRoot = getPackageRoot();
     
-    // 3. 解析 IDE
+    // 3. Resolve IDE
     if (!silent) printProgress(1, 5, 'Detecting IDE environment');
     const ideConfigs = resolveIDE(projectRoot, ideArg);
     if (!silent) printDone();
     
-    // 4. 统计 agents 和 skills 数量
+    // 4. Count agents and skills
     const { agentCount, skillCount } = countAgentsAndSkills(sourceRoot);
     
-    // 5. 显示安装摘要并确认
+    // 5. Show installation summary and confirm
     const version = getPackageVersion();
     const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
     
@@ -323,10 +323,10 @@ async function runInit(options = {}) {
       log('');
     }
     
-    // 6. 迁移旧的 .speccrewrc（如果存在）
+    // 6. Migrate old .speccrewrc (if exists)
     migrateOldSpeccrewRC(projectRoot, workspaceDir);
     
-    // 统计信息
+    // Statistics
     const stats = {
       ides: [],
       totalAgents: 0,
@@ -335,7 +335,7 @@ async function runInit(options = {}) {
       docsInstalled: 0,
     };
     
-    // 7. 复制 agents 和 skills
+    // 7. Copy agents and skills
     if (!silent) printProgress(2, 5, `Installing agents (${agentCount})`);
     for (const ideConfig of ideConfigs) {
       const agentsSourceDir = path.join(sourceRoot, 'agents');
@@ -363,28 +363,28 @@ async function runInit(options = {}) {
     }
     if (!silent) printDone();
     
-    // 8. 复制 skills（显示进度）
+    // 8. Copy skills (show progress)
     if (!silent) printProgress(3, 5, `Installing skills (${skillCount})`);
-    // skills 已经在上面复制完成，这里只是显示进度
+    // Skills already copied above, just showing progress here
     if (!silent) printDone();
     
-    // 9. 创建 speccrew-workspace 目录结构
+    // 9. Create speccrew-workspace directory structure
     if (!silent) printProgress(4, 5, 'Creating workspace structure');
     createWorkspaceStructure(workspaceDir);
     stats.workspaceCreated = true;
     if (!silent) printDone();
     
-    // 10. 复制 workspace 模板
+    // 10. Copy workspace template
     const templateDir = getWorkspaceTemplatePath();
     copyWorkspaceTemplate(templateDir, workspaceDir);
     
-    // 11. 复制文档
+    // 11. Copy documentation
     if (!silent) printProgress(5, 5, 'Installing documentation');
     const docsResult = copyDocs(packageRoot, workspaceDir);
     stats.docsInstalled = docsResult.copied;
     if (!silent) printDone();
     
-    // 12. 写入 .speccrewrc 到 workspace 目录
+    // 12. Write .speccrewrc to workspace directory
     const rcConfig = {
       ide: ideConfigs.length === 1 ? ideConfigs[0].id : ideConfigs.map(c => c.id),
       version: version,
@@ -392,7 +392,7 @@ async function runInit(options = {}) {
     };
     writeSpeccrewRC(workspaceDir, rcConfig);
     
-    // 13. 输出安装摘要
+    // 13. Output installation summary
     if (!silent) {
       log(`\nSpecCrew v${version} installed successfully!\n`);
       
@@ -442,7 +442,7 @@ async function runInit(options = {}) {
   }
 }
 
-// CLI 入口
+// CLI entry point
 function run() {
   const { ide: cliIdeArg } = parseArgs();
   

package/lib/commands/list.js

@@ -3,7 +3,7 @@ const path = require('path');
 const { readSpeccrewRC, getPackageVersion, isSpeccrewFile } = require('../utils');
 
 function run(projectRoot, args) {
-  // 检查是否已初始化
+  // Check if initialized
   const rc = readSpeccrewRC(projectRoot);
   if (!rc) {
     console.log('SpecCrew is not initialized in this project.');
@@ -25,7 +25,7 @@ function run(projectRoot, args) {
 
   console.log(`SpecCrew v${version} | IDE: ${ideDisplay} (${ideDirs.join(', ')})\n`);
 
-  // 收集所有 agents 和 skills
+  // Collect all agents and skills
   const speccrewAgents = new Set();
   const speccrewSkills = new Set();
   const userAgents = new Set();
@@ -35,7 +35,7 @@ function run(projectRoot, args) {
     const ideConfig = getIDEConfig(ideId);
     if (!ideConfig) continue;
 
-    // 扫描 agents
+    // Scan agents
     const agentsDir = path.join(projectRoot, ideConfig.agentsDir);
     if (fs.existsSync(agentsDir)) {
       const entries = fs.readdirSync(agentsDir, { withFileTypes: true });
@@ -49,7 +49,7 @@ function run(projectRoot, args) {
       }
     }
 
-    // 扫描 skills
+    // Scan skills
     const skillsDir = path.join(projectRoot, ideConfig.skillsDir);
     if (fs.existsSync(skillsDir)) {
       const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
@@ -64,7 +64,7 @@ function run(projectRoot, args) {
     }
   }
 
-  // 输出 Agents
+  // Output Agents
   const sortedAgents = Array.from(speccrewAgents).sort();
   console.log(`Agents (${sortedAgents.length}):`);
   for (const agent of sortedAgents) {
@@ -72,7 +72,7 @@ function run(projectRoot, args) {
   }
   console.log('');
 
-  // 输出 Skills
+  // Output Skills
   const sortedSkills = Array.from(speccrewSkills).sort();
   console.log(`Skills (${sortedSkills.length}):`);
   for (const skill of sortedSkills) {
@@ -80,7 +80,7 @@ function run(projectRoot, args) {
   }
   console.log('');
 
-  // 输出用户自定义内容
+  // Output user-defined content
   const allUserDefined = [...Array.from(userAgents), ...Array.from(userSkills)].sort();
   if (allUserDefined.length > 0) {
     console.log('User-defined:');
@@ -92,7 +92,7 @@ function run(projectRoot, args) {
   return true;
 }
 
-// 获取 IDE 配置（简化版，避免循环依赖）
+// Get IDE config (simplified version, avoid circular dependency)
 function getIDEConfig(ideId) {
   const configs = {
     qoder: {

package/lib/commands/uninstall.js

@@ -4,16 +4,16 @@ const readline = require('readline');
 const { readSpeccrewRC, isSpeccrewFile, removeDirRecursive } = require('../utils');
 
 function run(projectRoot, args) {
-  // 检查是否已初始化（兼容新旧两个路径）
+  // Check if initialized (compatible with both old and new paths)
   let rc = readSpeccrewRC(projectRoot);
   const newRcPath = path.join(projectRoot, 'speccrew-workspace', '.speccrewrc');
   
-  // 如果旧路径没有配置文件，检查新路径
+  // If config not found at old path, check new path
   if (!rc && fs.existsSync(newRcPath)) {
     try {
       rc = JSON.parse(fs.readFileSync(newRcPath, 'utf8'));
     } catch (e) {
-      // 忽略解析错误
+      // Ignore parse errors
     }
   }
   
@@ -25,10 +25,10 @@ function run(projectRoot, args) {
 
   const isAll = args.includes('--all');
 
-  // 获取 IDE 配置
+  // Get IDE configuration
   const ides = rc.ide ? (Array.isArray(rc.ide) ? rc.ide : [rc.ide]) : [];
 
-  // 扫描将要删除的内容（不实际删除）
+  // Scan content to be deleted (don't actually delete yet)
   let totalAgents = 0;
   let totalSkills = 0;
   const idePaths = [];
@@ -40,7 +40,7 @@ function run(projectRoot, args) {
     let agentCount = 0;
     let skillCount = 0;
 
-    // 统计 agents
+    // Count agents
     const agentsDir = path.join(projectRoot, ideConfig.agentsDir);
     if (fs.existsSync(agentsDir)) {
       const entries = fs.readdirSync(agentsDir, { withFileTypes: true });
@@ -51,7 +51,7 @@ function run(projectRoot, args) {
       }
     }
 
-    // 统计 skills
+    // Count skills
     const skillsDir = path.join(projectRoot, ideConfig.skillsDir);
     if (fs.existsSync(skillsDir)) {
       const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
@@ -67,17 +67,17 @@ function run(projectRoot, args) {
     idePaths.push({ ideConfig, agentCount, skillCount });
   }
 
-  // 检查配置文件是否存在（新路径和旧路径）
+  // Check if config file exists (new and old paths)
   const oldRcPath = path.join(projectRoot, '.speccrewrc');
   const hasNewRc = fs.existsSync(newRcPath);
   const hasOldRc = fs.existsSync(oldRcPath);
   const hasRcFile = hasNewRc || hasOldRc;
 
-  // 检查 workspace 是否存在
+  // Check if workspace exists
   const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
   const hasWorkspace = fs.existsSync(workspaceDir);
 
-  // 显示将要删除的内容
+  // Display content to be deleted
   console.log('SpecCrew Uninstall\n');
   console.log('The following will be removed:');
 
@@ -99,7 +99,7 @@ function run(projectRoot, args) {
     console.log('\nWARNING: This will permanently delete your workspace data!');
   }
 
-  // 询问用户确认
+  // Ask user for confirmation
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
@@ -117,7 +117,7 @@ function run(projectRoot, args) {
         return;
       }
 
-      // 执行卸载
+      // Execute uninstall
       const result = performUninstall(projectRoot, idePaths, isAll, hasOldRc);
       resolve(result);
     });
@@ -128,11 +128,11 @@ function performUninstall(projectRoot, idePaths, isAll, hasOldRc) {
   let removedAgents = 0;
   let removedSkills = 0;
 
-  // 计算总步骤数
+  // Calculate total steps
   const totalSteps = isAll ? 4 : 3;
   let currentStep = 0;
 
-  // 删除 agents
+  // Delete agents
   currentStep++;
   process.stdout.write(`[${currentStep}/${totalSteps}] Removing agents... `);
   for (const { ideConfig } of idePaths) {
@@ -154,7 +154,7 @@ function performUninstall(projectRoot, idePaths, isAll, hasOldRc) {
   }
   console.log(`done (${removedAgents} removed)`);
 
-  // 删除 skills
+  // Delete skills
   currentStep++;
   process.stdout.write(`[${currentStep}/${totalSteps}] Removing skills... `);
   for (const { ideConfig } of idePaths) {
@@ -176,17 +176,17 @@ function performUninstall(projectRoot, idePaths, isAll, hasOldRc) {
   }
   console.log(`done (${removedSkills} removed)`);
 
-  // 删除配置文件
+  // Delete config files
   currentStep++;
   process.stdout.write(`[${currentStep}/${totalSteps}] Removing configuration... `);
 
-  // 删除新路径的配置文件
+  // Delete config file at new path
   const newRcPath = path.join(projectRoot, 'speccrew-workspace', '.speccrewrc');
   if (fs.existsSync(newRcPath)) {
     fs.unlinkSync(newRcPath);
   }
 
-  // 兼容处理：删除旧路径的配置文件
+  // Compatibility: Delete config file at old path
   const oldRcPath = path.join(projectRoot, '.speccrewrc');
   if (fs.existsSync(oldRcPath)) {
     fs.unlinkSync(oldRcPath);
@@ -194,7 +194,7 @@ function performUninstall(projectRoot, idePaths, isAll, hasOldRc) {
 
   console.log('done');
 
-  // 如果 --all，删除 workspace
+  // If --all, delete workspace
   if (isAll) {
     currentStep++;
     process.stdout.write(`[${currentStep}/${totalSteps}] Removing workspace... `);
@@ -213,7 +213,7 @@ function performUninstall(projectRoot, idePaths, isAll, hasOldRc) {
   return true;
 }
 
-// 获取 IDE 配置（简化版，避免循环依赖）
+// Get IDE config (simplified version, avoid circular dependency)
 function getIDEConfig(ideId) {
   const configs = {
     qoder: {