team-collaboration（团队协作）

Team Collaboration Skill

企业级团队协作管理系统，支持项目管理、需求管理、任务管理，Bug跟踪、文档管理和里程碑管理。

API Base URL

• 后端: http://localhost:8080
• 前端: http://localhost:12345

功能模块

• 👥 用户认证与权限管理
• 📁 项目管理
• 📝 需求管理（支持优先级 P0-P3）
• ✅ 任务管理（支持工时记录）
• 🐛 Bug跟踪（支持严重程度和状态流转）
• 📄 文档管理（支持版本管理）
• 📅 里程碑管理
• 💬 话题讨论
• 🔔 通知系统

Actions (43个)

认证模块

auth_register

注册新用户账号

type auth_register = (_: {
  // 用户名（必须唯一）
  username: string,
  // 密码
  password: string,
  // 昵称
  nickname?: string,
  // 角色: user/admin/developer/tester/ops
  role?: string,
}) => any;

auth_login

用户登录

type auth_login = (_: {
  // 用户名
  username: string,
  // 密码
  password: string,
}) => any;

用户模块

get_users

获取用户列表

type get_users = () => any;

项目模块

list_projects

获取项目列表

type list_projects = () => any;

get_project

获取项目详情

type get_project = (_: {
  // 项目ID
  id: number,
}) => any;

create_project

创建新项目

type create_project = (_: {
  // 项目名称
  name: string,
  // 项目描述
  description?: string,
  // 计划上线日期 (YYYY-MM-DD)
  planDate?: string,
  // 项目状态
  status?: string,
}) => any;

update_project

更新项目信息

type update_project = (_: {
  // 项目ID
  id: number,
  // 项目名称
  name?: string,
  // 项目描述
  description?: string,
  // 计划上线日期
  planDate?: string,
  // 项目状态
  status?: string,
}) => any;

delete_project

删除项目

type delete_project = (_: {
  // 项目ID
  id: number,
}) => any;

需求模块

list_requirements

获取需求列表

type list_requirements = (_: {
  // 项目ID筛选
  projectId?: number,
}) => any;

get_requirement

获取需求详情

type get_requirement = (_: {
  // 需求ID
  id: number,
}) => any;

create_requirement

创建需求

type create_requirement = (_: {
  // 所属项目ID
  projectId: number,
  // 需求标题
  title: string,
  // 需求描述
  description?: string,
  // 优先级 (P0/P1/P2/P3)
  priority?: string,
  // 状态
  status?: string,
  // 需求类型
  type?: string,
  // 负责人ID
  assigneeId?: number,
  // 开始日期
  startDate?: string,
  // 截止日期
  endDate?: string,
}) => any;

update_requirement

更新需求

type update_requirement = (_: {
  // 需求ID
  id: number,
  // 需求标题
  title?: string,
  // 需求描述
  description?: string,
  // 优先级
  priority?: string,
  // 状态
  status?: string,
  // 负责人ID
  assigneeId?: number,
  // 开始日期
  startDate?: string,
  // 截止日期
  endDate?: string,
}) => any;

delete_requirement

删除需求

type delete_requirement = (_: {
  // 需求ID
  id: number,
}) => any;

任务模块

list_tasks

获取任务列表

type list_tasks = (_: {
  // 需求ID筛选
  requirementId?: number,
  // 负责人ID筛选
  assigneeId?: number,
}) => any;

get_task

获取任务详情

type get_task = (_: {
  // 任务ID
  id: number,
}) => any;

create_task

创建任务

type create_task = (_: {
  // 所属需求ID
  requirementId?: number,
  // 所属项目ID
  projectId?: number,
  // 任务标题
  title: string,
  // 任务描述
  description?: string,
  // 负责人ID
  assigneeId?: number,
  // 优先级 (P0/P1/P2/P3)
  priority?: string,
  // 状态
  status?: string,
  // 任务类型
  type?: string,
  // 开始日期
  startDate?: string,
  // 截止日期
  endDate?: string,
  // 预估工时
  estimatedHours?: number,
  // 实际工时
  actualHours?: number,
}) => any;

update_task

更新任务

