云效工作项 Skill 用于查询和操作云效工作项，包括需求、任务、缺陷、评论、项目与组织成员信息。
公开版约定
本文件只保留可公开的通用说明。私有组织 ID、项目 ID、内部前缀和团队约定，统一记录在工作区本地的 AGENTS.md。对外示例统一使用占位符，例如 、、PROJ-12345。
前置要求
已设置环境变量 YUNXIAO_ACCESS_TOKEN
可选设置 YUNXIAO_ORG_ID
如需在 Cursor 中直接使用，可在 ~/.cursor/mcp.json 配置对应 MCP Server 环境变量
# 云效访问令牌（必填）
export YUNXIAO_ACCESS_TOKEN=""
# 默认组织 ID（可选）
export YUNXIAO_ORG_ID=""
组织 ID 获取顺序
脚本会按以下顺序确定 organizationId：
命令行显式传入的 [orgId]
环境变量 YUNXIAO_ORG_ID
get_organizations 返回的第一个组织
如果你有内部默认组织或常用项目映射，把它们写到本地 AGENTS.md，不要写进公开 skill。
MCP 配置示例
{
"mcpServers": {
"yunxiao": {
"command": "npx",
"args": ["-y", "alibabacloud-devops-mcp-server"],
"env": {
"YUNXIAO_ACCESS_TOKEN": ""
}
}
}
}
功能列表
node scripts/yunxiao-mcp.cjs get_organizations
node scripts/yunxiao-mcp.cjs get_current_user [orgId]
node scripts/yunxiao-mcp.cjs search_projects [keyword] [orgId]
示例输出：
[
{
"id": "project-id-1",
"name": "示例项目",
"customCode": "PROJ",
"status": {
"name": "进行中"
}
}
]
node scripts/yunxiao-mcp.cjs get_work_item [orgId]
示例输出：
{
"id": "work-item-id",
"serialNumber": "PROJ-12345",
"subject": "示例需求标题",
"status": {
"name": "处理中"
},
"assignedTo": {
"name": "负责人A",
"id": "user-id-1"
},
"creator": {
"name": "创建人A",
"id": "user-id-2"
},
"participants": [
{
"name": "参与人A",
"id": "user-id-3"
}
],
"customFieldValues": []
}
node scripts/yunxiao-mcp.cjs search_workitems [optionsJson] [orgId]
参数：
参数 必填 说明
spaceId 是 项目 ID，可通过 search_projects 获取
optionsJson 否 JSON 格式搜索选项
orgId 否 显式指定组织 ID
搜索选项：
字段 类型 说明
category string 工作项类型：req、task、bug、risk、epic
status string 状态 ID 或状态名
assignedTo string 指派人 ID，self 表示当前用户
creator string 创建人 ID，self 表示当前用户
subject string 标题关键词
sprint string 迭代 ID
page number 页码，默认 1
perPage number 每页条数，默认 20，最大 200
includeDetails boolean 是否包含详情，默认 false
orderBy string 排序字段
sort string 排序方向：desc 或 asc
常用示例：
# 搜索项目中的所有需求
node scripts/yunxiao-mcp.cjs search_workitems ""
# 搜索待处理的需求
node scripts/yunxiao-mcp.cjs search_workitems "" '{"status":"pending_processing"}'
# 搜索指派给我的工作项
node scripts/yunxiao-mcp.cjs search_workitems "" '{"assignedTo":"self"}'
# 搜索缺陷
node scripts/yunxiao-mcp.cjs search_workitems "" '{"category":"bug"}'
# 分页搜索
node scripts/yunxiao-mcp.cjs search_workitems "" '{"perPage":50,"page":1}'
示例输出：
{
"items": [
{
"id": "work-item-id",
"serialNumber": "PROJ-12345",
"subject": "示例工作项",
"status": {
"name": "待处理",
"id": "100005"
},
"assignedTo": {
"name": "负责人A",
"id": "user-id-1"
},
"creator": {
"name": "创建人A",
"id": "user-id-2"
},
"workitemType": {
"name": "产品需求"
}
}
],
"pagination": {
"page": 1,
"perPage": 20,
"total": 1,
"totalPages": 1
}
}
node scripts/yunxiao-mcp.cjs get_comments [orgId] [page] [perPage]
示例输出：
[
{
"id": "comment-id",
"content": "评论内容示例",
"contentFormat": "RICHTEXT",
"user": {
"name": "评论人A",
"id": "user-id-1"
},
"gmtCreate": 1767843788000,
"gmtModified": 1767843788000
}
]
node scripts/yunxiao-mcp.cjs create_comment [orgId]
node scripts/yunxiao-mcp.cjs search_members [orgId]
命令速查
node scripts/yunxiao-mcp.cjs [args...]
get_organizations
get_current_user [orgId]
search_projects [keyword] [orgId]
get_work_item [orgId]
search_workitems [optionsJson] [orgId]
get_comments [orgId] [page] [perPage]
create_comment [orgId]
search_members [orgId]
使用场景
场景 1：查看某个工作项
用户：帮我看看云效需求 PROJ-12345
助手：调用 get_work_item 获取详情并整理重点信息
场景 2：搜索待处理工作
用户：帮我看看某个项目有哪些待处理需求
助手：1. 调用 search_projects 获取项目 ID
- 调用 search_workitems 搜索待处理需求
- 展示结果
场景 3：查看我的待办
用户：我在云效上有哪些待办？
助手：1. 调用 search_projects 获取相关项目
- 调用 search_workitems 搜索 assignedTo=self 的需求、任务或缺陷
- 展示结果
场景 4：查看工作项评论
用户：看一下 PROJ-12345 的评论
助手：调用 get_comments 获取评论列表
注意事项
评论内容通常是富文本结构。
大量结果建议结合 page 和 perPage 分页获取。
如果需要内部默认组织、项目快捷名或前缀映射，请放在本地 AGENTS.md，不要写进公开文档。
错误处理
错误 原因 解决方案
Cannot determine organization ID 未显式提供组织 ID，且无法自动获取 设置 YUNXIAO_ORG_ID、传入 [orgId]，或先运行 get_organizations
NotFound 工作项不存在或无权限 检查工作项 ID 和权限
Invalid spaceId 项目 ID 无效 使用 search_projects 获取正确的项目 ID
by