Skip to main content
你可以通过两种方式为 AI 编程智能体增加 AIsa Agent Skills 能力:从 agent-skills 技能仓库安装预构建 Skill,或者从零编写自己的 SKILL.md。如何选择取决于现有 Skill 是否已经覆盖你的用例。

核心区别


什么时候使用预构建 Skill

技能仓库中已经存在该能力。 如果你需要网页搜索、金融数据、Twitter/X 访问、图像/视频生成或 YouTube 研究,通常已经有对应 Skill。安装只需要一个命令,并且自带经过测试的脚本和完整示例。 你希望由 AIsa 团队负责维护。 当底层 API 变化时,预构建 Skills 会同步更新。你不需要追踪 API 废弃情况,也不需要在端点迁移时重写说明。 你需要快速制作原型。 执行 aisa skills install market,再打开新的 Claude Code 会话,即可查询实时股票价格。编写、测试并维护等价的自定义 Skill 会明显更耗时。

示例:安装并使用 Market Skill

智能体会读取 market Skill 的 description,加载 SKILL.md 指令,运行内置 Python 客户端,并调用 AIsa 金融 API。整个过程不需要你编写代码。

什么时候编写自定义 Skill

你需要调用内部 API。 预构建 Skills 覆盖 AIsa 公共 API 目录,无法查询公司的内部数据仓库、CRM 或专有服务。对于这些场景,需要编写 SKILL.md,描述内部端点和身份认证方式。 现有 Skill 没有覆盖你的精确用例。 如果你需要非常具体的工作流,例如按特定顺序组合多个 API 的多步骤流程,自定义 Skill 可以将这套顺序明确写入指令正文。 你想向智能体提供领域知识。 SKILL.md 不只是 API 封装。你可以写入领域背景、决策规则、输出格式要求,以及团队从生产实践中总结的注意事项。 你想为其他人发布 Skill。 自定义 Skills 可以通过 Pull Request 提交到 agent-skills 技能仓库。如果你基于 AIsa API 构建了有用能力,可以通过贡献它让整个生态受益。

示例:创建并编辑自定义 Skill

description 字段是最重要的一行。智能体会在启动时读取它,用于判断何时激活该 Skill。请具体描述触发条件:

快速决策指南


下一步

  • Agent Skills:浏览完整的预构建 Skill 目录
  • 快速入门:在 5 分钟内安装第一个 Skill
  • 标准:了解 SKILL.md 文件的工作方式,以及如何编写自己的 Skill
  • AIsa 入门:如果你刚开始使用 AIsa API