type update_task = (_: {
  // 任务ID
  id: number,
  // 任务标题
  title?: string,
  // 任务描述
  description?: string,
  // 负责人ID
  assigneeId?: number,
  // 优先级
  priority?: string,
  // 状态
  status?: string,
  // 开始日期
  startDate?: string,
  // 截止日期
  endDate?: string,
  // 预估工时
  estimatedHours?: number,
  // 实际工时
  actualHours?: number,
}) => any;

delete_task

删除任务

type delete_task = (_: {
  // 任务ID
  id: number,
}) => any;

add_task_comment

添加任务评论

type add_task_comment = (_: {
  // 任务ID
  taskId: number,
  // 评论内容
  content: string,
}) => any;

list_task_comments

获取任务评论列表

type list_task_comments = (_: {
  // 任务ID
  taskId: number,
}) => any;

Bug模块

list_bugs

获取Bug列表

type list_bugs = (_: {
  // 项目ID筛选
  projectId?: number,
}) => any;

get_my_bugs

获取分配给我的Bug

type get_my_bugs = () => any;

get_bug

获取Bug详情

type get_bug = (_: {
  // Bug ID
  id: number,
}) => any;

create_bug

报告Bug

type create_bug = (_: {
  // 所属项目ID
  projectId: number,
  // 关联需求ID
  requirementId?: number,
  // 关联任务ID
  taskId?: number,
  // Bug标题
  title: string,
  // Bug描述
  description?: string,
  // 严重程度 (致命/严重/一般/轻微)
  severity?: string,
  // 优先级 (P0/P1/P2/P3)
  priority?: string,
  // 状态
  status?: string,
  // Bug类型
  bugType?: string,
  // 负责人ID
  assigneeId?: number,
  // 复现步骤
  stepsToReproduce?: string,
  // 预期结果
  expectedResult?: string,
  // 实际结果
  actualResult?: string,
}) => any;

update_bug

更新Bug

type update_bug = (_: {
  // Bug ID
  id: number,
  // Bug标题
  title?: string,
  // Bug描述
  description?: string,
  // 严重程度
  severity?: string,
  // 优先级
  priority?: string,
  // 状态
  status?: string,
  // 负责人ID
  assigneeId?: string,
  // 复现步骤
  stepsToReproduce?: string,
  // 预期结果
  expectedResult?: string,
  // 实际结果
  actualResult?: string,
}) => any;

delete_bug

删除Bug

type delete_bug = (_: {
  // Bug ID
  id: number,
}) => any;

文档模块

list_documents

获取文档列表

type list_documents = (_: {
  // 项目ID筛选
  projectId?: number,
  // 需求ID筛选
  requirementId?: number,
}) => any;

get_document

获取文档详情

type get_document = (_: {
  // 文档ID
  id: number,
}) => any;

create_document

创建文档

type create_document = (_: {
  // 所属项目ID
  projectId: number,
  // 关联需求ID
  requirementId?: number,
  // 文档标题
  title: string,
  // 文档类型 (PRD/技术方案/设计稿/API文档/其他)
  docType?: string,
  // 文档内容
  content?: string,
  // 版本号
  version?: string,
  // 状态 (草稿/评审中/已发布)
  status?: string,
}) => any;

update_document

更新文档

type update_document = (_: {
  // 文档ID
  id: number,
  // 文档标题
  title?: string,
  // 文档类型
  docType?: string,
  // 文档内容
  content?: string,
  // 版本号
  version?: string,
  // 状态
  status?: string,
}) => any;

delete_document

删除文档

type delete_document = (_: {
  // 文档ID
  id: number,
}) => any;

里程碑模块

list_milestones

获取里程碑列表

type list_milestones = (_: {
  // 项目ID
  projectId: number,
}) => any;

get_milestone

获取里程碑详情

type get_milestone = (_: {
  // 里程碑ID
  id: number,
}) => any;

create_milestone

创建里程碑

type create_milestone = (_: {
  // 所属项目ID
  projectId: number,
  // 里程碑名称
  name: string,
  // 描述
  description?: string,
  // 截止日期 (YYYY-MM-DD)
  dueDate: string,
  // 状态 (待完成/进行中/已完成)
  status?: string,
}) => any;

update_milestone

更新里程碑

type update_milestone = (_: {
  // 里程碑ID
  id: number,
  // 里程碑名称
  name?: string,
  // 描述
  description?: string,
  // 截止日期
  dueDate?: string,
  // 状态
  status?: string,
}) => any;

