fix: harden skill template contracts and scaffolding

Align scaffold slug replacement, Action manifest strict boundaries, metadata prune API, field permission validation, and task_logs readonly semantics with documented template contracts.

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

references/ACTIONS.md

@@ -4,6 +4,17 @@
 
 **边界：** 用户市场说明见根目录 [`README.md`](../README.md)；CLI 参数与错误码细节见 [`CLI.md`](CLI.md)。
 
+## 模板严格规范 vs 宿主向后兼容
+
+| 角色 | 定位 |
+|------|------|
+| **skill-template** | 新技能推荐的**严格规范**：必填字段、明确类型、`additionalProperties: false` |
+| **宿主运行时** | **向后兼容**的历史 manifest 解析器：可能接受部分缺省字段（如 `description`、`placements`、`entrypoint.args`、input property `type`） |
+
+**新技能不应依赖宿主缺省行为。** 复制模板后按 [`assets/schemas/skill-actions.schema.json`](../assets/schemas/skill-actions.schema.json) 与本文完整填写 manifest。
+
+JSON Schema 使用 `additionalProperties: false` 表达模板严格边界；这与宿主共享类型中的可选字段并不矛盾——宿主为兼容旧技能可能更宽松，模板为防漂移要求更严。
+
 ## Action 是否必需
 
 Action 是**可选能力**：
@@ -33,6 +44,29 @@ Action 是**可选能力**：
 
 模板最小示例见 [`assets/actions.json`](../assets/actions.json)；JSON Schema 见 [`assets/schemas/skill-actions.schema.json`](../assets/schemas/skill-actions.schema.json)。
 
+## Phase 1 当前稳定支持（新技能应只使用这些）
+
+| 层级 | 稳定字段 / 能力 |
+|------|----------------|
+| 顶层 | `schemaVersion`、`skill`、`actions` |
+| action | `id`、`label`、`description`、`placements`、`entrypoint`；可选 `inputSchema`、`confirmation` |
+| entrypoint | `type = cli`、`command`、`args`（**必填** JSON 数组，项为 `string` / `number` / `boolean`） |
+| placements | `toolbar`、`skill-detail`、`agent`、`cron` |
+| inputSchema | 根 `type: object`；properties 使用 `string` / `number` / `boolean`；支持 `enum`、`default`、`required`、`sensitive` |
+| confirmation | `{ "message": "..." }` |
+
+## 预留能力（当前不可当作已实现能力）
+
+以下在宿主共享类型或 Schema 枚举中可能出现，但 **Phase 1 Runtime 尚未完整支持**，**新模板示例不得使用**：
+
+| 类别 | 预留项 | 说明 |
+|------|--------|------|
+| placements | `row`、`batch` | 行内 / 批量入口，未来扩展 |
+| action 字段 | `bind`、`concurrency`、`locks` | 绑定、并发与锁控制，宿主后续实现 |
+| inputSchema | `array`、nested `object`、`oneOf` 等 | 复杂表单与联合类型，不属于当前推荐模板范围 |
+
+可以在文档或 Schema 枚举中保留这些值供未来对齐，但不要让技能作者误以为它们已经可执行。
+
 ## 执行模型
 
 宿主将 action 转为 argv，再执行：