@chongyan/autospec 1.0.1 → 1.0.2

package/plugins/skills/project-evolve-scanner/scripts/subsystem-coverage.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+
+/**
+ * Subsystem Coverage Checker
+ *
+ * 检查多系统开发中的子系统实现覆盖情况
+ *
+ * 功能：
+ * 1. 读取设计文档，提取子系统清单
+ * 2. 扫描代码目录，检测实际修改的文件
+ * 3. 对比两者，输出覆盖报告
+ * 4. 供 CLI 命令和 Hook 调用
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { loadState, getSubsystemCoverage, normalizeSubsystems } from '../state.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * 读取设计文档，提取子系统清单
+ * @param {string} projectDir - 项目根目录
+ * @returns {Array} 设计文档中定义的子系统列表
+ */
+function extractSubsystemsFromDesign(projectDir) {
+  const designDir = path.join(projectDir, 'design');
+  const overviewPath = path.join(designDir, 'overview.md');
+
+  if (!fs.existsSync(overviewPath)) {
+    return [];
+  }
+
+  const content = fs.readFileSync(overviewPath, 'utf-8');
+  const subsystems = [];
+
+  // 简单的子系统提取逻辑
+  // 匹配 ##子系统名称 或 ### 子系统名称
+  const lines = content.split('\n');
+  for (const line of lines) {
+    const match = line.match(/^#{2,3}\s+(.+)$/);
+    if (match) {
+      const name = match[1].trim();
+      // 过滤掉非子系统标题
+      if (!['概述', ' Overview', '架构', ' Architecture', '目录', 'TOC'].includes(name)) {
+        subsystems.push({
+          name,
+          path: name.toLowerCase().replace(/\s+/g, '-'),
+        });
+      }
+    }
+  }
+
+  return subsystems;
+}
+
+/**
+ * 扫描代码目录，检测实际实现的文件
+ * @param {string} projectDir - 项目根目录
+ * @returns {Object} 各子系统的文件列表
+ */
+function scanCodeDirectories(projectDir) {
+  const result = {
+    backend: [],
+    frontend: [],
+    mobile: [],
+    data: [],
+    other: [],
+  };
+
+  const dirs = {
+    backend: ['backend', 'server', 'api', 'service'],
+    frontend: ['frontend', 'web', 'client', 'app'],
+    mobile: ['mobile', 'ios', 'android'],
+    data: ['data', 'warehouse', 'datalake'],
+  };
+
+  function scanDir(dir, category) {
+    if (!fs.existsSync(dir)) return;
+
+    try {
+      const files = fs.readdirSync(dir, { withFileTypes: true });
+      for (const file of files) {
+        const fullPath = path.join(dir, file.name);
+        if (file.isDirectory()) {
+          if (!file.name.startsWith('.') && file.name !== 'node_modules') {
+            scanDir(fullPath, category);
+          }
+        } else if (/\.(js|ts|jsx|tsx|java|go|py|rb)$/.test(file.name)) {
+          result[category].push(path.relative(projectDir, fullPath));
+        }
+      }
+    } catch (e) {
+      // 忽略权限错误
+    }
+  }
+
+  for (const [category, dirNames] of Object.entries(dirs)) {
+    for (const dirName of dirNames) {
+      const dirPath = path.join(projectDir, dirName);
+      if (fs.existsSync(dirPath)) {
+        scanDir(dirPath, category);
+      }
+    }
+  }
+
+  // 其他目录
+  const rootFiles = fs.readdirSync(projectDir, { withFileTypes: true });
+  for (const file of rootFiles) {
+    if (file.isDirectory() && !file.name.startsWith('.') && !['node_modules', 'design', 'docs', 'scripts'].includes(file.name)) {
+      const category = 'other';
+      scanDir(path.join(projectDir, file.name), category);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 对比设计与实现，生成覆盖报告
+ * @param {Array} designSubsystems - 设计文档中的子系统
+ * @param {Object} codeFiles - 实际代码文件
+ * @returns {Object} 覆盖报告
+ */
+function generateCoverageReport(designSubsystems, codeFiles) {
+  const report = {
+    total: designSubsystems.length,
+    covered: 0,
+    uncovered: [],
+    details: [],
+  };
+
+  for (const subsystem of designSubsystems) {
+    const subsystemPath = subsystem.path;
+    const matchedFiles = [];
+
+    // 搜索匹配的文件
+    for (const [category, files] of Object.entries(codeFiles)) {
+      for (const file of files) {
+        if (file.includes(subsystemPath) || file.includes(subsystem.name.toLowerCase())) {
+          matchedFiles.push({ file, category });
+        }
+      }
+    }
+
+    if (matchedFiles.length > 0) {
+      report.covered++;
+      report.details.push({
+        subsystem: subsystem.name,
+        status: 'covered',
+        files: matchedFiles,
+      });
+    } else {
+      report.uncovered.push(subsystem.name);
+      report.details.push({
+        subsystem: subsystem.name,
+        status: 'uncovered',
+        files: [],
+      });
+    }
+  }
+
+  report.coverage = report.total > 0 ? Math.round((report.covered / report.total) * 100) : 0;
+
+  return report;
+}
+
+/**
+ * 解析命令行参数
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const options = {
+    project: '.',
+    verbose: false,
+    output: null,
+    json: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--project':
+      case '-p':
+        options.project = args[++i];
+        break;
+      case '--verbose':
+      case '-v':
+        options.verbose = true;
+        break;
+      case '--output':
+      case '-o':
+        options.output = args[++i];
+        break;
+      case '--json':
+        options.json = true;
+        break;
+      case '--help':
+      case '-h':
+        printHelp();
+        process.exit(0);
+        break;
+    }
+  }
+
+  return options;
+}
+
+function printHelp() {
+  console.log(`
+Subsystem Coverage Checker
+
+用法：
+  node subsystem-coverage.js --project <path> [选项]
+
+选项：
+  -p, --project <path>   项目路径（默认：当前目录）
+  -o, --output <path>   输出报告路径（默认：stdout）
+  -v, --verbose         详细输出
+  -j, --json            JSON 格式输出
+  -h, --help            显示帮助
+
+示例：
+  node subsystem-coverage.js --project ./my-project
+  node subsystem-coverage.js --project ./my-project --output report.json
+`);
+}
+
+/**
+ * 主函数
+ */
+async function main() {
+  const options = parseArgs();
+
+  console.log('🔍 Subsystem Coverage Checker\n');
+
+  try {
+    // 1. 提取设计文档中的子系统
+    console.log('📋 提取设计文档子系统...');
+    const designSubsystems = extractSubsystemsFromDesign(options.project);
+    console.log(`   发现子系统: ${designSubsystems.length}`);
+
+    if (designSubsystems.length === 0) {
+      console.log('\n⚠️  未找到设计文档或子系统定义');
+      console.log('   请确保 design/overview.md 存在且包含子系统标题');
+      process.exit(0);
+    }
+
+    // 2. 扫描代码目录
+    console.log('\n📂 扫描代码目录...');
+    const codeFiles = scanCodeDirectories(options.project);
+    let totalFiles = 0;
+    for (const files of Object.values(codeFiles)) {
+      totalFiles += files.length;
+    }
+    console.log(`   扫描文件: ${totalFiles}`);
+
+    // 3. 生成覆盖报告
+    console.log('\n📊 生成覆盖报告...\n');
+    const report = generateCoverageReport(designSubsystems, codeFiles);
+
+    // 4. 输出报告
+    if (options.json) {
+      const output = JSON.stringify(report, null, 2);
+      if (options.output) {
+        fs.writeFileSync(options.output, output);
+        console.log(`✅ 报告已保存: ${options.output}`);
+      } else {
+        console.log(output);
+      }
+    } else {
+      console.log(`覆盖率: ${report.coverage}%`);
+      console.log(`已覆盖: ${report.covered}/${report.total}`);
+
+      if (report.uncovered.length > 0) {
+        console.log(`\n⚠️  未覆盖的子系统:`);
+        for (const name of report.uncovered) {
+          console.log(`   - ${name}`);
+        }
+      }
+
+      if (options.verbose) {
+        console.log('\n📝 详细情况:');
+        for (const detail of report.details) {
+          console.log(`\n${detail.subsystem}: ${detail.status}`);
+          if (detail.files.length > 0) {
+            for (const f of detail.files) {
+              console.log(`   - ${f.file} (${f.category})`);
+            }
+          }
+        }
+      }
+
+      if (options.output) {
+        fs.writeFileSync(options.output, JSON.stringify(report, null, 2));
+        console.log(`\n✅ 报告已保存: ${options.output}`);
+      }
+    }
+
+    process.exit(0);
+
+  } catch (error) {
+    console.error('\n❌ 检查失败:', error.message);
+    if (options.verbose) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}
+
+main().catch(error => {
+  console.error('未捕获的错误:', error);
+  process.exit(1);
+});

package/plugins/skills/project-evolve-verifier/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: project-evolve-verifier
+description: "效果验证：验证修复效果，检测退化，计算质量分数变化"
+type: verifier
+---
+
+# Project-Evolve Verifier
+
+## 定位
+
+效果验证技能，验证修复效果，检测退化，计算质量分数变化。
+
+## 输入
+
+- 修复记录（来自 fixer）
+- 修复前基线指标
+
+## 输出
+
+- 验证结果：通过/失败
+- 退化检测：是否发生退化
+- 质量分数：修复前后对比
+
+## 执行步骤
+
+### Step 1: 基线对比
+
+```
+记录修复前：
+1. 代码复杂度
+2. 测试覆盖率
+3. 构建时间
+4. 代码行数
+```
+
+### Step 2: 修复验证
+
+```
+验证每个修复：
+1. 运行测试
+2. 检查构建
+3. 验证功能
+4. 记录结果
+```
+
+### Step 3: 退化检测
+
+```
+检测退化：
+1. 对比修复前后指标
+2. 检查测试是否通过
+3. 验证性能影响
+4. 标记异常
+```
+
+### Step 4: 回滚处理
+
+```
+如检测到退化：
+1. 自动回滚修复
+2. 记录退化原因
+3. 生成警告报告
+4. 标记需人工处理
+```
+
+### Step 5: 质量评分
+
+```
+计算质量分数：
+1. 综合评分
+2. 各维度评分
+3. 分数变化
+4. 趋势分析
+```
+
+## 使用示例
+
+```
+# 执行效果验证
+读取 plugins/skills/project-evolve-verifier/SKILL.md 并执行
+
+# 输出
+- 验证项: 15
+- 通过: 14
+- 失败: 1
+- 退化: 无
+- 质量分数: +5 (70→75)
+```
+
+## 验证维度
+
+| 维度 | 验证内容 | 方法 |
+|------|----------|------|
+| 功能验证 | 代码功能正常 | 运行测试 |
+| 质量验证 | 复杂度降低 | 静态分析 |
+| 性能验证 | 运行无退化 | 性能测试 |
+| 集成验证 | 构建成功 | CI 检查 |
+
+## 与 self-evolve-verifier 的区别
+
+| 特性 | self-evolve-verifier | project-evolve-verifier |
+|------|----------------------|------------------------|
+| 目标 | 验证框架修复 | 验证项目修复 |
+| 验证对象 | 框架代码 | 用户项目 |
+| 回滚机制 | 自动回滚 | 自动回滚 |

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

@@ -10,11 +10,45 @@ description: "When requirement analysis, user story writing, feature scoping, or
 ## 前置检查
 
 1. 确认启动门禁已通过（`.autospec/runtime/state.json` 存在）
-2. 读取 `${KNOWLEDGE}/principles/constitution.md` → 确认红线
-3. 加载创业团队角色画像：读取 `${KNOWLEDGE}/guides/stages/` 目录下的角色文件
-4. 加载方法论原则：读取 `${KNOWLEDGE}/principles/core-principles.md` → 注入 P1(问题定义先行)、P2(价值驱动)、P31(目标设定三原则) 等通用原则意识
-5. 加载设计哲学：读取 `${KNOWLEDGE}/principles/design-philosophy.md` → 注入 DP17(结构化澄清) 和 DP16(模板即约束) 原则
-6. 加载认知增强原则：读取 `${KNOWLEDGE}/principles/core-principles.md` → 本阶段重点应用 CP1(合伙人模式)、CP3(先问后做)、CP5(置信度标注)
+2. 读取 `knowledge/01-principles/09-constitution.md` → 确认红线
+3. 加载创业团队角色画像：读取 `.claude/agents/roles/` 目录下的角色文件
+4. 加载方法论原则：读取 `${KNOWLEDGE}/principles/02-methodology-principles.md` → 注入 P1(问题定义先行)、P2(价值驱动)、P31(目标设定三原则) 等通用原则意识
+5. 加载设计哲学：读取 `${KNOWLEDGE}/principles/01-first-principles.md` → 注入 DP17(结构化澄清) 和 DP16(模板即约束) 原则
+6. 加载认知增强原则：读取 `${KNOWLEDGE}/principles/02-methodology-principles.md` → 本阶段重点应用 CP1(合伙人模式)、CP3(先问后做)、CP5(置信度标注)
+
+## 阶段检查点（本阶段必须完成）
+
+执行过程中请持续对照以下检查点，确保不遗漏：
+
+**说明**：
+- **检查点表**：快速验证产出是否存在/完成
+- **检查清单（checklists/）**：详细验证产出质量是否达标
+- 通过"检查清单核对完成"一项覆盖所有质量检查，避免重复
+
+| 类别 | 检查项 | 必须完成 | 验证方式 |
+|-----|-------|---------|---------|
+| 流程 | 复杂度评估完成 | ✅ | 检查是否已输出复杂度分数和角色列表 |
+| 流程 | 动态团队组建完成 | ✅ | 检查是否已根据复杂度确定参与角色 |
+| 做类 | 需求分析Agent加载完成 | ✅ | 已加载 analyze-requirement skill |
+| 做类 | 需求分析Agent正确执行 | ✅ | 已执行需求分析任务（背景/用例/功能点）并产出结果 |
+| 做类 | 需求文档生成完成 | ✅ | 各Agent产出已汇总到 requirement.md |
+| 流程 | 团队对抗审查执行（审类） | ✅ | 检查是否已调用 team-orchestrator 并汇总审查报告 |
+| 流程 | independent-reviewer Agent 调用 | ✅ | Layer 2 审查必须调用 |
+| 产出 | 检查清单核对完成 | ✅ | 已按 00-requirement.md 逐项核对并记录（质量检查） |
+| 产出 | requirement.md 生成 | ✅ | 文件存在于 .autospec/specs/{feature}/ |
+| 流程 | Benchmark 评测通过 | ✅ | REQ-001~003 全部通过 |
+
+**阶段完成前自检**：
+- [ ] 已完成复杂度评估（Step 1）
+- [ ] 已组建动态团队（根据复杂度确定角色）
+- [ ] 已加载需求分析Agent（analyze-requirement skill）
+- [ ] 已执行需求分析任务（背景/用例/功能点）
+- [ ] 需求文档已汇总到 requirement.md
+- [ ] 已执行团队对抗审查（Step 2，调用 team-orchestrator）
+- [ ] 已按检查清单（00-requirement.md）逐项核对（质量检查）
+- [ ] 已调用 independent-reviewer（Layer 2）
+- [ ] requirement.md 已生成（Step 4）
+- [ ] Benchmark 评测已通过（Layer 3）
 
 ## 认知姿态（本阶段：发散 + 挑战）
 
@@ -28,11 +62,11 @@ description: "When requirement analysis, user story writing, feature scoping, or
 
 在进入具体需求分析前，先评估任务复杂度，确定参与角色：
 
-**【强制】** 读取 `${KNOWLEDGE}/guides/support/complexity-assessor.md`，执行复杂度评估：
+**【强制】** 读取 `${KNOWLEDGE}/03-guides/24-assess-complexity.md`，执行复杂度评估：
 - 评估维度：需求复杂度、技术复杂度、数据敏感度、业务复杂度
 - 输出：复杂度分数、级别（simple/medium/complex）、需要的角色列表
 
-**【强制】** 读取 `${KNOWLEDGE}/config/team-triggers.yaml`，检查强制触发规则：
+**【强制】** 读取 `${KNOWLEDGE}/05-config/01-team-stage.yaml`，检查强制触发规则（mandatoryTriggers）：
 - 涉及用户数据 → 强制引入 security-engineer
 - 涉及支付/金融 → 强制引入 security-engineer
 - 跨系统变更 → 强制引入 tech-lead + devops-engineer
@@ -59,7 +93,7 @@ description: "When requirement analysis, user story writing, feature scoping, or
 
 **自主模式 — 多Agent并行对抗**：
 ```
-**【强制】** 读取 `${KNOWLEDGE}/guides/support/team-orchestrator.md`
+**【强制】** 读取 `${KNOWLEDGE}/03-guides/01-team-orchestrator.md`
 并行启动角色Agent（信息隔离，做审分离）：
   - CEO Agent：战略一致性、商业价值、风险把控
   - 产品负责人 Agent：用户价值、产品方向、MVP范围
@@ -104,9 +138,9 @@ description: "When requirement analysis, user story writing, feature scoping, or
 
 ### Step 4: 需求文档生成
 
-1. **【强制】** 加载做类skill：读取 `${KNOWLEDGE}/guides/stages/requirement-analyzer.md` → **按步骤执行**
-2. 加载检查清单：读取 `${KNOWLEDGE}/checklists/requirement.md` → 逐项核对
-3. 加载元学习方法：读取 `${KNOWLEDGE}/principles/core-principles.md` → 应用"三层知识漏斗"（原料→认知→执行）确保需求从模糊想法转化为可执行结构
+1. **【强制】** 加载做类skill：读取 `${KNOWLEDGE}/03-guides/02-analyze-requirement.md` → **按步骤执行**
+2. 加载检查清单：读取 `knowledge/04-checklists/00-requirement.md` → 逐项核对
+3. 加载元学习方法：读取 `${KNOWLEDGE}/principles/02-methodology-principles.md` → 应用"三层知识漏斗"（原料→认知→执行）确保需求从模糊想法转化为可执行结构
 4. 将团队对抗结论融入需求文档（战略背景、商业价值、成功指标）
 5. 将澄清结果融入需求文档（每个决策标注来源：用户确认/自动决策/待审阅）
 6. **【强制】** 补充边界条件分析：
@@ -127,7 +161,7 @@ description: "When requirement analysis, user story writing, feature scoping, or
 ```
 **【强制】** 调用 Agent 工具：
   prompt: 请审查以下需求文档。
-    1. 先读取审查标准: ${KNOWLEDGE}/guides/stages/requirement-reviewer.md
+    1. 先读取审查标准: ${KNOWLEDGE}/03-guides/09-review-requirement.md
     2. 被审查文档: .autospec/specs/{feature}/requirement.md
     3. 原始需求（用于对照）
     注意：你是独立审查者，只看产出物和标准，不参考生产过程
@@ -165,7 +199,7 @@ description: "When requirement analysis, user story writing, feature scoping, or
   prompt: 请评估需求分析阶段的产出物是否达到准出标准。
     当前阶段：Stage 01 需求分析
     产出物：.autospec/specs/{feature}/requirement.md
-    准出标准：${KNOWLEDGE}/checklists/requirement.md
+    准出标准：knowledge/04-checklists/00-requirement.md
     上游契约：原始需求
     自主级别：{自主/交互}
 ```

package/plugins/skills/skill-forge/SKILL.md

@@ -155,7 +155,7 @@ Layer 1 不过，不进 Layer 2。
 - Layer 1+2 通过 → 自动发布
 - 记录到 evolution-log.json
 
-**受控区 skills**（skills/stages/）：
+**受控区 skills**（skills/requirement-stage/, skills/design-stage/等）：
 - 生成变更提案
 - 提交人工审批
 - 审批通过后发布
@@ -190,7 +190,7 @@ Layer 1 不过，不进 Layer 2。
 
 ```
 触发：practice-log 记录了 5 次"需求冲突检测"模式
-锻造：蒸馏为 skills/stages/req-conflict-detector.md
+锻造：蒸馏为 skills/requirement-stage/req-conflict-detector.md
 验证：通过基准案例测试
 发布：受控区变更提案，人工审批后合入
 ```