chore: auto release commit (2026-07-14 11:56:45)

assets/schemas/skill-actions.schema.json

@@ -26,7 +26,7 @@
     "placement": {
       "type": "string",
       "enum": ["toolbar", "row", "batch", "cron", "agent", "skill-detail"],
-      "description": "模板 Phase 1 稳定支持 toolbar/cron/agent/skill-detail；row/batch 为预留入口，新技能示例不得使用"
+      "description": "稳定支持 toolbar/cron/agent/skill-detail；row/batch 为预留入口，新技能示例不得使用。placements 与 executionProfile 正交，不做条件限制。"
     },
     "scalarArg": {
       "type": ["string", "number", "boolean"]
@@ -95,9 +95,29 @@
         }
       }
     },
+    "bind": {
+      "type": "object",
+      "required": ["tables"],
+      "additionalProperties": false,
+      "properties": {
+        "tables": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z][a-z0-9_]*$",
+            "description": "英文 snake_case 业务表名；须真实存在于技能 SQLite / _jiangchang_tables"
+          },
+          "description": "数据管理表级绑定：决定 toolbar Action 出现在哪些表。宿主兼容旧技能时，缺失 bind 可视为全表展示；新技能 toolbar Action 必须显式声明。"
+        }
+      },
+      "description": "Phase 1 仅沉淀 bind.tables；不包含 selection/inputMapping/columns/row/concurrency/locks"
+    },
     "action": {
       "type": "object",
-      "required": ["id", "label", "description", "placements", "entrypoint"],
+      "required": ["id", "label", "description", "placements", "entrypoint", "executionProfile"],
       "additionalProperties": false,
       "properties": {
         "id": {
@@ -116,7 +136,8 @@
         "placements": {
           "type": "array",
           "minItems": 1,
-          "items": { "$ref": "#/$defs/placement" }
+          "items": { "$ref": "#/$defs/placement" },
+          "description": "决定 Action 出现在哪里；与 executionProfile 正交"
         },
         "entrypoint": { "$ref": "#/$defs/entrypoint" },
         "inputSchema": { "$ref": "#/$defs/inputSchema" },
@@ -124,10 +145,22 @@
         "executionProfile": {
           "type": "string",
           "enum": ["sync", "async"],
-          "description": "sync=宿主内联等待结果（约 30s）；async=后台 Job 进任务中心。模板要求显式写出；RPA/长耗时必须 async。"
-        }
+          "description": "sync=调用方等待结构化结果（不建 Job）；async=宿主建后台 Job 并进任务中心。必须显式写出；长耗时建议 async，但不限制 placements。"
+        },
+        "bind": { "$ref": "#/$defs/bind" }
       },
-      "description": "模板 Phase 1 不包含 bind/concurrency/locks 等预留能力字段；宿主类型可能定义这些字段，但新技能不得依赖"
+      "if": {
+        "properties": {
+          "placements": {
+            "contains": { "const": "toolbar" }
+          }
+        },
+        "required": ["placements"]
+      },
+      "then": {
+        "required": ["bind"]
+      },
+      "description": "concurrency/locks 为未稳定预留字段，勿写入新技能 manifest。placements 含 toolbar 时必须声明 bind.tables。"
     }
   }
 }