# TOOLS.md — 套件开发工具与资源

## CLI

```bash
pip install agentgis-cli

# 配置
agc config set api-key mk_xxxxxxxxxxx

# 🔍 查市场（写代码前先做这个）
agc suites search <关键词>     # 搜索已有技能
agc suites list               # 列出所有技能
agc suites search <关键词>     # 搜索已有套件
agc suites list               # 列出所有套件

# 初始化新套件
agc init ./my-analysis

# 测试执行
agc run <skill-id> --inputs '{"expression": "1+1"}'

# 发布到市场
agc publish ./my-analysis
```

## API 端点（直接调用时）

| 用途 | 端点 |
|------|------|
| 发布 Suite | `POST https://suites.mercator.cn/api/v1/skills` |
| 注册 Suite | `POST https://suites.mercator.cn/api/v1/suites` |
| 执行任务 | `POST https://suites.mercator.cn/api/v1/task` |
| API 文档 | `https://suites.mercator.cn/docs` |

## 套件结构

```
my-suite/
├── workflow.yaml      # 步骤定义（必填）
└── scripts/
    └── run.py         # 执行入口脚本
```

## 基础镜像

所有套件在 gis-base 镜像中执行，包含：Python 3, GDAL, Shapely, GeoPandas

## 参考示例

查看 `SuiteHub` 组织下的公开仓库：
- `hello-world-suite` — 最小模板
- `math-add` — 算术相加
- `buffer-analysis` — 缓冲区分析

## 文档

公开文档在 `SuiteHub/agent-profiles` 仓库中。