delete_milestone

删除里程碑

type delete_milestone = (_: {
  // 里程碑ID
  id: number,
}) => any;

话题模块

list_topics

获取话题列表

type list_topics = () => any;

get_topic

获取话题详情

type get_topic = (_: {
  // 话题ID
  id: number,
}) => any;

create_topic

创建话题讨论

type create_topic = (_: {
  // 话题标题
  title: string,
  // 话题内容
  content: string,
}) => any;

reply_topic

回复话题

type reply_topic = (_: {
  // 话题ID
  topicId: number,
  // 回复内容
  content: string,
  // 父回复ID (用于嵌套)
  parentId?: number,
}) => any;

通知模块

get_notifications

获取通知列表

type get_notifications = () => any;

mark_notification_read

标记通知为已读

type mark_notification_read = (_: {
  // 通知ID
  id: number,
}) => any;

角色权限模块

list_roles

获取角色列表

type list_roles = () => any;

get_role

获取角色详情

type get_role = (_: {
  // 角色ID
  id: number,
}) => any;

create_role

创建角色

type create_role = (_: {
  // 角色名称
  name: string,
  // 角色编码
  code: string,
  // 描述
  description?: string,
  // 权限列表
  permissions?: string[],
}) => any;

update_role

更新角色

type update_role = (_: {
  // 角色ID
  id: number,
  // 角色名称
  name?: string,
  // 描述
  description?: string,
  // 权限列表
  permissions?: string[],
}) => any;

delete_role

删除角色

type delete_role = (_: {
  // 角色ID
  id: number,
}) => any;

list_permissions

获取权限列表

type list_permissions = () => any;

使用示例

// 1. 用户登录
const loginRes = await auth_login({
  username: "admin",
  password: "admin123"
});
const token = loginRes.data.token;

// 2. 获取项目列表
const projects = await list_projects();

// 3. 创建需求
await create_requirement({
  projectId: 1,
  title: "用户登录功能",
  description: "实现用户登录功能",
  priority: "P0",
  status: "待处理"
});

// 4. 创建任务
await create_task({
  projectId: 1,
  title: "开发登录API",
  description: "开发用户登录接口",
  priority: "P1",
  type: "开发任务",
  estimatedHours: 8
});

// 5. 报告Bug
await create_bug({
  projectId: 1,
  title: "登录页面无法显示",
  description: "登录页面加载失败",
  severity: "严重",
  priority: "P0",
  status: "新建"
});

// 6. 创建里程碑
await create_milestone({
  projectId: 1,
  name: "Alpha版本发布",
  dueDate: "2026-04-01",
  status: "待完成"
});

注意事项

• 大多数API需要在Header中携带Authorization: Bearer {token}
• Agent也可以使用X-API-Key: agent-api-key-12345进行认证
• 登录后会返回token，后续请求需要使用该token
• 实时通知：支持WebSocket连接 ws://localhost:8080/ws/notification

WebSocket实时通知

系统支持WebSocket实时接收通知：

ws://localhost:8080/ws/notification

通知类型列表

Agent处理通知示例

// 建立WebSocket连接
const ws = new WebSocket('ws://localhost:8080/ws/notification');

ws.onmessage = (event) => {
  const notify = JSON.parse(event.data);
  handleNotification(notify);
};

async function handleNotification(notify) {
  switch (notify.type) {
    case 'task_assigned':
      // 开发Agent：开始处理任务
      console.log(`收到新任务: ${notify.title}`);
      await update_task({id: notify.taskId, status: "进行中"});
      break;
      
    case 'bug_assigned':
      // 测试Agent：开始处理Bug
      console.log(`收到新Bug: ${notify.title}`);
      await update_bug({id: notify.bugId, status: "进行中"});
      break;
      
    case 'task_status_changed':
      // PM：检查任务进度
      console.log(`任务${notify.title}已更新为: ${notify.status}`);
      break;
      
    case 'requirement_created':
      // PM：拆分任务
      console.log(`新需求: ${notify.title}`);
      break;
  }
}

// 或者使用HTTP轮询
setInterval(async () => {
  const notifs = await get_notifications();
  for (const n of notifs.data || []) {
    if (!n.read) handleNotification(n);
  }
}, 60000); // 每分钟检查一次