devops-project-management

name	devops-project-management
description	This skill should be used when the user asks to "manage work items", "create task", "check sprint", "track progress", "log hours", "effort report", "view backlog", "项目管理", "工作项", "迭代", "冲刺", "需求", "缺陷", "任务", "工时", "看板", "待办", "进度", "创建需求", "创建缺陷", "搜索工作项", "迭代进度", "工时登记", or discusses DevOps project management, work item tracking, sprint management, and effort tracking (项目管理、工作项跟踪、迭代管理、工时统计).
version	1.0.0

云效项目管理

管理云效项目的工作项、迭代和工时，这是云效助手最核心的能力。

架构概览

用户请求 → Skill 识别意图 → 选择合适 Agent → 返回结果
                              ├─ devops-workitem-tracker   (工作项 CRUD、搜索、工作流、评论)
                              ├─ devops-sprint-manager     (迭代 CRUD、进度分析)
                              └─ devops-effort-analyst     (工时跟踪、预估 vs 实际)

可用 Sub-Agent（3 个项目管理 Agent）

1. devops-workitem-tracker

用于: 工作项全生命周期管理 能力:

• 搜索和查看工作项（需求/缺陷/任务/风险/史诗）
• 创建、更新工作项
• 管理工作项评论
• 查看工作流状态和类型配置
• 多项目工作项统计

传递参数:

{
  "organizationId": "",
  "projectId": "",
  "action": "search | detail | create | update | comment | workflow | types",
  "category": "Req | Bug | Task | Risk | Epic",
  "keyword": "",
  "sprintId": "",
  "assignedTo": ""
}

2. devops-sprint-manager

用于: 迭代全生命周期管理 能力:

• 创建、更新、查看迭代
• 迭代进度分析和完成率计算
• 多迭代对比
• 燃尽趋势评估

传递参数:

{
  "organizationId": "",
  "projectId": "",
  "action": "list | detail | create | update | progress | compare",
  "sprintId": "",
  "compareSprintIds": []
}

3. devops-effort-analyst

用于: 工时跟踪和分析 能力:

• 查看和登记实际工时
• 查看和设置预估工时
• 工时偏差分析（实际 vs 预估）
• 成员工时统计

传递参数:

{
  "organizationId": "",
  "projectId": "",
  "action": "list | log | estimate | deviation | member_stats",
  "workItemId": "",
  "memberId": "",
  "dateRange": ""
}

决策树

用户请求：
├─ 工作项相关
│  ├─ "搜索工作项" / "查找需求" / "有哪些未完成的"
│  │  └─ 使用: devops-workitem-tracker（action: "search"）
│  ├─ "创建需求/缺陷/任务" / "新建工作项"
│  │  └─ 使用: devops-workitem-tracker（action: "create"）
│  ├─ "更新工作项状态" / "完成任务" / "关闭缺陷"
│  │  └─ 使用: devops-workitem-tracker（action: "update"）
│  ├─ "工作项详情" / "查看 BUG-123"
│  │  └─ 使用: devops-workitem-tracker（action: "detail"）
│  ├─ "添加评论" / "回复工作项"
│  │  └─ 使用: devops-workitem-tracker（action: "comment"）
│  └─ "所有项目的工作项统计"
│     └─ 为每个项目并行启动 devops-workitem-tracker
│
├─ 迭代相关
│  ├─ "当前迭代进度" / "Sprint 进度"
│  │  └─ 使用: devops-sprint-manager（action: "progress"）
│  ├─ "创建迭代" / "新建 Sprint"
│  │  └─ 使用: devops-sprint-manager（action: "create"）
│  ├─ "对比迭代" / "Sprint 3 vs Sprint 4"
│  │  └─ 使用: devops-sprint-manager（action: "compare"）
│  └─ "迭代列表" / "所有 Sprint"
│     └─ 使用: devops-sprint-manager（action: "list"）
│
├─ 工时相关
│  ├─ "登记工时" / "记录工时"
│  │  └─ 使用: devops-effort-analyst（action: "log"）
│  ├─ "我的工时" / "本周工时统计"
│  │  └─ 使用: devops-effort-analyst（action: "member_stats"）
│  ├─ "工时偏差" / "实际 vs 预估"
│  │  └─ 使用: devops-effort-analyst（action: "deviation"）
│  └─ "设置预估工时"
│     └─ 使用: devops-effort-analyst（action: "estimate"）
│
├─ 综合查询
│  ├─ "项目概览" / "项目全景"
│  │  └─ 并行启动 3 个 Agent 获取完整项目状态
│  └─ "迭代复盘" / "Sprint 回顾"
│     └─ 并行启动 sprint-manager + effort-analyst
│
└─ 简单查询（直接调用 MCP 工具，不启动 Sub-Agent）
   ├─ "搜索项目" / "项目列表"
   │  └─ 直接: mcp__yunxiao__search_projects
   ├─ "查看项目详情"
   │  └─ 直接: mcp__yunxiao__get_project
   └─ "迭代列表"
      └─ 直接: mcp__yunxiao__list_sprints

