@chongyan/autospec 1.0.1

package/scripts/cli/global.js

@@ -0,0 +1,324 @@
+/**
+ * AutoSpec global command
+ *
+ * 实现 autospec global 子命令
+ * 支持 init/sync/status/publish 操作
+ */
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import chalk from 'chalk';
+import {
+  GLOBAL_AUTOSPEC_DIR,
+  GLOBAL_AUTOSPEC_SUBDIRS,
+  CLAUDE_CODE_SKILLS_DIR,
+  KNOWLEDGE_SCOPE
+} from '../install/constants.js';
+
+/**
+ * 获取全局知识库根目录
+ */
+function getGlobalDir() {
+  return path.join(os.homedir(), GLOBAL_AUTOSPEC_DIR);
+}
+
+/**
+ * 获取 Claude Code skills 目录
+ */
+function getClaudeCodeSkillsDir() {
+  return path.join(os.homedir(), CLAUDE_CODE_SKILLS_DIR);
+}
+
+/**
+ * 创建目录
+ */
+function ensureDir(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+/**
+ * 初始化全局知识库
+ */
+export function initGlobal(options = {}) {
+  const globalDir = getGlobalDir();
+  const results = {
+    directoriesCreated: false,
+    symlinksCreated: false,
+    errors: []
+  };
+
+  console.log(chalk.bold('\n  AutoSpec Global Init\n'));
+  console.log(`  Target: ${globalDir}`);
+  console.log();
+
+  try {
+    // 创建全局知识库目录结构
+    const subdirs = Object.values(GLOBAL_AUTOSPEC_SUBDIRS);
+    for (const subdir of subdirs) {
+      const fullPath = path.join(globalDir, subdir);
+      ensureDir(fullPath);
+    }
+    results.directoriesCreated = true;
+
+    // 创建 Claude Code skills 符号链接
+    const autoSpecSkillsDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.SKILLS);
+    const claudeSkillsDir = getClaudeCodeSkillsDir();
+    ensureDir(claudeSkillsDir);
+
+    // 创建符号链接（如果不存在）
+    const symlinkPath = path.join(claudeSkillsDir, 'autospec');
+    if (!fs.existsSync(symlinkPath)) {
+      try {
+        fs.symlinkSync(autoSpecSkillsDir, symlinkPath, 'dir');
+        results.symlinksCreated = true;
+      } catch (e) {
+        // 符号链接创建失败时使用副本
+        console.log(chalk.yellow(`  ⚠ 符号链接创建失败，将使用副本: ${e.message}`));
+        copyDir(autoSpecSkillsDir, path.join(claudeSkillsDir, 'autospec'));
+        results.symlinksCreated = true;
+      }
+    }
+
+    console.log(chalk.green('  ✓') + ' 全局知识库目录已创建');
+    console.log(chalk.green('  ✓') + ' Claude Code skills 已链接');
+
+    console.log(chalk.bold('\n  快速开始\n'));
+    console.log('  全局知识库已初始化，您可以通过以下命令使用：');
+    console.log('');
+    console.log(chalk.cyan('  发布技能到全局'));
+    console.log('    autospec global publish <skill-name>');
+    console.log('');
+    console.log(chalk.cyan('  同步全局知识到项目'));
+    console.log('    autospec global sync');
+    console.log('');
+    console.log(chalk.cyan('  查看全局状态'));
+    console.log('    autospec global status');
+    console.log('');
+
+    return results;
+  } catch (e) {
+    results.errors.push(e.message);
+    console.log(chalk.red(`  ✗ 初始化失败: ${e.message}`));
+    return results;
+  }
+}
+
+/**
+ * 复制目录
+ */
+function copyDir(src, dest) {
+  ensureDir(dest);
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * 同步全局知识到项目
+ */
+export function syncToProject(projectDir, options = {}) {
+  const globalDir = getGlobalDir();
+  const results = {
+    skillsSynced: false,
+    knowledgeSynced: false,
+    errors: []
+  };
+
+  console.log(chalk.bold('\n  AutoSpec Global Sync\n'));
+  console.log(`  Global: ${globalDir}`);
+  console.log(`  Project: ${projectDir}`);
+  console.log();
+
+  try {
+    // 同步 skills
+    const globalSkillsDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.SKILLS);
+    const projectSkillsDir = path.join(projectDir, '.autospec', 'skills');
+
+    if (fs.existsSync(globalSkillsDir)) {
+      copyDir(globalSkillsDir, projectSkillsDir);
+      results.skillsSynced = true;
+      console.log(chalk.green('  ✓') + ' Skills 已同步');
+    }
+
+    // 同步 knowledge（只同步受控区和自由区）
+    const globalKnowledgeDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.KNOWLEDGE);
+    const projectKnowledgeDir = path.join(projectDir, '.autospec', 'knowledge');
+
+    if (fs.existsSync(globalKnowledgeDir)) {
+      // 只复制 guides/stages 和 domain（自由区）
+      const stagesDir = path.join(globalKnowledgeDir, 'guides', 'stages');
+      const domainDir = path.join(globalKnowledgeDir, 'domain');
+
+      if (fs.existsSync(stagesDir)) {
+        copyDir(stagesDir, path.join(projectKnowledgeDir, 'guides', 'stages'));
+      }
+      if (fs.existsSync(domainDir)) {
+        copyDir(domainDir, path.join(projectKnowledgeDir, 'domain'));
+      }
+      results.knowledgeSynced = true;
+      console.log(chalk.green('  ✓') + ' Knowledge 已同步');
+    }
+
+    console.log('');
+    return results;
+  } catch (e) {
+    results.errors.push(e.message);
+    console.log(chalk.red(`  ✗ 同步失败: ${e.message}`));
+    return results;
+  }
+}
+
+/**
+ * 查看全局状态
+ */
+export function globalStatus(options = {}) {
+  const globalDir = getGlobalDir();
+
+  console.log(chalk.bold('\n  AutoSpec Global Status\n'));
+  console.log(`  Global: ${globalDir}`);
+  console.log();
+
+  // 检查目录是否存在
+  if (!fs.existsSync(globalDir)) {
+    console.log(chalk.yellow('  ⚠ 全局知识库未初始化'));
+    console.log(chalk.cyan('  运行 autospec global init 初始化'));
+    return { initialized: false };
+  }
+
+  // 统计 skills
+  const skillsDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.SKILLS);
+  let skillCount = 0;
+  if (fs.existsSync(skillsDir)) {
+    skillCount = fs.readdirSync(skillsDir).filter(f =>
+      fs.statSync(path.join(skillsDir, f)).isDirectory()
+    ).length;
+  }
+
+  // 统计 roles
+  const rolesDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.ROLES);
+  let roleCount = 0;
+  if (fs.existsSync(rolesDir)) {
+    roleCount = fs.readdirSync(rolesDir).filter(f =>
+      fs.statSync(path.join(rolesDir, f)).isDirectory()
+    ).length;
+  }
+
+  console.log(chalk.green('  ✓') + ' 全局知识库已初始化');
+  console.log(`    Skills: ${skillCount}`);
+  console.log(`    Roles:  ${roleCount}`);
+  console.log('');
+
+  return { initialized: true, skillCount, roleCount };
+}
+
+/**
+ * 发布技能到全局
+ */
+export function publishSkill(skillName, options = {}) {
+  const { version = '1.0.0', message = '', force = false } = options;
+  const globalDir = getGlobalDir();
+  const skillsDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.SKILLS);
+
+  console.log(chalk.bold('\n  AutoSpec Global Publish\n'));
+  console.log(`  Skill: ${skillName}`);
+  console.log(`  Version: ${version}`);
+  console.log();
+
+  try {
+    // 从项目或源码获取技能
+    const projectSkillsDir = path.join(process.cwd(), 'plugins', 'skills', skillName);
+    const projectSkillFile = path.join(projectSkillsDir, 'SKILL.md');
+    const sourceSkillsDir = path.join(process.cwd(), 'plugins', 'skills');
+    const sourceSkillFile = path.join(sourceSkillsDir, skillName, 'SKILL.md');
+
+    let skillContent = null;
+    let sourcePath = null;
+
+    if (fs.existsSync(projectSkillFile)) {
+      skillContent = fs.readFileSync(projectSkillFile, 'utf-8');
+      sourcePath = projectSkillsDir;
+    } else if (fs.existsSync(sourceSkillFile)) {
+      skillContent = fs.readFileSync(sourceSkillFile, 'utf-8');
+      sourcePath = path.join(sourceSkillsDir, skillName);
+    }
+
+    if (!skillContent) {
+      console.log(chalk.red(`  ✗ 技能 ${skillName} 不存在`));
+      return { success: false, error: 'Skill not found' };
+    }
+
+    // 创建技能目录
+    const targetSkillDir = path.join(skillsDir, skillName, `v${version}`);
+    ensureDir(targetSkillDir);
+
+    // 写入技能文件
+    const targetSkillFile = path.join(targetSkillDir, 'SKILL.md');
+    fs.writeFileSync(targetSkillFile, skillContent);
+
+    // 复制 references 目录（如果存在）
+    const sourceRefsDir = path.join(sourcePath, 'references');
+    if (fs.existsSync(sourceRefsDir)) {
+      const targetRefsDir = path.join(targetSkillDir, 'references');
+      copyDir(sourceRefsDir, targetRefsDir);
+    }
+
+    // 更新 latest（副本）
+    fs.writeFileSync(path.join(skillsDir, skillName, 'SKILL.md'), skillContent);
+
+    console.log(chalk.green('  ✓') + ` 技能 ${skillName} v${version} 已发布到全局`);
+    console.log(`    Path: ${targetSkillFile}`);
+    console.log('');
+
+    return { success: true, skillName, version, path: targetSkillFile };
+  } catch (e) {
+    console.log(chalk.red(`  ✗ 发布失败: ${e.message}`));
+    return { success: false, error: e.message };
+  }
+}
+
+/**
+ * global 命令入口
+ */
+export function globalCommand(action, options = {}) {
+  switch (action) {
+    case 'init':
+      return initGlobal(options);
+
+    case 'sync':
+      return syncToProject(options.projectDir || process.cwd(), options);
+
+    case 'status':
+      return globalStatus(options);
+
+    case 'publish':
+      if (!options.skill) {
+        console.log(chalk.red('  ✗ 请指定技能名称'));
+        console.log('  用法: autospec global publish <skill-name>');
+        return { success: false, error: 'Skill name required' };
+      }
+      return publishSkill(options.skill, options);
+
+    default:
+      console.log(chalk.red(`  ✗ 未知操作: ${action}`));
+      console.log('  可用操作: init, sync, status, publish');
+      return { success: false, error: 'Unknown action' };
+  }
+}
+
+export default {
+  initGlobal,
+  syncToProject,
+  globalStatus,
+  publishSkill,
+  globalCommand
+};

