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