Providers

集成从 Provider 开始。

Provider 是 AtlasClaw 的集成边界。每个 Provider 都封装目标系统合同、一个或多个 Skills、实现脚本,以及让集成保持可理解的参考资料。

运行时架构

先看 Provider 如何承接运行时。

这张架构图展示了 Provider 如何承接鉴权、Skills、脚本与目标系统调用。

AtlasClaw provider runtime overview 点击放大

Provider 运行时架构

Provider 把鉴权、Skills、脚本与目标系统执行收拢到清晰边界之内。

文件结构

Provider 文件夹结构。

providers/<provider-name>/
├── PROVIDER.md
├── README.md
└── skills/
    ├── <skill-a>/
    │   ├── SKILL.md
    │   ├── scripts/
    │   └── references/
    └── <skill-b>/
关键原则

让边界明确、脚本收敛。

  • Provider 负责把 AtlasClaw 的身份上下文变成目标系统可接受的鉴权方式。
  • Skill 既保持人类可读,也能绑定到具体脚本入口。
  • Provider Qualified Naming 用于避免跨系统能力冲突。
  • 脚本应该保持窄而可预测,并正确处理密钥与错误映射。
命名约定

Provider Qualified Skills。

通过 provider 前缀避免不同系统技能的命名冲突。

{
  "providers_root": "../atlasclaw-providers/providers",
  "webhook": {
    "systems": [
      {
        "allowed_skills": ["jira:jira-issue"]
      }
    ]
  }
}
参考实现

先看参考,再自己扩展。