并行执行模式

模式 1: 多项目工作项统计

用户: "所有项目的工作项状态"

→ 步骤 1: search_projects 获取项目列表
→ 步骤 2: 为每个项目并行启动 devops-workitem-tracker
  Agent 1: devops-workitem-tracker（project: "project-a"）
  Agent 2: devops-workitem-tracker（project: "project-b"）
  Agent 3: devops-workitem-tracker（project: "project-c"）
→ 步骤 3: 汇总跨项目工作项统计

模式 2: 多迭代对比

用户: "对比 Sprint 3 和 Sprint 4"

→ 并行启动：
  Agent 1: devops-sprint-manager（sprintId: "sprint-3"）
  Agent 2: devops-sprint-manager（sprintId: "sprint-4"）
→ 对比两个迭代的数据

模式 3: 项目全景

用户: "给我一个项目概览"

→ 并行启动 3 个 Agent：
  Agent 1: devops-workitem-tracker（搜索所有工作项，统计状态分布）
  Agent 2: devops-sprint-manager（当前迭代进度）
  Agent 3: devops-effort-analyst（本周工时统计）
→ 汇总项目全景报告

模式 4: 迭代复盘

用户: "Sprint 4 复盘"

→ 并行启动 2 个 Agent：
  Agent 1: devops-sprint-manager（Sprint 4 完成率、范围变化）
  Agent 2: devops-effort-analyst（Sprint 4 工时偏差分析）
→ 生成迭代复盘报告

模式 5: 团队成员工时汇总

用户: "本周团队工时统计"

→ 并行为每个成员启动 devops-effort-analyst
→ 汇总团队工时报告

工作流

步骤 1: 解析用户请求

• 操作对象？（工作项 / 迭代 / 工时）
• 操作类型？（查询 / 创建 / 更新 / 分析）
• 涉及范围？（单项目 / 多项目 / 单迭代 / 多迭代）

步骤 2: 获取上下文

如需要组织 ID：

→ mcp__yunxiao__get_current_organization_info

如需要项目 ID：

→ mcp__yunxiao__search_projects（keyword: "项目名"）

步骤 3: 启动 Sub-Agent 或直接调用

简单查询直接调用 MCP 工具，复杂操作启动对应 Sub-Agent。

步骤 4: 展示结果

常用场景示例

用户请求	使用 Agent	模式
"查看当前迭代的进度"	devops-sprint-manager	单 Agent
"我有哪些未完成的工作项"	devops-workitem-tracker	单 Agent
"这周我的工时登记了多少"	devops-effort-analyst	单 Agent
"创建一个需求：实现用户登录"	devops-workitem-tracker	单 Agent
"对比 Sprint 3 和 Sprint 4"	devops-sprint-manager ×2	并行
"所有项目的工作项状态"	devops-workitem-tracker ×N	并行
"项目全景报告"	3 个 Agent	并行
"迭代复盘"	sprint-manager + effort-analyst	并行

工作项类型速查

类型	category 值	说明
需求	Req	产品需求、用户故事
缺陷	Bug	Bug、问题
任务	Task	开发任务、技术债务
风险	Risk	项目风险
史诗	Epic	大颗粒度的需求集合

注意事项

• 工作项搜索优先使用 search_workitems，它支持丰富的过滤条件
• 创建工作项前先用 get_work_item_types 确认项目支持的工作项类型
• 迭代进度分析需要同时查询迭代信息和迭代内工作项
• 工时操作需要 workItemId，如用户只提供工作项名称需先搜索
• 多项目操作先调用 search_projects 获取项目列表
• 大多数操作需要 organizationId，优先从上下文获取