feat: standardize skill data management and actions

Co-authored-by: Cursor <cursoragent@cursor.com>

assets/README.md

@@ -1,8 +1,9 @@
 # assets
 
+- `actions.json`：Skill Action manifest 最小示例（可选；不需要宿主入口时可删除）。
 - `examples/`：CLI 成功输出形状示例（虚构路径与数据）。
-- `schemas/`：轻量 JSON Schema 示例（`additionalProperties: true` 允许扩展字段）。
+- `schemas/`：轻量 JSON Schema（`skill-actions.schema.json`、`task-log-record.schema.json` 等）。
 
 - 用户市场说明见根目录 [`README.md`](../README.md)
-- Agent 调用/编排参考见 [`references/`](../references/)
+- Agent 调用/编排参考见 [`references/`](../references/)（含 [`ACTIONS.md`](../references/ACTIONS.md)）
 - 开发规范见 [`development/`](../development/)

assets/actions.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "skill": "your-skill-slug",
+  "actions": [
+    {
+      "id": "health",
+      "label": "运行检查",
+      "description": "检查技能运行环境并返回结构化结果。",
+      "placements": ["skill-detail", "agent"],
+      "entrypoint": {
+        "type": "cli",
+        "command": "health",
+        "args": []
+      }
+    },
+    {
+      "id": "version",
+      "label": "查看版本",
+      "description": "返回技能版本和机器标识。",
+      "placements": ["skill-detail"],
+      "entrypoint": {
+        "type": "cli",
+        "command": "version",
+        "args": []
+      }
+    },
+    {
+      "id": "config-path",
+      "label": "查看配置位置",
+      "description": "返回技能配置文件位置。",
+      "placements": ["skill-detail"],
+      "entrypoint": {
+        "type": "cli",
+        "command": "config-path",
+        "args": []
+      }
+    }
+  ]
+}

assets/schemas/skill-actions.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openclaw.local/skill-template/skill-actions.schema.json",
+  "title": "SkillActionManifest",
+  "description": "匠厂宿主 Skill Action manifest 通用契约（schemaVersion 1）",
+  "type": "object",
+  "required": ["schemaVersion", "skill", "actions"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "skill": {
+      "type": "string",
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$",
+      "description": "与 SKILL.md metadata.openclaw.slug 一致"
+    },
+    "actions": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/action" }
+    }
+  },
+  "$defs": {
+    "placement": {
+      "type": "string",
+      "enum": ["toolbar", "row", "batch", "cron", "agent", "skill-detail"]
+    },
+    "scalarArg": {
+      "type": ["string", "number", "boolean"]
+    },
+    "inputProperty": {
+      "type": "object",
+      "required": ["type"],
+      "additionalProperties": true,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["string", "number", "boolean", "object"]
+        },
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "default": {},
+        "enum": {
+          "type": "array",
+          "minItems": 1
+        },
+        "sensitive": { "type": "boolean" }
+      }
+    },
+    "inputSchema": {
+      "type": "object",
+      "required": ["type", "properties"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "const": "object" },
+        "required": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "properties": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/inputProperty" }
+        }
+      }
+    },
+    "entrypoint": {
+      "type": "object",
+      "required": ["type", "command", "args"],
+      "additionalProperties": false,
+      "properties": {
+        "type": { "const": "cli" },
+        "command": {
+          "type": "string",
+          "minLength": 1
+        },
+        "args": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scalarArg" }
+        }
+      }
+    },
+    "confirmation": {
+      "type": "object",
+      "required": ["message"],
+      "additionalProperties": false,
+      "properties": {
+        "message": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "action": {
+      "type": "object",
+      "required": ["id", "label", "description", "placements", "entrypoint"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+          "minLength": 1
+        },
+        "label": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "placements": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "$ref": "#/$defs/placement" }
+        },
+        "entrypoint": { "$ref": "#/$defs/entrypoint" },
+        "inputSchema": { "$ref": "#/$defs/inputSchema" },
+        "confirmation": { "$ref": "#/$defs/confirmation" }
+      }
+    }
+  }
+}