[PM decision] skills lane batch 10 — SKILL_MAP census residue: drop objectstack-api's untaught rest-server pointer; add objectstack-platform's taught stack.zod.ts pointer

[claude]

呈维护者裁决 —— skills 席(session session_019RfFHiRCSs3JXLK4cwcfox,os-steve),第 10 批,共 2 项(#15264 的两行普查残留)。裁后一行回批即可(「1A 2A」/「1A, 但…」)。

背景:#14462 家族(domain:spec 席,PR #15268,已于 08:59Z 合并)对 SKILL_MAP(packages/spec/scripts/build-skill-references.ts,生成 skills/*/references/_index.md)统一裁定「把索引收窄到 SKILL.md 真正教的东西」,并处置了四行(ai · automation · formula · i18n),每行都带消费者普查或 ADR 退役依据。同一次扫描还测出两行同形残留,只有扫描、没有普查,该 PR 记录而未动(#15264 原话:「在受管的客户面上删一个已发布指针或加一个,值得单独一裁,不该搭车」)。两行都是受管面(skills/** 的生成索引 + 生成器映射表)⇒ 无论裁哪个方向,落地都是草稿 PR、双批准人、人工合并;跨车道(生成器在 spec 流)事后补声明。

1. objectstack-api 索引广告 api/rest-server.zod.ts,SKILL.md 从未教过它

带 re-check 命令的前提(#15264 在 9c1bcda3 实测,本席未重测):grep -rn "rest-server\|RestServerConfig\|RestApiConfig\|rest server" skills/objectstack-api/ → 0 命中;其余核心条目都能从正文里至少一个导出名到达。

• A. 按 [finding] The objectstack-ai generated reference index advertises 6 schemas the SKILL.md never teaches and omits the one it names — SKILL_MAP in build-skill-references.ts is unreconciled with the body #14462 统一裁定收窄:从 SKILL_MAP['objectstack-api'] 删掉该指针,重生成索引(推荐)
  • 实际业务需求:索引是给 AI 作者「这个技能教了什么」的目录;广告一个从没教过的 schema 只会把作者引到一个没有教材的文件。谁在用 rest-server 的 schema?普查没做 —— 但技能面的判据是「正文教不教」,不是「schema 有没有用」。
  • 项目长远合理性:与 [finding] The objectstack-ai generated reference index advertises 6 schemas the SKILL.md never teaches and omits the one it names — SKILL_MAP in build-skill-references.ts is unreconciled with the body #14462 已裁的规则同形,四行已按此落地;第五行不例外才是可持续的。
  • 防 AI 写代码犯错:指针指向无教材的 schema,AI 会照 schema 自己猜用法 —— 收窄后要么正文教、要么不出现。
  • 创业阶段不扩散需求:零新增;删一行映射。
• B. 教它:在 skills/objectstack-api/SKILL.md 补一节 REST server 配置(RestServerConfig 及其子配置),保留指针
  • 实际业务需求:只有当 REST server 配置是作者常写的面时才成立 —— 未测;正文目前一字未提,说明该技能作者面从没需要过。
  • 项目长远合理性:技能正文扩面要过 token 棘轮(check-skills-token-ratchet)与发布面审核,是一次真正的内容工程。
  • 防 AI 写代码犯错:教得对能降错;教得半吊子比不教更糟。
  • 创业阶段不扩散需求:这一轴反对 B —— 无拉动的能力面按 implementation-first 处置。
• C. 不动,留给下一次普查
  • 四轴皆无收益;残留会在下次普查再次被测出,已经发生过一次。

推荐意见:A。

2. objectstack-platform 正文大篇幅教 defineStack / ObjectStackDefinitionSchema(stack.zod.ts),索引却不广告它

带 re-check 命令的前提:grep -n "ObjectStackDefinition\|defineStack" skills/objectstack-platform/SKILL.md → 多处命中;stack.zod.ts 不在任何包的核心列表,也不在任何索引的闭包里(#15264 实测)。

• A. 加指针:把 platform/stack.zod.ts(按实际路径)加进 SKILL_MAP['objectstack-platform'],重生成索引(推荐)
  • 实际业务需求:正文的主题就是它;作者从索引找不到正文最常用的 schema,是目录缺页。
  • 项目长远合理性:与「索引 = 正文教的东西」同一条规则的另一方向;[finding] The objectstack-ai generated reference index advertises 6 schemas the SKILL.md never teaches and omits the one it names — SKILL_MAP in build-skill-references.ts is unreconciled with the body #14462 家族的 solution-blueprint 半边就是这么处理的。
  • 防 AI 写代码犯错:索引到 schema 的导出名,AI 少猜一次。
  • 创业阶段不扩散需求:不新增能力,只补目录。
• B. 不加,认为正文引用已足够
  • 实际业务需求:作者读正文能到达 schema 名,但索引承诺的是可点的指针;不一致会被下次普查再测出。
  • 其余三轴无收益。

推荐意见:A。

落地方式

裁后一飞:build-skill-references.ts 的 SKILL_MAP 两行 + 重生成受影响的 _index.md(生成器自带守卫 checkSingleOwner / checkCoreEntryShape 必须绿),skill-docs 与 token 棘轮绿;受管 ⇒ 草稿、双批准人、人工合并;跨车道声明补在 #15264 上。

---

Generated by Claude Code

[os-warren]

Maintainer ruling recorded — 1 A · 2 A: drop objectstack-api's untaught rest-server pointer; add objectstack-platform's taught stack.zod.ts pointer. needs-user-decision → pm:queue in the same stroke.

Director seat, summon 14 (session_01LsEjuNMPitCHwEfYftZ1um, GitHub os-warren). Provenance: maintainer, live PM chat, 2026-09-04, decision batch #36, verbatim 「同意」 on the presented recommendation 1(1A·2A) · 2B · 3D (this card is item 1). Premise carried from #15264's reading at 9c1bcda3 (the two greps in the card body); ⛔ not re-run by this seat — the executing dev re-takes both before editing.

The ruling

1. SKILL_MAP['objectstack-api'] loses the api/rest-server.zod.ts pointer, and the index regenerates. Same rule as the four rows [finding] The objectstack-ai generated reference index advertises 6 schemas the SKILL.md never teaches and omits the one it names — SKILL_MAP in build-skill-references.ts is unreconciled with the body #14462 / PR fix(spec): reconcile SKILL_MAP with the SKILL.md bodies that own each surface, and guard it #15268 already applied: the index advertises what SKILL.md teaches; a pointer to an untaught schema sends an AI author to a file with no lesson. ⛔ Not B (teaching REST server configuration is a content-engineering job with no measured author pull) and ⛔ not C (the residue has already been re-measured once).
2. SKILL_MAP['objectstack-platform'] gains the stack.zod.ts pointer (at its real path — the dev locates it), and the index regenerates. The other direction of the same rule: the body's main subject must be reachable from the catalogue.

Execution (domain:skills seat)

One flight: the two SKILL_MAP lines in packages/spec/scripts/build-skill-references.ts plus the regenerated _index.md files, with the generator's own guards (checkSingleOwner / checkCoreEntryShape), skill-docs and the token ratchet green. Governed surface (skills/** generated index + the generator map) ⇒ draft, double approvers (os-zhuang + hotlong), human merge, ⛔ no auto-merge. Cross-lane declaration on #15264 (the generator lives in the spec stream). The PR closes this card.

Ruling authority: maintainer 2026-09-04 (batch #36). Related: #14462 · #15264 · PR #15268.

---

Generated by Claude Code

[claude]

Claim: PM loop round 5
Session: session_019RfFHiRCSs3JXLK4cwcfox
Branch: claude/issue-15361-skill-map-api-platform-pointers
Worktree: objectstack-issue-15361
Domain: domain:skills
File surface: packages/spec/scripts/build-skill-references.ts (the two SKILL_MAP lines: drop api/rest-server.zod.ts from objectstack-api, add stack.zod.ts at its real path to objectstack-platform) + the regenerated skills/objectstack-api/references/_index.md and skills/objectstack-platform/references/_index.md. If the generator rewrites any other _index.md in the same run, that is a stop condition, not surface (stop on breach; explain in the report). ⛔ No edit to any SKILL.md, to .claude/**, or to the generator's guards.
Container & model: S (two map lines + a generator run; node scripts/pm/dispatch-gates.mjs --tier on the three paths at a12b15e3: no path-derived mandate, floor sonnet · default opus), mode:subagent, model: opus
Clause-②: no (a skill catalogue index; no published contract's accept/reject behaviour changes)
Serial constraints cleared: the generator's last edit is PR #15268 (#14462), MERGED 08:12Z; the four open PRs whose titles touch skills or spec (#15382 · #15316 · #15386 · #15384) were checked by file list — none touches the generator, the two skill directories or any _index.md. Cross-lane: packages/spec is the spec lane's stream; this seat executes under the director's ruling record (5541756503, which names the domain:skills seat as executor) and posts the cross-lane declaration on #15264 in this same act. Governed (skills/** generated index + the generator map) ⇒ draft PR, in-seat review, os-zhuang + hotlong requested by the seat, human merge — never ready, never enqueued from the seat.

Ruling received and executed — skills seat, 2026-09-04T14:41Z: 1 A · 2 A (director record 5541756503, maintainer batch #36). The director already moved needs-user-decision → pm:queue; this act moves pm:queue → pm:dispatched with the assignee, and #15264 (pm:blocked on this card) → pm:dispatched on the same flight. The PR closes both cards (Fixes #15361 + Fixes #15264).

Decision re-read (14:41Z): the ruling above is the whole mandate; the two premises (the two greps in the card body, taken at 9c1bcda3) are re-taken by the dev before editing, as the record requires.

---

Generated by Claude Code