Learning Path
浏览 AI 技能 相关教程与章节。
AI Agent、机器学习、深度学习、数据分析与 Python 科学计算。
教程
40
Skills 教程 Skills，翻译过来就是技能，用于为 AI 智能体添加专业技能和知识。 就像人一样，你会做饭、会开车、会写PPT——这些都是你的技能。 智能体（Agent）也一样，它也需要有技能才能帮你干活。 Skills 就是智能体的技能，大模型负责想和说，Skills 负责做。 普通 AI 和 AI 智能体的核心区别：智能体不只是思考者，更是行动者。 为什么需要 Agent Skills AI 智能体虽然具..
Skills 工作原理 你可能会好奇：智能体又不是人，它怎么知道某个 Skill 能做什么、该怎么做？ 答案很简单——靠读文件。 每个 Skill 背后，都有一个描述文件，通常叫 SKILL.md，就像一份说明书。 Skills 的工作原理 Skills 使用渐进式披露（Progressive Disclosure）的方式，让代理在不同的阶段加载不同详细程度的信息。这种设计使得代理可以同时管理大量技能，而不会耗尽上下文空间。 ..
SKILL.md 文件 SKILL.md 是 Agent Skills 的核心文件。本节将深入讲解 SKILL.md 的完整结构和所有可用字段。 基本结构 一个 SKILL.md 文件包含两个主要部分： YAML Frontmatter（元数据区域） Markdown 内容（指令区域） 完整示例 [mycode4 type='yaml'] --- name: my-skill description..
Skills 与外部 API 集成 Skill 脚本可以像普通 Python 程序一样调用外部 HTTP API，从而将 Claude 的能力与第三方服务连接起来。 调用外部 API 的基本模式 使用 requests 库发送 HTTP 请求，是 Skill 脚本中最常见的 API 调用方式。 实例 [mycode4 type='python'] # 文件路径：scripts/api_client.py i..
Skills 异步与并发处理 当 Skill 需要同时等待多个耗时操作（如网络请求、文件 I/O）时，异步编程能大幅减少总等待时间。 本篇介绍 Python asyncio 在 Skill 脚本中的应用场景与写法。 同步 vs 异步：何时该用异步 场景推荐方式原因 单个文件处理、单次 API 调用同步异步收益不明显，代码更简单 同时发出多个 HTTP 请求异步并发等待，总时间 ≈ 最长单次时间 同时读取多个文件异..
Skills 组合与编排 单个 Skill 解决单一问题，而复杂的工作流往往需要多个 Skill 协同配合。 本篇介绍如何设计 Skill 之间的依赖关系，以及在 SKILL.md 中编排多 Skill 工作流。 组合模式：两种思路 模式描述适用场景 顺序编排Skill A 的输出作为 Skill B 的输入数据处理流水线 并行调用同时使用多个 Skill，结果合并多源数据聚合 Claude 在单次对话中可以跨 ..
Skills 上下文与状态管理 Claude 的每次 API 调用都是无状态的，它不会自动记住上一次会话的内容。 但在一次连续对话中，所有历史消息都在上下文窗口里。理解这一点，能帮助你写出在对话中表现稳定的 Skill。 Skills 的状态存在于哪里 状态类型 存储位置 有效范围 对话历史 上下文窗口 当前会话，关闭后消失 中间文件 ..
Skills 日志与调试进阶 入门调试靠 print，进阶调试靠系统性的日志机制。 本篇介绍如何为 Skill 脚本建立结构化日志，以及在复杂执行流程中定位问题的进阶技巧。 用 logging 替代 print print 适合快速调试，但在正式 Skill 中应改用 Python 标准库的 logging 模块。 logging 的优势是可以控制输出级别——开发时输出 DEBUG 信息，生产时只输出 WARNING 以上。 实..
Skills 调试 Skill 写好后，常常会遇到'没有触发'、'执行出错'、'输出不对'等问题。 本篇介绍排查这些问题的基本思路和方法。 调试的三类常见问题 问题类型 现象 优先排查点 未触发 Claude 完全没有使用 Skill description 写法、任务复杂度 触发但执..
Skills 依赖管理 Skill 脚本通常需要第三方库，如何声明、安装和锁定这些依赖，是保证 Skill 可靠运行的基础。 依赖声明文件 在 Skill 的 scripts/ 目录下创建 requirements.txt（Python）或 package.json（Node.js），集中声明所有依赖。 Python 依赖：requirements.txt # 文件路径：scripts/requirements.txt # 格..
Skills 描述优化技巧 description 字段是 Skill 触发的唯一判断依据。 一个写得好的 description，能让 Skill 在正确的时机被触发，并避免在不相关的场景下干扰 Claude。 Description 的作用与限制 Claude 在决定是否使用某个 Skill 时，只会阅读 description 字段，不会提前读取 SKILL.md 正文。 这意味着 description 需要同时承担两件事：..
Skills 描述 技能描述（description）是技能最重要的部分，它决定了代理能否正确识别何时应该激活该技能。本节将教你如何编写有效的技能描述。 为什么描述很重要 技能描述在代理加载技能的过程中扮演着关键角色： 在发现阶段，代理只加载每个技能的名称和描述 描述是代理判断是否激活技能的主要依据 一个好的描述可以提高技能的激活准确率 如果描述写得不好，代理可能会： 在不需要时激活技能（误报） 在需要时忘记激活技能（..
Skills 目录结构 理解 Skill 的目录结构和运行机制，是构建可维护、可复用 AI Agent 能力的基础。 本文从零开始拆解一个标准 Skill 的目录结构、各文件作用和完整工作流程。 什么是 Skill Skill 是一个独立的能力单元，用来完成某一类特定任务。 如果把 Agent 比作操作系统，Skill 就像应用程序；如果把 Agent 比作项目经理，Skill 就是可以被调用的专业能力。 Skill 的常见类型 ..
cat > /mnt/user-data/outputs/2026-05-18/skills-ecosystem.html..
Skills 错误处理与容错 一个只能在理想情况下运行的 Skill 是脆弱的。 健壮的 Skill 需要预见常见错误，给出清晰的反馈，并尽可能自动恢复。 错误处理的三个层次 层次 发生位置 处理方式 输入验证错误 执行前 检查输入，若不合法直接拒绝并说明原因 运行时错误 脚本执行中 捕获异常，输出结构化错误信息 ..
第一个 Skill 让我们暂时忘掉复杂的创建过程，先从 使用一个现成的 Skill 开始，感受它带来的便利。 本文的演示基于 Claude Code，如果你还没安装，可以参考我们的 Claude Code 教程。 创建 Skill 目录 Skills 存放在 ~/.claude/skills/（个人全局）或项目目录下的 .claude/skills/（项目专用）。 本章节再项目目录下测试，先创建个目录 claude-test: m..
Skills 简介 Skills 是一个开放格式，用于为 AI 代理添加专业技能和知识。通过 Skills，你可以将特定领域的专业知识、工作流程和最佳实践封装成可重用的技能包，让 AI 代理在需要时自动调用。 在学习 Skills 之前，我们先搞清楚一个更基础的问题：什么是 AI 智能体？ 大家肯定用过 ChatGPT、豆包、通义千问这类工具吧？你打字问它问题，它给你文字回答。这就是我们常说的大模型聊天机器人。 ChatGPT、豆包..
Skills 输入/输出规范设计 一个优秀的 Skill，不仅能完成任务，还要清晰地定义'接受什么'和'产出什么'。 良好的输入输出规范，是 Skill 可靠运行的基础。 为什么要定义输入输出规范 Skills 面对的是真实的用户请求，输入格式千变万化。 没有明确规范的 Skill，Claude 会自行猜测输入意图，导致行为不稳定。 规范不是限制，而是给 Claude 明确的行动边界，减少歧..
Skills 监控与可观测性 Skill 发布后，如何知道它工作得好不好？是否频繁出错？哪些步骤最慢？ 本篇介绍如何为 Skill 建立可观测性，通过日志和指标了解运行状态。 可观测性的三个维度 维度回答的问题实现方式 日志（Logs）发生了什么？出了什么错？结构化 JSON 日志文件 指标（Metrics）执行了多少次？耗时多少？成功率多少？追加写入指标文件 执行记录（Trace）每次执行经过了哪些步骤？每步耗..
Skills 多步骤流程设计 简单任务只需一个步骤，但现实中的工作流往往涉及多个环节。 本篇介绍如何将复杂任务拆解为清晰的步骤，并在 SKILL.md 中组织成可靠的执行流程。 为什么要显式定义步骤 Claude 很聪明，但在没有明确步骤指导的情况下，它可能会跳过某些环节，或者以不一致的顺序执行。 显式步骤的好处： 一是让 Claude 的行为可预测；二是便于用户理解正在发生什么；三是出错后容易定位到哪一步出了问题。 步骤设计..
Skills 参数传递与接收 Skills 不像传统函数那样接收显式参数，它通过 Claude 的上下文来感知输入信息。 理解这种'隐式参数传递'机制，是写出实用 Skill 的关键。 Skills 如何获取参数 当 Claude 读取一个 Skill 后，整个对话上下文就是这个 Skill 的参数。 这意味着用户说的话、上传的文件、历史对话记录，都可以成为 Skill 的输入来源。 输入来源 ..
Skills 设计模式与最佳实践 经过大量实践总结出来的 Skill 设计模式，能帮助你在面对新需求时快速做出合理决策。 本篇汇总了最常用的 7 种设计模式及其适用场景。 模式一：单一职责 Skill 每个 Skill 只做一件事，做好一件事。 功能越聚焦，description 越精准，触发准确率越高，维护也越容易。 做法示例 正确：职责单一pdf-to-text（只负责提取文字） 错误：职责混杂pdf-tools..
Skills 性能优化 当 Skill 处理大文件或被频繁调用时，性能问题会直接影响用户体验。 本篇介绍在脚本层面提升处理速度的常用技巧。 性能问题的常见来源 来源典型表现优化方向 一次性加载大文件读取 100MB CSV 耗时数秒分块读取（chunk） 重复执行相同计算每次调用都重新计算统计值缓存结果 单线程串行处理处理 1000 个文件需要很长时间并行处理 频繁的磁盘 I/O循环中逐行写入文件批量写入 ..
Skill 代码审查 本项目构建一个代码审查 Skill，用户上传代码文件后，自动分析代码质量、风格问题和潜在 Bug。 目标：掌握工具链集成与结构化问题报告的生成。 项目需求分析 功能支持语言工具 语法检查Pythonpy_compile（内置） 代码风格检查Pythonflake8 代码复杂度分析Pythonradon JavaScript 检查JS/TSeslint（npx） 综合问题报告所有自定义..