package/scripts/cli/index.js

@@ -0,0 +1,55 @@
+/**
+ * AutoSpec CLI entry point
+ *
+ * CLI 命令仅保留 init、update、list，其他功能通过斜杠命令实现
+ */
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initCommand } from './init.js';
+import { updateCommand } from './update.js';
+import { listCommand } from './list.js';
+import { setVerbose, setLogLevel, LOG_LEVELS } from '../install/hook-logger.js';
+
+const VERSION = '0.1.0';
+
+const program = new Command();
+
+program
+  .name('autospec')
+  .description('AI驱动的无人值守自动化产品研发流程')
+  .version(VERSION, '-V, --version')
+  .option('-v, --verbose', 'Enable verbose logging', false)
+  .hook('preAction', (thisCommand) => {
+    const options = thisCommand.opts();
+    if (options.verbose) {
+      setVerbose(true);
+      setLogLevel(LOG_LEVELS.DEBUG);
+    }
+  });
+
+// --- init ---
+program
+  .command('init')
+  .description('Initialize AutoSpec in current project')
+  .option('-w, --workflow <type>', 'Iteration mode (waterfall|agile|experiment|hotfix)', 'waterfall')
+  .option('-r, --roles <roles>', 'Project roles, comma-separated (backend,frontend,data,ai,quality)', '')
+  .option('-d, --domain <domain>', 'Business domain description (free text)', '')
+  .option('--force', 'Force overwrite existing files', false)
+  .option('-v, --verbose', 'Enable verbose logging', false)
+  .action(initCommand);
+
+// --- update ---
+program
+  .command('update')
+  .description('更新框架文件和 Claude Code 命令（保留 state）')
+  .action(updateCommand);
+
+// --- list ---
+program
+  .command('list')
+  .alias('ls')
+  .description('列出所有可用的斜杠命令')
+  .action(listCommand);
+
+program.parse();