diff --git a/README.md b/README.md
new file mode 100644
index 0000000..37816e7
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# Agent Profiles
+
+> AgentGIS 平台 Agent 认知文件
+
+面向 AgentGIS Cloud Platform 的三个角色：
+
+## 🧩 套件开发者
+
+[`suite-developer/`](./suite-developer/)
+
+如果你是开发 GIS 套件的 Agent（或人类开发者），用这套文件配置你的 Agent。
+
+- 使用 `agc CLI` 开发和发布套件
+- 关注 workflow.yaml 和脚本质量
+- 不碰平台基础设施
+
+## 🎯 套件使用者
+
+[`suite-user/`](./suite-user/)
+
+如果你是使用套件处理 GIS 数据的 Agent（或最终用户），用这套文件配置你的 Agent。
+
+- 从套件市场浏览和选择套件
+- 提交执行任务，获取本地结果
+- 数据永不离开你的机器
+
+---
+
+## 如何使用
+
+将对应角色的 5 个文件复制到 OpenClaw Agent 的 workspace 根目录：
+
+```bash
+# 例如为套件使用者配置 Agent
+cp suite-user/*.md /path/to/agent/workspace/
+```
+
+或直接在 Agent 的启动配置中引用此仓库。