Skip to content

docs(skill): 补充自动状态进度条 & detail.stageField:false 开关 - #2453

Closed
baozhoutao wants to merge 1 commit into
mainfrom
docs/skill-stagefield-optout
Closed

docs(skill): 补充自动状态进度条 & detail.stageField:false 开关#2453
baozhoutao wants to merge 1 commit into
mainfrom
docs/skill-stagefield-optout

Conversation

@baozhoutao

Copy link
Copy Markdown
Contributor

问题

这是 AI 开发场景:AI 作者装的是 objectstack-ai/framework 的 skills。但分发的 skills/objectstack-ui/SKILL.md完全没提:

detail.stageField 只靠 spec 的 .passthrough() 放行、没有 typed 键,所以也无类型/补全提示——对 AI 而言唯一可靠的发现渠道就是 skill。缺这段,别的 AI 会重复踩"非线性 status 被画成进度条且关不掉"的坑。

方案

skills/objectstack-ui/SKILL.mdrecord:path 示例之后补一段:

  1. 自动详情页 & 状态进度条说明 + detectStatusField 探测优先级(含 detail.stageField === false|null 显式关闭);
  2. ObjectSchema.create({ detail: { stageField: false }, ... }) 示例,并强调必须放 detail 块、不能放顶层(顶层未知键被 ObjectSchema.create() 拒绝;detail.passthrough() 的 synth 提示落点)。

仅改文档一处(+29 行),无代码/无包变更。

Closes#2452
配套:objectstack-ai/objectui#2066(行为实现)

@vercel

vercelBot commented Jun 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJun 29, 2026 4:17am

Request Review

@baozhoutao

Copy link
Copy Markdown
ContributorAuthor

改变方案:不走 skill 文档(一次加太多)。改为在 spec 的 detail 块加一个 typed stageField 键,直接给作者类型 + 自动补全来发现该能力。新 PR 见 #2452

The distributed objectstack-ui skill never mentioned that ObjectUI auto-
synthesizes a detail page and auto-detects a status field for a top record:path
stepper, nor the detail.stageField:false opt-out (objectstack-ai/objectui#2066).
AI authors install framework's skills, so without this they re-hit the
'non-linear status rendered as an ordered path, can't disable it' trap.
Adds, after the record:path example: the detectStatusField precedence and a
detail:{ stageField:false } example, stressing it must live in the passthrough
detail block (top-level unknown keys are rejected by ObjectSchema.create()).
Closes#2452
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(spec):detail 块补 typed stageField 键(record:path 自动进度条开关的发现性)

1 participant

@baozhoutao