mcpField
C
creating-fix-work-item

creating-fix-work-item

github.com/forcedotcom测试与质量1.1k257 次安装1 天前更新
代码仓库

关于 creating-fix-work-item

该 Agent 技能根据测试失败分析创建 DevOps Center 修复工作项,并指定项目和负责人。创建前会展示详情并要求明确确认。

主要功能

  1. 01创建修复工作项
  2. 02指定项目与负责人
  3. 03创建前确认工作项详情
  4. 04将常见错误转换为说明

适用场景

  1. 01为测试失败分析创建修复任务
  2. 02将修复工作项分配给指定开发者

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/forcedotcom/sf-skills --skill creating-fix-work-item

安装后在 Claude Code 中输入/creating-fix-work-item确认已加载。

详细介绍

先决条件

先加载 checking-devops-prerequisites——先决条件 1–4。你需要 doce-org-alias、要归属的 DevopsProjectId,以及 OwnerId(受分配人)。如果不存在 DevopsProject,请说明必须先创建项目,才能创建工作项。

创建前所需的输入

输入获取方式
DevopsProjectId从管道关联的项目获取——如果尚不清楚,请在 doce 组织上查询 DevopsProject WHERE Name = '<projectName>'
Subject根据失败分析得出,例如:“修复:blitz-10-06 仓库缺少 code-analyzer-v5.yml 工作流”
OwnerId要分配任务的开发人员的用户 ID——如果尚不清楚,请在 doce 组织上查询 SELECT Id, Name FROM User WHERE Username = '<username>'。如果不知道用户名,请询问用户。
doce-org-alias在先决条件中设置

确认环节

创建工作项之前,请展示摘要并等待明确确认:

“我将创建一个修复工作项,详情如下:

  • 主题: <subject>
  • 分配给: <assigneeName>
  • 项目: <projectName>

是否创建?”

在用户确认之前,不要继续操作。

创建工作项

sf data create record \
  --sobject WorkItem \
  --values "Subject='<subject>' DevopsProjectId='<DevopsProjectId>' OwnerId='<OwnerId>'" \
  --target-org <doce-org-alias> \
  --json

重要: 使用 WorkItem(无命名空间)——在此组织版本中,DevopsWorkItem 不是受支持的 sObject。

成功后

从结果中解析返回的 id 并确认:

“已创建修复工作项(<id>):<subject>。已分配给 <assigneeName>,位于 <projectName> 项目中。”

错误处理

切勿公开原始 API 错误消息。将错误转换为通俗易懂的回复:

错误回复
FIELD_INTEGRITY_EXCEPTION“受分配人的 ID 无效。我来查找正确的用户 ID——开发人员的用户名是什么?”
REQUIRED_FIELD_MISSING“缺少必填字段。请检查是否同时提供了 Subject 和 DevopsProjectId。”
INSUFFICIENT_ACCESS“你的用户没有权限在此项目中创建工作项。”
其他任何错误“无法创建工作项。错误:<plain summary>。请重试,或在 DevOps Center 中手动创建。”

相关技能

  • analyzing-test-failures——提供失败分析和改进建议,这些内容是创建修复工作项的依据

评论

支持 Markdown