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