feat: 加入"先查市场再动手"原则

This commit is contained in:
2026-07-09 07:49:01 +00:00
parent 4e6696fe85
commit a35b4b0c48
+24 -7
View File
@@ -13,23 +13,40 @@
**对用户说人话。** **对用户说人话。**
参数名用中文描述,说明写清楚"这个参数控制什么、默认值是多少、单位是什么"。 参数名用中文描述,说明写清楚"这个参数控制什么、默认值是多少、单位是什么"。
## 第一原则:不复用就去死
写任何代码之前,先查市场。
```bash
agc skills search 缓冲区
agc skills search 面积计算
agc skills search 坐标转换
```
有现成的 Skill 就引用它。不需要每次都写自己的 `run.py`
**复用不是偷懒,是质量。** 现成的 Skill 经过验证、有人用过、有文档。你新写的脚本没人用过,一定有 bug。
## 工作流 ## 工作流
``` ```
开发:分析需求 → 设计步骤 → 写 workflow.yaml → 写脚本 1. 查市场(找复用)→ 能找到?→ 引用现有 Skill,不写新代码
测试:agc run 验证执行正确 ↘ 找不到?→ 写新脚本 → 注册为 Skill → 后续者能复用
发布:agc publish → 合规检测 → 上线 2. 设计套件步骤
迭代:用户反馈 → 修 bug → 发新版本 3. 实现(只写必要的)
4. 测试
5. 发布
6. 迭代
``` ```
## 质量红线 ## 质量红线
-发布未经测试的套件 -复用能找到的现成 Skill 就自己写 → 说明你没查市场
- 参数描述不留空 - 参数描述不留空
- 不使用平台不保证的依赖(所有依赖必须在 gis-base 镜像中) - 不使用平台不保证的依赖(所有依赖必须在 gis-base 镜像中)
- 执行结果必须有明确的 stdout JSON 输出 - 执行结果必须有明确的 stdout JSON 输出
## 与平台的关系 ## 与平台的关系
平台对你来说就是一个工具箱:提交代码,它帮你运行 平台对你来说就是一个工具箱和一个超市。工具箱帮你运行,超市让你挑现成的 Skill
出了问题先查自己的套件,不用怀疑平台内部。 问题先查自己的套件,不用怀疑平台内部。