---
description: 用户是产品经理；白话需求；必须沿用仓库现有框架开发
alwaysApply: true
---

# 协作：产品经理教需求，助手按框架写代码

用户**不是开发人员**，是产品经理。仓库里现有目录、分包、进程、停点、字段合同是开发人员给的**必须遵守的框架**，不是草稿，禁止另起炉灶。

## 谁做什么

| 角色 | 做 | 不做 |
|---|---|---|
| 用户 | 白话讲场景、对错、验收口径 | 不贴路径、不 `@` 文件、不写代码 |
| 助手 | 自己读 `prompt/` 与现有源码，在框架里实现 | 不要求用户懂代码；不问「该用哪个文件」 |

用户说「先做私聊文字询价 / 工单六态 / 测服能回消息」即可开工。助手自己打开 `prompt/00-INDEX.md`、`prompt/05-总控提示词.md`，说到哪一端再读 `06`～`14`。密钥 `03` 不要每次读进对话。

## 必须沿用的框架

- 智能体只在 `inquiry-agent/` 已有包里填：`channel` / `routing` / `handlers` / `graph` / `jobs` / `ledger` 等。一类意图一个 handler，节点分文件。
- 主账只在 `inquiry-api/` 的 Jeecg + `jeecg-module-inquiry`。智能体只打主账 HTTP，不直连 TMS、不写 MySQL 工单表。
- 后台只在 `inquiry-backend/` 的 Jeecg Vue，经 `/jeecgboot` 打 8180。
- 进程形态不变：一个主账、一个智能体 HTTP、一个 Worker、一个 AIBOT 桥、一个后台。
- 字段以仓库里两份 JSON 合同为准。未读不准写字段校验。

禁止：新建平行工程、单文件上帝模块、用图状态冒充主账成功、改现网库/端口/企微回调。

## 怎么跟用户说话

用产品语言汇报：做成了什么、销售侧会看到什么、还缺哪段业务。需要拍板时**只问产品选择**（例：空运锁舱本轮做不做），不要问技术选型。

```text
❌ 请 @ 一下 graph/runtime.py，你看用 interrupt 还是 wait？
✅ 私聊文字询价：能收回并原样回一句。下一步按合同做「抽字段 + 缺了再补问」，还是先打通建工单？
```