learning-assistant-builder

The saved excerpt is a snapshot from when this skill was listed. The external source remains the complete and most current version.

---
name: learning-assistant-builder
description: Build student-friendly learning assistant web projects through a required Chinese Q&A workflow. Use when the user says "我想创造一个学习助手" or asks to create a learning assistant, AI tutor, study helper, homework coach, quiz practice app, mistake notebook, learning planner, or similar educational web app. The workflow must ask questions first, confirm before generating a design document, confirm again before implementing, and strictly apply Vite auto-port startup requirements.
---

# Learning Assistant Builder

Use Chinese by default.

For reuse outside Codex, use `references/portable-agent-prompt.md` as the self-contained portable prompt. It can be pasted into another Agent tool's system prompt, custom instruction, workflow node, or role definition.

## 必须保留的触发与流程

- 该 skill 接收到“我想创造一个学习助手”后开启调用，调用后按照以下提示词的流程进行问答交流，全部问答结束后请求用户确认后生成设计文档，再请求用户确认后开始执行生成项目，项目生成严格按照提示词中的要求进行，最终明确指明如何进行项目展示，例如启动文件的名称和网址，越直接明了越好。
- 在问答交流环节，如若收到“停止”指令，则自动按照主流设计理念直接补充剩下的部分，不占用多余时间。

## 执行顺序

1. 当用户说“我想创造一个学习助手”或表达同等需求时，先进入问答交流。
2. 问答交流结束后，必须新增一个提问，确认这个应用的使用逻辑。
3. 使用逻辑确认后，必须请求用户确认是否生成设计文档。
4. 只有用户确认后，才生成设计文档。
5. 设计文档生成后，必须再次请求用户确认是否开始执行生成项目。
6. 只有用户确认后，才开始创建或修改项目文件。
7. 生成项目代码部分必须以 15 分钟内完成为目标进行时间盒控制，并严格执行“15 分钟代码生成优化要求”。
8. 生成项目时，必须调用 `design-taste-frontend` 和 `ui-ux-pro-max` 两个 skill 来提升界面设计质量。
9. 生成项目时，必须严格执行下面“端口自动适配与一次启动成功要求”。
10. 最终回复必须明确指明如何展示项目，包括启动文件名称和网址说明；启动命令和网址说明必须放在整个回复最后。

## 问答交流要求

- 问答交流必须是引导式、开放式、自然对话，不是问卷、表格、选择题或需求清单。
- 每一轮优先只问 1 个核心问题；确实必要时最多问 2 个，不要一次性把多个方向全部抛给用户。
- 不要给具体选项让用户选择，例如不要写“A/B/C”、不要写“你可以选择……”、不要列出一串可选功能、年级、学科、风格或页面。
- 不要用“请选择”“以下选项”“你更偏向哪一种方案”这类话术，除非用户主动要求你给选项。
- 开启问答后的第一轮必须围绕“学科方向”提问，并且只问一个开放问题。
- 第一轮推荐使用：“为了先把学习方向定下来，我们先从学科聊起：你希望这个学习助手主要陪学生学习哪一门或哪一类内容？可以用一句话描述你心里的学习场景。”
- 不要把第一轮问题写成学科选项列表；让用户自由描述学科、课程或跨学科方向。
- 每次必须先提问获取用户回答，再基于用户回答给出理解、建议或推荐；不要在用户回答前主动推荐方案。
- 用户回答后，先用一句话确认理解；如果需要推荐，只能推荐与该回答直接相关的内容，然后继续问下一个自然问题。
- 不要在信息不足时直接生成设计文档或项目。
- 如果用户回复“停止”，立刻停止追问，按照主流设计理念补齐剩余需求，并进入“请求用户确认是否生成设计文档”的步骤。

## 问答覆盖范围

问答交流结束前，必须尽量确认以下内容。不要把这些内容一次性列给用户；应按照自然对话逐轮提问：

1. 学科方向：学习助手主要服务哪门学科、课程或跨学科内容。
2. 实际问题：学生当前最需要解决的具体学习痛点、卡点或任务。
3. 使用对象：学生年龄、年级、基础水平、学习习惯，以及是否面向老师或家长辅助使用。
4. 使用场景：课堂演示、课后练习、作业辅导、考试复习、自主学习、社团项目或其他真实场景。
5. 功能范围：围绕用户回答提炼必要功能，不要提前塞功能清单；必须区分核心功能和可后置功能。
6. 页面布局：根据已确认的学习流程讨论页面组织方式，例如主界面、练习区、记录区、计划区等，但不要先给模板式选项。
7. 设计风格：根据使用对象和场景引导确认视觉气质、信息密度、互动感和课堂展示效果。
8. MVP 实现部分：确认第一版必须完成的最小可用范围，保证能运行、能展示、能体现学习助手核心价值。
9. 迭代部分：确认后续可以增强的方向，例如真实 AI 接口、上传资料、个性化学习档案、教师端、数据统计等。

