# 套件开发最佳实践

## 命名规范

- 使用英文小写 + 连字符：`buffer-analysis`、`land-use-classification`
- 名称反映功能：`stream-extraction` 而非 `my-suite-1`
- 参数名用 snake_case：`input_path`、`buffer_distance`

## 查市场

开发新套件前，先查询市场是否已有能复用的套件：

```bash
curl -s https://suites.mercator.cn/api/v1/suites | python3 -c "import json,sys; [print(s['name']) for s in json.load(sys.stdin)]"
```

## 模板复用

有现成的 Suite → 在 workflow.yaml 中用 `suite_id` 引用。
找不到 → 写新脚本 → 发布为新 Suite → 方便后续者复用。

## 调试技巧

在 `agc run` 时，注意观察：

1. 是否成功解析套件和下载 package_url
2. 输入文件是否复制到工作目录
3. Docker 容器内脚本的执行输出

日志在控制台直接打印，无需额外配置。