@chongyan/autospec 1.0.2 → 1.0.3

package/plugins/skills/field-evolve-scanner/scripts/fallback-scanner.js

@@ -1,288 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * 模型兜底扫描器 - Field Evolve Scanner 子模块
- *
- * 功能：当规则匹配完成后，使用 AI 模型识别规则之外的潜在文档
- * 支持：设计文档、业务文档、测试文档的兜底分类
- */
-
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-const { execSync } = require('child_process');
-
-// 配置
-const CONFIG = {
-  confidenceThreshold: 0.7,  // 高置信度阈值
-  reviewThreshold: 0.5,      // 待确认阈值
-  ignoreThreshold: 0.5,      // 忽略阈值
-};
-
-/**
- * 读取检测规则配置
- */
-function loadDetectionPatterns() {
-  const patternsPath = path.join(__dirname, '../../../../knowledge/06-environment/01-detection-patterns.yaml');
-  const content = fs.readFileSync(patternsPath, 'utf-8');
-  return yaml.load(content);
-}
-
-/**
- * 收集所有 Markdown 文件
- */
-function collectMarkdownFiles(baseDirs, ignoreDirs) {
-  const files = [];
-
-  for (const dir of baseDirs) {
-    if (!fs.existsSync(dir)) continue;
-
-    try {
-      const ignorePattern = ignoreDirs.map(d => `-path "*/${d}/*"`).join(' \\! ');
-      const result = execSync(
-        `find "${dir}" -name "*.md" \\! ${ignorePattern} 2>/dev/null`,
-        { encoding: 'utf-8' }
-      );
-      files.push(...result.trim().split('\n').filter(f => f));
-    } catch (e) {
-      // 忽略错误
-    }
-  }
-
-  return files;
-}
-
-/**
- * 排除已匹配的文件
- */
-function excludeMatchedFiles(allFiles, matchedPatterns) {
-  const micromatch = require('micromatch');
-
-  let excluded = new Set();
-
-  for (const pattern of matchedPatterns) {
-    const matches = micromatch(allFiles, pattern);
-    for (const m of matches) {
-      excluded.add(m);
-    }
-  }
-
-  return allFiles.filter(f => !excluded.has(f));
-}
-
-/**
- * 读取文件内容摘要（前 1000 字符）
- */
-function readFileSummary(filePath) {
-  try {
-    const content = fs.readFileSync(filePath, 'utf-8');
-    return content.slice(0, 1000) + (content.length > 1000 ? '...' : '');
-  } catch (e) {
-    return '';
-  }
-}
-
-/**
- * 调用 AI 模型进行分类
- */
-async function classifyWithAI(files, aiPrompt, categoryType, claudeClient) {
-  const results = [];
-
-  for (const file of files) {
-    const summary = readFileSummary(file);
-    const fileName = path.basename(file);
-    const relativePath = path.relative(process.cwd(), file);
-
-    // 构造 prompt
-    const prompt = `${aiPrompt}
-
-待分析文件：${relativePath}
-文件内容摘要：
-${summary}
-
-请分析并输出 JSON 结果。`;
-
-    // 调用 Claude API
-    try {
-      const response = await claudeClient.messages.create({
-        model: 'claude-sonnet-4-6',
-        max_tokens: 1000,
-        messages: [
-          {
-            role: 'user',
-            content: prompt
-          }
-        ]
-      });
-
-      const content = response.content[0].text;
-      // 提取 JSON
-      const jsonMatch = content.match(/\{[\s\S]*\}/);
-      if (jsonMatch) {
-        const result = JSON.parse(jsonMatch[0]);
-        result.filePath = relativePath;
-        results.push(result);
-        console.log(`  [${categoryType}] ${relativePath} -> ${result.category || 'unknown'} (confidence: ${result.confidence})`);
-      }
-    } catch (e) {
-      console.error(`  [错误] ${relativePath}: ${e.message}`);
-    }
-  }
-
-  return results;
-}
-
-/**
- * 执行兜底扫描
- */
-async function runFallbackScan(options = {}) {
-  const {
-    projectPath = process.cwd(),
-    enableDesign = true,
-    enableBusiness = true,
-    enableTest = true,
-    claudeClient
-  } = options;
-
-  console.log('🔍 开始模型兜底扫描...\n');
-
-  // 加载检测规则
-  const patterns = loadDetectionPatterns();
-
-  // 基础扫描目录
-  const baseDirs = [
-    path.join(projectPath, 'docs'),
-    path.join(projectPath, 'specs'),
-    path.join(projectPath, 'knowledge'),
-    path.join(projectPath, 'business'),
-    path.join(projectPath, 'tests'),
-  ].filter(d => fs.existsSync(d));
-
-  if (baseDirs.length === 0) {
-    console.log('  ⚠️  未找到扫描目录');
-    return { designDocs: [], businessDocs: [], testDocs: [] };
-  }
-
-  // 忽略目录
-  const ignoreDirs = [
-    'node_modules', '.git', '.autospec', '.claude',
-    '.pytest_cache', '.mypy_cache', '__pycache__',
-    'venv', '.venv', 'env', '.env',
-    '.idea', '.vscode', 'data', 'logs', 'cache', 'tmp', 'temp'
-  ];
-
-  // 1. 收集所有 Markdown 文件
-  console.log('Step 1: 收集 Markdown 文件...');
-  const allFiles = collectMarkdownFiles(baseDirs, ignoreDirs);
-  console.log(`  找到 ${allFiles.length} 个 Markdown 文件\n`);
-
-  // 2. 排除已规则匹配的文件
-  console.log('Step 2: 排除已匹配文件...');
-
-  // 设计文档规则
-  const designPatterns = [];
-  for (const [key, rule] of Object.entries(patterns.designDocs || {})) {
-    if (key === 'fallback') continue;
-    if (rule.patterns) {
-      for (const loc of rule.locations || []) {
-        for (const pat of rule.patterns) {
-          designPatterns.push(path.join(loc, pat));
-        }
-      }
-    }
-  }
-
-  // 业务文档规则
-  const businessPatterns = [];
-  for (const [key, rule] of Object.entries(patterns.businessDocs || {})) {
-    if (key === 'fallback') continue;
-    if (rule.patterns) {
-      for (const loc of rule.locations || []) {
-        for (const pat of rule.patterns) {
-          businessPatterns.push(path.join(loc, pat));
-        }
-      }
-    }
-  }
-
-  // 测试文档规则
-  const testPatterns = [];
-  for (const [key, rule] of Object.entries(patterns.testDocs || {})) {
-    if (key === 'fallback') continue;
-    if (rule.patterns) {
-      for (const loc of rule.locations || []) {
-        for (const pat of rule.patterns) {
-          testPatterns.push(path.join(loc, pat));
-        }
-      }
-    }
-  }
-
-  const allMatchedPatterns = [...designPatterns, ...businessPatterns, ...testPatterns];
-  const candidateFiles = excludeMatchedFiles(allFiles, allMatchedPatterns);
-  console.log(`  剩余 ${candidateFiles.length} 个候选文件\n`);
-
-  if (candidateFiles.length === 0) {
-    console.log('  ✅ 所有文件已被规则匹配，无需兜底扫描');
-    return { designDocs: [], businessDocs: [], testDocs: [] };
-  }
-
-  // 3. AI 分类
-  console.log('Step 3: AI 模型分类...\n');
-
-  const results = {
-    designDocs: [],
-    businessDocs: [],
-    testDocs: []
-  };
-
-  // 设计文档兜底
-  if (enableDesign && patterns.designDocs?.fallback?.enabled) {
-    console.log('  [设计文档兜底]');
-    const designPrompt = patterns.designDocs.fallback.aiPrompt;
-    results.designDocs = await classifyWithAI(candidateFiles, designPrompt, 'design', claudeClient);
-  }
-
-  // 业务文档兜底
-  if (enableBusiness && patterns.businessDocs?.fallback?.enabled) {
-    console.log('  [业务文档兜底]');
-    const businessPrompt = patterns.businessDocs.fallback.aiPrompt;
-    results.businessDocs = await classifyWithAI(candidateFiles, businessPrompt, 'business', claudeClient);
-  }
-
-  // 测试文档兜底
-  if (enableTest && patterns.testDocs?.fallback?.enabled) {
-    console.log('  [测试文档兜底]');
-    const testPrompt = patterns.testDocs.fallback.aiPrompt;
-    results.testDocs = await classifyWithAI(candidateFiles, testPrompt, 'test', claudeClient);
-  }
-
-  // 汇总高置信度结果
-  const summary = {
-    designDocs: results.designDocs.filter(d => d.confidence >= CONFIG.confidenceThreshold),
-    businessDocs: results.businessDocs.filter(d => d.confidence >= CONFIG.confidenceThreshold),
-    testDocs: results.testDocs.filter(d => d.confidence >= CONFIG.confidenceThreshold),
-    pendingReview: [
-      ...results.designDocs.filter(d => d.confidence < CONFIG.confidenceThreshold),
-      ...results.businessDocs.filter(d => d.confidence < CONFIG.confidenceThreshold),
-      ...results.testDocs.filter(d => d.confidence < CONFIG.confidenceThreshold)
-    ]
-  };
-
-  console.log('\n✅ 兜底扫描完成');
-  console.log(`  高置信度设计文档：${summary.designDocs.length} 个`);
-  console.log(`  高置信度业务文档：${summary.businessDocs.length} 个`);
-  console.log(`  高置信度测试文档：${summary.testDocs.length} 个`);
-  console.log(`  待人工确认：${summary.pendingReview.length} 个`);
-
-  return summary;
-}
-
-// 主函数
-if (require.main === module) {
-  //  standalone 运行时，没有 claudeClient，需要特殊处理
-  console.log('⚠️  独立运行时请通过 API 调用，或集成到 skill 中使用');
-  process.exit(1);
-}
-
-module.exports = { runFallbackScan, collectMarkdownFiles, excludeMatchedFiles };

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

