码上飞AI开发需求怎么写_码上飞AI需求描述入门指南

夏敏酱_2798

夏敏酱_2798

2026-11-22

541人浏览

原创

码上飞AI需按专业角色(如Python后端工程师)明确目标、输入输出、行为边界及异常处理:输入含手机号与6位验证码,输出含user_id和7天JWT token;必须调用指定接口、用Redis存token并脱敏密码;禁止连MySQL、不写前端和未授权API;须处理格式错误、过期、Redis失败三类异常。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

码上飞ai开发需求怎么写_码上飞ai需求描述入门指南

想让码上飞AI准确理解你要做的功能,不是简单写“做个智能客服”,而是要像给同事交代任务一样说清输入、输出、边界和异常——否则模型可能按字面意思生成完全跑偏的代码。

明确角色与目标

第一步:用一句话定义AI在这次任务中扮演什么角色。例如:“你是一个Python后端开发工程师,正在为微信小程序写一个用户登录接口。”不能写“你是个AI助手”,这会让模型失去专业语境约束。

第二步:紧接着写出这个角色要达成的具体业务目标。例如:“该接口需接收手机号+短信验证码,校验通过后返回用户ID和7天有效期的JWT token。”目标必须可验证,不能出现“尽量”“大概”“友好提示”这类模糊词。

注意:如果目标里含主观判断(如“界面美观”“响应快”),必须量化。比如把“响应快”改成“首屏渲染时间≤300ms”,否则码上飞无法生成可测试的实现逻辑。

描述输入与输出

方法一:用字段列表写清输入参数

在请求体(JSON)中列出每个字段名、类型、是否必填、示例值、约束条件。例如:"code": {"type": "string", "required": true, "minLength": 6, "maxLength": 6, "description": "短信验证码,纯数字字符串"}。漏掉 minLength/maxLength 会导致生成的校验逻辑缺失,上线后被刷验证码攻击。

方法二:用真实样例代替抽象描述

直接贴一段典型输入和对应期望输出。输入:{"phone": "13800138000", "code": "123456"};输出:{"user_id": 1024, "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."}。样例比文字描述更不容易歧义,尤其对嵌套结构或特殊格式(如时间戳、base64图片)效果显著。

划定行为边界

说明哪些事AI**绝对不能做**,哪些事**必须做**。

码上飞
码上飞

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

下载

必须做:调用 【/api/v1/sms/verify】 接口校验短信码;使用 Redis 存储 token 并设置 7 天过期;密码字段在日志中必须脱敏为 "***"。

禁止做:不连接 MySQL 用户表;不生成前端页面;不调用任何未声明的第三方 API;不写单元测试代码(除非你明确要求)。

这一步没写清楚,生成的代码很可能引入未授权的数据源或冗余模块,增加安全审计风险。

处理异常与边缘情况

列出至少三个具体异常场景及对应返回:

① 手机号格式错误 → 返回 HTTP 400,body 含 {"error": "invalid_phone_format", "message": "手机号应为11位数字"}

② 验证码已过期 → 返回 HTTP 401,body 含 {"error": "code_expired", "message": "验证码已失效,请重新获取"}

③ Redis 写入失败 → 返回 HTTP 503,body 含 {"error": "service_unavailable", "message": "认证服务暂时不可用"}。这三类错误覆盖了参数层、业务层、基础设施层,缺一不可。

方法三:用“当……时,应该……”句式补全隐性规则。例如:“当用户首次注册时,应该自动创建用户记录并返回 user_id;当用户已存在时,不应重复插入。”

相关专题

更多
Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

20

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

20

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

60

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

40

10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

40

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

80

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习