激活合约
用于设计、评审或优化终端界面（面板、侧边栏、状态栏、卡片、提示框），尤其针对Gentle Shell。目标感觉是终端内的IDE：密集、宁静、开发者优先，绝不做复古TUI的装饰。不适用于网页（参见 gentle-design）。
硬性规则
- 绝不要仅凭代码或记忆评判终端UI：务必截取截图（
references/visual-loop.md），并在每次改动前后查看对应的PNG。 - 在进行任何UI编辑之前，先阅读
references/terminal-craft.md；这是底线，而非建议。 - 运作模式：熟悉胜过表达。使用IDE术语（窗格、树、标签页、状态栏、命令面板）；品牌体现在调色板、密度和一项标志性动作上。
- 每一行都有成本。层次结构来自颜色角色、字重和对齐，绝不要依靠空行或嵌套方框来表示。
- 每个屏幕只陈述一个事实。标题中显示的数据不要在面板中重复。
- 一个命令，一个目标。优化保留系统；重构替换系统。永远不要打磨一个即将被抛弃的外观。
- 渲染保持轻量：渲染路径中不要有I/O或重计算，缓存键覆盖所有影响输出的因素（样式、宽度、主题）。
- 原型（通过
gentle-design）必须能在终端中表达：以ch为单位的等宽字元网格，仅使用前景/背景颜色、粗体/暗淡/斜体/下划线/删除线、制表符和字形。
决策门
| 场景 | 命令 | 加载项 |
|---|---|---|
| 尚无产品/设计上下文 | document | references/design-doc.md |
| 新界面或重构 | shape，然后原型，再实现 | references/commands.md |
| “看起来如何/哪里有问题” | critique | references/critique.md |
| 过于拥挤、浪费空间、冗余 | distill / layout / quieter | references/commands.md |
| 平坦、无层次、难以阅读 | typeset / colorize / bolder | references/commands.md |
| 边界情况、窄终端、长文本 | harden / adapt | references/commands.md |
| 提交前最终检查 | polish | references/commands.md |
执行步骤
- 如果项目有
DESIGN.md则加载其上下文；否则先提议执行document。 - 使用视觉循环，按定义的尺寸（宽屏180x50，断点140，窄屏80x24）捕获当前状态。
- 针对一个命名目标运行所选命令；先记录发现，再修改代码。
- 修改后重新捕获，对比之前的PNG和需求摘要；最多迭代3轮，然后报告。
- 每个优化命令结束时都执行
polish检查，并运行仓库的针对性测试（渲染计数、溢出）。
输出合约
返回：目标、执行的命令、前后对比PNG路径、按P0-P3标签标记的已修复发现、未解决的发现以及执行的检查项。
参考资料
references/terminal-craft.md：底线规则和终端反模式。references/commands.md：针对终端适配的命令手册。references/critique.md：计分评审和严重性评定量规。references/design-doc.md：终端产品的DESIGN.md框架。references/visual-loop.md：截图工具和比较循环。NOTICE.md：归属说明。