AI编程代理项目管理工具

Velocity是一个集成MCP服务器的项目管理平台,为AI编程代理提供自动化任务跟踪和问题管理功能,适用于软件开发中的协作和进度跟踪。

  • by velocity-quest
  • 本地部署
  • 更新于
在 GitHub 查看 velocity-quest/skills

使用说明

速度技能

AI编码代理技能和说明 速度 --带有内置MCP服务器的项目管理平台。

这是什么?

此存储库包含指导AI编码代理如何使用Velocity MCP服务器的指令文件 在开发过程中积极主动 --不仅仅是在明确要求的时候。将这些文件放入您的项目中,您的代理将自动跟踪其工作:发现问题、更新进度、归档错误和标记任务完成。

先决条件

  • Velocity工作区位于 专业版 计划或以上
  • MCP连接令牌(在以下位置创建一个 设置>MCP服务器)

设置

克劳德代码

增添 .mcp.json 在项目根目录中:

{
  "mcpServers": {
    "velocity": {
      "url": "https://velocity.quest/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

光标

增添 .cursor/mcp.json 在项目根目录中:

{
  "mcpServers": {
    "velocity": {
      "url": "https://velocity.quest/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

帆板运动

增添 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "velocity": {
      "serverUrl": "https://velocity.quest/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Gemini CLI

增添 .gemini/settings.json 在项目根目录中:

{
  "mcpServers": {
    "velocity": {
      "url": "https://velocity.quest/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

开源代码

增添 .opencode.json 在项目根目录中:

{
  "mcp": {
    "velocity": {
      "type": "remote",
      "url": "https://velocity.quest/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

VS代码

增添 .vscode/mcp.json 在项目根目录中:

{
  "servers": {
    "velocity": {
      "type": "http",
      "url": "https://velocity.quest/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

代理如何使用Velocity

一旦连接,代理就会遵循 代理开发工作流程:

  1. 东方 --呼叫 list_teams, list_statuses, list_labels 了解工作空间
  2. 接工作 — get_issue("ENG-42") 为了阅读上下文, update_issue 标记“进行中”
  3. 跟踪进度 — add_comment 在实施过程中,注意决策和阻碍因素
  4. 完成 — update_issue 为了标记“完成”, add_comment 附有变更摘要
  5. 文件跟进 — create_issue 用于在实施过程中发现的错误或确定的工作

代理人被指示使用这些工具 主动地 --他们不会等待用户说“创建问题”或“更新状态”

可用的MCP工具(38)

问题跟踪(7个工具)

工具 描述 范围
list_issues 列出筛选和分页问题 read
get_issue 通过UUID或标识符获取完整的问题详细信息(例如。 ENG-42) 阅读
create_issue 创建新问题 编写
update_issue 更新现有问题 写入
search_issues 跨问题全文搜索 阅读
add_comment 为问题添加评论(支持线程回复) 写
list_comments 列出对某个问题的所有评论 阅读

项目和周期(4个工具)

工具 描述 范围
list_projects 列出具有状态筛选器的项目 read
get_project 获取项目详细信息和里程碑 阅读
list_cycles 使用状态筛选器列出周期(冲刺) read
get_cycle 获取周期详细信息和进度 阅读

工作区元数据(4个工具)

工具 描述 范围
list_teams 列出工作区中的所有团队 阅读
list_labels 列出可用标签 阅读
list_statuses 列出每个团队的工作流状态 阅读
list_members 列出工作区成员 阅读

路线图(9个工具)

工具 描述 范围
list_roadmap_items 列出带过滤器的路线图项目 阅读
create_roadmap_item 创建路线图项目 编写
update_roadmap_item 更新路线图项目 编写
delete_roadmap_item 删除路线图项 写入
vote_roadmap_item 切换路线图项目的投票 写入
list_roadmap_versions 列出路线图版本(发布) 阅读
create_roadmap_version 创建路线图版本 编写
get_roadmap_settings 获取路线图设置 阅读
update_roadmap_settings 更新路线图设置 写入

工作区和用户(10个工具)

工具 描述 范围
list_workspaces 列出用户所属的所有工作区 read
create_workspace 创建新工作区(用户成为所有者) 写入
delete_workspace 永久删除工作区(仅限所有者) 写入
get_workspace 获取当前工作区详细信息 阅读
update_workspace 更新工作区名称或描述 写入
get_current_user 获取经过身份验证的用户的个人资料 读取
update_current_user 更新用户显示名称或头像 写入
list_user_api_keys 列出个人API密钥(velu_ 前缀) 读取
create_user_api_key 创建个人API密钥(返回一次) 写入
revoke_user_api_key 吊销个人API密钥 写入

自定义域(4个工具)

工具 描述 范围
list_domains 列出自定义域 读取
add_domain 添加自定义域 写入
verify_domain 验证域DNS记录 写入
remove_domain 删除自定义域 写入

使用技能档案

文件 代理 目的
CLAUDE.md Claude代码 自动加载项目指令
AGENTS.md Gemini CLI 自动加载代理指令
claude-code/SKILL.md Claude Code 工具参考的可安装技能
.github/copilot-instructions.md GitHub Copilot Copilot的自定义说明

将这些文件中的任何一个复制到您的项目中,以提供有关Velocity的MCP工具和代理开发工作流的相应代理上下文。

许可证

麻省理工学院