用途：在会话中发现重要仓库学习点（反复出现的模式、不易察觉的坑、关键架构约束、可复用领域知识）时，将其固化为持久化的 skill 或 instruction，避免未来会话重复摸索。触发时机包括：用户明确说 "learn!" 或要求记录；发现耗费大量调试时间的模式或约束；识别出仓库中未记录的领域知识；用户纠正揭示出值得保留的通用原则。
决策：小型洞察（1-4 句）且能自然融入现有 instruction 时，加入现有文件的 Learnings 段，遵循 .github/instructions/learnings.instructions.md 的模式；知识较庞大（多步流程、详细指南、丰富示例）或覆盖独立领域、未来可按名称调用时，创建或更新 skill，路径为 .github/skills/{name}/SKILL.md（项目级）或 .agents/skills/{name}/SKILL.md（智能体专用）；规则需按文件模式（applyTo）自动应用或全局生效、属于编码约定/架构约束/流程规则、无需按需调用时，创建 or 更新 instruction（.github/instructions/{name}.instructions.md）。
流程：先反思问题与根因、修复方式、能否泛化；再检查已有文件： ls .github/skills/ .agents/skills/ 2>/dev/null ls .github/instructions/ 2>/dev/null grep -r "related-keyword" .github/skills/ .github/instructions/ .agents/skills/
优先追加到已有文件的 ## Learnings 段；无合适归宿则新建 skill 或 instruction。新建 skill 的 SKILL.md 需带 frontmatter，name 必须与父文件夹名完全一致，正文应含具体正反例。新建 instruction 的 frontmatter 含 description 和可选 applyTo 通配符。
质量检查：学习点是否足够通用、足够具体可执行、含正反例、不重复已有内容、description 能让智能体判断何时调用。完成后向用户总结捕获内容与位置、选择该位置的原因、是更新还是新建。限制：资料未提供具体适用范围、依赖工具或版本要求。