docs(skills): 九份已发布 skill 的 compatibility 声明由 16.x 更正为 17.x (#5245) - #5937
Merged
Conversation
`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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GX3sL71LFq8m2usg6VqTSE
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
os-zhuang
added
skip-changeset
Claude
github-actions
Bot
added
the
documentation
os-zhuang
marked this pull request as ready for review
August 6, 2026 12:56
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #5245
skills/下的 SKILL.md 随npx skills add objectstack-ai/objectstack/skills原样发给第三方。九份的 frontmattercompatibility仍声明 “Requires @objectstack/spec 16.x”,而正文教的已是 17 的能力 —— 消费者读到的适用版本与实际教的内容差一个 major。按 2026-08-04 分诊裁定的方案①,逐份改写为 17.x 精确行。真值核实(全部实测,非推断)
packages/spec/package.json17.0.0-rc.2→ major 17packages/formula/package.json17.0.0-rc.2packages/core/package.json17.0.0-rc.2dependencies.zod^4.4.3→ 保留engines.node>=22.0.0→ 保留逐份处置
@objectstack/spec 17.x (Zod v4 schemas):ai / api / automation / data / i18n / query / ui。objectstack-formula:Requires @objectstack/spec 17.x and @objectstack/formula 17.x (CEL)objectstack-platform:Requires @objectstack/spec 17.x and @objectstack/core 17.x (Zod v4 schemas), Node 22+(Node 约束按原样保留)objectstack-pm-dispatch不动:实测其compatibility是折叠块,写明 “No @objectstack/spec dependency — process skill”,本无 16.x 声明,不适用本单格式。均保持既有单行格式。
与 issue 记述的差异
issue 说“十份、九份同句”。实测:
skills/下确有 10 份 SKILL.md,但携带Requires @objectstack/spec 16.x的是 9 份,其中同句的只有 7 份,formula 与 platform 是两份变体。故本单改 9 份、其中 7 份走同一句式。正文另有两处
16.x按原样保留 —— objectstack-ai:243 “permissions 键在 16.x 移除”、objectstack-api:582 “in 16.x, #2377”,都是历史事实陈述而非适用版本声明,且改正文超出本单范围。metadata.version逐份 +0.1按 git log 实测先例办,并修正了派单里引用的 #5670 测法:
objectstack-data的三个提交里,b49ccfdfe是该文件的创建(@@ -0,0 +1,1034 @@,建档即 4.3),不是内容修改;另两个(72c3c8613、28ad90e9a)确实未 bump,但都是大型代码 PR 顺带改 SKILL.md,不构成“仅改 skill”的先例。objectstack-pm-dispatch仍是两轴决策框架 —— 与.claude/内部三轴(#5130)分叉,且「创业聚焦」轴是否该泛化给第三方项目未定 #5451 / PR docs(skills): 已发布 skillobjectstack-pm-dispatch的决策框架由两轴升为三轴(裁决 B:泛化内核后搬) #5799(77adf297f),它 bump 了metadata.version1.0 → 1.1。本单同类,故逐份 +0.1。changeset 路线
不写 changeset,走
skip-changeset标签(gate 的 路线 2 / PREFERRED)。依据:skills/不是 workspace 成员,也不随任何 npm 包发布(根包private: true,无 package 的files收录它),故本 PR 不发布任何包。一处值得记录的张力:上述先例
77adf297f(2026-08-06 06:57)走的是路线 3 空 frontmatter changeset,而 #5292 / PR #5467(2026-08-05 13:18)已把路线 3 降级为 LAST RESORT(#4898:全空集合会静默绿灯地卡住 release)。即该先例晚于处方一天却仍用了被降级的路线。本单按现行处方取路线 2。门禁(全绿,实跑输出见下)
check:skill-docs/check:skill-refs/check:skill-examples/check:nul-bytes/check:doc-authoring/check:skill-frame-sync六项全绿。compatibility与metadata.version经实测不进任何生成物 —— 改完check:skill-docs直接报 “Skill docs in sync”,无需重新生成。Co-authored-by: Claude <noreply@anthropic.com>
Generated by Claude Code