统一服务启动入口至 Makefile（dev-core/dev-*/db-*/test-*），Alembic 迁移改为 000 起三位顺序编号并经 make db-revision 生成

AGENTS.md

@@ -224,6 +224,18 @@ Compose 文件不使用顶部 `version` 字段。
 
 ## 开发命令
 
+### 本地开发（Makefile 统一入口）
+
+所有本地服务的启动、测试与数据库迁移统一经根目录 Makefile（`make help` 查看全部）：
+
+```bash
+make dev-core                 # 核心三服务并行：灵台 + 神识 + 照壁
+make dev-backend              # 灵台（另有 dev-shenshi / dev-bff / dev-frontend / dev-sandbox / dev-tianmu / dev-yuanqi）
+make db-upgrade               # Alembic 升级到 head（迁移编号 000/001/002…）
+make db-revision m="说明"     # 生成下一号迁移（自动编号 + autogenerate，禁手写哈希 id）
+make test                     # 全部测试（backend / shenshi / bff / frontend）
+```
+
 ### Docker
 
 编排按职责解耦为两个文件，容器名统一以 `hunjing-` 开头，通过共享网络 `hunjing-net` 互通，详细说明见 `docker/README.md`：