docs(skill): plugin bundle pipeline v2 (IIFE/多资产/热更新) 文档入仓

README.md

@@ -1,6 +1,27 @@
 # inkreach-teable-cli
 
-把下面这段引导词发给任意机器 / 任意会话中的 Agent，即可完成安装并开始使用：
+inkreach-teable 实例的运维 CLI（npm 包 `@inkreach/inkreach-teable`）与
+**全部 Agent Skills 的唯一维护仓库**。
+
+## Skills（本仓库 `skills/` 目录 = single source of truth）
+
+| Skill | 用途 |
+|---|---|
+| `inkreach-teable` | 操作已部署实例：表格/字段/记录/视图/自动化日常运维、REST API 参考 |
+| `inkreach-teable-plugin` | 开发动态 React 组件插件：IIFE bundle（webpack/vite 双模板）、多资产上传（chunk + sourcemap）、`teable-plugin dev` 热更新闭环、5 个挂载位（含整页 route） |
+
+**维护规则**：所有 skill 只在本仓库修改；主仓库（inkreach-teable）不含任何
+skill 源文件。改完后同步到安装位置（`~/.zcode/skills/` 为主，
+`~/.agents/skills/` 为镜像）：
+
+```bash
+cp -r skills/<name>/SKILL.md skills/<name>/metadata.json skills/<name>/dynamic-plugins ~/.zcode/skills/<name>/
+cp -r skills/<name>/ ~/.agents/skills/<name>/   # 按需镜像
+```
+
+## 安装（任意机器 / 任意会话的 Agent）
+
+把下面这段引导词发给 Agent 即可完成安装并开始使用：
 
 ```text
 请安装并用 inkreach-teable CLI 操作 inkreach-teable：
@@ -11,3 +32,9 @@
 3. 鉴权（PAT 从 Web UI Settings → Personal Access Tokens 获取）：
    inkreach-teable auth login --endpoint https://table.inkreach.cc --token <PAT> --base-id bseXXX
 ```
+
+## 目录结构
+
+- `skills/` — Agent Skills（本仓库的核心资产之一）
+- `src/` — CLI 源码（commander 实现）
+- `docs/cli-skill-design.md` — CLI + Skill 的设计文档