79 lines
3.1 KiB
Markdown
79 lines
3.1 KiB
Markdown
# {{任务编号}} 前端任务：{{任务标题}}
|
||
|
||
## 概述
|
||
|
||
{{一段描述：组件级交互目标}}
|
||
|
||
**前置依赖**: {{依赖任务列表}}
|
||
|
||
## tmux 执行协议
|
||
|
||
- **Session**: `arno-team`，始终复用 `项目` / `后端` / `前端` / `测试` 四个 pane，禁止新建 tmux session / window / pane
|
||
- **环境重置**: 开始前确保目标 pane 中是新启动的 `cc` 环境（/exit 后重启，清除遗留上下文）
|
||
- **分发方式**: 由 `项目` pane 发送简短提示词，让目标 pane 自行读取任务文件
|
||
|
||
## 前置文档（必读）
|
||
|
||
> 执行本任务前必须加载以下文档，作为设计和交互规范。
|
||
|
||
### 设计文档（所有前端任务通用）
|
||
- `docs/05-设计-UI.md` — 设计系统摘要（组件结构、设计令牌、色彩/排版/间距体系）
|
||
- `docs/设计-Apple风格.md` — Apple 风格设计令牌（色彩、排版、组件规范）
|
||
- `docs/设计-UX-错误处理.md` — 错误状态处理规范（错误提示样式/交互/文案）
|
||
|
||
### 编码规范（所有前端任务通用）
|
||
- `docs/11-工程规范.md` §6（前端开发规范：Svelte 5、组件设计原则、IPC 通信模式）
|
||
- `team/svelte.md` — Svelte 5 开发完整指南
|
||
|
||
### 按任务选取
|
||
| 任务 | UI 设计文档 | UX 交互文档 | API 契约 |
|
||
|------|-----------|-----------|---------|
|
||
| M2-002 | `docs/设计-UI-初始化向导.md` | `docs/设计-UX-用户旅程.md` §2.1, §2.2 + `docs/设计-UX-操作流程.md` §4.1 | `docs/09-API契约.md` §5 |
|
||
| M4-004 | `docs/设计-UI-主界面.md` | `docs/设计-UX-交互模式.md` + `docs/设计-UX-操作流程.md` §4.3 | `docs/09-API契约.md` §9.4、§9.5 |
|
||
| M4-005 | `docs/设计-UI-主界面.md` | `docs/设计-UX-交互模式.md` + `docs/设计-UX-操作流程.md` §4.3 | `docs/09-API契约.md` §9.7 |
|
||
| M5-003 | `docs/设计-UI-状态组件.md` | `docs/设计-UX-交互模式.md` §3.5, §3.8 | `docs/09-API契约.md` §6、§9.17 |
|
||
| M7-003 | `docs/设计-UI-主界面.md` | `docs/设计-UX-交互模式.md` + `docs/设计-UX-操作流程.md` §4.3 | — |
|
||
| M7-005 | `docs/设计-UI-认证.md` | `docs/设计-UX-操作流程.md` §4.2 | `docs/09-API契约.md` §9.16 |
|
||
| M8-004 | `docs/设计-UI-其他.md` | `docs/设计-UX-用户旅程.md` §2.5 + `docs/设计-UX-操作流程.md` §4.6 | — |
|
||
|
||
## 功能需求（FR-NNN ~ FR-NNN）
|
||
|
||
- {{需求条目}}
|
||
|
||
## 需要创建的文件
|
||
|
||
### 1. `src/lib/components/{{path}}/{{Component}}.svelte` — {{组件名}}
|
||
|
||
{{组件结构骨架（script + markup）}}
|
||
|
||
### 2. 其他文件
|
||
|
||
{{附加组件/类型定义/Store}}
|
||
|
||
## 设计系统（Apple 风格）
|
||
|
||
| 元素 | 规范 |
|
||
|------|------|
|
||
| {{设计令牌}} | {{值}} |
|
||
|
||
## 编码规范
|
||
|
||
- Svelte 5 runes 语法（$state, $derived, $effect, $props）
|
||
- TypeScript 类型注解，禁止 any
|
||
- CSS 使用设计令牌，参照 Apple 风格设计系统
|
||
- 完整指南参考 `team/svelte.md`
|
||
|
||
## 验收标准
|
||
|
||
- {{逐条检查}}
|
||
- 无控制台错误
|
||
|
||
## 验证命令
|
||
|
||
```bash
|
||
cd apps/desktop/frontend && npx svelte-check --tsconfig ./tsconfig.json
|
||
cd apps/desktop/frontend && npm run build
|
||
```
|
||
|
||
完成后将产出物清单写入 `/workspace/tasks/result/{{任务编号}}.md`。
|