docs: precipitate Action/CRUD Lookup contract for skill authors

references/SCHEMA.md

@@ -518,6 +518,7 @@ CREATE TABLE demo_items (
   "ref_table": "platforms",
   "value_column": "platform_key",
   "label_column": "display_name",
+  "extra_column": "category",
   "filter_column": "enabled",
   "filter_value": 1
 }
@@ -526,13 +527,23 @@ CREATE TABLE demo_items (
 | 字段 | 必填 | 说明 |
 |---|---|---|
 | `ref_table` | 是 | 同库被引用表名（snake_case 标识符） |
-| `value_column` | 是 | 写入当前字段的值列 |
-| `label_column` | 是 | 下拉展示名列 |
+| `value_column` | 是 | 写入当前字段的值列（编号 / 外键） |
+| `label_column` | 是 | 下拉主文案列（名称） |
+| `extra_column` | 否 | 第三展示列（不必叫「备注」）；有值时拼进括号 |
 | `filter_column` / `filter_value` | 否 | 等值过滤（如只列出 `enabled=1`） |
 
 宿主在加载表 schema 时查询 `ref_table`，把结果展开成 `{value,label}` 下拉选项；**物理列仍存标量**（如 `platform_key` 文本、`account_id` 整数），不做嵌套子表。
 
-示例：账号表的平台字段 → 平台信息表；凭据表的账号编号 → 账号信息表。
+**统一展示文案（宿主固定一种，技能只配列）：**
+
+- 默认：`{value} · {label}`，例如 `2 · 通用私信-留资`、`douyin · 抖音`
+- 配置了 `extra_column` 且该行有非空值：`{value} · {label}（{extra}）`
+- 未配置 `extra_column`、或额外列为空：不加 `（）`
+- `label` 为空或与 `value` 相同时：只显示 `value`（可再带额外括号）
+
+Action 弹窗内联 Lookup 与上表 **同构**（字段名一致），见 [`ACTIONS.md`](ACTIONS.md)「跨表引用：Lookup」。
+
+示例：账号表的平台字段 → 平台信息表；凭据表的账号编号 → 账号信息表；私信 Action 选话术 → `message_templates`。
 
 ## 幂等初始化标准