{"summary":"提示框、跟随气泡、就地确认、弹窗、抽屉和独立页面，分别适合什么场景。","notes":"<p>很多后台产品处处用弹窗：问号的说明、归档前的确认、编辑表单，每次都要先处理弹窗才能继续。提示框几乎不打断用户，弹窗会遮住整个页面，常见的浮层有以下几种：</p>\n        <ol>\n        <li><strong>提示框（Tooltip）</strong>：为指针所指的内容补充文字，常见于被截断的长文本，如表格里的长文件名。指针移开就消失，所以只放文字；要放按钮或链接，改用点击打开的气泡（Popover）。</li>\n        <li><strong>跟随气泡（Cursor tip）</strong>：在一整块区域内持续提供信息，常见于图表和相对独立的元素。指针移入才出现，并跟着指针移动，如折线图上显示所指数据点的日期和数值。</li>\n        <li><strong>就地确认（Popconfirm）</strong>：用于大多数不可撤销的操作，如删除一条评论。确认框出现在按钮旁，用户不用移开视线，路径短，也不打扰。</li>\n        <li><strong>弹窗（Dialog）</strong>：用于影响大、批量操作或必须让用户停下来考虑的确认，如永久删除整个项目；也用于较短、不需要参照页面其他信息的表单，如重命名文件。</li>\n        <li><strong>抽屉（Drawer）</strong>：用于较长的表单，或填写时需要对照页面内容，如在客户列表旁编辑某位客户的资料。抽屉从侧边滑出，主页面仍然可见，也能更好地利用宽屏的横向空间。</li>\n        <li><strong>独立页面</strong>：表单本身就是主要任务时，如新建项目时的完整设置，做成独立页面，有自己的地址和返回路径。</li>\n        </ol>\n        <p>另外，能撤销的操作，如归档，不需要确认：直接执行，再留一个「撤销」入口。到了手机上，提示框和跟随气泡都改成点击显示。</p>\n        <p>附带的 Prompt 会先找出产品里所有的浮层，逐个判断该用哪一种，列成表格由你决定；确认后只改你同意的部分，视觉样式保持不变。</p>","prompt":"Review how my product uses floating UI (tooltips, tooltips that follow the pointer, popovers, popconfirms, drawers and dialogs) and decide which kind each case should be. Work inside my existing design system. This is about choosing the right kind, not about restyling: keep my components, colours, radii, shadows, fonts, motion and copy style.\n\n0. Start from what exists\n- Find every overlay in the product and the components behind it: tooltips, hover cards, popovers, confirm bubbles, menus that confirm, side panels, drawers, sheets, modals and dialogs.\n- For each use, note where it is, what opens it, what it holds and what happens when the user confirms.\n- Find the design system's own component for each kind. Reuse it. If two components do the same job, say so and suggest which one to keep.\n\n1. What each kind is for\n- Tooltip: adds text about what the pointer is on, such as long text that has been cut short, an icon-only button or a disabled control. Text only. If it needs actions, it becomes a popover opened by a click.\n- Tooltip that follows the pointer: keeps giving information across an area. It appears when the pointer enters, follows it, and goes when the pointer leaves. Common on charts and on other self-contained elements.\n- Popconfirm: the second check for an irreversible action on a single item, right where it was clicked. The path stays short and nothing else is interrupted.\n- Dialog: for something the user must stop and confirm or complete before going on: an action with a large impact, one that affects other people, a bulk action, or one that needs another decision first (such as who takes over the projects). Also for a short form that doesn't need anything else on the page for reference.\n- Drawer: for a long form, for work that needs the page in view to compare against, or to make better use of horizontal space. Never use a drawer to confirm something.\n- Full page: when the task is the user's main job there, or it needs a link that can be shared and survives a reload.\n\n2. Questions that settle a case\n- Can the action be undone? Then don't confirm: do it at once and offer Undo (a toast, or a way back such as a trash).\n- If it can't: is it one item of the user's own, with a button to anchor to? Popconfirm. Large impact, other people, a bulk selection, or a decision still to make? Dialog.\n- Is it a form? Short, and nothing on the page is needed for reference: dialog. Long, needs the page in view, or wants the width: drawer. The main task, or needs its own URL: a page.\n- Is the information about one element, or about wherever the pointer is inside an area? One element: tooltip. An area: tooltip that follows the pointer. Either way, does it need anything to click? Then it is a popover.\n- On touch screens there is no hover: anything shown on hover must also be reachable by a tap.\n\n3. What each kind should do\nFill in only what is missing, with the design system's existing parts.\n- Tooltip: shows on hover and on keyboard focus, after about 500ms for the first one, then at once when moving to a neighbour. Stays inside the viewport, lets the pointer through, one at a time, linked with aria-describedby.\n- Tooltip that follows the pointer: sits beside the pointer without covering it and flips near the edges of the viewport. On a chart, the guide line follows the pointer and the value snaps to the nearest data point. On touch, a tap shows the value.\n- Popconfirm: anchored to the button that opened it and grows from it. Escape or a click outside closes it, and focus goes back to that button. The confirm button names the action.\n- Dialog: the system's modal or a native dialog opened with showModal(). Keeps focus inside and Escape cancels. It says who or what is affected and what cannot be undone. Buttons name the action (\"Remove member\", not \"OK\").\n- Drawer: comes in from the edge it is attached to and leaves the page in view. Changes show up in the page behind it as they are made. Closes with Escape and a close button; focus moves into it and back out to what opened it.\n- Drawers, dialogs and pages with a form: closing with unsaved changes asks first.\n\n4. Keep the design as it is\n- Change only the kind where the current one is wrong, plus the missing behaviour from step 3.\n- Don't change colours, radii, shadows, fonts, spacing or animations, and don't add new visual patterns.\n- Keep copy as it is, except confirm buttons and the line that explains what cannot be undone.\n- If a case needs a component the system doesn't have (an undo toast, a popover), stop and ask me before adding one.\n\n5. Deliver the decisions first\n- Before changing any code, give me a table: each use, where it is, its current kind, the kind you recommend, and why in one line.\n- Mark the ones that are already right, and the ones that could fit two kinds, with what decides between them.\n- Wait for my go-ahead, then make only the changes I approve and list every file you touched.","skill":"/skills/kubai-overlays/SKILL.md","skillText":"# 浮层组件的选择规则\n\n《999 个小技巧，让你 Vibe 的产品更有质感》第 009 期 · @kubai087\n\n在用户的项目里按下面的要求改造。要求以用户的口吻写成：文中的 I、me、my 指用户；写着要先问的地方，先停下来问用户再继续。\n\n## 改造要求\n\nReview how my product uses floating UI (tooltips, tooltips that follow the pointer, popovers, popconfirms, drawers and dialogs) and decide which kind each case should be. Work inside my existing design system. This is about choosing the right kind, not about restyling: keep my components, colours, radii, shadows, fonts, motion and copy style.\n\n0. Start from what exists\n- Find every overlay in the product and the components behind it: tooltips, hover cards, popovers, confirm bubbles, menus that confirm, side panels, drawers, sheets, modals and dialogs.\n- For each use, note where it is, what opens it, what it holds and what happens when the user confirms.\n- Find the design system's own component for each kind. Reuse it. If two components do the same job, say so and suggest which one to keep.\n\n1. What each kind is for\n- Tooltip: adds text about what the pointer is on, such as long text that has been cut short, an icon-only button or a disabled control. Text only. If it needs actions, it becomes a popover opened by a click.\n- Tooltip that follows the pointer: keeps giving information across an area. It appears when the pointer enters, follows it, and goes when the pointer leaves. Common on charts and on other self-contained elements.\n- Popconfirm: the second check for an irreversible action on a single item, right where it was clicked. The path stays short and nothing else is interrupted.\n- Dialog: for something the user must stop and confirm or complete before going on: an action with a large impact, one that affects other people, a bulk action, or one that needs another decision first (such as who takes over the projects). Also for a short form that doesn't need anything else on the page for reference.\n- Drawer: for a long form, for work that needs the page in view to compare against, or to make better use of horizontal space. Never use a drawer to confirm something.\n- Full page: when the task is the user's main job there, or it needs a link that can be shared and survives a reload.\n\n2. Questions that settle a case\n- Can the action be undone? Then don't confirm: do it at once and offer Undo (a toast, or a way back such as a trash).\n- If it can't: is it one item of the user's own, with a button to anchor to? Popconfirm. Large impact, other people, a bulk selection, or a decision still to make? Dialog.\n- Is it a form? Short, and nothing on the page is needed for reference: dialog. Long, needs the page in view, or wants the width: drawer. The main task, or needs its own URL: a page.\n- Is the information about one element, or about wherever the pointer is inside an area? One element: tooltip. An area: tooltip that follows the pointer. Either way, does it need anything to click? Then it is a popover.\n- On touch screens there is no hover: anything shown on hover must also be reachable by a tap.\n\n3. What each kind should do\nFill in only what is missing, with the design system's existing parts.\n- Tooltip: shows on hover and on keyboard focus, after about 500ms for the first one, then at once when moving to a neighbour. Stays inside the viewport, lets the pointer through, one at a time, linked with aria-describedby.\n- Tooltip that follows the pointer: sits beside the pointer without covering it and flips near the edges of the viewport. On a chart, the guide line follows the pointer and the value snaps to the nearest data point. On touch, a tap shows the value.\n- Popconfirm: anchored to the button that opened it and grows from it. Escape or a click outside closes it, and focus goes back to that button. The confirm button names the action.\n- Dialog: the system's modal or a native dialog opened with showModal(). Keeps focus inside and Escape cancels. It says who or what is affected and what cannot be undone. Buttons name the action (\"Remove member\", not \"OK\").\n- Drawer: comes in from the edge it is attached to and leaves the page in view. Changes show up in the page behind it as they are made. Closes with Escape and a close button; focus moves into it and back out to what opened it.\n- Drawers, dialogs and pages with a form: closing with unsaved changes asks first.\n\n4. Keep the design as it is\n- Change only the kind where the current one is wrong, plus the missing behaviour from step 3.\n- Don't change colours, radii, shadows, fonts, spacing or animations, and don't add new visual patterns.\n- Keep copy as it is, except confirm buttons and the line that explains what cannot be undone.\n- If a case needs a component the system doesn't have (an undo toast, a popover), stop and ask me before adding one.\n\n5. Deliver the decisions first\n- Before changing any code, give me a table: each use, where it is, its current kind, the kind you recommend, and why in one line.\n- Mark the ones that are already right, and the ones that could fit two kinds, with what decides between them.\n- Wait for my go-ahead, then make only the changes I approve and list every file you touched.\n"}