用途：为智能体式 AI 功能设计界面。智能体指会规划多步骤工作、调用工具、在数秒到数分钟内半自主运行的 AI 功能，其 UI 必须暴露计划、进度与控制。若功能只是单提示单回复的聊天，应改用 ai-ux-patterns；若只做工程侧工具接线，应改用 ai-agents-tools。
三条原则：执行前先展示计划（少于 3 步且无外部副作用的简单任务可隐藏）；分层呈现信息，默认视图只显示阶段、已用时间与一个下一步操作；为共享控制而设计，每一步都可中断、可编辑、可回滚。
五种智能体模式及 UI 要求：反思（高风险场景显示“审查中…发现错误…已修正”）、工具使用（显示调用了哪个工具、做了什么、返回了什么，并配合分级权限）、规划（执行前展示分解后的计划，暴露分支点，允许运行前编辑）、多智能体（每个输出标注来源智能体，冲突作为用户决策点）、ReAct（显示迭代计数，如“第 3 次尝试”，并提供升级/移交路径）。
分级权限框架：只读类（文件读取、网页抓取、grep）自动执行不提示；中等类（shell 命令、HTTP POST）首次调用时提示，可按目录或会话记住；破坏性类（删除文件、写数据库、rm -rf、git push force）每次都必须提示。权限提示需回答三问：做什么（动作与参数可见）、为什么（来自计划的一句话理由）、如何撤销（如“在设置 > 权限中撤销此批准”）。
六个检查点原语：检查点（每步后的命名、带时间戳的状态快照）、回滚（一键回到任一检查点，先确认）、中间输出（步骤间的临时输出，标注为临时，用户编辑作为下一阶段输入）、权限（副作用动作的显式同意）、编辑/错误面板（按时间顺序展示错误、重试与用户修正）、来源（每条事实性主张标注来源、访问时间与链接）。
四层进度沟通：通知（仅最顶层信息，可关闭）、第一层概览（阶段名、已用时间、活动权限，一行）、第二层详情（子任务分解、当前推理默认折叠、工具与来源引用，一个面板）、第三层完整记录（可审计日志，独立视图）。
用户侧标签：选择器中不暴露原始模型 ID，改用“适合快速响应”“专为复杂推理优化”等描述；自动路由时显示常驻徽章说明选择原因。文案上聊天机器人用“提问/回复”，智能体用“运行/启动/执行”，不要混用。
反模式：无计划预览就自动运行多步破坏性动作；长时间转圈却无中间输出或预计时间；折叠全部推理导致无法审计；权限提示不说明后果与撤销方式；静默重试无迭代计数；多智能体输出无归属；用户界面出现技术模型 ID；副作用动作后无法回滚。
所需输入：功能描述（步骤数、副作用面、预期运行时长）、工具清单（按只读/中等/破坏性分组）、回滚范围与粒度。工作流：先读 SKILL.md，按需加载参考文档，对照五种模式分类，定义分级权限策略，指定六个检查点原语与四层进度模型，产出线框标注与组件规格。输出包括智能体 UI 线框标注、分级权限策略文档、检查点 schema、计划预览组件规格、多层进度组件规格。参考资料包括 agentic-patterns.md、permission-framework.md、checkpoint-primitives.md、progress-tiers.md。