agent-profiles/suites-help/开发者指南/最佳实践.md

套件开发最佳实践

命名规范

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

查市场

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

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 容器内脚本的执行输出

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