Skip to content

快速开口

这页只解决一件事:第一次应该给人工智能哪些结构化输入,才不会让它跑偏。

第一句一定要说清 5 件事

必须说清什么例子
产品情况做什么业务、有哪些主要模块
输入来源产品源 Git 仓、二开项目、文档目录、原型目录
当前对象项目整体、模块名
目标状态可开模块研发、可联调、可人工验收
人工边界数据库方案、业务边界、验收口径、专项审批

起始输入模板:

text
产品情况是 <业务说明 / 模块范围>。
先判断当前属于 <产品源 Git 仓 / 二开项目 / 当前工作流仓>。
输入来源是 <来源仓 / 文档目录 / 原型目录>。
当前推进对象是 <项目整体 / 模块名>。
目标是推进到 <可开模块研发 / 可联调 / 可人工验收>。
数据库方案、业务边界、验收口径和专项审批这类必须人工决定的事项,再停下来问我。

交给别人时直接用这几个例子

### 例子 1:全新项目,先整理项目基础
text
产品情况:
这是一个园区运营管理系统,当前先做商户管理、商铺管理、合同管理、收费管理 4 个模块。

项目情况:
这是新项目,当前工作流刚开始,很多基础资料还没有整理完整。

输入来源:
- 产品源 Git:<仓库地址>
- 产品文档目录:doc/产品输入/<项目名>/product/
- 原型目录:prototype/

当前对象:
项目整体

目标状态:
先把项目基础整理好,判断现在应该从哪个阶段开始推进。

人工边界:
数据库总设计评审结论、业务边界、专项审批由人确认。
### 例子 2:二开项目,先梳理现状
text
产品情况:
这是一个已经上线的后台管理系统,本轮新增优惠券、积分商城、会员等级 3 个功能。

项目情况:
这是二开项目,仓库里已经有历史代码、历史菜单、历史接口和旧文档。

输入来源:
- 当前研发仓:<仓库地址>
- 产品补充文档目录:doc/产品输入/<项目名>/product/
- 原型目录:prototype/

当前对象:
项目整体

目标状态:
先梳理现状,确认当前项目应该从哪个阶段继续推进,不要直接改代码。

人工边界:
旧功能是否重构、数据库是否改历史表、验收范围由人拍板。
### 例子 3:只推进一个模块
text
产品情况:
当前只推进“商户入驻审核”模块,涉及审核列表、审核详情、通过驳回、材料查看。

项目情况:
项目基础已经有了,现在进入模块推进阶段。

输入来源:
- 模块产品文档:doc/产品输入/<项目名>/product/商户入驻审核.md
- 模块原型:prototype/
- 当前项目配置:.contract/project.json

当前对象:
商户入驻审核模块

目标状态:
先判断这个模块当前应该从哪个阶段开始,如果前置资料没收敛就先补齐,再推进。

人工边界:
审核规则、驳回原因口径、最终验收口径由人确认。
### 例子 4:小程序模块,但端型由产品定义
text
产品情况:
当前推进预约下单模块,产品里明确这是小程序模块,但具体端型要以产品文档和任务契约定义为准。

项目情况:
项目基础已存在,现在推进模块。

输入来源:
- 模块产品文档:doc/产品输入/<项目名>/product/预约下单.md
- 原型目录:prototype/
- 项目配置:.contract/project.json

当前对象:
预约下单模块

目标状态:
先判断它当前应从哪个阶段开始;如果产品还没把端型定义清楚,就先停在模块资料收敛,不要自行扩写。

人工边界:
小程序端型归属、业务边界、验收口径由人确认。

最稳的起手方式

项目整体

  • 先提供产品情况、项目情况和输入来源
  • 如果当前还是新项目、基础资料还不完整,先让 AI 整理项目基础
  • 先判断当前属于产品源 Git、二开项目,还是当前工作流仓
  • 如果项目门禁或数据库总设计评审未通过,停在前置阶段

某个模块

  • 指定当前推进的 <模块名>
  • 先判断它当前应从哪个阶段开始
  • 如果前置资料未收敛,先补齐
  • 条件满足后再推进到目标状态

如果涉及小程序,再补一句

  • 先判断它是不是小程序模块
  • 具体端型不预设,先按产品文档和任务契约定义
  • 只有产品已经定义具体端型时,才按对应原型和代码目录推进产出
  • 端型已定义后,再落到对应目录:mini/<按项目约定的端型目录>/
  • 对应原型目录再看产品输入映射,由产品文档和任务契约确认

需要完整收口

  • <模块名> 做完整收口
  • 不停在代码修改完成
  • 必须同时补齐阶段、验证、风险、阻塞和下一步
  • 目标是达到可人工验收状态

什么时候应该立刻打断

  • 它跳过阶段判断直接开写。
  • 它连产品情况和项目情况都没整理就开始写模块。
  • 它不提数据库设计和评审。
  • 它只看代码,不看产品输入。
  • 它脱离产品定义,自己先把小程序端型定死。
  • 它没有验证证据就说完成。
  • 它把必须人工拍板的事情自己定了。

最短的一句话

text
先判断当前阶段,再推进到目标状态;如果前置条件不满足,就先补齐缺口,不要直接开发。