@@ -1,64 +0,0 @@
----
-name: field-evolve-verifier
-description: "验证修复效果，评估修复方案有效性"
-type: verifier
----
-
-# Field-Evolve Verifier
-
-## 定位
-
-验证修复效果，评估修复方案在多个项目中的有效性。
-
-## 输入
-
-- 修复记录
-- 修复前基线指标
-
-## 输出
-
-- 验证结果
-- 效果评估
-
-## 执行步骤
-
-### Step 1: 修复验证
-
-```
-验证修复：
-1. 运行测试
-2. 检查构建
-3. 验证功能
-```
-
-### Step 2: 效果评估
-
-```
-评估效果：
-1. 对比修复前后指标
-2. 评估修复方案有效性
-3. 生成评估报告
-```
-
-### Step 3: 方案优化
-
-```
-优化方案：
-1. 分析验证结果
-2. 识别方案不足
-3. 优化修复模板
-```
-
-## 使用示例
-
-```
-# 执行验证
-读取 plugins/skills/field-evolve-verifier/SKILL.md 并执行
-```
-
-## 与其他技能的区别
-
-| 技能 | 侧重点 |
-|------|--------|
-| project-evolve-verifier | 单个项目修复验证 |
-| **field-evolve-verifier** | 跨项目方案有效性验证 |

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

