docs(data-modeling,skills): re-quote the corrected searchable-fields hint, drop the moot caveat

[os-project-manager]

Fixes #6925

中文说明

PR #6921(#6673)把 packages/lint/src/validate-searchable-fields.ts 里
searchable-field-unknown 规则的 hint 文案从"copy the value onto a formula
field here"改成了"copy the value onto a stored text field here"——formula
字段是虚拟的,不落任何列,旧文案本来就不可能生效。

content/docs/data-modeling/schema-design.mdx 和 skills/objectstack-data/SKILL.md
在 PR #6670(早于 #6673)里逐字引用了这段 hint,并各自附了一句说明"引用的措辞有点松散,
只有 stored 那一半能用"的旁注。#6673 落地后这两处引用文本本身过期了(引用的是工具已经
不再输出的文案),而那句旁注现在讨论的是一段已经不存在的措辞,同样过期。

本 PR 只做机械的逐字重新引用 + 删除过期旁注,不改变任何处方(两处文档早就正确地建议"落到
一个 stored 字段"——只是引用块本身滞后)。

• content/docs/data-modeling/schema-design.mdx:重新引用 hint 文本,删除
  "(That hint's "text/formula" family of wording is loose…)" 旁注。
• skills/objectstack-data/SKILL.md:同上,删除 "(The hint's "formula field"
  wording is loose…)" 旁注。

Verification

Re-quoted both blocks from origin/main's actual tool source
(packages/lint/src/validate-searchable-fields.ts:347,
Clients echo this declaration … not just a quietly narrowed one. block) and
diffed the quoted text against the literal string the tool builds — byte-for-byte
match on both files (verified with a small script comparing the hint: fenced
block against the concatenated template-literal from the source).

Repo-wide grep for the stale wording (a formula field here, text/formula)
found no other content/docs/** or skills/** hit beyond the two named in the
issue — the .changeset/searchable-fields-stored-hint.md FROM/TO note from
PR #6921 itself is historical record of the change, not a live prescription, and
is left untouched. content/docs/protocol/objectql/query-syntax.mdx:915 mentions
"a formula field is virtual" in prose (not a verbatim tool-output quote) and
was already correct — no change needed there.

Gate coverage note

This repo has no gate that diffs a quoted tool-output block in docs/skills
against the literal string the source builds — check:doc-authoring only scans
for the bare-metadata-literal anti-pattern in fenced TS/TSX blocks, and
check:docs-audit-scope's affected-docs.mjs maps changed packages to docs
that reference them (0 packages changed here, since only content/docs/** and
skills/** moved). The verbatim-match claim above is manual, not
gate-enforced; flagging this per the dispatch's verification bar in case a
future check:hint-quote-sync-style gate is worth adding.

Boundaries respected

• Did not touch packages/lint/src/validate-searchable-fields.ts (tool text
  correct as merged).
• Did not touch skills/objectstack-ui/SKILL.md or content/docs/ui/views.mdx
  (already corrected by docs(skills): objectstack-ui 补 searchableFields 章节 —— 工具栏搜索的收窄语义与失败边界 (#6675) #6898 / docs(ui): the searchableFields boundary is allowed-set membership, not field type (#6897) #6922).
• Did not touch docs/adr/** or content/docs/releases/**.
• content/docs/** is the domain-boundary-contested path (域标签词表有两个未入表条目:domain:spec-tooling(在用,文件面与 devx 完全重叠)与 domain:ui(一例,与 repo:objectui 重复) #5469); diff is kept
  to exactly the two stale blocks named in the issue, nothing else in that tree.
• Ran gates: check:nul-bytes, check:doc-authoring, check:skill-frame-sync,
  check:skill-frame-freshness, check:skill-compatibility,
  docs-audit/affected-docs.mjs — all green (see report).

Docs/skills-only change — no package code, no user-visible runtime behaviour
change — skip-changeset label applied.

---

Generated by Claude Code

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
objectstack	Ignored		Aug 9, 2026 7:30am