CodeNodeX AI
Sign upWrite

Learning Path

AI skills tutorials

Browse tutorials and chapters for AI skills.

AI & data

AI agents, ML, deep learning, analytics, and scientific Python.

Tutorials

40

TAXONOMYAI & dataFetched/AI skills

Skills 教程

Skills 教程 Skills，翻译过来就是技能，用于为 AI 智能体添加专业技能和知识。 就像人一样，你会做饭、会开车、会写PPT——这些都是你的技能。 智能体（Agent）也一样，它也需要有技能才能帮你干活。 Skills 就是智能体的技能，大模型负责想和说，Skills 负责做。 普通 AI 和 AI 智能体的核心区别：智能体不只是思考者，更是行动者。 为什么需要 Agent Skills AI 智能体虽然具..

TUTORIALAI & dataFetched/AI skills

Skills 工作原理

Skills 工作原理 你可能会好奇：智能体又不是人，它怎么知道某个 Skill 能做什么、该怎么做？ 答案很简单——靠读文件。 每个 Skill 背后，都有一个描述文件，通常叫 SKILL.md，就像一份说明书。 Skills 的工作原理 Skills 使用渐进式披露（Progressive Disclosure）的方式，让代理在不同的阶段加载不同详细程度的信息。这种设计使得代理可以同时管理大量技能，而不会耗尽上下文空间。 ..

TUTORIALAI & dataFetched/AI skills

SKILL.md 文件

SKILL.md 文件 SKILL.md 是 Agent Skills 的核心文件。本节将深入讲解 SKILL.md 的完整结构和所有可用字段。 基本结构 一个 SKILL.md 文件包含两个主要部分： YAML Frontmatter（元数据区域） Markdown 内容（指令区域） 完整示例 [mycode4 type='yaml'] --- name: my-skill description..

TUTORIALAI & dataFetched/AI skills

Skills 与外部 API 集成

Skills 与外部 API 集成 Skill 脚本可以像普通 Python 程序一样调用外部 HTTP API，从而将 Claude 的能力与第三方服务连接起来。 调用外部 API 的基本模式 使用 requests 库发送 HTTP 请求，是 Skill 脚本中最常见的 API 调用方式。 实例 [mycode4 type='python'] # 文件路径：scripts/api_client.py i..

TUTORIALAI & dataFetched/AI skills

Skills 异步与并发处理

Skills 异步与并发处理 当 Skill 需要同时等待多个耗时操作（如网络请求、文件 I/O）时，异步编程能大幅减少总等待时间。 本篇介绍 Python asyncio 在 Skill 脚本中的应用场景与写法。 同步 vs 异步：何时该用异步 场景推荐方式原因 单个文件处理、单次 API 调用同步异步收益不明显，代码更简单 同时发出多个 HTTP 请求异步并发等待，总时间 ≈ 最长单次时间 同时读取多个文件异..

TUTORIALAI & dataFetched/AI skills

Skills 组合与编排

Skills 组合与编排 单个 Skill 解决单一问题，而复杂的工作流往往需要多个 Skill 协同配合。 本篇介绍如何设计 Skill 之间的依赖关系，以及在 SKILL.md 中编排多 Skill 工作流。 组合模式：两种思路 模式描述适用场景 顺序编排Skill A 的输出作为 Skill B 的输入数据处理流水线 并行调用同时使用多个 Skill，结果合并多源数据聚合 Claude 在单次对话中可以跨 ..

TUTORIALAI & dataFetched/AI skills

Skills 上下文与状态管理

Skills 上下文与状态管理 Claude 的每次 API 调用都是无状态的，它不会自动记住上一次会话的内容。 但在一次连续对话中，所有历史消息都在上下文窗口里。理解这一点，能帮助你写出在对话中表现稳定的 Skill。 Skills 的状态存在于哪里 状态类型 存储位置 有效范围 对话历史 上下文窗口 当前会话，关闭后消失 中间文件 ..

TUTORIALAI & dataFetched/AI skills

Skills 日志与调试进阶

Skills 日志与调试进阶 入门调试靠 print，进阶调试靠系统性的日志机制。 本篇介绍如何为 Skill 脚本建立结构化日志，以及在复杂执行流程中定位问题的进阶技巧。 用 logging 替代 print print 适合快速调试，但在正式 Skill 中应改用 Python 标准库的 logging 模块。 logging 的优势是可以控制输出级别——开发时输出 DEBUG 信息，生产时只输出 WARNING 以上。 实..