@@ -1,279 +0,0 @@
----
-name: hotfix-iteration
-description: "热修复快速通道。包含风险评估、变更控制、最小化验证。"
-triggers:
-  - workflow: hotfix
-parameters:
-  issue: ""
-  riskLevel: "unknown"
-  changedFiles: []
----
-
-# Hotfix Rapid - 热修复快速通道
-
-## 概述
-
-热修复模式是紧急问题修复的快速通道。与完整研发流程不同，热修复模式跳过设计阶段，专注于快速定位问题、最小化变更、快速验证和部署。
-
-## 输入
-
-- 问题描述
-- 相关代码路径
-- 问题严重程度
-
-## 执行流程
-
-### Step 1: 问题诊断（快速定位）
-
-```
-1. 分析问题现象
-   - 错误日志
-   - 用户反馈
-   - 监控告警
-
-2. 定位问题代码
-   - 堆栈追踪
-   - 代码审查
-   - 复现步骤
-
-3. 确定修复范围
-   - 受影响的文件
-   - 受影响的功能
-   - 依赖关系
-
-4. 记录到 hotfix-issue.md
-```
-
-**问题诊断文档格式**：
-```markdown
-# 热修复问题诊断
-
-## 问题现象
-
-- 错误信息: ...
-- 影响范围: ...
-- 严重程度: P0/P1/P2
-
-## 根因分析
-
-- 直接原因: ...
-- 根本原因: ...
-- 触发条件: ...
-
-## 受影响范围
-
-- 文件: [file1, file2]
-- 功能: [功能A, 功能B]
-- 用户: [用户群体]
-
-## 修复思路
-
-- 修复方案: ...
-- 变更文件: ...
-- 风险评估: ...
-```
-
-### Step 2: 风险评估
-
-```
-risk_score = 0
-detected_risks = []
-
-for factor in riskFactors:
-  if 检测到风险因素:
-    risk_score += factor.weight
-    detected_risks.append(factor)
-
-# 风险等级判定
-if risk_score >= 5:
-  riskLevel = 'HIGH'
-elif risk_score >= 3:
-  riskLevel = 'MEDIUM'
-else:
-  riskLevel = 'LOW'
-```
-
-**风险因素清单**：
-
-| 风险因素 | 权重 | 检测方式 |
-|---------|------|---------|
-| 数据迁移 | 3 | 检查是否涉及数据库schema变更 |
-| 安全相关 | 3 | 检查是否涉及认证/授权/加密代码 |
-| 核心业务 | 2 | 检查是否影响主流程 |
-| 多文件变更 | 1 | 检查变更文件数量 |
-| 公共API | 2 | 检查是否影响对外接口 |
-
-**高风险处理**：
-
-当检测到高风险时，**提示用户选择**：
-
-```
-⚠️ 检测到高风险因素：
-- 涉及数据迁移 (权重: 3)
-- 涉及安全相关代码 (权重: 3)
-
-建议升级为瀑布模式以确保质量。
-
-请选择：
-1. 升级为瀑布模式（推荐）
-2. 继续热修复（需确认风险）
-```
-
-### Step 3: 变更控制
-
-```
-# 检查变更范围
-if changed_files.length > maxFiles:
-  error('变更文件过多 (#{changed_files.length} > #{maxFiles})，考虑升级为瀑布模式')
-
-if changed_lines > maxLines:
-  warn('变更行数较多 (#{changed_lines} > #{maxLines})，请确认是否必要')
-
-for pattern in excludePatterns:
-  if 有文件匹配 pattern:
-    error('禁止变更此文件: ' + pattern)
-    → 必须升级为瀑布模式或人工审批
-```
-
-**变更控制参数**：
-
-| 参数 | 默认值 | 说明 |
-|------|-------|------|
-| maxFiles | 5 | 最大变更文件数 |
-| maxLines | 100 | 最大变更行数 |
-| excludePatterns | migrations, auth | 禁止变更的文件模式 |
-
-### Step 4: 快速编码（最小变更）
-
-```
-# 编码原则
-1. 最小化变更：只修改必要的代码
-2. 向后兼容：不破坏现有接口
-3. 可回滚：保留回滚路径
-4. 可观测：添加必要的日志
-
-# 编码检查
-- 不引入新的依赖
-- 不修改公共API签名
-- 不删除现有功能
-- 添加必要的注释
-```
-
-### Step 5: 快速审查（自动化）
-
-```
-# 自动检查项
-auto_checks = [
-  'formatting',      # 代码格式
-  'syntax',          # 语法检查
-  'security',        # 安全扫描
-  'data-integrity',  # 数据完整性
-]
-
-# 自动通过项
-auto_pass = [
-  'formatting',      # 格式问题可自动修复
-  'minor-fix',       # 小修复
-  'typo',            # 拼写错误
-]
-
-# 需要人工确认
-require_human = [
-  'security',        # 安全相关
-  'data-integrity',  # 数据完整性
-  'api-change',      # API变更
-]
-```
-
-### Step 6: 最小化验证
-
-```
-# 只执行必要验证
-checks = [
-  'compile',           # 编译检查
-  'affected-tests',    # 受影响测试
-]
-
-# 跳过的检查
-skip = [
-  'full-test',         # 全量测试
-  'integration-test',  # 集成测试
-  'type-check',        # 类型检查（可选）
-]
-
-# 验证命令
-npm run compile
-npm test -- --grep "affected-module"
-```
-
-### Step 7: 快速部署
-
-```
-# 部署前检查
-- 外部API变更 → 人工确认
-- DB变更 → 人工确认
-- 配置变更 → 人工确认
-
-# 部署步骤
-1. 备份当前版本
-2. 部署新版本
-3. 冒烟测试
-4. 监控告警
-```
-
-## 输出
-
-- `specs/{feature}/hotfix-issue.md` - 问题诊断文档
-- `specs/{feature}/hotfix-record.md` - 热修复记录
-- 风险评估结果
-- 变更记录
-
-## 热修复记录格式
-
-```markdown
-# 热修复记录
-
-## 基本信息
-
-- 修复时间: {timestamp}
-- 问题严重程度: P0/P1/P2
-- 风险等级: LOW/MEDIUM/HIGH
-
-## 问题诊断
-
-- 问题现象: ...
-- 根因分析: ...
-- 受影响范围: ...
-
-## 变更记录
-
-| 文件 | 变更行数 | 变更类型 |
-|------|---------|---------|
-| file1.js | +10/-5 | 修复 |
-| file2.js | +3/-1 | 修复 |
-
-## 风险评估
-
-- 风险分数: {score}
-- 检测到的风险: [...]
-- 处理方式: ...
-
-## 验证结果
-
-- 编译: ✅ 通过
-- 受影响测试: ✅ 通过 (5/5)
-
-## 部署信息
-
-- 部署时间: {timestamp}
-- 部署版本: {version}
-- 回滚路径: {rollback_version}
-```
-
-## 注意事项
-
-1. **最小化原则**：只修改必要的代码，避免"顺便"优化
-2. **风险意识**：高风险变更宁可慢一点，也不要引入新问题
-3. **可回滚**：确保有回滚路径
-4. **复盘记录**：热修复后需要复盘，找出根本原因
-5. **禁止事项**：禁止变更 migrations、auth 等敏感目录