Kulaxyz/self-learning-skills

self‑learning‑skills – AI 编码代理的元技能

它是什么

• 一个微小的“技能”，可以添加到任何 AI 驱动的编码助手（Claude Code、Cursor、Codex、Aider、Gemini‑CLI、Zed 等）。
• 它的目的不是编写代码本身，而是记住代理在调试或部署过程中发现的步骤，并在未来的会话中自动重播它们。

为什么它很重要

• 当您使用基于 LLM 的代理时，每次开始新会话时，通常必须重复相同的“我该如何连接生产数据库？”或“部署指令是什么？”的发现过程。此技能捕捉那些得来不易的“黄金路径”（包括无效的方法），并将其存储在代理下次可以自动加载的地方，将临时的故障排除转化为可重复使用的知识。

运作方式

1. 识别 – 该技能会监控代理的输出以寻找提示（例如，您说*“记住这个”*，或者代理在多次尝试后终于成功）。
2. 捕捉 – 它会创建一个简洁、独立的程序描述（或单一事实），如果相关，还会包含关于避免了哪些失败尝试的注记。
3. 重复使用 – 在下一个会话中，存储的条目会自动加载，作为新的技能（用于多步骤工作流程）或轻量级笔记（用于单一事实）。代理随后无需重新推导步骤即可应用它。

工具特定的持久化

代理 / 工具	知识写入位置	如何自动加载
Claude Code, Codex, 其他 Agent Skills 客户端	skills/<name>/SKILL.md	Agent Skills 框架的技能匹配逻辑
Cursor	.cursor/rules/learned/<name>.mdc	Cursor 的规则匹配机制
Zed, Aider, Gemini‑CLI, 任何读取 AGENTS.md 的工具	AGENTS.md (或项目范围笔记)	每次启动时读取该文件

安装选项

• 通过 npx 的单行指令（推荐） – 检测已安装的代理并放入适当的文件：

  npx skills add kulaxyz/self-learning-skills          # 本地于当前项目
  npx skills add kulaxyz/self-learning-skills -g      # 全局于所有项目
  npx skills add kulaxyz/self-learning-skills -a claude-code  # 仅限 Claude Code
  

• Claude Code 插件 – 通过内置市场添加：

  /plugin marketplace add kulaxyz/self-learning-skills
  /plugin install self-learning@self-learning-skills
  

• 手动复制 – 克隆存储库并将相关目录/文件复制到适当位置（请参阅 README 的“Manual”部分）。

提升规则（质量守门员） 只有在满足所有三个条件时，捕捉到的条目才会成为技能：

1. 程序已验证（测试通过、构建成功等）。
2. 明确命名了它所避免的失败模式。
3. 记录了至少一个已尝试并排除的死胡同。 如果缺少任何条件，该条目将保持为临时笔记或被丢弃，防止未经验证的猜测污染技能集。

安全考量

• 该技能绝不会写入实际的密钥值。它只记录密钥的位置（例如环境变量名称、密钥管理器查找）。
• 由于产生的文件旨在提交，设计刻意避免泄露凭证。

存储库布局（快速地图）

self-learning-skills/
├─ AGENTS.md                # 适用于任何支持 AGENTS 的工具的通用循环描述
├─ skills.sh.json           # `npx skills` 安装程序的清单
├─ .claude-plugin/…         # Claude Code 市场元数据
├─ skills/self-learning/    # 核心技能文件 (SKILL.md, 模板, 文档)
└─ .cursor/rules/…          # Cursor 规则和 learned‑rules 文件夹

典型使用案例

1. 您开始与 LLM 代理进行调试会话。
2. 经过几次尝试，您终于发现了迁移数据库的正确指令。
3. 您说*“记住这个”*（或者技能自动检测到成功）。
4. 该技能写入一个 SKILL.md（或 Cursor 的 .mdc），描述迁移步骤和失败的尝试。
5. 在下一个会话中，代理自动加载该技能，无需您再次进行试错即可执行迁移。

限制

• 它依赖于底层代理支持 Agent‑Skills 标准或读取 AGENTS.md；没有此类挂钩的工具无法受益。
• “识别时刻”的检测是启发式的；如果错过了提示，知识将不会被捕捉。
• 提升规则需要通过验证步骤，因此纯信息性事实（例如“生产数据库 URL 在 DATABASE_URL 中”）将仅作为轻量级笔记存储，而不是作为可执行技能。

授权

• MIT © kulaxyz (参阅 LICENSE)。