我是如何保证 Agent Skill 多而不乱的？

┌────────────────────────────────────────────────────────────────┐
│                       任务请求（用户输入）                        │
└───────────────┬────────────────────────────────┬───────────────┘
                │ 快路径                          │ 慢路径（兜底）
                ▼                                ▼
┌───────────────────────────┐   ┌────────────────────────────────┐
│ L1 排序层                  │   │ 子Agent 全量检索                 │
│ 多指标综合排序 → Top-N      │   │ 触发条件：复杂任务 / 首轮效果不佳  │
│ 注入 system prompt        │   │ （skill-matcher subagent）      │
└─────────────┬─────────────┘   └───────────────┬────────────────┘
              │                                │
              ▼                                ▼
┌────────────────────────────────────────────────────────────────┐
│                   L2 存储管理层（skills-manager）                │
│   中央库 ~/.skills-manager/ → Preset 分组 → 软链接分发到各工具     │
│   SQLite: skills-manager.db（单一事实来源 Single Source of Truth）│
└─────────────────────────────┬──────────────────────────────────┘
                              │ 每个 skill 内部
                              ▼
┌────────────────────────────────────────────────────────────────┐
│                   L3 分区保护层（每个 skill 内部）                │
│   ┌─────────────────────────────────────────────────────────┐  │
│   │ 不可修改区（核心）         │ 可修改区（外围）              │  │
│   │ SKILL.md 元原则（≤15条）   │ references/*.md 经验卡片    │  │
│   │ 红线 / 方法论骨架          │ 模板 / 示例 / 临时结论        │  │
│   │ 变更需人工确认 + 日期标注   │ 使用中自由迭代               │  │
│   └─────────────────────────────────────────────────────────┘  │
└─────────────────────────────┬──────────────────────────────────┘
                              │ 使用反馈回流
                              ▼
┌────────────────────────────────────────────────────────────────┐
│                   L4 自进化层                                    │
│   使用数据 → 评估基准（with/without 对比）→ 触发分析 → 迭代      │
│   同一问题出现 3 次 → 升级为元原则（不可修改区）                 │
│   新经验与元原则冲突 → 触发元原则修订（带日期标注）               │
└────────────────────────────────────────────────────────────────┘

score = w1·norm(usage_freq)      # 0.35 个人实证最重
      + w2·norm(community_score) # 0.15 社区验证
      + w3·norm(uniqueness)      # 0.20 不可替代性
      + w4·norm(success_rate)    # 0.20 质量
      + w5·norm(recency)         # 0.10 新鲜度

中央库 ~/.skills-manager/skills/（+ skills-manager.db 元数据）
        │
        ├── Preset "Web Dev"     → skill1 ✓, skill2 ✓
        ├── Preset "Code Analysis" → skill2 ✓, skill3 ✓
        └── Preset "Team Core"   → ...
                │
                ▼ 软链接分发
~/.claude/skills/   ~/.cursor/skills/   .trae/...   各项目 .agents/skills/

ALTER TABLE skills ADD COLUMN category     TEXT;  -- 分类（classify_skills.py 产出）
ALTER TABLE skills ADD COLUMN score        REAL;  -- L1 综合分
ALTER TABLE skills ADD COLUMN usage_freq   INTEGER DEFAULT 0;
ALTER TABLE skills ADD COLUMN community_score REAL DEFAULT 0;
ALTER TABLE skills ADD COLUMN uniqueness   REAL DEFAULT 0;
ALTER TABLE skills ADD COLUMN success_rate REAL DEFAULT 0;
ALTER TABLE skills ADD COLUMN mutable      INTEGER DEFAULT 0;  -- L3: 1=可修改区技能
ALTER TABLE skills ADD COLUMN last_used    TIMESTAMP;
ALTER TABLE skills ADD COLUMN source_url   TEXT;  -- 溯源

my-skill/
├── SKILL.md           ← 【不可修改区】元原则层
│                          核心方法论骨架、红线、触发规则
│                          上限 15 条元原则
│                          变更条件：人工确认 + 日期标注（如 "2026-09-05 修订"）
├── references/        ← 【可修改区】经验卡片层
│   ├── lesson-*.md       场景/问题/根因/方案/反模式/溯源 六元组
│   └── ...               使用中自由追加、修改、淘汰
├── templates/         ← 【可修改区】模板
└── evals/             ← 【可修改区】评估用例（随经验同步更新）

使用/踩坑 → 记录（usercontext 会话级）
    → 蒸馏（经验卡片进 references/，即 dev-lessons 模式）
    → 评估（skill_benchmark: with_skill vs without_skill 对比）
    → 触发分析（skill_trigger_analyzer: 假阳性/假阴性统计）
    → 迭代 SKILL.md 描述 / 断言 / 元原则
    ↻ 循环，全程留 iteration-N 快照可回滚