From c8110bbf1a3c2403e0868c09d5c7200b809a444e Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 6 Aug 2026 12:35:39 +0000 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=E4=B9=9D=E4=BB=BD=E5=B7=B2?= =?UTF-8?q?=E5=8F=91=E5=B8=83=20skill=20=E7=9A=84=20compatibility=20?= =?UTF-8?q?=E5=A3=B0=E6=98=8E=E7=94=B1=2016.x=20=E6=9B=B4=E6=AD=A3?= =?UTF-8?q?=E4=B8=BA=2017.x=20(#5245)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `skills/` 下的 SKILL.md 随 `npx skills add objectstack-ai/objectstack/skills` 原样发给第三方。九份的 frontmatter `compatibility` 仍声明 “Requires @objectstack/spec 16.x”,而正文教的已是 17 的能力 —— 消费者读到的适用版本 与实际教的内容差一个 major。 实测真值后逐份改写(保持既有单行格式): - 七份统一句式改 `@objectstack/spec 17.x (Zod v4 schemas)`:ai / api / automation / data / i18n / query / ui。 - `objectstack-formula` 与 `objectstack-platform` 是两份变体,伴随包版本 一并改 17.x:`@objectstack/formula 17.x (CEL)`、`@objectstack/core 17.x (Zod v4 schemas), Node 22+`。Node 约束按原样保留。 - `objectstack-pm-dispatch` 不动:实测其 `compatibility` 是折叠块且写明 “No @objectstack/spec dependency — process skill”,本无 16.x 声明。 三处措辞的真值都已实测,不是推断:`packages/spec`、`packages/formula`、 `packages/core` 的 version 均为 `17.0.0-rc.2`(major 17);spec 的 zod 依赖 为 `^4.4.3`,故 “Zod v4 schemas” 仍准确;根 `engines.node` 为 `>=22.0.0`, 故 “Node 22+” 仍准确。 正文两处 `16.x`(objectstack-ai 的 “permissions 键在 16.x 移除”、 objectstack-api 的 “in 16.x, #2377”)是历史事实陈述而非适用版本声明, 按原样保留。 `metadata.version` 逐份 +0.1:按 git log 实测的唯一“仅改 skill”先例 (#5451 / PR #5799)——该单同样只改已发布 skill 内容,bump 了 1.0 → 1.1。 另三个动过 SKILL.md 的提交未 bump,但均为大型代码 PR 的顺带改动, 不构成本单的先例。 Closes #5245 Co-authored-by: Claude Claude-Session: https://claude.ai/code/session_01GX3sL71LFq8m2usg6VqTSE --- skills/objectstack-ai/SKILL.md | 4 ++-- skills/objectstack-api/SKILL.md | 4 ++-- skills/objectstack-automation/SKILL.md | 4 ++-- skills/objectstack-data/SKILL.md | 4 ++-- skills/objectstack-formula/SKILL.md | 4 ++-- skills/objectstack-i18n/SKILL.md | 4 ++-- skills/objectstack-platform/SKILL.md | 4 ++-- skills/objectstack-query/SKILL.md | 4 ++-- skills/objectstack-ui/SKILL.md | 4 ++-- 9 files changed, 18 insertions(+), 18 deletions(-) diff --git a/skills/objectstack-ai/SKILL.md b/skills/objectstack-ai/SKILL.md index 3d6c736d44..ee03ce04e7 100644 --- a/skills/objectstack-ai/SKILL.md +++ b/skills/objectstack-ai/SKILL.md @@ -9,10 +9,10 @@ description: > them via skills and tools, not by authoring `*.agent.ts`. Do not use for general LLM prompting questions unrelated to ObjectStack metadata. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "1.2" + version: "1.3" domain: ai tags: agent, tool, skill, conversation, llm, embedding, mcp --- diff --git a/skills/objectstack-api/SKILL.md b/skills/objectstack-api/SKILL.md index 3216eb645d..40d04d7135 100644 --- a/skills/objectstack-api/SKILL.md +++ b/skills/objectstack-api/SKILL.md @@ -11,10 +11,10 @@ description: > syntax (see objectstack-query). CEL expressions in route guards or auth predicates: load objectstack-formula alongside. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "1.3" + version: "1.4" domain: api tags: rest, graphql, endpoint, auth, realtime, server --- diff --git a/skills/objectstack-automation/SKILL.md b/skills/objectstack-automation/SKILL.md index f50d570638..cd2da8ab54 100644 --- a/skills/objectstack-automation/SKILL.md +++ b/skills/objectstack-automation/SKILL.md @@ -9,10 +9,10 @@ description: > / plugin events (see objectstack-platform). CEL expressions in flow conditions / edge guards: load objectstack-formula alongside. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "1.2" + version: "1.3" domain: automation tags: flow, workflow, trigger, approval, state-machine, scheduled, webhook --- diff --git a/skills/objectstack-data/SKILL.md b/skills/objectstack-data/SKILL.md index c8ef3bf05b..4f662b779e 100644 --- a/skills/objectstack-data/SKILL.md +++ b/skills/objectstack-data/SKILL.md @@ -15,10 +15,10 @@ description: > formulas / validations / sharing rules / dynamic seed values: load objectstack-formula alongside. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "4.3" + version: "4.4" domain: data tags: object, field, validation, index, relationship, hook, schema, permission, rls, security, seed, fixture --- diff --git a/skills/objectstack-formula/SKILL.md b/skills/objectstack-formula/SKILL.md index 7a23715a99..2ae09db9b6 100644 --- a/skills/objectstack-formula/SKILL.md +++ b/skills/objectstack-formula/SKILL.md @@ -9,10 +9,10 @@ description: > predicate". Do not use for SQL fragments (driver-native), cron schedules (cron dialect), or L2 hook bodies (those belong in objectstack-data). license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x and @objectstack/formula 16.x (CEL) +compatibility: Requires @objectstack/spec 17.x and @objectstack/formula 17.x (CEL) metadata: author: objectstack-ai - version: "1.1" + version: "1.2" domain: expression tags: cel, formula, predicate, condition, validation, visibility, seed-dynamic --- diff --git a/skills/objectstack-i18n/SKILL.md b/skills/objectstack-i18n/SKILL.md index b135e0c384..98232925f6 100644 --- a/skills/objectstack-i18n/SKILL.md +++ b/skills/objectstack-i18n/SKILL.md @@ -8,10 +8,10 @@ description: > resolving missing-translation warnings. Do not use for general i18n library questions unrelated to ObjectStack bundles. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "1.2" + version: "1.3" domain: i18n tags: i18n, translation, locale, l10n, bundle, coverage --- diff --git a/skills/objectstack-platform/SKILL.md b/skills/objectstack-platform/SKILL.md index 9a1afb1441..980353a10c 100644 --- a/skills/objectstack-platform/SKILL.md +++ b/skills/objectstack-platform/SKILL.md @@ -12,10 +12,10 @@ description: > objectstack-query); data lifecycle hooks (beforeInsert / afterUpdate) belong in objectstack-data — only kernel / service-level events live here. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x and @objectstack/core 16.x (Zod v4 schemas), Node 22+ +compatibility: Requires @objectstack/spec 17.x and @objectstack/core 17.x (Zod v4 schemas), Node 22+ metadata: author: objectstack-ai - version: "1.2" + version: "1.3" domain: platform tags: project, defineStack, driver, adapter, plugin, kernel, service, DI, lifecycle, cli, deploy, ops --- diff --git a/skills/objectstack-query/SKILL.md b/skills/objectstack-query/SKILL.md index 7bd93ea504..f3dcb68893 100644 --- a/skills/objectstack-query/SKILL.md +++ b/skills/objectstack-query/SKILL.md @@ -8,10 +8,10 @@ description: > relationships (see objectstack-data) or for designing the API endpoint that exposes a query (see objectstack-api). license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "1.2" + version: "1.3" domain: query tags: query, filter, sort, paginate, aggregate, ObjectQL, full-text --- diff --git a/skills/objectstack-ui/SKILL.md b/skills/objectstack-ui/SKILL.md index 347c3935e9..4c8a3c4892 100644 --- a/skills/objectstack-ui/SKILL.md +++ b/skills/objectstack-ui/SKILL.md @@ -16,10 +16,10 @@ description: > ships with the platform). CEL expressions in visibility/conditional rules: load objectstack-formula alongside. license: Apache-2.0 -compatibility: Requires @objectstack/spec 16.x (Zod v4 schemas) +compatibility: Requires @objectstack/spec 17.x (Zod v4 schemas) metadata: author: objectstack-ai - version: "1.2" + version: "1.3" domain: ui tags: view, app, page, dashboard, report, chart, action, widget, doc ---