From 085a5026797c31c8c755d5a9221fe0ce6ba22657 Mon Sep 17 00:00:00 2001 From: Claude Date: Mon, 28 Sep 2026 02:45:47 +0000 Subject: [PATCH] =?UTF-8?q?docs(skills):=20retirement=20playbook=20=C2=A70?= =?UTF-8?q?=20judges=20each=20family=20by=20mainstream=20capability?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit §0 said benign display metadata (`description`, `tags`, `icon`) is never retired and that "no code reads it" is the evidence for retirement. Both contradict the maintainer's per-family criterion: ask whether mainstream platforms have the capability; yes ⇒ build the consumer, no ⇒ retire, never judged by whether anything in this repo reads the key. The docs-shaped keys (`hook.label`, `flow.description`) stay, now as the "yes" outcome of that one criterion (render, do not retire) rather than as a second rule. `authorWarn` marking defers to the liveness README. Net 0 lines, widest table row unchanged. Claude-Session: https://claude.ai/code/session_01MjvgiFAmjHqsxy1XLiVYfH Co-authored-by: Claude --- .claude/skills/spec-property-retirement/SKILL.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/.claude/skills/spec-property-retirement/SKILL.md b/.claude/skills/spec-property-retirement/SKILL.md index f32d9702970..2985b9e1ea3 100644 --- a/.claude/skills/spec-property-retirement/SKILL.md +++ b/.claude/skills/spec-property-retirement/SKILL.md @@ -40,11 +40,11 @@ preview renderer 不算消费者)与 AGENTS.md §"Touched `packages/spec`?"(八 `rls.enabled` 曾是「证据错误的 live」而实际**无人读取** —— disabled 的 policy 仍在贡献它的授权。那个键最后是**被强制执行**,不是被删除。功能存在时,强制 执行赢。 -- [ ] **它是文档形状的吗?** `hook.label`、`hook.description`、`flow.description` - 没有运行时消费者,但被**有意保留** —— 它们为下一个读者(按 ADR-0033,常是模 - 型)记录意图。把豁免写进台账 `note`,下次审计不再重审。良性展示元数据 - (`description`、`tags`、`icon`)永远谈不上「误导」;不要标 `authorWarn`,也 - 不要退役它。 +- [ ] **主流平台有没有这个能力?** 声明而未执行的键每族问这句,按维护者原话(裁决评论 + `5727134555`):「有 ⇒ 补消费端(一次做对);没有 ⇒ 退役,而不是看仓里有没有人读」。 + 文档形状的键(`hook.label`、`flow.description`)为下一个读者记录意图(ADR-0033),是「有」的 + 一例:补渲染、不退役,判定写进台账 `note`,下次审计不再重审。`description`、`tags`、`icon` + 不自动豁免:RLS 策略的 `tags` 主流没有 ⇒ 退役。`authorWarn` 另按 README 判。 - [ ] **有已承诺的路线图吗?** 那就是 `experimental` + `.describe()` 里的 `[EXPERIMENTAL — not enforced]` 标记,不是删除。 - [ ] **同 major 记账。** 同一个*未发布 major* 里更早的 conversion 改名了你现在要删 @@ -58,7 +58,7 @@ preview renderer 不算消费者)与 AGENTS.md §"Touched `packages/spec`?"(八 `live-elsewhere` 一节。 - [ ] **零编写实例普查要并跑一个同族已知存活的键作对照**,两读数都报;同得零即没测出。 - [ ] **拿 `cross-repo` 行当论据,就当刻重核路径与行号**:漂了读作重新取证,⛔ 不是 `dead`。 -- [ ] **「零编写实例」≠「没有代码读它」。** 前者答的是示例应用,后者才是退役的证据。 +- [ ] **「零编写实例」≠「没有代码读它」。** 前者答的是示例应用,后者才证 `dead`。 ## 1. 裁判是构建,不是台账