@chongyan/autospec 1.0.1 → 1.0.3

package/plugins/skills/startup-guard/SKILL.md

@@ -1,38 +0,0 @@
----
-name: startup-guard
-description: "When a development task, coding request, feature implementation, or bug fix is detected — but NO /autospec: command was used — ensures AutoSpec startup gate protocol is followed before any code is written."
----
-
-# AutoSpec 启动门禁（自动触发）
-
-你检测到了一个开发类任务，但用户**没有通过 /autospec: 命令启动**。
-
-## 跳过条件
-
-如果用户已经通过以下任一命令启动流程，**本 skill 不生效**（用户主动走流程 = 门禁已过）：
-- `/autospec:run`（含 --workflow 参数）
-- `/autospec:explore`、`/autospec:propose`、`/autospec:apply`、`/autospec:archive`
-
-## 门禁检查（仅非命令触发时执行）
-
-1. 确认 `.autospec/knowledge/` 存在（如不存在，提示用户运行 `autospec init`）
-2. **情境识别（CP2）**：分析任务类型，推荐最匹配的迭代模式：
-   - 新功能/大变更 → `/autospec:run --workflow=waterfall` 或 `/autospec:explore`
-   - 紧急bug修复 → `/autospec:run --workflow=hotfix`
-   - 技术可行性验证 → `/autospec:run --workflow=experiment`
-   - 用户故事迭代 → `/autospec:run --workflow=agile`
-3. 提醒用户：检测到开发任务，建议通过 AutoSpec 流程执行
-4. 推荐命令：
-   - `/autospec:run` — 完整流程 + 模式选择（推荐）
-   - `/autospec:explore` — 从需求探索开始
-   - `/autospec:run --workflow=hotfix` — 快速修复
-   - `/autospec:run --workflow=experiment` — 技术探索
-   - `/autospec:run --workflow=agile` — 敏捷迭代
-5. 如果用户明确表示不走流程，尊重用户选择
-
-## 违规处理
-
-如果发现自己已经跳过门禁开始写代码（且不是通过 / 命令触发的）：
-- **立即停止**
-- 提醒用户可以使用 `/autospec:run` 启动流程
-- 或使用 `/autospec:run --workflow=hotfix`、`/autospec:run --workflow=experiment` 选择更轻量的模式

package/plugins/skills/testing-stage/SKILL.md

