@chongyan/autospec 1.0.1

package/scripts/cli/init.js

@@ -0,0 +1,382 @@
+/**
+ * AutoSpec init command
+ *
+ * Merged from src/cli/commands/init.js and src/core/init.js
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+import { FRAMEWORK_SRC, FRAMEWORK_DEST } from '../install/constants.js';
+import { generateCommands, generateIntegration } from '../install/index.js';
+import { initGlobalMemory, initProjectMemory, hasGlobalMemory } from '../../plugins/hooks/lib/memory-manager.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
+
+/**
+ * Check if file should be excluded from copy
+ * Exclude README files to avoid noise in user projects
+ */
+function shouldExclude(filename) {
+  // Exclude all README files (README.md, README.en.md, README.zh-CN.md, etc.)
+  if (filename.startsWith('README')) {
+    return true;
+  }
+  return false;
+}
+
+/**
+ * Copy directory recursively, excluding README files
+ */
+function copyDirSync(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+  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()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      // Skip README files
+      if (shouldExclude(entry.name)) {
+        continue;
+      }
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Initialize autospec in target project directory
+ *
+ * Init copies knowledge files and hooks, generates commands/skills/agents.
+ * Runtime directories (runtime/, evolution/, environment/) are auto-created
+ * by hooks when slash commands are executed in Claude Code.
+ */
+export function initProject(targetDir, options = {}) {
+  const knowledgeSrc = path.join(PACKAGE_ROOT, FRAMEWORK_SRC);
+  const knowledgeDest = path.join(targetDir, FRAMEWORK_DEST);
+  const pluginsSrc = path.join(PACKAGE_ROOT, 'plugins');
+  const pluginsDest = path.join(targetDir, '.autospec', 'plugins');
+  const commandsDir = path.join(targetDir, '.claude', 'commands', 'autospec');
+
+  const results = {
+    frameworkCopied: false,
+    pluginsCopied: false,
+    commandsGenerated: false,
+    integrationGenerated: false,
+    claudeMdUpdated: false,
+    globalMemoryInitialized: false,
+    projectMemoryInitialized: false,
+    errors: []
+  };
+
+  // 1. Copy entire knowledge/ directory
+  try {
+    copyDirSync(knowledgeSrc, knowledgeDest);
+    results.frameworkCopied = true;
+  } catch (e) {
+    results.errors.push(`Knowledge copy failed: ${e.message}`);
+  }
+
+  // 1.5 Copy plugins/hooks/ directory (hooks need to be accessible at runtime)
+  try {
+    const hooksSrc = path.join(pluginsSrc, 'hooks');
+    const hooksDest = path.join(pluginsDest, 'hooks');
+    if (fs.existsSync(hooksSrc)) {
+      copyDirSync(hooksSrc, hooksDest);
+      results.pluginsCopied = true;
+    }
+  } catch (e) {
+    results.errors.push(`Plugins copy failed: ${e.message}`);
+  }
+
+  // 2. Generate Claude Code slash commands
+  try {
+    generateCommands(commandsDir);
+    results.commandsGenerated = true;
+  } catch (e) {
+    results.errors.push(`Command generation failed: ${e.message}`);
+  }
+
+  // 3. Generate Claude Code integration (skills + agents + hooks)
+  try {
+    generateIntegration(targetDir);
+    results.integrationGenerated = true;
+  } catch (e) {
+    results.errors.push(`Integration generation failed: ${e.message}`);
+  }
+
+  // 4. Create/update CLAUDE.md
+  try {
+    updateClaudeMd(targetDir);
+    results.claudeMdUpdated = true;
+  } catch (e) {
+    results.errors.push(`CLAUDE.md update failed: ${e.message}`);
+  }
+
+  // 5. Create .autospec directory (hooks will auto-create subdirectories when needed)
+  const autospecDir = path.join(targetDir, '.autospec');
+  if (!fs.existsSync(autospecDir)) {
+    fs.mkdirSync(autospecDir, { recursive: true });
+  }
+
+  // 6. Create .autospec/package.json with "type": "module" to support ESM hooks
+  const autospecPackageJson = path.join(autospecDir, 'package.json');
+  if (!fs.existsSync(autospecPackageJson)) {
+    fs.writeFileSync(autospecPackageJson, JSON.stringify({
+      name: 'autospec-config',
+      version: '1.0.0',
+      type: 'module',
+      description: 'AutoSpec configuration directory'
+    }, null, 2), 'utf-8');
+  }
+
+  // 7. Initialize memory system (global + project)
+  try {
+    // Initialize global memory if not exists
+    if (!hasGlobalMemory()) {
+      initGlobalMemory();
+      results.globalMemoryInitialized = true;
+    }
+  } catch (e) {
+    results.errors.push(`Global memory init failed: ${e.message}`);
+  }
+
+  try {
+    // Initialize project memory
+    initProjectMemory(targetDir);
+    results.projectMemoryInitialized = true;
+  } catch (e) {
+    results.errors.push(`Project memory init failed: ${e.message}`);
+  }
+
+  return results;
+}
+
+function updateClaudeMd(targetDir) {
+  const claudeMd = path.join(targetDir, 'CLAUDE.md');
+  const block = `
+# AutoSpec Integration
+
+本项目使用 AutoSpec 自动化研发流程。
+
+## 启动门禁
+
+收到任何开发类任务时，**必须先执行启动门禁**（startup-guard skill 会自动提醒）：
+1. 读取 \`.autospec/knowledge/process/overview.md\`
+2. 读取 \`.autospec/knowledge/principles/constitution.md\`
+3. 确认执行模式（自主/交互）和工作流类型
+4. 向用户确认任务范围
+
+**违反 = 宪法违规 → 立即停止。**
+
+## 命令速查
+
+| 命令 | 说明 |
+|------|------|
+| \`/autospec:run\` | 全流程自主执行（推荐） |
+| \`/autospec:explore\` | 需求探索 |
+| \`/autospec:propose\` | 方案设计 |
+| \`/autospec:apply\` | 实施（编码 + 审查 + 测试） |
+| \`/autospec:archive\` | 交付归档 |
+| \`/autospec:evolve\` | 自进化触发 |
+| \`/autospec:status\` | 查看状态 |
+| \`/autospec:validate\` | Layer 1 验证 |
+
+**迭代模式选择**（通过 /autospec:run）：
+- \`--workflow=waterfall\` Waterfall (default)
+- \`--workflow=agile\` Agile
+- \`--workflow=experiment\` Experiment (AI/ML)
+- \`--workflow=hotfix\` Hotfix
+
+## 推荐组合
+
+先探索后执行效果更佳：
+1. /autospec:explore → 需求探索澄清
+2. 将探索结果作为上下文输入 → /autospec:run <探索结果>
+
+这样可以让 AI 更准确地理解需求，避免方向偏差。
+
+**也可以直接运行**：直接使用 /autospec:run 时，AI 会通过内部 agent 对抗博弈自动整理需求，但可能不如先探索再运行准确。
+
+## Skills（自动感知）
+
+以下 skills 会根据场景自动触发，为 Claude 注入对应阶段的流程意识：
+
+| Skill | 触发场景 |
+|-------|---------|
+| startup-guard | 检测到开发类任务 → 强制启动门禁 |
+| layer1-validation | 代码变更后 → 提醒运行 Layer 1 验证 |
+| requirement-stage | 需求分析场景 → 加载需求分析流程 |
+| design-stage | 方案设计场景 → 加载设计流程 |
+| implementation-stage | 编码实现场景 → 加载实现流程 |
+| testing-stage | 测试场景 → 加载测试流程 |
+| delivery-stage | 交付部署场景 → 加载交付流程 + 自动记录 practice-log + 进化扫描 |
+| evolution-process | 框架进化场景 → 加载进化流程（强制执行 meta skills） |
+| pending-dashboard | 新会话启动 → 扫描待处理提案/practice-log/中断流程 |
+
+## 审查 Agent（做审分离）
+
+Layer 2 审查使用独立 Agent，实现信息隔离（DP2）：
+
+| Agent | 用途 | 隔离方式 |
+|-------|------|---------|
+| independent-reviewer | 需求/设计/代码审查 | 只读权限，不知生产过程 |
+| test-coverage-reviewer | 测试充分性审查 | 只读权限，独立评估覆盖度 |
+| consistency-checker | 跨产物一致性检查（DP18） | 只读权限，六维检测 |
+| ceo | CEO/战略视角需求探索 | 只读权限，聚焦商业价值 |
+| product-owner | 产品落地挑战（与 CEO 博弈） | 只读权限，聚焦可行性 |
+| stage-gate-evaluator | 自主阶段产出审批（替代人工确认） | 只读权限，客观评估产出质量 |
+| safety-auditor | 不可逆操作安全审计（DB 迁移/部署） | 只读权限，安全风险评估 |
+| failure-diagnostician | 自主故障诊断 | 只读权限，根因分析 + 决策 |
+
+**CEO 探索机制**：需求分析阶段前置步骤。
+- 自主模式：ceo + product-owner 自动对话博弈
+- 交互模式：围绕 5 个战略维度与用户交互
+
+调用方式：Agent 工具，只传入产出物 + 审查标准 + 上游契约，不传入生产过程上下文。
+
+## Hooks
+
+已配置确定性 hooks（见 .claude/settings.json）：
+- **frozen-zone-guard**: 阻止修改宪法/进化规则等冻结区文件
+- **constitution-guard**: 提醒执行启动门禁协议（读取宪法 + 概述）
+- **scope-sentinel**: 编码阶段偏航检测（修改范围外文件时三级递增提醒）
+- **layer1-validator**: Layer 1 强制检查 + 结果捕获 + 质量指标追踪
+- **environment-manager**: 环境知识验证 + 未注册中间件检测
+- **ai-project-guard**: AI 项目安全检查 + 效果验证
+- **execution-tracker**: 执行日志追踪（skill 加载、agent 调用、产物生成）
+`;
+
+  if (fs.existsSync(claudeMd)) {
+    const content = fs.readFileSync(claudeMd, 'utf-8');
+    if (!content.includes('# AutoSpec Integration')) {
+      fs.appendFileSync(claudeMd, '\n' + block);
+    }
+  } else {
+    fs.writeFileSync(claudeMd, block.trim() + '\n');
+  }
+}
+
+/**
+ * Check if running as root and warn user
+ */
+function checkRootPermission() {
+  if (process.getuid && process.getuid() === 0) {
+    console.log('');
+    console.log(chalk.bold.yellow('  ⚠️  权限警告'));
+    console.log('');
+    console.log('  正在以 root 身份运行 autospec init');
+    console.log('  创建的 .autospec 和 .claude 目录将属于 root 用户');
+    console.log('');
+    console.log(chalk.bold('  后续操作建议：'));
+    console.log('');
+    console.log('  方案一：后续命令也用 sudo 运行');
+    console.log(chalk.dim('    sudo claude'));
+    console.log('');
+    console.log('  方案二：修复权限后用普通用户运行');
+    console.log(chalk.dim('    sudo chown -R $(whoami) .autospec .claude CLAUDE.md'));
+    console.log('');
+    console.log('  方案三：删除后不使用 sudo 重新初始化');
+    console.log(chalk.dim('    sudo rm -rf .autospec .claude CLAUDE.md'));
+    console.log(chalk.dim('    autospec init'));
+    console.log('');
+  }
+}
+
+export function initCommand(options) {
+  const targetDir = process.cwd();
+
+  // Pass verbose option to initProject
+  if (options.verbose) {
+    process.env.AUTOSPEC_VERBOSE = 'true';
+  }
+
+  console.log(chalk.bold('\n  AutoSpec Init\n'));
+  console.log(`  Target:   ${targetDir}`);
+  console.log(`  Workflow: ${options.workflow}`);
+  console.log(`  Roles:    ${options.roles || '(none)'}`);
+  console.log(`  Domain:   ${options.domain}`);
+  if (options.verbose) {
+    console.log(chalk.dim('  Verbose:  enabled'));
+  }
+  console.log();
+
+  const roles = options.roles ? options.roles.split(',').map(r => r.trim()) : [];
+
+  const result = initProject(targetDir, {
+    workflow: options.workflow,
+    roles,
+    domain: options.domain,
+    verbose: options.verbose
+  });
+
+  // Results
+  if (result.frameworkCopied) {
+    console.log(chalk.green('  ✓') + ' Knowledge      .autospec/knowledge/');
+  }
+  if (result.commandsGenerated) {
+    console.log(chalk.green('  ✓') + ' Commands (17)  .claude/commands/autospec/');
+  }
+  if (result.integrationGenerated) {
+    console.log(chalk.green('  ✓') + ' Skills (9)     .claude/skills/');
+    console.log(chalk.green('  ✓') + ' Agents (16)    .claude/agents/');
+    console.log(chalk.green('  ✓') + ' Hooks          .claude/settings.json');
+  }
+  if (result.claudeMdUpdated) {
+    console.log(chalk.green('  ✓') + ' CLAUDE.md      updated');
+  }
+  if (result.globalMemoryInitialized) {
+    console.log(chalk.green('  ✓') + ' Global Memory  ~/.autospec-global/memory/');
+  }
+  if (result.projectMemoryInitialized) {
+    console.log(chalk.green('  ✓') + ' Project Memory .autospec/memory/');
+  }
+
+  if (result.errors.length > 0) {
+    console.log(chalk.red('\n  Errors:'));
+    result.errors.forEach(e => console.log(chalk.red('    ✗ ' + e)));
+  }
+
+  // 使用指南
+  console.log(chalk.bold('\n  快速开始\n'));
+
+  console.log(chalk.cyan('  自主模式（推荐）'));
+  console.log('    /autospec:run <任务描述>   启动完整流程，AI 自主执行');
+  console.log('    /autospec:run              基于已有探索上下文继续执行');
+  console.log('');
+  console.log(chalk.dim('  💡 建议先执行需求探索，再启动自主运行，可以更精准地完成任务'));
+  console.log(chalk.dim('    /autospec:explore          需求探索 - 澄清需求、识别约束'));
+  console.log('');
+
+  console.log(chalk.cyan('  交互模式'));
+  console.log('  分阶段执行，每阶段人工确认：');
+  console.log('');
+  console.log('    /autospec:explore      需求探索 - 澄清需求、识别约束');
+  console.log('    /autospec:propose      方案设计 - 技术方案、任务拆分');
+  console.log('    /autospec:apply        实施 - 编码、审查、测试');
+  console.log('    /autospec:archive      交付归档 - 文档、部署、复盘');
+  console.log('');
+
+  console.log(chalk.cyan('  环境同步'));
+  console.log('    /autospec:env-sync     同步环境知识到 AI 上下文');
+  console.log('');
+
+  console.log(chalk.cyan('  记忆管理'));
+  console.log('    /autospec:memory status     查看记忆系统状态');
+  console.log('    /autospec:memory show core  显示北极星指标');
+  console.log('');
+
+  console.log(chalk.dim('  更多命令: autospec list'));
+  console.log(chalk.dim('  帮助信息: autospec help <command>'));
+  console.log('');
+  console.log(chalk.green('  准备就绪，运行 /autospec:run <任务描述> 开始') + '\n');
+
+  // 权限检查：放在最后，确保用户能看到
+  checkRootPermission();
+}

package/scripts/cli/list.js

@@ -0,0 +1,69 @@
+/**
+ * autospec list command - 显示所有可用的斜杠命令
+ */
+
+import chalk from 'chalk';
+import { COMMAND_DEFINITIONS } from '../config/commands.config.js';
+
+export function listCommand() {
+  console.log(chalk.bold('\n  AutoSpec 斜杠命令\n'));
+
+  // 核心流程命令
+  console.log(chalk.cyan('  核心流程'));
+  console.log('    /autospec:run <任务>   启动完整流程（瀑布/敏捷/实验/热修复）');
+  console.log('    /autospec:run          基于已有探索上下文继续执行');
+  console.log('    /autospec:explore      需求探索阶段');
+  console.log('    /autospec:propose      方案设计阶段');
+  console.log('    /autospec:apply        实施阶段（编码+审查+测试）');
+  console.log('    /autospec:archive      交付归档阶段');
+  console.log('    /autospec:evolve       自进化循环');
+  console.log('');
+
+  // 状态与验证命令
+  console.log(chalk.cyan('  状态与验证'));
+  console.log('    /autospec:status       查看流程状态');
+  console.log('    /autospec:validate     Layer 1 确定性验证');
+  console.log('    /autospec:review       审查交付物');
+  console.log('    /autospec:evaluate     生成评测报告');
+  console.log('');
+
+  // 环境管理命令
+  console.log(chalk.cyan('  环境管理'));
+  console.log('    /autospec:env          查看环境配置');
+  console.log('    /autospec:env-validate 验证环境配置');
+  console.log('    /autospec:env-sync     同步环境知识（含初始化）');
+  console.log('    /autospec:env-import   导入知识库');
+  console.log('    /autospec:env-export   导出知识库');
+  console.log('');
+
+  // 组件命令
+  console.log(chalk.cyan('  组件管理'));
+  console.log('    /autospec:component    列出已注册组件');
+  console.log('    /autospec:component-add 添加组件知识');
+  console.log('');
+
+  // 迭代模式
+  console.log(chalk.cyan('  迭代模式 (via /autospec:run)'));
+  console.log('    --workflow=waterfall   瀑布模式（默认）');
+  console.log('    --workflow=agile       敏捷模式');
+  console.log('    --workflow=experiment  实验模式（AI/ML）');
+  console.log('    --workflow=hotfix      热修复模式');
+  console.log('');
+
+  // 提示
+  console.log(chalk.dim('  文档: .autospec/knowledge/'));
+  console.log(chalk.dim('  配置: .claude/settings.json'));
+  console.log('');
+}
+
+/**
+ * 获取命令列表（供其他模块使用）
+ */
+export function getCommandList() {
+  return Object.entries(COMMAND_DEFINITIONS)
+    .filter(([, config]) => !config.internal)
+    .map(([name, config]) => ({
+      name: `/autospec:${name}`,
+      description: config.description
+    }));
+}