Skip to content

Commit 2ab8cb6

Browse files
claude[bot]claude
andauthored
docs(skills): drop the issue id from the retirement guidance prescription (#15695)
Convention 2 of the guidance-string conventions prescribed `(#issue[, ADR-XXXX Dn])`, so an author following it literally wrote an internal issue id into a `retiredKey()` tombstone — customer-facing spec text, where `check:doc-authoring` refuses one. The tombstone-note template a few lines up carried the same `(#<issue>)` fragment. Convention 2 now prescribes `(ADR-XXXX[ Dn])` and carries the redirect and the gate that enforces it: the id belongs in the schema comment. The template drops its fragment. Line-neutral at 337 of 337; the amended convention is 120 bytes, at the ratchet's per-line cap. Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox Co-authored-by: Claude <noreply@anthropic.com>
1 parent b2a5c93 commit 2ab8cb6

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

  • .claude/skills/spec-property-retirement

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ walk 看不见的属性就是 ratchet 管不到的属性。
114114

115115
墓碑条目的 note 模板(house style 原文,如 `liveness/action.json`):
116116

117-
> `REMOVED <date> (#<issue>) — tombstoned at the schema (retiredKey carries the prescription; authoring it is a tsc error and a parse error) and stripped from sources by the protocol-<N> conversion. The entry stays because retiredKey keeps the key in the walked shape (the rls.priority precedent); <what to do instead>.`
117+
> `REMOVED <date> — tombstoned at the schema (retiredKey carries the prescription; authoring it is a tsc error and a parse error) and stripped from sources by the protocol-<N> conversion. The entry stays because retiredKey keeps the key in the walked shape (the rls.priority precedent); <what to do instead>.`
118118
119119
### ⚠ 四张 ratchet 的可见性,按路线是**相反**的 —— 拿错对照就会判错
120120

@@ -151,7 +151,7 @@ ratchet(#2978)会先开火,要求你**有意删除**对应的 manifest key;删
151151
五条惯例,树上每个墓碑都遵守 —— 逐点判定归下面那个 pin 测试,不归这段散文:
152152

153153
1. 反引号包着的**全限定**键打头 —— `` `flow.errorHandling.fallbackNodeId` ``,不是裸尾段。
154-
2. `was removed in @objectstack/spec <version> (#issue[, ADR-XXXX Dn])`
154+
2. `was removed in @objectstack/spec <version> (ADR-XXXX[ Dn])`;`#<n>` 归 schema 注释,`check:doc-authoring` 把门
155155
3. 一个破折号从句讲**它为何惰性或错误** —— "it never had an effect"、"no renderer ever read it"。
156156
4. 祈使句修复:改名写 "use `<replacement>`" + "Rename the key; the value (…) is unchanged.";删除写 "Delete
157157
the key." + **真正生效的机制是什么**

0 commit comments

Comments
 (0)