TUTORIALAI & dataFetched/AI skills

Skills 调试

Skills 调试 Skill 写好后，常常会遇到'没有触发'、'执行出错'、'输出不对'等问题。 本篇介绍排查这些问题的基本思路和方法。 调试的三类常见问题 问题类型 现象 优先排查点 未触发 Claude 完全没有使用 Skill description 写法、任务复杂度 触发但执..

TUTORIALAI & dataFetched/AI skills

Skills 依赖管理

Skills 依赖管理 Skill 脚本通常需要第三方库，如何声明、安装和锁定这些依赖，是保证 Skill 可靠运行的基础。 依赖声明文件 在 Skill 的 scripts/ 目录下创建 requirements.txt（Python）或 package.json（Node.js），集中声明所有依赖。 Python 依赖：requirements.txt # 文件路径：scripts/requirements.txt # 格..

TUTORIALAI & dataFetched/AI skills

Skills 描述优化技巧

Skills 描述优化技巧 description 字段是 Skill 触发的唯一判断依据。 一个写得好的 description，能让 Skill 在正确的时机被触发，并避免在不相关的场景下干扰 Claude。 Description 的作用与限制 Claude 在决定是否使用某个 Skill 时，只会阅读 description 字段，不会提前读取 SKILL.md 正文。 这意味着 description 需要同时承担两件事：..

TUTORIALAI & dataFetched/AI skills

Skills 描述

Skills 描述 技能描述（description）是技能最重要的部分，它决定了代理能否正确识别何时应该激活该技能。本节将教你如何编写有效的技能描述。 为什么描述很重要 技能描述在代理加载技能的过程中扮演着关键角色： 在发现阶段，代理只加载每个技能的名称和描述 描述是代理判断是否激活技能的主要依据 一个好的描述可以提高技能的激活准确率 如果描述写得不好，代理可能会： 在不需要时激活技能（误报） 在需要时忘记激活技能（..

TUTORIALAI & dataFetched/AI skills

Skills 目录结构

Skills 目录结构 理解 Skill 的目录结构和运行机制，是构建可维护、可复用 AI Agent 能力的基础。 本文从零开始拆解一个标准 Skill 的目录结构、各文件作用和完整工作流程。 什么是 Skill Skill 是一个独立的能力单元，用来完成某一类特定任务。 如果把 Agent 比作操作系统，Skill 就像应用程序；如果把 Agent 比作项目经理，Skill 就是可以被调用的专业能力。 Skill 的常见类型 ..

TUTORIALAI & dataFetched/AI skills

自定义 Skills 生态系统搭建

cat > /mnt/user-data/outputs/2026-05-18/skills-ecosystem.html..

TUTORIALAI & dataFetched/AI skills

Skills 错误处理与容错

Skills 错误处理与容错 一个只能在理想情况下运行的 Skill 是脆弱的。 健壮的 Skill 需要预见常见错误，给出清晰的反馈，并尽可能自动恢复。 错误处理的三个层次 层次 发生位置 处理方式 输入验证错误 执行前 检查输入，若不合法直接拒绝并说明原因 运行时错误 脚本执行中 捕获异常，输出结构化错误信息 ..

TUTORIALAI & dataFetched/AI skills

第一个 Skill

第一个 Skill 让我们暂时忘掉复杂的创建过程，先从 使用一个现成的 Skill 开始，感受它带来的便利。 本文的演示基于 Claude Code，如果你还没安装，可以参考我们的 Claude Code 教程。 创建 Skill 目录 Skills 存放在 ~/.claude/skills/（个人全局）或项目目录下的 .claude/skills/（项目专用）。 本章节再项目目录下测试，先创建个目录 claude-test: m..

TUTORIALAI & dataFetched/AI skills

Skills 简介

Skills 简介 Skills 是一个开放格式，用于为 AI 代理添加专业技能和知识。通过 Skills，你可以将特定领域的专业知识、工作流程和最佳实践封装成可重用的技能包，让 AI 代理在需要时自动调用。 在学习 Skills 之前，我们先搞清楚一个更基础的问题：什么是 AI 智能体？ 大家肯定用过 ChatGPT、豆包、通义千问这类工具吧？你打字问它问题，它给你文字回答。这就是我们常说的大模型聊天机器人。 ChatGPT、豆包..

