关于 creating-fix-work-item
该 Agent 技能根据测试失败分析创建 DevOps Center 修复工作项,并指定项目和负责人。创建前会展示详情并要求明确确认。
主要功能
- 01创建修复工作项
- 02指定项目与负责人
- 03创建前确认工作项详情
- 04将常见错误转换为说明
适用场景
- 01为测试失败分析创建修复任务
- 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