@chongyan/autospec 1.0.1

package/plugins/skills/project-evolution/SKILL.md

@@ -0,0 +1,847 @@
+---
+name: project-evolution
+description: "When project self-improvement, code quality optimization, test enhancement, or intelligent refactoring is needed — loads AI Native project self-evolution process."
+---
+
+# AutoSpec Project-Evolution — 项目自我进化技能
+
+## 定位
+
+AI Native 智能进化技能的实现层，负责：
+1. **智能感知**：自动发现项目特征和进化点
+2. **智能决策**：关联分析、影响预测、优先级计算
+3. **自适应执行**：渐进式自动化、A/B验证、效果追踪
+4. **记忆进化**：评测记忆的自维护、学习、泛化
+
+## 前置
+
+1. 读取 `${KNOWLEDGE}/principles/constitution.md` → 确认红线
+2. 读取 `${KNOWLEDGE}/principles/evolution.md` → 确认进化分区
+3. 读取 `${KNOWLEDGE}/principles/core-principles.md` → CP6(错误即信号)、CP7(模式识别)
+4. 加载项目记忆 → `.autospec/autospec:memory/index.yaml`
+
+## 认知姿态（本阶段：智能感知 + 自适应学习）
+
+- **CP6 错误即信号**：每次代码问题、测试失败、Review打回都是进化信号
+- **CP7 模式识别**：从代码重复、团队习惯、业务特征中发现可泛化模式
+- **CP9 刚好够用**：不追求完美，优先解决高频、高影响问题
+- **自适应学习**：根据团队反馈持续调整，越用越懂团队
+
+---
+
+## 执行流程
+
+### 根据触发参数选择执行路径
+
+| 触发参数 | 执行路径 | 说明 |
+|---------|---------|------|
+| `--init-memory` | 初始化流程 | 自动发现项目特征，创建记忆结构 |
+| `--cruise` | 巡航流程 | 全自动持续进化 |
+| `--deep` | 深度进化流程 | 全维度分析+修复 |
+| `--focus=*` | 专项进化流程 | 针对特定维度 |
+| `--advise` | 建议流程 | 只分析不执行 |
+| `--chat` | 对话流程 | 交互式进化 |
+| `--learn-from` | 学习流程 | 观察人工操作 |
+| `--review` | 回顾流程 | 效果回顾分析 |
+| `--memory-*` | 记忆管理流程 | 记忆系统管理 |
+
+---
+
+## 核心能力
+
+### 1. 智能感知（Smart Perception）
+
+#### 1.1 项目特征识别
+
+**Step 1: 技术栈检测**
+
+```
+检测文件 → 技术栈：
+- package.json → Node.js / React / Vue / Angular
+- pom.xml → Java / Spring Boot
+- build.gradle → Java / Kotlin / Gradle
+- go.mod → Go
+- requirements.txt → Python
+- Cargo.toml → Rust
+
+提取信息：
+- 主要语言
+- 框架版本
+- 构建工具
+- 测试框架
+- lint工具
+```
+
+**Step 2: 项目结构分析**
+
+```
+分析目录结构：
+- 源码目录位置
+- 测试目录位置
+- 配置文件位置
+- 文档位置
+
+识别模式：
+- 单系统 vs 多系统
+-  monorepo vs polyrepo
+- 分层架构 vs 领域驱动
+```
+
+**Step 3: 多系统检测（如适用）**
+
+```
+检测子系统：
+- backend/ → 后端系统
+- frontend/ → 前端系统
+- mobile/ → 移动端
+- data/ → 数据系统
+- ai/ → AI/模型系统
+
+分析依赖：
+- 子系统间调用关系
+- 共享代码位置
+- 接口定义位置
+- 数据流方向
+```
+
+#### 1.2 代码质量感知
+
+**复杂度分析**：
+```
+计算指标：
+- 圈复杂度（Cyclomatic Complexity）
+- 认知复杂度（Cognitive Complexity）
+- 代码行数
+- 函数参数数量
+- 嵌套深度
+
+识别热点：
+- 复杂度增长趋势
+- 高频变更文件
+- 多人协作冲突区
+```
+
+**代码气味检测**：
+```
+检测模式：
+- 重复代码（>3行相似）
+- 过长函数（>50行）
+- 过大类（>300行）
+- 过多参数（>5个）
+- 深层嵌套（>4层）
+- 神秘命名
+- 死代码（未使用变量/函数/导入）
+```
+
+**类型安全分析**（TypeScript/Java等）：
+```
+检测问题：
+- any 类型滥用
+- 类型断言过多
+- 可选链缺失
+- 类型定义不完整
+- 泛型使用不当
+```
+
+#### 1.3 测试体系感知
+
+**覆盖率分析**：
+```
+统计维度：
+- 行覆盖率
+- 分支覆盖率
+- 函数覆盖率
+- 语句覆盖率
+
+缺口识别：
+- 高频变更低覆盖文件
+- 核心业务逻辑未覆盖
+- 边界条件未测试
+- 错误处理未测试
+```
+
+**测试质量检测**：
+```
+检测问题：
+- Flaky test（不稳定测试）
+- 测试执行时间过长
+- 测试间依赖
+- Mock 不当
+- 断言不充分
+```
+
+**契约测试**（多系统）：
+```
+检测内容：
+- 消费者驱动契约
+- 提供者契约验证
+- 接口版本兼容性
+- Schema 一致性
+```
+
+#### 1.4 多系统关联感知
+
+**接口漂移检测**：
+```
+对比分析：
+- 后端API定义 vs 前端调用
+- 接口版本一致性
+- 参数类型匹配
+- 返回值结构匹配
+
+识别漂移：
+- 后端已变更，前端未更新
+- 类型不匹配
+- 必需参数缺失
+```
+
+**共享逻辑识别**：
+```
+扫描重复：
+- 跨子系统的相似代码
+- 重复的数据处理逻辑
+- 重复的工具函数
+
+抽离建议：
+- 创建共享库
+- 提取公共模块
+- 定义共享接口
+```
+
+**依赖循环检测**：
+```
+构建依赖图：
+- 子系统间导入关系
+- 模块间调用关系
+
+识别循环：
+- A → B → A
+- A → B → C → A
+
+解耦建议：
+- 提取共享接口
+- 依赖注入
+- 事件驱动解耦
+```
+
+#### 1.5 运行时信号感知（如有）
+
+**错误日志分析**：
+```
+统计模式：
+- 高频错误类型
+- 错误发生位置
+- 错误趋势变化
+
+关联代码：
+- 错误堆栈映射到源码
+- 识别根因位置
+```
+
+**性能指标分析**：
+```
+收集指标：
+- 响应时间
+- 内存使用
+- CPU占用
+- 资源加载时间
+
+识别瓶颈：
+- 慢查询
+- 大文件加载
+- 重复计算
+```
+
+### 2. 智能决策（Smart Decision）
+
+#### 2.1 关联分析
+
+**多维度关联**：
+```
+输入信号：
+- 代码质量问题
+- 测试缺口
+- 运行时错误
+- 团队反馈
+
+关联推理：
+例："模块A测试覆盖率低"
+  ↓
+关联发现：
+  - 模块A变更频率高
+  - 近期Bug多
+  - 依赖模块B不稳定
+  - 新成员常修改
+  ↓
+根因分析：
+  不是"没写测试"
+  而是"模块职责不清 + 依赖混乱 + 缺乏文档"
+```
+
+**影响预测**：
+```
+预测维度：
+- Bug率变化
+- 维护成本变化
+- 开发效率变化
+- 新人上手时间变化
+
+预测方法：
+- 历史数据对比
+- 相似项目参考
+- 行业基准
+```
+
+#### 2.2 优先级计算
+
+**动态优先级公式**：
+```
+优先级分数 =
+  影响分数 ×
+  紧急程度权重 ×
+  频率权重 ×
+  修复成本权重 ×
+  历史效果权重
+
+影响分数：
+- 核心模块: 100
+- 重要模块: 75
+- 一般模块: 50
+- 边缘模块: 25
+
+紧急程度：
+- 生产故障: 2.0
+- 即将发布: 1.5
+- 日常优化: 1.0
+
+频率权重：
+- 每天发生: 2.0
+- 每周发生: 1.5
+- 偶尔发生: 1.0
+
+修复成本：
+- 自动修复: 1.2
+- 简单修复: 1.0
+- 复杂修复: 0.8
+
+历史效果：
+- 之前修复有效: 1.2
+- 无历史数据: 1.0
+- 之前修复无效: 0.8
+```
+
+**优先级分级**：
+```
+P0 (>=90分): 立即处理
+- 生产故障风险
+- 安全漏洞
+- 阻塞性问题
+
+P1 (60-89分): 计划处理
+- 明显代码异味
+- 测试缺口
+- 性能瓶颈
+
+P2 (<60分): 观察
+- 轻微风格问题
+- 建议性优化
+- 待验证假设
+```
+
+#### 2.3 方案生成
+
+**自动修复方案**（L1）：
+```
+适用场景：
+- 代码格式化
+- 未使用导入清理
+- 简单命名规范化
+- 依赖安全升级
+
+方案格式：
+{
+  "type": "auto-fix",
+  "target": "file-path",
+  "action": "remove-unused-imports",
+  "validation": "compile-pass",
+  "rollback": "git-checkout"
+}
+```
+
+**建议确认方案**（L2）：
+```
+适用场景：
+- 架构调整
+- 接口变更
+- 配置修改
+- 重构建议
+
+方案格式：
+{
+  "type": "suggest",
+  "title": "重构订单模块",
+  "problem": "当前复杂度35，超过阈值20",
+  "solution": "拆分为3个子模块",
+  "steps": [...],
+  "impact": "维护成本降低40%",
+  "effort": "2小时",
+  "confirmation": "required"
+}
+```
+
+**方案对比**（L3）：
+```
+适用场景：
+- 多种重构方案
+- 不同技术选型
+- 风险评估
+
+方案格式：
+{
+  "type": "compare",
+  "options": [
+    {
+      "name": "方案A：渐进重构",
+      "pros": ["风险低", "可回滚"],
+      "cons": ["耗时较长"],
+      "score": 85
+    },
+    {
+      "name": "方案B：全面重写",
+      "pros": ["彻底解决问题"],
+      "cons": ["风险高", "耗时长"],
+      "score": 70
+    }
+  ]
+}
+```
+
+### 3. 自适应执行（Adaptive Execution）
+
+#### 3.1 自动化级别
+
+| 级别 | 类型 | 执行方式 | 人工介入 |
+|------|------|---------|---------|
+| L1 | 自动修复 | 直接执行，自动提交 | 无需介入 |
+| L2 | 建议+确认 | 生成方案，等待确认 | 一键确认 |
+| L3 | 方案对比 | 多方案对比，选择执行 | 选择方案 |
+| L4 | 学习模式 | 观察人工操作 | 初期介入 |
+
+#### 3.2 A/B 验证机制
+
+**基线记录**：
+```
+修复前记录：
+- 代码复杂度
+- 测试通过率
+- 构建时间
+- 代码行数
+- 依赖数量
+```
+
+**修复执行**：
+```
+1. 创建临时分支
+2. 执行修复
+3. 运行验证
+   - 编译/构建
+   - 单元测试
+   - 集成测试
+   - Lint检查
+```
+
+**效果对比**：
+```
+对比指标：
+- 复杂度变化
+- 测试通过率变化
+- 构建时间变化
+- 代码质量评分
+
+决策：
+- 提升 > 阈值 → 提交
+- 退化 → 回滚
+- 不明显 → 人工确认
+```
+
+**回滚机制**：
+```
+回滚条件：
+- 测试失败
+- 构建失败
+- 质量评分下降
+- 人工拒绝
+
+回滚动作：
+1. 恢复原始代码
+2. 记录失败模式
+3. 标记规则为待优化
+4. 通知相关人员
+```
+
+#### 3.3 效果追踪
+
+**短期效果**（即时）：
+```
+- 代码规范通过率
+- 测试覆盖率
+- 构建成功率
+- Lint错误数
+```
+
+**中期效果**（1-4周）：
+```
+- Bug率变化
+- 代码Review时间
+- 新功能开发速度
+- 回归测试稳定性
+```
+
+**长期效果**（1-3月）：
+```
+- 系统可维护性
+- 团队开发效率
+- 新人上手时间
+- 技术债务趋势
+```
+
+### 4. 记忆进化（Memory Evolution）
+
+#### 4.1 记忆生命周期
+
+```
+发现 → 验证 → 固化 → 进化 → 退役
+
+发现：
+- AI扫描项目，发现潜在评测点
+- 标记为 "learning" 状态
+
+验证：
+- 执行3次以上
+- 观察稳定性和价值
+- 收集团队反馈
+
+固化：
+- 效果良好 → 标记为 "validated"
+- 加入常规检查
+- 可被其他项目复用
+
+进化：
+- 根据反馈调整规则
+- 优化检测精度
+- 改进修复方案
+
+退役：
+- 不再适用 → 标记为 "deprecated"
+- 归档到历史记忆
+- 记录退役原因
+```
+
+#### 4.2 记忆结构
+
+```yaml
+# 记忆文件格式
+memory:
+  id: "unique-id"
+  version: "1.0"
+
+  # 元信息
+  meta:
+    name: "React组件规范"
+    description: "React组件必须有displayName"
+    category: "code-quality"
+    created_at: "2024-03-26"
+    updated_at: "2024-03-26"
+    status: "learning"  # learning | validated | deprecated
+
+  # 适用条件
+  applicability:
+    tech_stacks: ["react", "typescript"]
+    file_patterns: ["*.tsx", "*.jsx"]
+    min_confidence: 0.8
+
+  # 检测规则
+  detection:
+    type: "ast-pattern"
+    pattern: "FunctionDeclaration[name] > Identifier"
+    condition: "!parent.displayName"
+
+  # 修复方案
+  fixes:
+    - type: "auto"
+      description: "添加displayName"
+      transformation: |
+        const ${name} = React.memo(function ${name}() { ... })
+        ${name}.displayName = '${name}'
+      validation: "compile-pass"
+
+  # 执行统计
+  statistics:
+    triggered: 10
+    accepted: 8
+    rejected: 2
+    effectiveness: 0.8
+
+  # 语义向量（用于相似匹配）
+  embedding: [0.23, -0.45, 0.89, ...]
+
+  # 关联记忆
+  related:
+    - "react-props-types" (0.85)
+    - "react-hooks-deps" (0.72)
+```
+
+#### 4.3 语义记忆
+
+**向量索引**：
+```
+将记忆编码为向量：
+- 代码模式 → 代码语义向量
+- 自然语言描述 → 文本语义向量
+- 执行效果 → 效果特征向量
+
+用途：
+- 相似代码匹配
+- 语义搜索
+- 模式聚类
+```
+
+**关联发现**：
+```
+基于向量相似度发现关联：
+- "错误处理模式" ↔ "日志记录模式"
+- "API重试" ↔ "断路器模式"
+- "数据验证" ↔ "类型守卫"
+```
+
+#### 4.4 团队偏好学习
+
+**偏好类型**：
+```
+代码风格偏好：
+- 缩进: 2空格 vs 4空格 vs Tab
+- 引号: 单引号 vs 双引号
+- 分号: 使用 vs 不使用
+
+架构偏好：
+- 函数式 vs 面向对象
+- 分层架构 vs 领域驱动
+- 严格类型 vs 灵活类型
+
+流程偏好：
+- 自动修复接受度
+- 确认阈值
+- 通知频率
+```
+
+**学习方式**：
+```
+1. 观察人工修改
+   - AI建议 vs 人工实际修改
+   - 分析差异原因
+
+2. 收集显式反馈
+   - 接受/拒绝建议
+   - 评分反馈
+   - 自定义规则
+
+3. 更新偏好模型
+   - 调整规则权重
+   - 更新默认配置
+   - 个性化建议
+```
+
+### 5. 多系统支持
+
+#### 5.1 子系统依赖图
+
+```
+构建依赖图：
+- 节点：子系统、模块、文件
+- 边：依赖关系（导入、调用）
+- 权重：依赖频率、重要性
+
+分析：
+- 入度/出度分析
+- 关键路径识别
+- 循环依赖检测
+- 影响范围计算
+```
+
+#### 5.2 接口契约管理
+
+**契约定义**：
+```yaml
+contract:
+  service: "order-service"
+  endpoint: "/api/orders"
+  method: "POST"
+
+  request:
+    body:
+      user_id: string (required)
+      items: array (required)
+      coupon_id: string (optional)
+
+  response:
+    200:
+      order_id: string
+      total: number
+      status: "created"
+    400:
+      error: "InvalidRequest"
+      message: string
+```
+
+**契约验证**：
+```
+消费者验证：
+- 检查调用方代码
+- 验证请求参数
+- 处理响应结果
+
+提供者验证：
+- 检查实现代码
+- 验证响应格式
+- 处理错误情况
+
+一致性检查：
+- 契约定义 vs 实现
+- 版本兼容性
+- 变更影响分析
+```
+
+#### 5.3 跨系统优化
+
+**共享库提取**：
+```
+检测重复：
+- 跨系统的相似代码
+- 重复的数据模型
+- 重复的工具函数
+
+提取建议：
+1. 创建 shared/ 目录
+2. 移动共享代码
+3. 更新依赖关系
+4. 验证所有子系统
+```
+
+**构建优化**：
+```
+分析构建图：
+- 识别并行构建机会
+- 优化构建顺序
+- 缓存共享依赖
+
+优化策略：
+- 无依赖子系统并行构建
+- 共享依赖预构建
+- 增量构建优化
+```
+
+---
+
+## 执行步骤
+
+### 根据命令参数执行
+
+```
+Step 1: 解析命令参数
+Step 2: 加载项目记忆
+Step 3: 执行对应流程
+Step 4: 记录执行结果
+Step 5: 更新记忆统计
+Step 6: 生成执行报告
+```
+
+### 各流程详细步骤
+
+#### 初始化流程 (--init-memory)
+
+```
+Step 1: 扫描项目结构
+Step 2: 检测技术栈
+Step 3: 识别多系统（如适用）
+Step 4: 生成评测规则
+Step 5: 创建记忆结构
+Step 6: 输出初始化报告
+```
+
+#### 巡航流程 (--cruise)
+
+```
+Step 1: 加载 validated 记忆
+Step 2: 执行代码扫描
+Step 3: 执行测试分析
+Step 4: 执行多系统检查（如适用）
+Step 5: 智能决策
+Step 6: 执行L1自动修复
+Step 7: 记录执行结果
+Step 8: 生成巡航报告
+```
+
+#### 深度进化流程 (--deep)
+
+```
+Step 1: 加载所有记忆
+Step 2: 六层全面扫描
+Step 3: 关联推理分析
+Step 4: 生成改进方案
+Step 5: 优先级排序
+Step 6: 执行修复（如--auto-fix）
+Step 7: A/B验证
+Step 8: 记录效果和反馈
+Step 9: 生成深度报告
+```
+
+#### 专项进化流程 (--focus)
+
+```
+Step 1: 加载相关记忆
+Step 2: 专项深度扫描
+Step 3: 生成专项方案
+Step 4: 执行修复
+Step 5: 验证效果
+Step 6: 生成专项报告
+```
+
+#### 学习流程 (--learn-from)
+
+```
+Step 1: 读取人工修改记录
+Step 2: 对比AI建议与人工决策
+Step 3: 分析差异原因
+Step 4: 提取团队偏好
+Step 5: 更新偏好模型
+Step 6: 调整未来建议
+```
+
+---
+
+## 反模式清单
+
+1. **过度自动化**：自动修复高风险变更。检测：L2+级别必须人工确认
+2. **忽视上下文**：不考虑项目特征，一刀切规则。检测：必须加载项目记忆
+3. **噪音过多**：生成大量低价值建议。检测：智能降噪，优先级过滤
+4. **记忆膨胀**：不清理过期记忆。检测：自动归档机制
+5. **隐私泄露**：敏感信息进入记忆。检测：敏感信息脱敏
+6. **回滚失败**：没有有效的回滚机制。检测：每次修复必须有回滚方案
+
+---
+
+## 安全底线
+
+- 绝不修改冻结区文件（constitution.md, evolution.md）
+- 绝不降低安全标准
+- 自动修复必须有验证和回滚
+- 敏感信息必须脱敏
+- 每次变更必须记录审计日志
+
+---
+
+## 产出物
+
+- `.autospec/autospec:memory/` — 评测记忆
+- `.autospec/logs/autospec:project-evolve/` — 执行日志和报告
+- `.autospec/runtime/project-evolve-state.json` — 执行状态