TUTORIALAI & dataFetched/AI skills

Skills 输入/输出规范设计

Skills 输入/输出规范设计 一个优秀的 Skill，不仅能完成任务，还要清晰地定义'接受什么'和'产出什么'。 良好的输入输出规范，是 Skill 可靠运行的基础。 为什么要定义输入输出规范 Skills 面对的是真实的用户请求，输入格式千变万化。 没有明确规范的 Skill，Claude 会自行猜测输入意图，导致行为不稳定。 规范不是限制，而是给 Claude 明确的行动边界，减少歧..

TUTORIALAI & dataFetched/AI skills

Skills 监控与可观测性

Skills 监控与可观测性 Skill 发布后，如何知道它工作得好不好？是否频繁出错？哪些步骤最慢？ 本篇介绍如何为 Skill 建立可观测性，通过日志和指标了解运行状态。 可观测性的三个维度 维度回答的问题实现方式 日志（Logs）发生了什么？出了什么错？结构化 JSON 日志文件 指标（Metrics）执行了多少次？耗时多少？成功率多少？追加写入指标文件 执行记录（Trace）每次执行经过了哪些步骤？每步耗..

TUTORIALAI & dataFetched/AI skills

Skills 多步骤流程设计

Skills 多步骤流程设计 简单任务只需一个步骤，但现实中的工作流往往涉及多个环节。 本篇介绍如何将复杂任务拆解为清晰的步骤，并在 SKILL.md 中组织成可靠的执行流程。 为什么要显式定义步骤 Claude 很聪明，但在没有明确步骤指导的情况下，它可能会跳过某些环节，或者以不一致的顺序执行。 显式步骤的好处： 一是让 Claude 的行为可预测；二是便于用户理解正在发生什么；三是出错后容易定位到哪一步出了问题。 步骤设计..

TUTORIALAI & dataFetched/AI skills

Skills 参数传递与接收

Skills 参数传递与接收 Skills 不像传统函数那样接收显式参数，它通过 Claude 的上下文来感知输入信息。 理解这种'隐式参数传递'机制，是写出实用 Skill 的关键。 Skills 如何获取参数 当 Claude 读取一个 Skill 后，整个对话上下文就是这个 Skill 的参数。 这意味着用户说的话、上传的文件、历史对话记录，都可以成为 Skill 的输入来源。 输入来源 ..

TUTORIALAI & dataFetched/AI skills

Skills 设计模式与最佳实践

Skills 设计模式与最佳实践 经过大量实践总结出来的 Skill 设计模式，能帮助你在面对新需求时快速做出合理决策。 本篇汇总了最常用的 7 种设计模式及其适用场景。 模式一：单一职责 Skill 每个 Skill 只做一件事，做好一件事。 功能越聚焦，description 越精准，触发准确率越高，维护也越容易。 做法示例 正确：职责单一pdf-to-text（只负责提取文字） 错误：职责混杂pdf-tools..

TUTORIALAI & dataFetched/AI skills

Skills 性能优化

Skills 性能优化 当 Skill 处理大文件或被频繁调用时，性能问题会直接影响用户体验。 本篇介绍在脚本层面提升处理速度的常用技巧。 性能问题的常见来源 来源典型表现优化方向 一次性加载大文件读取 100MB CSV 耗时数秒分块读取（chunk） 重复执行相同计算每次调用都重新计算统计值缓存结果 单线程串行处理处理 1000 个文件需要很长时间并行处理 频繁的磁盘 I/O循环中逐行写入文件批量写入 ..

TUTORIALAI & dataFetched/AI skills

Skill 代码审查

Skill 代码审查 本项目构建一个代码审查 Skill，用户上传代码文件后，自动分析代码质量、风格问题和潜在 Bug。 目标：掌握工具链集成与结构化问题报告的生成。 项目需求分析 功能支持语言工具 语法检查Pythonpy_compile（内置） 代码风格检查Pythonflake8 代码复杂度分析Pythonradon JavaScript 检查JS/TSeslint（npx） 综合问题报告所有自定义..