proactive-self-improving-agent
自动捕获经验并安全进化的技能。触发条件:(1)命令/操作失败时→记ERRORS.md (2)被用户纠正('不对'/'应该是')时→记LEARNINGS.md (3)用户需要不存在的能力时→记FEATURE_REQUESTS.md (4)外部API/工具出错时→记ERRORS.md (5)发现自己知识过时/错误时→记LEARNINGS.md (6)发现更好做法时→记LEARNINGS.md (7)每个任务完成时→回顾过程,有新经验则记LEARNINGS.md。去重原则:如果没有新经验或已有条目已覆盖则跳过不写。每次写入同时在.learnings/CHANGELOG.md追加JSONL日志。经验反复出现≥3次时晋升到AGENTS.md/TOOLS.md/SOUL.md。详见正文。
Security Assessment
About proactive-self-improving-agent
The 'proactive-self-improving-agent' skill is designed to enable an AI agent to autonomously capture experiences, learn from them, and safely evolve over time. It addresses the challenge of knowledge decay and repeated mistakes by automatically recognizing errors, corrections, and opportunities for improvement, then documenting these insights in a structured format. By systematically recording experiences and reviewing tasks, the agent develops a persistent knowledge base, ensuring that lessons learned are retained and actionable improvements are propagated without manual intervention.
The skill provides a robust experience recording system with clearly defined triggers for logging new information, such as failed commands, user corrections, feature requests, external API failures, and discovery of outdated or suboptimal practices. Entries are categorized into learnings, errors, and feature requests, each following a structured format with metadata, priority levels, status, and context. Repeated experiences can be promoted to permanent files like AGENTS.md, TOOLS.md, or SOUL.md, ensuring that high-value knowledge is solidified as long-term capability. The skill also includes safeguards against redundant or low-value entries to maintain the quality and relevance of the knowledge base.
Typical use cases include research environments, automated workflow optimization, and AI systems that require continuous self-improvement. Target users are developers, AI trainers, and knowledge engineers who want their agents to autonomously learn from interactions and operational feedback. It is particularly useful in scenarios where repetitive tasks, tool interactions, or decision-making processes can be refined over time, allowing the agent to evolve safely while maintaining a clear audit trail of lessons learned and errors encountered.
FAQ
How does the agent determine what experiences to record?
The agent monitors specific triggers such as command failures, user corrections, feature requests, API errors, and task reviews. It evaluates whether an experience is genuinely new before recording it to avoid redundancy.
Where are the recorded experiences stored?
Experiences are stored in a structured file system under .learnings/, including LEARNINGS.md for lessons and best practices, ERRORS.md for errors, FEATURE_REQUESTS.md for capability requests, and CHANGELOG.md for logging changes.
Can recorded experiences evolve into permanent capabilities?
Yes, experiences that are repeated and deemed valuable can be promoted to permanent files like AGENTS.md, TOOLS.md, or SOUL.md, which codifies them as long-term agent capabilities.
What formats and metadata are used for entries?
Learnings, errors, and feature requests each have structured formats with priority, status, area, content summary, suggested fixes, and metadata such as source, pattern keys, and cross-references for traceability.
Who can benefit from using this skill?
Developers, AI trainers, and knowledge engineers who want their agents to autonomously learn, safely improve over time, and maintain a structured record of insights, errors, and best practices will find this skill valuable.
Install proactive-self-improving-agent
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
