用途：capture-learning 用于把一次问题解决过程完整记录下来，形成可复用的叙事文档，而不仅是记录最终答案。它强调记录“发现之旅”，包括我们原本以为的事实、实际发现的事实、排查步骤、最终方案与关键结论。
主要能力：按六个叙事要素组织内容——问题、初始假设、实际情况、排查过程、解决方案、关键收获；可选将经验提升到全局，写入 ~/.claude/learnings/global-patterns.md 供跨项目使用；输出文件包含完整叙事、前后对比、技术细节与所用命令、可执行的经验总结。
使用方式：交互模式运行 bun ~/.claude/skills/capture-learning/scripts/capture-learning.ts，会引导填写叙事；直接模式需提供全部六个参数：bun ~/.claude/skills/capture-learning/scripts/capture-learning.ts "problem" "initial assumption" "actual reality" "troubleshooting steps" "solution" "key takeaway"。触发短语包括“Great job, log this”“Document this”“Capture this learning”“Save this for later”“That worked!”等。
输出位置：文件保存到 <project-root>/.claude/learnings/YYYY-MM-DD-problem-description.md；若不在 git 仓库内，则回退到 ~/.claude/learnings/。
限制与注意：Claude Code 不会自动读取 learnings 目录，需要在项目的 CLAUDE.md 中显式加入提示，让 Claude 每次会话前检查 .claude/learnings/ 并应用过往经验；资料未提供其他平台支持、收费或价格信息。