@chongyan/autospec 1.0.1

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

@@ -0,0 +1,38 @@
+---
+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

@@ -0,0 +1,195 @@
+---
+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

@@ -0,0 +1,288 @@
+/**
+ * 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
+};