📑 目录

1. 第一步：先别急着写代码，把需求聊成人话
2. 第二步：把需求拆成 AI 能听懂的小任务
3. 第三步：防翻车小技巧
4. 总结

💡 先说结论

最终成品像这样：https://wxaiway.com/xiaodaren
很多人以为喊一句“帮我做口算题生成器”，就万事大吉。
真干起来才发现：需求越来越多，代码越来越胖，连自己都忘了到底想打印几页 A4。

1️⃣ 先别急着写代码，把需求聊成人话

小学生的口算题型五花八门，除了直接算，还有这些小把戏：

• 直接算：2 + 3 = ___
• 填运算符：□ 1 □ 3 = 4
• 比大小：5 □ 2
• 填数字：□ + 4 = 7

⚠️ 提示：想清楚功能点，避免出现“超纲大题”或者“奇怪的负数计算”。

和 AI 聊的时候，可以用这个模板：

  我想开发一个【口算题生成系统】。  
背景
小学生需要每天练习口算，家长和老师希望快速生成可打印题目。
核心功能

根据年级和月份选模板
自定义数字范围和运算符
生成 PDF，可直接打印
支持中文符号：□、○

技术要求

前端：纯 HTML/CSS/JS
后端：Python + FastAPI
PDF 生成：ReportLab
部署：Docker 可直接运行

用户界面
描述页面布局，最好有草图
API 设计
列主要接口
数据结构
题目模板、题型配置
特殊要求
中文支持、打印优化
优先级

核心功能
次要功能
可选功能

⚡ 效果：把需求讲清楚，开发效率瞬间提高 N 倍。

2️⃣ 把需求拆成 AI 能听懂的小任务

1. 项目概述

• 系统：口算题生成器
• 用户：小学教师和家长
• 核心功能：模板选择、题目参数自定义、生成 PDF
• 技术：前端 HTML/JS，后端 FastAPI，PDF ReportLab

2. 功能拆解

前端

• 模板列表：按年级和月份筛选
• 参数配置：页数、题目数量、题型开关
• 高级设置：PDF标题、学生信息
• 交互：选择模板自动预览，生成 PDF 显示进度条

后端 API

• GET /templates：获取模板列表
• POST /generate/{template_name}：生成 PDF
• GET /sample/{template_name}：获取样题

数据结构

• 模板包含标题、年级、月份、题型配置
• 题型包括算术题、填空题、比较题等

3. 技术细节

• 中文支持（方正楷体 + □ ○ 符号）
• PDF 排版：A4，多列布局，页眉包含标题和学生信息
• 题目生成：避免重复，结果在指定范围
• 性能优化：流式 PDF 生成，前端 PDF.js 预览

4. 示例

• 一年级 9 月模板：5 以内加减法

• 题型示例：

  • 直接算：1 + 4 = ___
  • 填运算符：2 □ 2 = 4
  • 比较大小：3 □ 2
  • 填数字：□ + 1 = 5

• 布局参考：卡片式设计，紫色渐变风格

3️⃣ 防翻车小技巧

1. 循序渐进：先核心功能，再加花里胡哨的设置

小步快跑，否则上一轮辛苦做好的功能会被新需求打回原形

2. 给示例：输入输出示例越具体，AI 越容易理解

比如：“生成 2 页，每页 50 题，题型包括 1+□、□+1、3 □ 2。”

3. 及时反馈：发现问题要立即说明

例如：“我传 pages=2，但只生成 1 页，每页 50 题，日志如下…”

4. 保存上下文：用 CLAUDE.md 记录项目约定

下次中断恢复，AI 不会忘记方向

5. 明确优先级：哪些必须做，哪些暂时放一边

4️⃣ 总结

全程只抓三件事：

1. 需求聊清楚
2. 功能拆小步
3. 上下文留底稿

照着这个流程走，你也能 10 秒钟生成一份 PDF 口算题，保证小学生练得开心，家长省心，自己也不被“翻车”。

参考文章链接：https://www.feishu.cn/community/article?id=7553195481057198083&filterTags=7402137802504142852-7402137804089589763