使用说明
速度技能
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
一旦连接,代理就会遵循 代理开发工作流程:
- 东方 --呼叫
list_teams,list_statuses,list_labels了解工作空间 - 接工作 —
get_issue("ENG-42")为了阅读上下文,update_issue标记“进行中” - 跟踪进度 —
add_comment在实施过程中,注意决策和阻碍因素 - 完成 —
update_issue为了标记“完成”,add_comment附有变更摘要 - 文件跟进 —
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工具和代理开发工作流的相应代理上下文。
许可证
麻省理工学院