AI 工具

工具总览

VortFlow 为 AI 员工提供 6 个工具，覆盖项目管理的核心操作：

工具名	功能	典型触发语
vortflow_create_project	创建项目	"帮我建一个项目"
vortflow_intake_story	录入需求	"录入一个需求：xxx"
vortflow_query	查询工作项	"查看当前待处理的 Bug"
vortflow_assign	分配负责人	"把这个任务分配给张三"
vortflow_update_progress	更新状态/进度	"这个需求评审通过了"
group_bind_project	群聊绑定项目	"绑定当前群到 XX 项目"

vortflow_create_project

创建一个新的研发项目。

参数	类型	必填	说明
name	string	是	项目名称
description	string	否	项目描述
prefix	string	否	工作项编号前缀（如 OV）

示例对话：

用户: 帮我创建一个项目，名字叫 OpenVort，前缀用 OV
AI:   好的，已创建项目"OpenVort"，编号前缀 OV。后续工作项将使用 OV-xxx 编号。

vortflow_intake_story

快速录入一条用户需求。AI 会自动帮用户结构化需求内容。

参数	类型	必填	说明
project_id	int	是	项目 ID
title	string	是	需求标题
description	string	否	需求描述
priority	string	否	优先级：low / medium / high / critical
children	array	否	子需求列表（用于需求拆分）

智能整理： 当用户描述零散时，AI 会先提炼标题和描述，再调用此工具。

用户: 我想让用户可以用手机号登录，要支持验证码，还有密码登录也要保留
AI:   我帮你整理一下：
      - 标题：用户登录支持手机验证码
      - 描述：在现有密码登录基础上，新增手机号 + 验证码登录方式
      - 优先级：中
      已创建 #OV-89。需要分配给谁？

vortflow_query

查询项目中的工作项，支持多维度筛选。

参数	类型	必填	说明
project_id	int	否	项目 ID（不传查所有项目）
type	string	否	类型：story / task / bug
status	string	否	状态过滤
assignee	string	否	负责人过滤
keyword	string	否	关键词搜索

用户: 目前有哪些待处理的 Bug？
AI:   当前项目有 3 个待确认缺陷：
      1. #BUG-45 - 导出报告格式错误（严重）
      2. #BUG-48 - 搜索结果分页异常（一般）
      3. #BUG-51 - 移动端样式错位（轻微）

vortflow_assign

将工作项分配给指定人员。

参数	类型	必填	说明
work_item_id	int	是	工作项 ID
assignee	string	是	负责人名称

AI 会通过通讯录插件将 IM 用户名映射到系统成员。

vortflow_update_progress

更新工作项的状态或进度。

参数	类型	必填	说明
work_item_id	int	是	工作项 ID
status	string	否	新状态
progress	int	否	进度百分比（0-100）
comment	string	否	进度说明

AI 自动遵守状态机规则，不允许跳步操作。

group_bind_project

将 IM 群聊与项目关联。

参数	类型	必填	说明
project_id	int	是	项目 ID

绑定后，AI 在该群聊中自动获得项目上下文，无需每次指定项目。