docs(design): 组件台账回填三行 —— 沙箱告知落地,并订正陈旧 12 天的右栏宽度行 - #1332
Merged
Conversation
`docs/design/README.md` 说得明白:「A component whose ledger row still reads 设计中 after its issue closed is the drift this layer exists to surface.」这次是那层自己漏了。 - 沙箱告知两行(`#term-sandbox` / `#wtop-readonly`):`ac#1322` 已随 PR #1330 合入 (`95880b18f`,2026-09-10),落地日与代码入口按实读回填,状态转「已实现」。 - **右栏宽度规则(`ac#1161`)**:该票 2026-08-29 就由 PR #1169(`3665829bd`)关闭,代码里 固定上限 560 已彻底移除(`rail-width.ts` 现为 320 / 400 / 480 三常量 + 按实测工作区宽收敛), 而台账那行仍写着「设计中 · 固定上限 560,待改」—— **陈旧 12 天**。一并订正。 回填前对五份台账 41 行做了一次全量对照(行状态 vs 票的真实状态):未结行 6 处,其中票已 全部关闭的漂移 1 处 = 上面这条;回填后重扫,漂移 0 处。剩余 5 处未结行的票确实仍开着 (ac#245 / ac#246 / ac#1130)或尚未立票,不是漂移。 Refs #1322 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01HE3Jmp5ZDzEvnCNhgCDreN
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
为什么有这张 PR
owner 问:「
current/靠什么确保它精准体现最新内容?」答案是组件台账(docs/design/README.md:「A page's design is aligned with its implementation when its ledger has no row still open.」)。查这一问的过程本身就查出了漂移 —— 那层自己漏了。回填三行
#term-sandbox终端面沙箱告知ac#132295880b18f合入 2026-09-10 ⇒ 落地日 + 代码入口 + 状态「已实现」#wtop-readonly工作区只读告知ac#1322#railsec右栏宽度规则ac#11613665829bd)关闭,rail-width.ts里固定上限 560 已彻底移除(现为RAIL_MIN_WIDTH320 /RAIL_DEFAULT_WIDTH400 /SESSION_MIN_WIDTH480 + 按实测工作区宽收敛),而台账那行仍写「设计中 · 固定上限 560,待改」全量对照(回填的依据,不是抽查)
对
docs/design/current/*/components.md五份台账 41 行逐行取「行状态」与「实现票的真实状态」对照:剩余 5 处未结行不是漂移 —— 票确实还开着(
ac#245/ac#246/ac#1130),或该行尚未立票(artifact-workbench 的到站占位文案、conversation-timeline 的「可预览」标示,两行的票号栏本来就写着待立)。门
check-doc-links.py✓ 7 relative link(s) resolve across 1 file(s)rc=0。只改一个 Markdown 文件,不涉及代码。值得单独说一句
这次漂移不是靠判据发现的,是靠人临时想起来去查。台账是唯一的对齐定义,但它没有任何自动化守卫:
落地一栏 README 明写应当「Derived from the issue, not asserted by hand」,而实际是手填的。要不要给它立一道闸,归 owner 决定 —— 本 PR 不含闸。Refs #1322
🤖 Generated with Claude Code
https://claude.ai/code/session_01HE3Jmp5ZDzEvnCNhgCDreN