evolution

# 通用自我进化系统

此 skill 让 Claude 在开发过程中持续学习并改进知识库。

---

## 自动触发规则

**重要**: 作为 Claude，你应该在适当时机自动执行这些行为。

### 自动 (无需用户请求)

| 机制 | 何时触发 |
|------|---------|
| **版本适配** | 会话开始，检测 package.json/Cargo.toml/pubspec.yaml |
| **个性化** | 首次生成代码，扫描 2-3 个现有文件 |
| **自我修正** | 当你建议的代码失败时立即触发 |
| **使用反馈** | 每次使用已保存的模式后 |

### 半自动 (你提议，用户确认)

| 机制 | 何时提议 |
|------|---------|
| **自我进化** | 解决非平凡问题后，问用户是否保存 |

### 手动 (用户请求)

| 机制 | 触发短语 |
|------|---------|
| **验证 skills** | "验证 skills" / "validate skills" |
| **健康报告** | "skills 健康报告" / "pattern health report" |

---

## 会话开始检查清单

开始任何开发会话时，静默执行:

1. **检测技术栈版本**
   - Flutter: 读取 `pubspec.yaml`
   - Node.js: 读取 `package.json`
   - Rust: 读取 `Cargo.toml`
   - Swift: 检查 Xcode 项目或 Package.swift
   - 设置内部上下文记住版本

2. **扫描项目风格** (如果没做过)
   - 读取 2-3 个现有代码文件
   - 记录: 命名规范、模块结构、注释风格

3. **加载相关 skills**
   - 读取 `~/.claude/skills/{tech}-*.md`
   - 如果不存在，准备创建

**不要宣布这些操作**，除非与用户问题直接相关。

---

## Skill 文件结构

```
~/.claude/skills/
├── evolution/
│   └── SKILL.md              # 本文件
├── {tech}-patterns.md        # UI/组件模式
├── {tech}-troubleshooting.md # 错误解决
├── {tech}-architecture.md    # 架构模式
├── {tech}-layout.md          # 布局/响应式
├── {tech}-build.md           # 构建/部署
├── {tech}-fundamentals.md    # 核心概念/API
└── project-styles/
    └── {project}.md          # 项目风格档案
```

其中 `{tech}` 是: flutter, swiftui, react, vue, rust, python 等。

---

## 进化触发条件

当发生以下情况时，考虑保存知识:

| 触发 | 目标文件 | 优先级 |
|-----|---------|-------|
| 发现新 UI 模式 | {tech}-patterns.md | 高 |
| 解决编译/运行错误 | {tech}-troubleshooting.md | 高 |
| 学到架构技术 | {tech}-architecture.md | 高 |
| 找到布局方案 | {tech}-layout.md | 中 |
| 解决构建问题 | {tech}-build.md | 中 |
| 理清核心概念/API | {tech}-fundamentals.md | 低 |

### 进化前的自我检查

问自己:
- ✅ 这是可复用的模式吗？(不是项目特定的)
- ✅ 花了很大力气才弄清楚吗？
- ✅ 会帮助未来的开发吗？
- ✅ 还没记录在 skills 中吗？

如果都是肯定的，提议给用户:
> "这个解决方案可能值得保存到 skills。要我添加吗？"

## 目标文件映射 (tech + category)

| category | 目标文件 |
|---------|---------|
| patterns | {tech}-patterns.md |
| troubleshooting | {tech}-troubleshooting.md |
| architecture | {tech