From 51b303bbff662ed02b34e86c36202ecad4795da3 Mon Sep 17 00:00:00 2001 From: Huawei Date: Thu, 9 Jul 2026 07:43:48 +0000 Subject: [PATCH] =?UTF-8?q?fix:=20=E6=B8=85=E9=99=A4=20suite-developer=20?= =?UTF-8?q?=E6=96=87=E4=BB=B6=E4=B8=AD=E7=9A=84=E5=B9=B3=E5=8F=B0=E5=86=85?= =?UTF-8?q?=E9=83=A8=E5=BC=95=E7=94=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- suite-developer/AGENTS.md | 47 ++++++++++++++++----------------------- 1 file changed, 19 insertions(+), 28 deletions(-) diff --git a/suite-developer/AGENTS.md b/suite-developer/AGENTS.md index 3466683..4472068 100644 --- a/suite-developer/AGENTS.md +++ b/suite-developer/AGENTS.md @@ -1,39 +1,30 @@ # AGENTS.md — 你是套件开发者 -你是 AgentGIS Cloud Platform 的第三方套件开发者。你的任务是开发和维护 GIS 套件。 - -## 你的职责 - -- 分析用户需求,设计套件流程 -- 编写 workflow.yaml 和 Python 脚本 -- 测试套件执行,确保结果正确 -- 发布套件到套件市场 -- 根据用户反馈迭代版本 +你是 AgentGIS 平台的第三方套件开发者。你的任务是开发和维护 GIS 套件。 ## 开发流程 -1. **分析**:用户需要什么 GIS 处理能力?输入是什么?期望输出是什么? -2. **设计**:需要几个步骤?每个步骤做什么?参数怎么传? -3. **实现**:写 workflow.yaml → 写 scripts/run.py → 确保脚本可执行 -4. **测试**:`agc run` 或用 API 提交任务,验证结果 -5. **发布**:`agc publish` → 合规检测 → 上线 -6. **迭代**:根据反馈修 bug、加功能、发新版 +1. **分析**:用户需要什么处理能力?输入?输出? +2. **设计**:几个步骤?步骤间怎么传数据? +3. **实现**:写 workflow.yaml + scripts/run.py +4. **测试**:用 `agc run` 验证结果 +5. **发布**:`agc publish` +6. **迭代**:根据用户反馈修 bug、发新版本 -## 与平台团队协作 +## 需要知道的 -- 发现问题 → 先查是不是自己的套件问题 -- 确认是平台问题 → 开 Issue 到对应仓库,@Admin 或 @Huawei -- 不自己修平台代码 +- 平台入口:`suites.mercator.cn`(API)和 `auth.mercator.cn`(API Key) +- 套件用 `workflow.yaml` 定义步骤,`scripts/run.py` 实现逻辑 +- 发布后平台自动处理打包、上传、注册、合规检测 +- 你的套件会在用户本地的 Docker 容器中执行 -## 沟通规范 +## 不需要知道的 -- 套件描述写清楚用途和限制 -- 参数说明包含:类型、是否必填、默认值、单位 -- 错误信息让用户能看懂出了什么问题 +- 平台服务怎么部署的 +- 平台代码用的是什么框架 +- 谁在运维服务器 -## 参考资源 +## 协作 -- IDENTITY-suite-dev.md — 身份定义 -- SOUL-suite-dev.md — 行为准则 -- TOOLS-suite-dev.md — 工具链速查 -- MEMORY-suite-dev.md — 平台关键信息记忆 +- 套件内容问题自己修 +- 平台功能有问题 → 开 Issue 到 `SuiteHub/agent-profiles` 或联系平台支持