用途:在编写任何 AI 功能 UI 代码之前使用。它主张“没有设计状态图的 AI 功能只算半个功能”,要求在实现开始前把 7 种状态全部设计、记录并确认。
主要能力:定义 7 种必需状态——Loading(请求已发送、等待首个 token)、Streaming(token 到达、内容逐步生成)、Success(生成完成、可复制/重试/分享)、Error(API 失败、超时、服务端错误,需人话提示与恢复动作)、Partial(回答不完整,需标明并可继续)、Uncertain(置信度低、需不确定性提示与来源)、Empty(无输入/无历史/首次使用,需引导与示例)。每种状态需定义视觉表现、文案、可用操作和状态转换。
使用方式:先列出功能中每个 AI 触点(主回复区、内联预测、状态指示、次级输出),每个触点各自设计 7 态;再把状态图写入 design/ai-states/<feature-name>.md;然后复核边界情况(流中断、空响应、超长响应、重复提交等);满足后按固定格式声明完成,列出各状态的具体元素与文案。
适用场景:新增 AI 驱动 UI、新增用户可见输出的模型调用、设计新智能体或聊天界面、为现有功能加 AI 能力。
限制:不适用于无用户可见输出的后台 AI 任务(批处理、后台分类)以及终端用户看不到输出的开发者专用工具。资料未提供收费、价格、平台等信息。