diff --git a/Makefile b/Makefile
new file mode 100644
index 00000000..491c478a
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,12 @@
+CUR_DIR=$(shell pwd)
+
+.PHONY: dev_tool
+# 安装工具
+dev_tool:
+	# install protoc
+	go install github.com/golang/protobuf/protoc-gen-go@v1.5.2
+
+.PHONY: gen
+# gen 生成代码
+gen:
+	cd protocol/proto && make gen
\ No newline at end of file
diff --git a/README.md b/README.md
index da7dc486..5b3ad72a 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,15 @@
 # hk4e
 
 hk4e game server
+
+## 开发快速上手
+* Go >= 1.19
+1. 首次需要安装工具 `make dev_tool`
+1. 生成协议 `make gen`
+
+## 快速运行
+* mongodb
+* nats-server
+1. 启动dispatch `cd dispatch/cmd && go run .`
+1. 启动gate `cd gate/cmd && go run .`
+1. 启动gs `cd gs/cmd && go run .`
diff --git a/protocol/proto/Makefile b/protocol/proto/Makefile
new file mode 100644
index 00000000..420beef3
--- /dev/null
+++ b/protocol/proto/Makefile
@@ -0,0 +1,3 @@
+# gen 生成proto
+gen:
+	protoc -I. --go_out=paths=source_relative:. ./*.proto
\ No newline at end of file