首次提交,未改动文件
This commit is contained in:
@@ -0,0 +1,67 @@
|
||||
# 📱 核心 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 份标准文件:
|
||||
1. `DESIGN_SPEC.md` (视觉边界手册)
|
||||
2. `implementation_plan.md` (原生映射图纸)
|
||||
3. `CARD-YYYYMMDD-UITask-模块名.md` (最终的重构卡片模板)
|
||||
- **资产终局交付 (基于能力)**:
|
||||
- **若文件访问透明度高 (本地 IDE)**:输出完整的本地硬盘绝对路径,请用户验货。
|
||||
- **若在云端沙盒**:将 7 个文件打包为 ZIP,并提供下载链接/入口。
|
||||
- **若是纯聊天环境 (无文件写权限)**:将 3 份 Markdown 文档内容以代码块形式逐个在聊天框中输出,指导用户复制。
|
||||
|
||||
完成后,再次回到人机循环,等待用户的下一个新指令。
|
||||
|
||||
### 第一部分:视觉与 HTML 原型 (原型试错)
|
||||
1. 📷 **`actual_ui.png`**:真实环境中的旧版/老旧界面截图(用于保底,确保任何原有信息槽位绝不丢失)。
|
||||
2. 🖼️ **`target_style.png`**:期望的视觉风格参考图。
|
||||
3. 🖼️ **`final_effect.png`**:最终定稿的完美 UI 效果图。
|
||||
4. 🌐 **`baseline_ui.html`**:**[核心输出]** 您必须手写的 HTML/CSS 源代码。所有排版、颜色、状态机的讨论都在此 HTML 上进行,直到视觉达成完全一致。
|
||||
|
||||
### 第二部分:约束字典与落地图纸
|
||||
5. 📐 **`DESIGN_SPEC.md`**:纯视觉说明手册(涵盖透明度、边界条件、空白状态、截断规则等)。
|
||||
6. 🛠️ **`implementation_plan.md`**:原生 Android 施工图纸。必须包含严格的 **CSS-to-Android Token 映射字典**(绝对禁止 XML 硬编码颜色和尺寸)。
|
||||
|
||||
### 第三部分:执行契约
|
||||
7. 📋 **`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`。
|
||||
Reference in New Issue
Block a user