推荐顺序：

1. 先问学科方向。
2. 再问实际问题。
3. 再问使用对象。
4. 再问使用场景。
5. 基于前四项回答，再引导功能范围、页面布局、设计风格、MVP 和迭代部分。

在功能、布局、风格、MVP、迭代部分，必须先让用户描述想法或约束，再根据回答做推荐。推荐时用“基于你刚才说的……”开头，避免凭空给方案。

## 使用逻辑确认

问答交流结束后、请求生成设计文档前，必须单独确认应用的使用逻辑。

这一轮提问必须帮助用户确认：

- 用户打开应用后第一步做什么
- 用户如何输入或选择学习任务
- 学习助手如何给出讲解、练习或反馈
- 用户如何查看结果、记录或下一步学习建议
- 一次完整学习流程如何结束

不要直接替用户定稿。先用一句话概括你根据前面问答理解到的使用逻辑，再用开放式问题请用户确认或修正。

推荐问法：

```text
在生成设计文档前，我想先确认一下这个应用的使用逻辑：我理解的是，学生进入应用后先说明自己要学习的问题，系统再引导讲解和练习，最后沉淀记录或下一步建议。这个流程符合你的想法吗？你希望学生实际使用时还有哪些关键步骤？
```

## 设计文档要求

用户确认后，生成一份清晰、可执行的设计文档，至少包含：

- 项目名称和定位
- 学科方向
- 实际问题
- 目标用户
- 使用场景
- 核心功能
- 页面结构
- 设计风格
- 响应式设计策略
- 交互流程
- 应用使用逻辑
- MVP 实现范围
- 页面数量与功能对应关系
- 每个页面的核心任务
- 后续迭代方向
- 技术方案
- 15 分钟内代码生成策略
- 端口与启动方案
- 项目验收标准

设计文档完成后，必须请求用户确认是否开始执行生成项目。

## 默认快速技术栈

新建项目默认采用轻量技术栈，以降低生成、构建和修复时间：

- Vite
- TypeScript
- Tailwind CSS
- 原生 Hash 路由或轻量视图切换

默认引入 Tailwind CSS 来提升 UI 质量和响应式效率。不默认引入 React/shadcn，不引入第三方路由库，不引入状态管理库，不引入后端、数据库或登录系统。

如果用户明确要求 React/Vue 等框架，或当前已有项目已经使用这些框架，可以沿用现有技术栈；否则必须优先使用上述轻量技术栈。

## 15 分钟代码生成优化要求

项目代码生成阶段必须以 15 分钟内完成为目标，不追求一次性做完整产品。必须优先保证项目能运行、能展示、界面好看、流程闭环。

执行时必须遵守：

- 严格做 MVP，不把迭代部分提前实现。
- 只实现一个完整学习闭环：进入应用、输入学习问题、获得讲解或练习、看到反馈或记录、知道下一步。
- 使用本地模拟数据和本地模拟学习助手逻辑；除非用户已经明确提供真实 API 信息，否则不要接入真实 AI API。
- 不做登录注册、数据库、后端服务、复杂权限、复杂文件上传、教师端、长期学习档案、复杂数据统计等耗时功能；这些内容放入迭代部分。
- 优先使用 Vite 原生 TypeScript + Tailwind CSS 项目和已有依赖，不引入大型 UI 框架或复杂状态管理，除非项目已存在并正在使用。
- 必须做响应式设计，至少覆盖手机竖屏、平板/窄屏和桌面宽屏；核心学习流程在移动端和桌面端都必须可用。
- 页面数量按照设计文档确定，不得影响主要功能实现。
- 每个页面必须服务设计文档中的核心功能或完整使用逻辑；不要为了“看起来完整”创建空页面或弱功能页面。
- 如果 1 页能完整承载核心学习闭环，就做 1 页；如果核心功能天然分离，就用多个轻量页面或视图；如果设计文档需要更多页面，优先保证主要功