tb（待定）

Teambition 连接与管理

通过 Teambition MCP 服务获取管理项目、任务、成员等能力。

配置文件

配置文件格式 (.teambition)

mcp_server=https://your-mcp-server-url.com
userid=your_user_id

🔧 初始化引导（首次激活时执行）

第一步：检查配置文件

读取 {baseDir}/.teambition 文件，解析获取：

• mcp_server：MCP Server 地址
• userid：用户 ID

第二步：收集缺失信息

若缺少 mcp_server：

📋 请提供你的 Teambition MCP Server 地址。 你可以访问 Teambition MCP 配置页面 获取 MCP Server 地址。 获取后把地址发给我，我帮你配置好。

若缺少 userid： 使用 GetUsersMe 工具获取当前用户信息，并解析其中的 userId 字段，保存到配置文件。

📚 接口参数参考

接口请求参数的详细说明请查阅：Teambition 开放平台文档中心

📡 可用操作

根据用户需求，从以下工具列表中选择合适的工具：

项目管理

任务管理

任务评论与动态

任务关联

项目关联

迭代管理

项目分组

工作流

自定义字段

任务类型

搜索与查询

成员与组织

模板

文件与附件

富文本

🔍 工具选择策略

多工具时的决策流程

1. 理解用户需求：先理解用户想做什么
2. 列出候选工具：根据需求列出所有可能适用的工具
3. 明确性判断：

- 如果只有一个明确适用的工具 → 直接使用 - 如果多个工具可能适用 → 需要与用户确认具体使用哪个

1. 确认话术（多选一）：

> 你想用哪个方式？ > - A. 通过项目名称查询 → 使用 QueryProjectsV3 > - B. 通过 TQL 条件搜索 → 使用 SearchProjectsTQL > - C. 查看我参与的项目 → 使用 ListUserProjectsV3

📋 常用场景示例

查询我的任务

用户：帮我看看我有什么任务
→ 使用 `SearchUserTasksV3`，roleTypes: "executor,involveMember"

创建任务

用户：在 XX 项目创建个任务
→ 先用 `QueryProjectsV3` 或 `SearchProjectsTQL` 找到项目
→ 再用 `GetMcpTaskPrecreate` 获取项目任务字段配置
→ 最后用 `CreateTaskV3` 创建任务

查看项目成员

用户：XX 项目有哪些人
→ 使用 `ListProjectMembersV3`

⚠️ 错误处理

🔐 配置文件读写

读取配置

# 读取 .teambition 文件
cat {baseDir}/.teambition

# 解析 mcp_server
grep "^mcp_server=" {baseDir}/.teambition | cut -d= -f2

# 解析 userid
grep "^userid=" {baseDir}/.teambition | cut -d= -f2

写入配置

# 创建或更新配置文件
echo "mcp_server=https://your-mcp-server.com" > {baseDir}/.teambition
echo "userid=your_user_id" >> {baseDir}/.teambition