Skip to content

Commit 085a502

Browse files
committed
docs(skills): retirement playbook §0 judges each family by mainstream capability
§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 <noreply@anthropic.com>
1 parent 8af914a commit 085a502

1 file changed

Lines changed: 6 additions & 6 deletions

File tree

  • .claude/skills/spec-property-retirement

‎.claude/skills/spec-property-retirement/SKILL.md‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -40,11 +40,11 @@ preview renderer 不算消费者)与 AGENTS.md §"Touched `packages/spec`?"(八
4040
`rls.enabled` 曾是「证据错误的 live」而实际**无人读取** —— disabled 的
4141
policy 仍在贡献它的授权。那个键最后是**被强制执行**,不是被删除。功能存在时,强制
4242
执行赢。
43-
- [ ] **它是文档形状的吗?** `hook.label`、`hook.description`、`flow.description`
44-
没有运行时消费者,但被**有意保留** —— 它们为下一个读者(按 ADR-0033,常是模
45-
型)记录意图。把豁免写进台账 `note`,下次审计不再重审。良性展示元数据
46-
(`description`、`tags`、`icon`)永远谈不上「误导」;不要标 `authorWarn`,也
47-
不要退役它。
43+
- [ ] **主流平台有没有这个能力?** 声明而未执行的键每族问这句,按维护者原话(裁决评论
44+
`5727134555`):「有 ⇒ 补消费端(一次做对);没有 ⇒ 退役,而不是看仓里有没有人读」。
45+
文档形状的键(`hook.label`、`flow.description`)为下一个读者记录意图(ADR-0033),是「有」的
46+
一例:补渲染、不退役,判定写进台账 `note`,下次审计不再重审。`description`、`tags`、`icon`
47+
不自动豁免:RLS 策略的 `tags` 主流没有 ⇒ 退役。`authorWarn` 另按 README 判。
4848
- [ ] **有已承诺的路线图吗?** 那就是 `experimental` + `.describe()` 里的
4949
`[EXPERIMENTAL — not enforced]` 标记,不是删除。
5050
- [ ] **同 major 记账。** 同一个*未发布 major* 里更早的 conversion 改名了你现在要删
@@ -58,7 +58,7 @@ preview renderer 不算消费者)与 AGENTS.md §"Touched `packages/spec`?"(八
5858
`live-elsewhere` 一节。
5959
- [ ] **零编写实例普查要并跑一个同族已知存活的键作对照**,两读数都报;同得零即没测出。
6060
- [ ] **拿 `cross-repo` 行当论据,就当刻重核路径与行号**:漂了读作重新取证,⛔ 不是 `dead`。
61-
- [ ] **「零编写实例」≠「没有代码读它」。** 前者答的是示例应用,后者才是退役的证据。
61+
- [ ] **「零编写实例」≠「没有代码读它」。** 前者答的是示例应用,后者才证 `dead`。
6262

6363
## 1. 裁判是构建,不是台账
6464

0 commit comments

Comments
 (0)