@chongyan/autospec 1.0.2 → 1.0.3

package/plugins/skills/waterfall-iteration/SKILL.md

@@ -1,115 +0,0 @@
----
-name: waterfall-iteration
-description: "瀑布模式下的完整流程执行。从需求分析到交付的完整阶段循环。"
-triggers:
-  - workflow: waterfall
-parameters:
-  currentStage: requirement
-  stages: [requirement, design, implement, test, deliver]
----
-
-# Iteration Waterfall - 瀑布迭代执行
-
-## 概述
-
-瀑布模式的核心是**阶段驱动**的完整流程。与敏捷模式的故事驱动不同，瀑布模式按顺序执行需求→设计→实现→测试→交付的完整阶段循环。
-
-## 输入
-
-- `specs/{feature}/requirement.md`: 需求文档
-- `currentStage`: 当前执行阶段
-- `stages`: 完整阶段列表
-
-## 执行流程
-
-### Step 1: 需求阶段 (Requirement)
-
-```
-1. 读取 specs/{feature}/requirement.md
-2. 需求分析：
-   - 功能需求
-   - 非功能需求
-   - 验收标准
-3. 产出: 需求规格说明书
-4. 验证: 需求完整性检查
-```
-
-### Step 2: 设计阶段 (Design)
-
-```
-1. 架构设计：
-   - 系统架构
-   - 模块划分
-   - 接口定义
-2. 详细设计：
-   - 数据结构
-   - 算法逻辑
-   - 业务流程
-3. 产出: 设计文档
-4. 验证: 设计评审
-```
-
-### Step 3: 实现阶段 (Implement)
-
-```
-1. 编码实现：
-   - 按设计文档编码
-   - 遵循编码规范
-2. 单元测试：
-   - 编写单元测试
-   - 本地快速验证
-3. 产出: 代码实现 + 单元测试
-4. 验证: 编译 + 单元测试通过
-```
-
-### Step 4: 测试阶段 (Test)
-
-```
-1. 集成测试：
-   - 模块集成验证
-   - 接口测试
-2. 系统测试：
-   - 功能测试
-   - 性能测试
-3. 产出: 测试报告
-4. 验证: 所有测试通过
-```
-
-### Step 5: 交付阶段 (Deliver)
-
-```
-1. 部署准备：
-   - 配置整理
-   - 部署文档
-2. 交付验证：
-   - 上线检查
-   - 回滚预案
-3. 产出: 交付物 + 发布说明
-4. 验证: 部署成功
-```
-
-## 阶段验证
-
-| 阶段 | 验证项 | 通过标准 |
-|------|--------|---------|
-| Requirement | 需求完整性 | 需求描述清晰、验收标准完整 |
-| Design | 设计合理性 | 架构设计合理、接口定义完整 |
-| Implement | 代码质量 | 编译通过、单元测试通过 |
-| Test | 测试覆盖 | 功能测试通过、性能达标 |
-| Deliver | 交付完整性 | 部署成功、文档齐全 |
-
-## 与其他迭代模式的区别
-
-| 模式 | 驱动方式 | 适用场景 |
-|------|---------|---------|
-| waterfall-iteration | 阶段驱动 | 需求稳定、项目明确 |
-| agile-iteration | 故事驱动 | 需求变化、增量交付 |
-| hotfix-iteration | 问题驱动 | 紧急修复、快速响应 |
-| experiment-iteration | 假设驱动 | 探索性验证、A/B测试 |
-
-## 注意事项
-
-1. **阶段门禁**：每个阶段必须通过验证才能进入下一阶段
-2. **回退机制**：阶段失败可回退到上一阶段重新处理
-3. **文档驱动**：每个阶段产出明确的文档作为下一阶段输入
-4. **完整流程**：必须走完所有阶段才算完成

package/scripts/cli/global-init.js

