docs(ui): add user stories and interaction checklists

2026-07-17 09:18:42 +08:00
parent 123849f5ee
commit 93cfb165c3
12 changed files with 229 additions and 20 deletions
@@ -19,6 +19,7 @@
 | [`docs/00-ai-start-here.md`](docs/00-ai-start-here.md) | AI coding agent 的入口、阅读顺序、任务领取规则 |
 | [`docs/01-vision.md`](docs/01-vision.md) | 项目为什么做、为谁做、什么不做 |
 | [`docs/02-requirements.md`](docs/02-requirements.md) | 产品需求、用户故事、验收标准 |
+| [`docs/07-user-stories.md`](docs/07-user-stories.md) | 用户目标、业务价值、验收场景与 US / IX 追踪 |
 | [`docs/03-tech-stack.md`](docs/03-tech-stack.md) | 技术选型和运行命令 |
 | [`docs/04-architecture.md`](docs/04-architecture.md) | 系统结构、职责边界、数据模型、开发顺序 |
 | [`docs/05-coding-rules.md`](docs/05-coding-rules.md) | AI 写代码前必须遵守的硬规则 |
@@ -27,6 +28,7 @@
 | [`docs/adoption-checklist.md`](docs/adoption-checklist.md) | 已有项目接入 harness 文档的迁移清单 |
 | [`docs/api.md`](docs/api.md) | API 合约模板 |
 | [`docs/routes.md`](docs/routes.md) | 页面路由、组件归属、导航规则 |
+| [`docs/08-interaction-checklist.md`](docs/08-interaction-checklist.md) | UI 交互、状态反馈、无障碍与验收证据 |
 | [`docs/clean-state-checklist.md`](docs/clean-state-checklist.md) | 会话收尾检查清单，保证下一轮无需人工修复即可开工 |
 | [`docs/current-state.md`](docs/current-state.md) | 当前实现状态快照，防止计划和代码现实脱节 |
 | [`docs/agent-context.json`](docs/agent-context.json) | 机器可读上下文路由：最小必读、任务类型和 SHA 刷新规则 |
@@ -67,7 +69,7 @@

 新项目从零开始时，建议复制根目录入口文件和 `docs/` 目录（含 `docs/tasks/`），并按操作系统选择 `init.sh` 或 `init.ps1`。复制后按顺序处理：

-1. 从 `docs/01-vision.md` 和 `docs/02-requirements.md` 开始替换业务内容。
+1. 从 `docs/01-vision.md` 和 `docs/02-requirements.md` 开始替换业务内容；有 UI / UX 时，同时完成 `docs/07-user-stories.md` 和 `docs/08-interaction-checklist.md`。
 2. 在 `docs/03-tech-stack.md` 固定技术选型，不确定的选项标为待定。
 3. 在 `docs/04-architecture.md` 写清事实来源、数据模型、系统边界。
 4. 在 `docs/06-tasks.md` 拆出阶段路线图和建议任务；开工时按 `docs/tasks/README.md` 把任务落成 `docs/tasks/T-<编号>.md`，要求 AI 每轮只领取一个任务。