diff --git a/README.md b/README.md
index 93ad468..852d457 100644
--- a/README.md
+++ b/README.md
@@ -42,6 +42,23 @@ pnpm test       # vitest 单测（field-normalize / field-display / resources）
 pnpm typecheck
 ```
 
+## Agent 引导词
+
+在任意新机器 / 新会话中，把下面这段直接发给 Agent，即可引导它完成安装并开始使用：
+
+```text
+请为操作 inkreach-teable 实例安装 inkreach-teable CLI 及配套 skill：
+1. 克隆工具仓库：
+   git clone ssh://git@gitea.inkreach.cc:2222/inkreachhub/inkreach-teable-cli.git ~/deployments/inkreach-teable-cli
+2. 在仓库内运行安装脚本（构建 CLI、全局链接命令、安装 skill 到 ~/.zcode/skills/）：
+   bash ~/deployments/inkreach-teable-cli/skills/inkreach-teable/scripts/install.sh
+3. 配置认证并验证（PAT 从 Web UI Settings → Personal Access Tokens 获取）：
+   inkreach-teable auth login --endpoint http://<后端地址> --token <PAT> --base-id bseXXX
+   inkreach-teable auth status
+4. 之后按 ~/.zcode/skills/inkreach-teable/SKILL.md 的模块地图使用（skill 在新会话自动加载；
+   当前会话直接阅读该文件即可）。注意：官方 teable CLI 与本实例自动化契约不兼容，必须用 inkreach-teable。
+```
+
 ## 来源
 
 2026-09-23 从 inkreach-teable monorepo 拆分独立（原路径 `packages/inkreach-cli/` +