核心概念
1. 渐进式披露
为了高效管理上下文，Skills 使用三层加载策略：- 发现：Agent 最初只加载 Skill 的
name和description，用于判断相关性。 - 激活：当任务匹配时，完整的
SKILL.md指令会被读入上下文。 - 执行：只有在 Agent 明确需要时，才加载详细的脚本、参考资料或资源文件。
2. 可移植性与可审计性
一个 Skill 本质上只是包含SKILL.md 文件的文件夹。这让它具备：
- 自描述：人类可以像 Agent 一样轻松阅读并审计指令。
- 可版本化：Skills 可以在 Git 仓库中管理，从而清晰追踪变更。
- 可扩展：可以从简单的文本指令扩展到复杂的可执行代码。
目录结构
标准 AIsa Skill 遵循如下目录结构：SKILL.md 规范
SKILL.md 文件是每个 Skill 的核心。它必须包含 YAML Frontmatter，随后是 Markdown 正文。
Frontmatter 字段
- name：短小、唯一的标识符（使用小写字母、数字和连字符）。
- description：清楚说明该 Skill 能做什么，以及 Agent 应该何时使用它。这是发现阶段的主要信号。
- metadata：（可选）用于附加属性的映射，例如作者、版本或平台专用 Tag。
- homepage：（可选）Skill 主页或仓库链接。
正文内容
Markdown 正文包含实际指令。对于 AIsa Skills，我们建议包括：- 分步指令：清晰、可执行的步骤。
- 使用示例：具体的 cURL 或 Python 代码片段。
- 边界情况：说明如何处理常见错误或限制。