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

What it does

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

1. 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 INLINECODE1
• Define commonMistakes[] and INLINECODE3
• Before every invocation, read it and remind yourself what to avoid

2. When you make a mistake

1. 1. Stop immediately, don't keep retrying
2. Record the mistake in INLINECODE4
3. Update the skill's experience JSON:

1. 4. 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

CODEBLOCK0

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.