docs: suites-help/开发者指南/快速开始.md

suites-help/开发者指南/快速开始.md

@@ -0,0 +1,94 @@
+# 快速开始 — 开发第一个套件
+
+## 什么是套件
+
+套件（Suite）是平台的可执行单元。一个套件包含：
+- **workflow.yaml**：步骤定义（核心）
+- **scripts/run.py**：执行脚本
+
+## 第一步：创建套件目录
+
+```bash
+mkdir my-first-suite
+cd my-first-suite
+```
+
+## 第二步：编写 workflow.yaml
+
+```yaml
+name: hello-world
+description: 最小示例套件 — 输出用户输入的文本
+version: 1.0.0
+category: utility
+
+params:
+  type: object
+  required:
+    - message
+  properties:
+    message:
+      type: string
+      description: 要输出的文本
+
+steps:
+  - id: say-hello
+    name: 输出信息
+    script_id: run
+    params:
+      message: "${{inputs.message}}"
+
+resolved_params:
+  - step_index: 0
+    step_name: 输出信息
+    params:
+      message: "Hello, AgentGIS!"
+```
+
+## 第三步：编写脚本
+
+```bash
+mkdir scripts
+```
+
+`scripts/run.py`：
+
+```python
+#!/usr/bin/env python3
+import json, os
+
+params_file = os.environ.get("PARAMS_FILE", "/tmp/params.json")
+with open(params_file) as f:
+    params = json.load(f)
+
+message = params.get("message", "Hello!")
+result = {"output": message, "length": len(message)}
+print(json.dumps(result))
+```
+
+## 第四步：测试
+
+```bash
+agc run <skill-id> --inputs '{"message": "测试"}'
+```
+
+或直接提交任务到 API：
+
+```bash
+curl -X POST https://suites.mercator.cn/api/v1/task \
+  -H "Authorization: Bearer mk_xxxx" \
+  -d '{"skill_id": "...", "inputs": {"message": "测试"}}'
+```
+
+## 第五步：发布
+
+```bash
+agc publish ./my-first-suite
+```
+
+发布后套件会在市场中展示，其他用户可以搜索和使用。
+
+## 查看已发布的套件
+
+```bash
+agc suites list
+```