mcpField
L
learn

learn

github.com/aviz85Agent 工作流5048 次安装16 周前更新
代码仓库

关于 learn

这是一个 Claude 技能，可研究主题并将整理出的知识保存为后续对话可复用的技能。它在可用时使用 Context7，也可改用 WebSearch 和 WebFetch，并支持更新技能或保存到项目目录。

主要功能

  1. 01研究库、API 和其他主题
  2. 02使用 Context7 或网页研究工具
  3. 03创建可复用的主题技能
  4. 04依据新文档更新技能
  5. 05全局或按项目保存技能

适用场景

  1. 01根据文档学习某个库
  2. 02整理 API 配置与使用模式
  3. 03创建项目专用领域参考
  4. 04文档变更后更新技能

MCP 相关

此流程可使用 Context7 MCP 插件解析库并查询文档。若该插件不可用或没有相关主题，则改用 WebSearch 和 WebFetch。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aviz85/claude-skills-library --skill learn

安装后在 Claude Code 中输入/learn确认已加载。

详细介绍

学习：教会 Claude 任意主题

研究并学习任意主题，然后将知识保留为永久技能。适用于：

  • 代码库：React、Stripe、Supabase（如有 Context7，则使用）
  • API 和服务：Twilio、OpenAI、Google API
  • 概念与方法论：GTD、敏捷、设计模式
  • 领域知识：税法、医学术语、行业实践
  • 工具：Docker、Kubernetes、FFmpeg

学习之后，Claude 在未来的所有对话中都会成为该主题的专家。

用法

/learn <topic>           # Create new skill from docs
/learn <topic> --update  # Update existing skill with latest docs
/learn <topic> --project # Save to project (.claude/skills/) instead of global

流程

1. 研究主题

对于代码库/API——首先尝试使用 Context7：

mcp__plugin_context7_context7__resolve-library-id
  query: "user's task/question"
  libraryName: "<topic>"

对于任意主题（或 Context7 不包含相关内容时）——使用 WebSearch：

WebSearch: "<topic>" guide tutorial best practices
WebSearch: "<topic>" official documentation
WebSearch: "<topic>" examples patterns

对于领域知识——进行更广泛的研究：

WebSearch: "<topic>" comprehensive guide
WebSearch: "<topic>" key concepts terminology
WebSearch: "<topic>" common mistakes pitfalls

使用 WebFetch 阅读找到的最相关页面。

2. 提取知识

查询文档，获取关键信息：

mcp__plugin_context7_context7__query-docs
  libraryId: "<resolved-id>"
  query: "getting started setup authentication common patterns"

提取以下内容：

  • 设置/安装：如何开始使用
  • 核心概念：关键抽象和术语
  • 常见模式：典型用法示例
  • API 参考：必要的方法/函数
  • 易错点：文档中提到的不明显陷阱
  • 最佳实践：推荐的方法

如果文档内容较多，请进行多次有针对性的查询：

  1. “安装、设置、快速入门”
  2. “身份验证、API 密钥、配置”
  3. “常见模式、示例”
  4. “错误处理、故障排除”
3. 查阅 Claude Code 指南

创建技能前，使用 claude-code-guide Agent 确认当前的技能规范：

Task tool with subagent_type: claude-code-guide
prompt: "What are the current conventions for writing Claude Code skills?
        I need to know: required/optional frontmatter fields,
        description best practices, and recommended structure."

这样可以确保生成的技能遵循最新的 Claude Code 模式。

4. 生成技能结构

在适当的位置创建技能：

  • 默认：~/.claude/skills/<topic>/skill.md
  • 使用 --project：.claude/skills/<topic>/skill.md

技能模板：

---
name: <topic>
description: <What the library does>. Use when <specific triggers>. Covers: <main capabilities>.
---

# <Topic> Quick Reference

## Setup

[Installation commands and initial config]

## Core Concepts

[Key abstractions - 2-3 sentences each]

## Common Patterns

### [Pattern 1 Name]
[Code example with brief explanation]

### [Pattern 2 Name]
[Code example with brief explanation]

## API Quick Reference

| Method | Purpose | Example |
|--------|---------|---------|
| ... | ... | ... |

## Gotchas

- [Non-obvious issue 1]
- [Non-obvious issue 2]

## Links

- [Official Docs](url)
- [API Reference](url)
5. 验证并告知用户

创建技能后：

  1. 确认技能已创建
  2. 显示技能描述（什么情况会触发它）
  3. 显示 2-3 个可触发该技能的提示词示例

质量指南

应当：

  • 聚焦于实用、可执行的信息
  • 加入文档中的真实代码示例
  • 如有相关内容，记录特定版本的详情
  • 添加官方文档 URL 以供参考

不要：

  • 复制整份文档（涉及版权）
  • 包含营销/宣传内容
  • 添加 Claude 通常已知的信息
  • 让技能过长（少于 500 行）

更新模式（--update）

更新现有技能时：

  1. 阅读当前技能内容
  2. 查询文档，获取最新/新增信息
  3. 合并新内容，同时保留现有结构
  4. 如适用，注明版本变更

示例

User: /learn stripe-payments

Claude:
1. Resolves "stripe" via Context7 → /stripe/stripe-node
2. Queries: setup, authentication, common patterns, webhooks
3. Consults claude-code-guide for current skill conventions
4. Creates ~/.claude/skills/stripe-payments/skill.md with:
   - API key setup
   - Payment intent flow
   - Webhook verification
   - Error handling patterns
5. Reports: "Created stripe-payments skill. Triggers on: 'Stripe payment', 'charge card', 'payment intent'"

要求

  • Context7 MCP 插件（推荐）——用于访问代码库文档
  • 或使用 WebSearch/WebFetch 工具——作为访问任意文档的后备方案

评论

支持 Markdown