@@ -1,195 +0,0 @@
----
-name: testing-stage
-description: "When test case generation, QA testing, test plan creation, or test coverage analysis is needed — loads AutoSpec testing process and skill."
----
-
-# AutoSpec QA测试（Stage 05）
-
-你正在执行QA测试阶段。此阶段从用户视角验证产品功能正确性。
-
-## 前置检查
-
-1. 确认代码审查阶段已完成（检查 `.autospec/runtime/state.json`）
-2. 读取 `${KNOWLEDGE}/principles/constitution.md` → 确认红线
-3. 读取需求文档（验收标准是测试用例的基础）
-4. **检查是否为多系统项目**：读取 `.autospec/runtime/config.json` 的 `subsystems` 字段
-5. **检查是否需要效果评测**：检查是否有 ai 类型子系统或 needsEvaluation=true
-6. 如有角色配置，加载 `${KNOWLEDGE}/guides/stages/{角色}-profile.md` 中**QA测试阶段**关注点（如后端关注接口契约测试/数据一致性测试）
-7. 加载认知增强原则：读取 `${KNOWLEDGE}/principles/core-principles.md` → 本阶段重点应用 CP6(错误即信号)、CP10(自我质检)、CP1(合伙人模式)
-
-## 执行
-
-### Step 1: 确定模式
-
-读取 `.autospec/runtime/config.json`，检查 `subsystems` 字段：
-- **无 subsystems 或长度为1** → 单系统模式
-- **有 subsystems 且长度>1** → 多系统模式
-
-检查是否需要效果评测：
-- 有 `type: ai` 的子系统或 `needsEvaluation: true` → 需要效果评测开发
-
-### Step 2: 单系统模式（普通功能）
-
-1. **【强制】** 加载做类skill：读取 `${KNOWLEDGE}/guides/stages/test-planner.md` → **测试方案规划**
-2. **【强制】** 加载做类skill：读取 `${KNOWLEDGE}/guides/stages/test-generator.md` → **测试代码生成**
-3. 加载方法论原则：读取 `${KNOWLEDGE}/principles/core-principles.md` → 注入 P1(验证为王) 测试原则
-4. 逐条对照需求验收标准，生成测试用例
-5. 生成边界条件和异常路径测试
-6. 针对关键假设设计验证用例
-7. 如有角色特有测试关注点（如后端的"幂等验证"、前端的"跨浏览器兼容"），额外覆盖
-8. 将测试用例转化为可执行的测试代码
-9. **运行所有测试**，生成测试报告
-
-### Step 3: 多系统模式
-
-1. **各子系统测试**：
-   ```
-   for subsystem in config.subsystems:
-     a. 运行 {subsystem.test}
-     b. 收集测试结果
-     c. 产出 tests/{subsystem.name}.md
-   ```
-
-2. **集成测试**：
-   - 设计跨系统测试场景（基于 design/overview.md 中的系统交互）
-   - 执行端到端测试
-   - 产出 `tests/integration.md`
-
-3. **验收标准对照**：
-   - 逐条对照需求文档中的验收标准
-   - 确保每条标准都有对应测试覆盖
-
-### Step 4: 效果评测开发（AI/模型类功能）
-
-当项目包含 AI/模型 相关功能时，测试阶段需要额外开发：
-
-#### 4.1 评测需求分析
-
-1. 从需求文档中提取效果相关指标：
-   - 准确率、召回率、F1等（分类任务）
-   - BLEU、ROUGE等（生成任务）
-   - 任务完成率、响应质量（智能体）
-   - 业务效果指标（转化率、用户满意度等）
-
-2. 确定评测方法：
-   - 自动评测（有标注数据）
-   - 人工评测（需要评测人员）
-   - A/B测试（线上对比）
-   - LLM-as-Judge（用LLM评估LLM）
-
-#### 4.2 评测数据集构建
-
-1. 从需求中提取典型场景
-2. 构造正例和反例
-3. 标注预期结果
-4. 写入 `tests/evaluation/dataset/`
-
-#### 4.3 评测脚本开发
-
-产出 `tests/evaluation/evaluator.py`：
-- 加载模型/智能体
-- 执行评测数据集
-- 计算效果指标
-- 生成评测报告
-
-#### 4.4 智能体评测
-
-如果项目包含智能体（Agent）功能：
-
-1. **任务完成评测**：定义评测任务集，执行并判断成功率
-2. **响应质量评测**：使用LLM-as-Judge评估
-3. **工具使用评测**：验证工具调用正确性
-
-#### 4.5 数据系统测试
-
-如果项目包含数据系统（data类型）：
-
-1. **数据质量测试**：完整性、一致性、准确性检查
-2. **ETL流程测试**：数据转换正确性、异常处理
-3. **性能测试**：大数据量处理能力
-
-#### 4.6 评测报告生成
-
-产出 `tests/evaluation-report.md`：
-- 评测概述（方法、数据集规模）
-- 效果指标结果
-- 与基线/目标对比
-- Badcase分析
-- 改进建议
-
-## 认知纪律（本阶段：批判思维 + 错误捕获）
-
-- **CP6 错误即信号**：测试失败不是坏事，是发现问题的好时机。每个失败的测试用例都要分析根因：是代码bug？需求歧义？还是测试用例设计问题？
-- **CP10 自我质检**：测试完成前自问：我是否覆盖了所有验收标准？核心路径都测了吗？有没有"看起来测了很多但关键的没测"的情况？
-- **CP1 合伙人模式**：如果测试过程中发现需求或设计的缺陷，必须指出，不要只是让测试通过
-
-## 验证
-
-### Layer 1: 确定性验证
-- 所有测试用例执行通过
-- 测试覆盖率满足要求
-- 无跳过或被禁用的测试
-- **多系统模式**：所有子系统测试都通过
-- **效果评测模式**：评测脚本可运行，评测报告已产出
-
-### Layer 2: AI审查（做审分离）
-使用 **test-coverage-reviewer** Agent（专用测试审查Agent）执行独立审查：
-```
-**【强制】** 调用 Agent 工具：
-  prompt: 请审查以下测试方案和结果。
-    1. 先读取审查标准: ${KNOWLEDGE}/guides/stages/test-reviewer.md
-    2. 测试用例和测试代码
-    3. 测试执行报告（或 tests/ 目录）
-    4. 上游需求文档: .autospec/specs/{feature}/requirement.md（用于验证覆盖度）
-    5. 关键假设清单
-    注意：你是独立审查者，评估测试充分性，不参考测试生成过程
-```
-
-### Layer 3: Benchmarks 评测（新增）
-
-**【强制】** 执行 testing benchmarks 评测：
-```
-1. 执行测试套件，收集覆盖率报告
-2. 调用 benchmark-executor 执行评测：
-   - TST-001: 测试覆盖率（行覆盖>=80%、分支覆盖>=70%、核心功能100%）
-   - TST-002: 测试质量（无Flaky test、执行时间<5分钟、测试数据独立）
-   - TST-003: 集成测试（关键路径有集成测试、契约测试覆盖）
-3. 生成评测报告到 .autospec/benchmarks/results/testing-{run-id}.json
-4. 如评测未通过：
-   - 生成改进建议
-   - 返回 Step 2 补充测试
-   - 最多重试 3 次
-5. 如评测通过：
-   - 记录评测结果
-   - 允许进入 delivery stage
-```
-
-**评测触发方式**：
-- 自动触发：测试执行完成后自动执行
-- 手动触发：`/benchmark --run --stage=testing`
-- 变更触发：tests/ 目录修改后自动重新评测
-
-## 阶段门禁（所有自主级别）
-
-使用 **stage-gate-evaluator** Agent 评估产出物是否达到准出标准：
-```
-**【强制】** 调用 Agent 工具：
-  prompt: 请评估QA测试阶段的产出物是否达到准出标准。
-    当前阶段：Stage 05 QA测试
-    产出物：测试用例 + 测试执行报告（或 tests/ 目录）
-    准出标准：测试覆盖率 + 验收标准覆盖度
-    上游契约：.autospec/specs/{feature}/requirement.md
-    自主级别：{自主/交互}
-```
-
-**根据自主级别处理评估结果**：
-- **交互模式**：评估结果提交人工确认，AI 等待用户批准后继续
-- **自主模式**：评估通过后自动进入下一阶段，评估不通过进入精准回退
-
-## 完成
-
-- 两层验证通过 + 阶段门禁评估通过 → 输出测试报告 → 更新 `.autospec/runtime/state.json` → 进入交付部署
-- 不通过 → 精准回退：
-  - Level 1: 内联重试（单次）
-  - Level 2: 修正循环（最多3次，只重处理失败项）
-  - Level 3: 3次后使用 **failure-diagnostician** Agent 执行根因分析，再升级用户

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
-};