skill-experience-layer（技能经验层）

Skill Experience Layer - 技能经验分层机制

What it does

Give your agent permanent, per-skill experience memory that:

1. Pre-call checking: Before you call any skill, *automatically read the common mistakes and best practices* so you avoid repeating the same pitfalls
2. Error-driven learning: When you make a mistake, *immediately record it to the corresponding skill's experience file*
3. Automatic evolution: Integrates with capability-evolver to automatically improve experience when mistakes repeat
4. Fits existing memory architecture: Works with your existing (instant → hot → short-term → long-term) memory hierarchy

Why this is different

Workflow

1. For every skill you use

When you install a new skill:

• Create memory/experiences/{skill-name}.json
• Define commonMistakes[] and bestPractices[]
• *Before every invocation*, read it and remind yourself what to avoid

2. When you make a mistake

1. Stop immediately, don't keep retrying
2. Record the mistake in self-improving/corrections.md
3. Update the skill's experience JSON:

- Add new entry to experiences[] with context, lesson, prevention - Update commonMistakes[] if it's a new pattern - Increment failureCount

1. If the *same mistake repeats 2+ times*, trigger capability-evolver to automatically improve the experience and best practices
2. Retry after updating

3. Regular maintenance

• Daily: End-of-day review mistakes, update experiences
• Weekly: Promote key lessons to long-term memory in MEMORY.md
• Automatic: capability-evolver can continuously improve stale experiences

Example experience file

{
  "type": "skill",
  "name": "my-skill",
  "lastUpdated": "2026-03-17T19:00:00+08:00",
  "totalExecutions": 10,
  "successCount": 8,
  "failureCount": 2,
  "experiences": [
    {
      "id": "exp-my-skill-001",
      "timestamp": "2026-03-10T20:00:00+08:00",
      "context": "What you were doing when the mistake happened",
      "lesson": "What you learned",
      "severity": "medium",
      "timesRepeated": 1,
      "prevention": "What to do differently next time"
    }
  ],
  "patterns": {
    "commonMistakes": [
      "First common mistake to avoid",
      "Second common mistake"
    ],
    "bestPractices": [
      "First best practice",
      "Second best practice"
    ]
  }
}

Integration with existing systems

Works great with:

• self-improving: Uses the correction/reflection workflow
• capability-evolver: Automatic experience improvement when mistakes repeat
• Your existing memory hierarchy: Experiences live in memory/experiences/, fits alongside your daily/weekly memory

Safety Boundaries

• ✅ Only modifies experience files in memory/experiences/ and skill-owned files
• ✅ Never touches core root files (MEMORY.md, SOUL.md, IDENTITY.md, USER.md, .env) — reads but does not write
• ✅ Never accesses sensitive directories (~/.ssh, ~/.aws, /etc)
• ✅ All automatic changes are backed up before applying, can roll back
• ✅ High-risk changes require human approval

Author

Created from practical experience integrating self-improvement into a working agent. This is the missing glue between general self-improving frameworks and your actual daily usage.

Get smarter with every mistake, don't repeat the same pit twice.