---
name: easyai-submit-task
description: 将 EasyAI 产品需求或 Bug 规范登记到指定飞书多维表格。当用户说“提需求”“新建需求”“报 Bug”“反馈问题”“登记产品任务”或要把产品想法提交给 Codex 处理时使用。
---

# EasyAI 提需求/报 Bug

## 执行流程

1. 读取 [intake-rules.md](references/intake-rules.md) 判断类型和必填信息。
2. 检查用户已给出的信息。每轮最多追问 3 个对验收有实质影响的问题，不询问仓库、分支或技术方案。
3. 按 [base-schema.md](references/base-schema.md) 构造 JSON，通过 stdin 传给 `scripts/prepare-intake.mjs`。
4. 展示脚本返回的中文预览。必须等待用户明确说“确认提交”或等价表达。
5. 确认后，将同一 JSON 通过 stdin 传给 `scripts/submit-intake.mjs --confirm <confirmation_token>`。
6. 返回提交回执、幂等键和处理状态。任务编号由中央调度器在下一次扫描时生成并通过飞书通知。

## 命令

```bash
printf '%s' '<json>' | node scripts/prepare-intake.mjs
printf '%s' '<json>' | node scripts/submit-intake.mjs --confirm '<confirmation_token>'
```

`submit-intake.mjs` 使用当前电脑已授权的飞书用户身份提交企业内受控表单，不要要求用户提供 token、Cookie 或密码。

## 安全边界

- 只能通过受控表单写入 [base-schema.md](references/base-schema.md) 列出的产品字段。
- 禁止写入任务编号、任务状态、执行阶段、状态版本、Thread、PR、部署、验收、锁、重试和审计字段。
- 不经用户确认不得运行提交脚本。
- 附件必须是当前工作目录内的相对路径；不得读取或上传其他文件。
- 提交失败时保留原输入并报告结构化错误，不得改写产品意图后自动重试。

## 返回规则

- 信息不完整：只返回下一组最多 3 个问题。
- 待确认：展示类型、标题、背景、验收标准、优先级和附件。
- 提交成功：返回提交回执并明确说明“已登记，等待系统分配任务编号”。
- 飞书授权不足：原样返回缺失 scope 及授权提示，不改用 bot 身份。