@@ -1,288 +0,0 @@
-/**
- * Global Init - 全局初始化脚本
- *
- * 自动在用户主目录创建全局知识库结构
- * 创建 Claude Code skills 符号链接
- * 注册全局 plugin.json
- */
-
-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
-} 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 });
-  }
-}
-
-/**
- * 复制目录
- */
-function copyDir(src, dest) {
-  ensureDir(dest);
-  if (!fs.existsSync(src)) {
-    return;
-  }
-  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 initGlobalKnowledge(options = {}) {
-  const globalDir = getGlobalDir();
-  const results = {
-    directoriesCreated: false,
-    skillsLinked: false,
-    pluginJsonCreated: false,
-    errors: []
-  };
-
-  console.log(chalk.bold('\n  AutoSpec Global Knowledge Init\n'));
-  console.log(`  Target: ${globalDir}`);
-  console.log();
-
-  try {
-    // 1. 创建全局知识库目录结构
-    const subdirs = Object.values(GLOBAL_AUTOSPEC_SUBDIRS);
-    for (const subdir of subdirs) {
-      const fullPath = path.join(globalDir, subdir);
-      ensureDir(fullPath);
-    }
-    results.directoriesCreated = true;
-    console.log(chalk.green('  ✓') + ' 目录结构已创建');
-
-    // 2. 创建 Claude Code skills 符号链接
-    results.skillsLinked = linkClaudeCodeSkills(globalDir);
-    if (results.skillsLinked) {
-      console.log(chalk.green('  ✓') + ' Claude Code skills 已链接');
-    }
-
-    // 3. 创建全局 plugin.json
-    results.pluginJsonCreated = createGlobalPluginJson(globalDir);
-    if (results.pluginJsonCreated) {
-      console.log(chalk.green('  ✓') + ' 全局 plugin.json 已创建');
-    }
-
-    console.log();
-    return results;
-  } catch (e) {
-    results.errors.push(e.message);
-    console.log(chalk.red(`  ✗ 初始化失败: ${e.message}`));
-    return results;
-  }
-}
-
-/**
- * 创建 Claude Code skills 符号链接
- */
-function linkClaudeCodeSkills(globalDir) {
-  const autoSpecSkillsDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.SKILLS);
-  const claudeSkillsDir = getClaudeCodeSkillsDir();
-
-  // 确保 Claude Code skills 目录存在
-  ensureDir(claudeSkillsDir);
-
-  // 创建符号链接指向全局 skills
-  const symlinkPath = path.join(claudeSkillsDir, 'autospec');
-
-  try {
-    // 如果已存在，先删除
-    if (fs.existsSync(symlinkPath)) {
-      const stats = fs.lstatSync(symlinkPath);
-      if (stats.isSymbolicLink()) {
-        fs.unlinkSync(symlinkPath);
-      } else {
-        // 如果是目录，先删除
-        fs.rmSync(symlinkPath, { recursive: true });
-      }
-    }
-
-    // 创建符号链接
-    fs.symlinkSync(autoSpecSkillsDir, symlinkPath, 'dir');
-    return true;
-  } catch (e) {
-    // 符号链接创建失败时使用副本
-    console.log(chalk.yellow(`  ⚠ 符号链接创建失败，使用副本: ${e.message}`));
-
-    const targetPath = path.join(claudeSkillsDir, 'autospec');
-    if (fs.existsSync(targetPath)) {
-      fs.rmSync(targetPath, { recursive: true });
-    }
-    copyDir(autoSpecSkillsDir, targetPath);
-    return true;
-  }
-}
-
-/**
- * 创建全局 plugin.json
- */
-function createGlobalPluginJson(globalDir) {
-  const pluginJsonPath = path.join(globalDir, 'plugin.json');
-
-  const pluginJson = {
-    name: 'autospec-global',
-    version: '1.0.0',
-    namespace: 'autospec',
-    description: 'AutoSpec 全局知识库',
-    skills: [],
-    commands: [],
-    agents: []
-  };
-
-  try {
-    fs.writeFileSync(pluginJsonPath, JSON.stringify(pluginJson, null, 2));
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * 同步全局知识到项目
- */
-export function syncToProject(projectDir, options = {}) {
-  const globalDir = getGlobalDir();
-  const results = {
-    skillsSynced: false,
-    knowledgeSynced: false,
-    errors: []
-  };
-
-  console.log(chalk.bold('\n  Syncing Global Knowledge to Project\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 synced');
-    }
-
-    // 同步 knowledge
-    const globalKnowledgeDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.KNOWLEDGE);
-    const projectKnowledgeDir = path.join(projectDir, '.autospec', 'knowledge');
-
-    if (fs.existsSync(globalKnowledgeDir)) {
-      // 只同步自由区
-      const stagesDir = path.join(globalKnowledgeDir, 'guides', 'stages');
-      const domainDir = path.join(globalKnowledgeDir, 'domain');
-
-      ensureDir(path.join(projectKnowledgeDir, 'guides'));
-
-      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 synced');
-    }
-
-    console.log();
-    return results;
-  } catch (e) {
-    results.errors.push(e.message);
-    console.log(chalk.red(`  ✗ Sync failed: ${e.message}`));
-    return results;
-  }
-}
-
-/**
- * 检查全局知识库是否已初始化
- */
-export function isGlobalInitialized() {
-  const globalDir = getGlobalDir();
-  return fs.existsSync(globalDir);
-}
-
-/**
- * 获取全局知识库状态
- */
-export function getGlobalStatus() {
-  const globalDir = getGlobalDir();
-
-  if (!fs.existsSync(globalDir)) {
-    return { initialized: false };
-  }
-
-  // 统计
-  const skillsDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.SKILLS);
-  let skillCount = 0;
-  if (fs.existsSync(skillsDir)) {
-    skillCount = fs.readdirSync(skillsDir).filter(f => {
-      const fullPath = path.join(skillsDir, f);
-      return fs.statSync(fullPath).isDirectory();
-    }).length;
-  }
-
-  const rolesDir = path.join(globalDir, GLOBAL_AUTOSPEC_SUBDIRS.ROLES);
-  let roleCount = 0;
-  if (fs.existsSync(rolesDir)) {
-    roleCount = fs.readdirSync(rolesDir).filter(f => {
-      const fullPath = path.join(rolesDir, f);
-      return fs.statSync(fullPath).isDirectory();
-    }).length;
-  }
-
-  // 检查 Claude Code skills 链接
-  const claudeSkillsDir = getClaudeCodeSkillsDir();
-  const symlinkPath = path.join(claudeSkillsDir, 'autospec');
-  const skillsLinked = fs.existsSync(symlinkPath);
-
-  return {
-    initialized: true,
-    path: globalDir,
-    skillCount,
-    roleCount,
-    skillsLinked,
-    claudeCodeSkillsPath: symlinkPath
-  };
-}
-
-export default {
-  initGlobalKnowledge,
-  syncToProject,
-  isGlobalInitialized,
-  getGlobalStatus
-};