快速开口
这页只解决一件事:第一次应该给人工智能哪些结构化输入,才不会让它跑偏。
第一句一定要说清 5 件事
| 必须说清什么 | 例子 |
|---|---|
| 产品情况 | 做什么业务、有哪些主要模块 |
| 输入来源 | 产品源 Git 仓、二开项目、文档目录、原型目录 |
| 当前对象 | 项目整体、模块名 |
| 目标状态 | 可开模块研发、可联调、可人工验收 |
| 人工边界 | 数据库方案、业务边界、验收口径、专项审批 |
起始输入模板:
text
产品情况是 <业务说明 / 模块范围>。
先判断当前属于 <产品源 Git 仓 / 二开项目 / 当前工作流仓>。
输入来源是 <来源仓 / 文档目录 / 原型目录>。
当前推进对象是 <项目整体 / 模块名>。
目标是推进到 <可开模块研发 / 可联调 / 可人工验收>。
数据库方案、业务边界、验收口径和专项审批这类必须人工决定的事项,再停下来问我。交给别人时直接用这几个例子
### 例子 1:全新项目,先整理项目基础text
### 例子 2:二开项目,先梳理现状 产品情况:
这是一个园区运营管理系统,当前先做商户管理、商铺管理、合同管理、收费管理 4 个模块。
项目情况:
这是新项目,当前工作流刚开始,很多基础资料还没有整理完整。
输入来源:
- 产品源 Git:<仓库地址>
- 产品文档目录:doc/产品输入/<项目名>/product/
- 原型目录:prototype/
当前对象:
项目整体
目标状态:
先把项目基础整理好,判断现在应该从哪个阶段开始推进。
人工边界:
数据库总设计评审结论、业务边界、专项审批由人确认。text
### 例子 3:只推进一个模块 产品情况:
这是一个已经上线的后台管理系统,本轮新增优惠券、积分商城、会员等级 3 个功能。
项目情况:
这是二开项目,仓库里已经有历史代码、历史菜单、历史接口和旧文档。
输入来源:
- 当前研发仓:<仓库地址>
- 产品补充文档目录:doc/产品输入/<项目名>/product/
- 原型目录:prototype/
当前对象:
项目整体
目标状态:
先梳理现状,确认当前项目应该从哪个阶段继续推进,不要直接改代码。
人工边界:
旧功能是否重构、数据库是否改历史表、验收范围由人拍板。text
### 例子 4:小程序模块,但端型由产品定义 产品情况:
当前只推进“商户入驻审核”模块,涉及审核列表、审核详情、通过驳回、材料查看。
项目情况:
项目基础已经有了,现在进入模块推进阶段。
输入来源:
- 模块产品文档:doc/产品输入/<项目名>/product/商户入驻审核.md
- 模块原型:prototype/
- 当前项目配置:.contract/project.json
当前对象:
商户入驻审核模块
目标状态:
先判断这个模块当前应该从哪个阶段开始,如果前置资料没收敛就先补齐,再推进。
人工边界:
审核规则、驳回原因口径、最终验收口径由人确认。text
产品情况:
当前推进预约下单模块,产品里明确这是小程序模块,但具体端型要以产品文档和任务契约定义为准。
项目情况:
项目基础已存在,现在推进模块。
输入来源:
- 模块产品文档:doc/产品输入/<项目名>/product/预约下单.md
- 原型目录:prototype/
- 项目配置:.contract/project.json
当前对象:
预约下单模块
目标状态:
先判断它当前应从哪个阶段开始;如果产品还没把端型定义清楚,就先停在模块资料收敛,不要自行扩写。
人工边界:
小程序端型归属、业务边界、验收口径由人确认。最稳的起手方式
项目整体
- 先提供产品情况、项目情况和输入来源
- 如果当前还是新项目、基础资料还不完整,先让 AI 整理项目基础
- 先判断当前属于产品源 Git、二开项目,还是当前工作流仓
- 如果项目门禁或数据库总设计评审未通过,停在前置阶段
某个模块
- 指定当前推进的
<模块名> - 先判断它当前应从哪个阶段开始
- 如果前置资料未收敛,先补齐
- 条件满足后再推进到目标状态
如果涉及小程序,再补一句
- 先判断它是不是小程序模块
- 具体端型不预设,先按产品文档和任务契约定义
- 只有产品已经定义具体端型时,才按对应原型和代码目录推进产出
- 端型已定义后,再落到对应目录:
mini/<按项目约定的端型目录>/ - 对应原型目录再看产品输入映射,由产品文档和任务契约确认
需要完整收口
- 对
<模块名>做完整收口 - 不停在代码修改完成
- 必须同时补齐阶段、验证、风险、阻塞和下一步
- 目标是达到可人工验收状态
什么时候应该立刻打断
- 它跳过阶段判断直接开写。
- 它连产品情况和项目情况都没整理就开始写模块。
- 它不提数据库设计和评审。
- 它只看代码,不看产品输入。
- 它脱离产品定义,自己先把小程序端型定死。
- 它没有验证证据就说完成。
- 它把必须人工拍板的事情自己定了。
最短的一句话
text
先判断当前阶段,再推进到目标状态;如果前置条件不满足,就先补齐缺口,不要直接开发。