Zion平台需按三步规范描述组件需求:一明确组件类型与用途,二列出数据来源与字段依赖,三说明交互边界与异常路径;否则Cursor易生成偏离业务逻辑的代码。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Zion平台用自然语言描述组件需求时,不按规范写容易让Cursor生成偏离业务逻辑的代码,比如漏掉权限校验、错配数据表字段、或把前端交互写成后端API调用。
Zion官方推荐的需求描述结构
第一步:明确组件类型与核心用途
例如:“开发一个游客端的景点预约抽屉组件”,不能只说“做个预约功能”——【“游客端”限定了用户角色,“抽屉”明确了交互形态,“景点预约”锚定了业务实体】。
第二步:列出关键数据来源与字段依赖
例如:“需从‘景点’表读取名称、开放时间、最大预约人数;从‘预约记录’表实时校验当前时段余量;状态变更需同步更新‘用户行程’表”。这一步缺失会导致AI默认用mock数据,上线即报错。
第三步:说明交互边界与异常路径
例如:“点击‘立即预约’后,先校验登录态→再检查时段是否可约→若余量为0则弹出‘已约满’toast并禁用按钮→成功后自动关闭抽屉并刷新首页卡片”。很多用户只写正常流程,结果生成的组件在未登录时直接崩溃。
三种常见错误写法及修正
方法一:模糊泛化型(错误)
“做一个好看的预约页面”
→ 问题:无角色、无数据源、无状态流转,Cursor会生成纯静态HTML+随机占位图。
方法二:技术指令型(错误)
“用React写个Modal,里面放Formik表单,提交走GraphQL mutation”
→ Zion不鼓励指定技术实现,AI会忽略业务语义,强行套模板,导致与Zion MCP数据模型不兼容。
方法三:碎片罗列型(错误)
“要能选日期、选人数、显示余量、弹提示、刷新首页”
→ 缺少动词主语和触发条件,AI无法判断“谁在什么条件下执行什么动作”,生成的逻辑链断裂。
一句话快速自查模板
把你的需求描述套进这句话:“【谁】在【什么场景】下,通过【什么操作】,基于【哪些真实数据表字段】,完成【什么业务动作】,并处理【哪几种异常情况】。”填不满任意一项,就需补全。











