5.8 KiB
5.8 KiB
📱 核心 UI 翻新与重构体系 (UITask 原型车间)
⚠️ 智能体请注意 (Agent Prompt & Protocol): 如果您被唤醒并要求接手本目录的 UI 任务,请不要一上来就盲目生成代码! 您必须充当“UI 架构师”的角色,严格按照以下的 “一步一答 (Step-by-Step) 交互式协议” 引导人类用户完成工作流。您的最终目标是集齐 7 件标准物料。
🔄 您的交互式工作流 (Step-by-Step Protocol)
当您(新手智能体)被人类协作者唤醒,并收到这张 README 时,请按顺序执行以下 6 个步骤。每完成一步,必须停下来等待用户的回复,严禁抢跑:
📁 Step 1: 确定界面归属与建仓 (防覆盖)
- 您的动作:询问用户:“请问本次重构属于哪个界面?是否是某个主界面下的子界面(例如:主界面/侧滑抽屉)?”
- 执行:根据用户的回答,自动在
.agents/UITask/下为您创建对应的物理文件夹路径。 - ⚠️ 强制规则:为了防止覆盖过往版本,创建的文件夹必须带有当天的日期后缀(例如:
UITask/用户管理界面-20260816/)。
🌟 AI 能力自检探针 (Capability Check) 在执行前,请 AI 评估自身当前具备哪些具体的 Tool/API 权限,并据此调整策略:
- 文件读写能力:能否在后台静默创建文件/目录并打包ZIP?(有则静默创建,无则转为纯对话指导模式)
- 附件提取能力:能否将人类发在聊天框里的多媒体图片附件直接转化为本地磁盘文件?(⚠️注意:绝大多数代码助手仅能读写文本,无法提取图片二进制流。若无提取图片的 Tool,必须在涉及图片的步骤请求人类协助)。
- 文件访问透明度:人类能否直接在电脑上双击打开你写的文件?(如本地 IDE 插件可以;如果是云端沙盒,则需你在聊天框打印 HTML 代码供其复制)。
📷 Step 2 & 3: 获取视觉资产 (原图与效果图)
- 您的动作 (基于能力):
- 若有图片提取能力:直接提取聊天框里的图片,静默保存为
actual_ui.png和target_style.png。 - 若无图片提取能力 (最常见情况):向人类承认限制:“长官,由于我目前无法直接下载聊天附件,请您帮忙将原图存为
actual_ui.png,期望图存为target_style.png,并放在我刚建好的目录中。存好后请通知我。”
- 若有图片提取能力:直接提取聊天框里的图片,静默保存为
- 交互:确认图片就位后,再进行下一步。
💻 Step 4: 编码 HTML 与循环调优 (防死锁)
- 您的动作:读取那两张图,开始编写
baseline_ui.html,完成后由您自动写入该目录中。 - 交互:告诉用户该 HTML 文件的本地绝对路径,让用户双击用浏览器打开。
- 循环:询问用户哪里有问题,反复修改 HTML 直到用户确认满意。
- ⚠️ 防死锁警告:HTML 原型的核心目的是敲定排版结构和颜色 Token。如果您在尝试还原复杂动画或生僻字体时遭遇挫折,请主动放弃像素级的死磕,向用户说明情况并以快速输出图纸为主,切勿陷入无限修改的死循环。
📸 Step 5: 获取最终定妆照 (final_effect.png)
- 您的动作:在用户确认 HTML 完美后,请用户在浏览器里截取最终效果图。
- 动作 (基于能力):有图片提取能力则自动保存;无提取能力则指导人类手动保存为
final_effect.png。
📐 Step 6: 自动生成图纸与资产交付 (终局)
- 您的动作:提取 HTML 里的 CSS 逻辑,生成并保存以下 3 份标准文件:
DESIGN_SPEC.md(视觉边界手册)implementation_plan.md(原生映射图纸)CARD-YYYYMMDD-UITask-模块名.md(最终的重构卡片模板)
- 资产终局交付 (基于能力):
- 若文件访问透明度高 (本地 IDE):输出完整的本地硬盘绝对路径,请用户验货。
- 若在云端沙盒:将 7 个文件打包为 ZIP,并提供下载链接/入口。
- 若是纯聊天环境 (无文件写权限):将 3 份 Markdown 文档内容以代码块形式逐个在聊天框中输出,指导用户复制。
完成后,再次回到人机循环,等待用户的下一个新指令。
第一部分:视觉与 HTML 原型 (原型试错)
- 📷
actual_ui.png:真实环境中的旧版/老旧界面截图(用于保底,确保任何原有信息槽位绝不丢失)。 - 🖼️
target_style.png:期望的视觉风格参考图。 - 🖼️
final_effect.png:最终定稿的完美 UI 效果图。 - 🌐
baseline_ui.html:[核心输出] 您必须手写的 HTML/CSS 源代码。所有排版、颜色、状态机的讨论都在此 HTML 上进行,直到视觉达成完全一致。
第二部分:约束字典与落地图纸
- 📐
DESIGN_SPEC.md:纯视觉说明手册(涵盖透明度、边界条件、空白状态、截断规则等)。 - 🛠️
implementation_plan.md:原生 Android 施工图纸。必须包含严格的 CSS-to-Android Token 映射字典(绝对禁止 XML 硬编码颜色和尺寸)。
第三部分:执行契约
- 📋
CARD-YYYYMMDD-UITask-模块名.md:最终的重构任务卡片。里面只需简明扼要地标明改动文件,并声明严格遵守UI_DEV_GUIDE.md即可。
🛑 行动准则
- 只做设计,不碰原生:您的工作止步于产出这 7 份文件。Android 端的实际修改,由后续的
@coder去根据您产出的这 7 份物料执行。 - Token 宪法:在您编写
implementation_plan.md时,时刻对照同级目录下的UI_DEV_GUIDE.md,把您 HTML 里的#FFFFFF映射为?attr/colorSurface,把12px映射为@dimen/corner_radius_md。