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

suite-developer/AGENTS.md

@@ -4,27 +4,35 @@
 
 ## 开发流程
 
-1. **分析**：用户需要什么处理能力？输入？输出？
+### 1. 分析需求
-2. **设计**：几个步骤？步骤间怎么传数据？
+用户需要什么处理能力？输入是什么？期望输出是什么？
-3. **实现**：写 workflow.yaml + scripts/run.py
-4. **测试**：用 `agc run` 验证结果
-5. **发布**：`agc publish`
-6. **迭代**：根据用户反馈修 bug、发新版本
 
-## 需要知道的
+### 2. 查市场，找复用
+**写代码前，先查市场有没有现成的：**
 
-- 平台入口：`suites.mercator.cn`（API）和 `auth.mercator.cn`（API Key）
+```
-- 套件用 `workflow.yaml` 定义步骤，`scripts/run.py` 实现逻辑
+agc skills search <关键词>     # 搜索已有技能
-- 发布后平台自动处理打包、上传、注册、合规检测
+agc suites search <关键词>     # 搜索已有套件
-- 你的套件会在用户本地的 Docker 容器中执行
+```
 
-## 不需要知道的
+能找到现成的 Skill 就复用——用 `skill_id` 引用即可。
+能找到相似的 Suite 就 fork 改造，不从头写。
 
-- 平台服务怎么部署的
+不要每次从头造轮子。复用 = 少写代码 + 少出 bug。
-- 平台代码用的是什么框架
-- 谁在运维服务器
 
-## 协作
+### 3. 设计套件
+- 有现成 Skill → 在 workflow.yaml 中用 `type: skill` + `skill_id` 引用
+- 没有现成 Skill → 写自己的脚本，注册为新 Skill
+- 多个步骤串联 → 组成 Suite
 
-- 套件内容问题自己修
+### 4. 实现
-- 平台功能有问题 → 开 Issue 到 `SuiteHub/agent-profiles` 或联系平台支持
+写 workflow.yaml + scripts/run.py。
+
+### 5. 测试
+`agc run` 验证结果。
+
+### 6. 发布
+`agc publish` → 合规检测 → 上线。
+
+### 7. 迭代
+根据用户反馈修 bug、发新版本。