stack.zod.ts 的 skills JSDoc 仍写「trigger phrases for intent matching」—— triggerPhrases 已在 #3896 退役,文案教一个会被 retiredKey 拒收的键

[qq9340100]

在 #3905(PR #6077)实施过程中发现,dev 报告记录、PM 代立案(该改动触发 spec 生成物重生成,落在 #3905 申报文件面之外,不做 rider)。

现象

packages/spec/src/stack.zod.ts:396 附近的 skills JSDoc 仍在写「trigger phrases for intent matching」,而 triggerPhrases 已在 #3896 被 retiredKey() 退役 —— 照着这段文案写的作者(AI 或人)会写出被墓碑当场拒收的键。

定性

与 #5920 / #5310 / #5552 / #6065 同族:spec 的 JSDoc/describe 在教已失效或会被拒的东西。#5310 验收时已记录「describe 示例喂对应判据」的家族门构想 —— 本单是又一实例,家族门若立项可一并覆盖。

修法

一行文案订正(措辞对齐 #3896 的退役处方);若该 JSDoc 进 describe 流则按 os-regen 重生成。

Refs: #3905、PR #6077、#3896;家族:#5920 / #5310 / #5552 / #6065。

观察级,无用户今日撞上;留 finding 交发现分诊轮定级,域标签归分诊座位。

[claude]

发现分诊轮判级(#4949 纪律):晋级 pm:queue(摘 finding)+ 补域 domain:spec。本单立单以来从未获判级,本轮首判。

• 域锚定:落点 packages/spec/src/stack.zod.ts 的一段 JSDoc(+ 若该段进 describe 流则按 os-regen 重生成)⇒ 域表「packages/spec 及其生成物」= domain:spec。
• 过时前提检查(origin/main 9e3709a 逐行实读,成立):stack.zod.ts:396-397 原样仍在 —— declares its agent surface affinity (…), **trigger phrases for intent matching**, and trigger conditions…;而 triggerPhrases 的墓碑同样在册(packages/spec/src/ai/skill.form.ts:39 的退役注记、skill.test.ts:188 的 describe('#3896 close-out — retired \triggerPhrases`')`)。
• 为什么晋级而不是继续持有(与作者自评的 observation 级不同,判级发生在本轮而不在立单时):
  1. 有一条 pin 测试正在保护相反的方向。 skill.test.ts:215 断言解析错误信息 不得出现 triggerPhrases(:203 写明理由:不能把作者引到一个已被移除的键上)。仓库为「别把作者指向这个键」专门立了门,而 stack.zod.ts 的散文仍在正面推销它 —— 这不是冗余文案,是与既定处方方向相反的一处存活面。
  2. 今日可达。 该 JSDoc 是 ObjectStackSchema 的作者面说明,AI 作者照抄即写出被 retiredKey() 当场拒收的键 —— 与 shared/mapping.zod.ts 的 javascript 变换 describe 推荐 dialect="js",而 ExpressionDialect 只有 cel/cron/template —— 照着写会被拒 #5552(同族,pm:queue)判据一致,且本单更便宜(措辞由 POST /data/sharing/rules 绕过 SharingRuleSchema:criteria 缺失或拼错静默变成"共享该对象全部记录",与 ADR-0049 "never seeded as a permissive match-all" 直接冲突 #3896 的退役处方现成给定,无取舍项)。
  3. 不属 needs-user-decision:不改枚举、不改 schema、不改对外契约,只把散文对齐已落地的退役裁决。与 ApiEndpointSchema / ApiMappingSchema 还有三处 .describe() 在向作者推销 publish 门整键拒绝的能力(type: 'script'|'proxy'、target 的 "Script Name, or Proxy URL"、ApiMapping.transform) #6065 / ApiEndpointSchema.path 的 .describe() 举的例子会被 ADR-0121 D1 当场拒绝 —— 而这段文案正是 Studio 端点表单显示给作者的提示 #5310 那类「被冻结保留的被拒键该不该在作者表单里自陈」的措辞取舍不同形 —— 那是契约取舍,这里没有可取舍的东西。
• 查重:家族 FieldWidgetPropsSchema 的 JSDoc 仍在教 objectui#3222 裁掉的双份显示:required「visually」+ error「display in its UI」 #5920 / ApiEndpointSchema.path 的 .describe() 举的例子会被 ADR-0121 D1 当场拒绝 —— 而这段文案正是 Studio 端点表单显示给作者的提示 #5310 / shared/mapping.zod.ts 的 javascript 变换 describe 推荐 dialect="js",而 ExpressionDialect 只有 cel/cron/template —— 照着写会被拒 #5552 / ApiEndpointSchema / ApiMappingSchema 还有三处 .describe() 在向作者推销 publish 门整键拒绝的能力(type: 'script'|'proxy'、target 的 "Script Name, or Proxy URL"、ApiMapping.transform) #6065 各有各的文件与判据,本单是 stack.zod.ts 一处,无重复单;ApiEndpointSchema.path 的 .describe() 举的例子会被 ADR-0121 D1 当场拒绝 —— 而这段文案正是 Studio 端点表单显示给作者的提示 #5310 验收记的「describe 示例喂对应判据」家族门若立项可一并覆盖,但家族门不是本单的前置。
• 串行注记:PR feat(mcp): skill 的 instructions 半边投影为 MCP prompts 原语;tool-binding 半边标注 cloud-runtime-only (#3905) #6077(Skills are declared the only third-party extension primitive, but nothing in the open distribution consumes them #3905)的 17 个文件已核 —— 触 packages/spec/src/ai/skill.zod.ts 与 liveness/skill.json,不触 stack.zod.ts,无源文件冲突;两者都可能重生成 spec 产物,落地时重跑生成即可。

本评论来自分诊座位 Routine(#5474 试点),不构成认领。

---

Generated by Claude Code

[hotlong]

Release-board audit (maintainer-directed re-audit of non-board domain:spec items, 2026-08-07): adding target:v17 — criterion ④: the published JSDoc still sells triggerPhrases ("trigger phrases for intent matching"), retired in #3896 — authors copying it write a retiredKey()-rejected key. Triage seat may veto.

---

Generated by Claude Code

[qq9340100]

Riding sweep #6243 —— 本单已并入首次 sweep 打包试点,由 draft PR #6288 的七条 Fixes 之一关闭(会话 session_011M7UwH25Unfi73UHim7ajY,分支 claude/issue-6243-description-truth-sweep)。本单落点:stack.zod.ts 的 skills JSDoc 摘掉「trigger phrases for intent matching」,改指现拼法 triggerConditions ∩ agent allowlist,并把自然语言意图指向 description / instructions —— 措辞复用 #3896 的退役处方(那是一次 SPLIT,不是改名)。skill.test.ts:215 那条既有 pin 未受影响并仍绿:它钉的是解析错误信息不得出现 triggerPhrases,而本次改的是散文,且散文只在把该键讲成已退役、会被拒时提到它。

---

Generated by Claude Code