通过华为云码道CodeArts代码智能体实现需求管理智能化
需求管理服务（CodeArts Req）支持以“CodeArts工具链插件”形式与华为云码道CodeArts代码智能体集成。CodeArts工具链插件通过灵活配置提示词（Prompt）、技能（Skill）等指令可让智能体更高效完成需求管理相关任务操作。
无需学习控制台的相关操作，就可以直接在华为云码道CodeArts代码智能体聊天窗口通过自然语言指令，实现智能化需求管理。
核心价值
- 免切换操作：无需登录需求管理控制台，无需在控制台各个界面来回操作切换，即可在智能体聊天窗完成需求管理相关操作。
- 自然语言交互: “对话即操作”，通过指令即可完成智能化需求管理。
- 全场景覆盖：工作项管理、工作项状态流转、分解子工作项、关联工作项、工作项评论管理、工作项附件管理、计划管理、配置查询八大场景。
- 研发流程贯通：与流水线、测试计划等服务联动，实现端到端研发流程。
工作原理
需求管理服务通过CodeArts工具链插件，将自身API能力提供给华为云码道CodeArts代码智能体调用。码道代码智能体理解用户的自然语言指令后，通过KooCLI调用需求管理API执行对应操作，并将结果返回至聊天窗口。
交互流程如图1所示。
CodeArts工具链插件
CodeArts工具链插件将需求管理、代码托管、代码检查、测试、流水线与编译构建、制品管理、部署发布等CodeArts研发服务以技能（Skill）和子代理（Subagent）形式集成在代码智能体中。用户安装插件后，无需切换控制台，直接在智能体聊天窗口通过自然语言指令即可触发对应服务操作。主Agent接收用户指令后，通过Skill获取执行规范与路由策略：交互式操作由Skill引导完成，复杂编排任务委托SubAgent在隔离上下文中自主执行并返回结果。CodeArts工具链插件包含的Skill及Subagent详情请查阅CodeArts全量Subagent和Skill。
需求管理服务在CodeArts工具链插件中提供了八个技能（Skill）和一个子代理（Subagent）。
技能是需求管理的交互式执行专家，覆盖工作项管理、工作项状态流转、分解子工作项、关联工作项、工作项评论管理、工作项附件管理、计划管理、配置查询等全场景，能理解用户的自然语言意图并完成需求管理智能化相关操作。当操作复杂度高、涉及批量处理或多步编排时，技能会将任务转交给子代理执行。子代理在独立上下文中自主运行，不占用主会话资源，可自动完成执行创建工作项、工作项状态流转、分解子工作项等复杂编排任务，完成后返回结构化结果报告。两者协同构成了CodeArts工具链插件的两层执行架构，使码道代码智能体能灵活应对从单次查询到批量编排的全场景需求。
需求管理支持技能如下：
- codearts-req-workitem
- codearts-req-comment
- codearts-req-config-ipd
- codearts-req-config-scrum
- codearts-req-issue-attachment
- codearts-req-plan
- codearts-req-workitem-ipd
- codearts-req-workitem-scrum
适用场景
在进行需求管理工作项增删改查时，以下场景均可让华为云码道CodeArts代码智能体完成。
| 场景分类 | 场景说明 | 自然语言指令示例 |
|---|---|---|
| 工作项管理 | 支持创建工作项、查询工作项、更新工作项、删除工作项。 |
|
| 工作项状态流转 | 按照工作流配置对工作项进行状态流转。 | 将云平台项目中的IR20260908171790状态流转到分析。 |
| 分解子工作项 | 按照工作项类型模板的配置，对工作项进行拆解，分解为更细粒度的子工作项。 | 将云平台项目中的IR20260908171790工作项分解为2个SR。 |
| 关联工作项 | 按照工作项关联关系的配置，对工作项设置关联项。 | 在云平台项目中把IR20260908171790工作项和BUG20260908171775工作项关联起来。 |
| 工作项评论管理 | 支持对工作项添加评论并对发表后的评论进行回复、编辑、置顶、删除操作。 | 在云平台项目中，给BUG20260908171775工作项添加评论“已修复”。 |
| 工作项附件管理 | 支持对工作项上传附件，并对上传的附件进行下载、删除操作。 | 在风险管理项目中，对mytest工作项上传附件D:\test\testbug.pdf。 |
| 计划管理 | 支持新建发布计划和迭代计划、并对发布计划/迭代计划进行基线和取消基线操作、更新发布/迭代状态等操作。 | 在风险管理项目中，创建一个名称为springtest，时间为当月的迭代。 |
| 配置查询 | 支持查询工作项状态、工作项字段、项目成员、工作流配置等信息。 | 查询风险管理项目的项目成员。 |
前提条件
本操作执行工具调用、大模型推理会消耗码道代码智能体账号下的token或者积分。
| 序号 | 条件项 | 说明 |
|---|---|---|
| 1 | 已安装华为云码道CodeArts代码智能体并完成账号登录。 | 需求管理智能化需在码道代码智能体中体现。 |
| 2 | 已购买需求管理服务。 | 通过码道代码智能体使用需求管理服务的相关功能，需已购买需求管理服务。 |
| 3 | 通过码道代码智能体使用需求管理服务的相关功能，需已配置完相关权限。 |
操作步骤
- 单击下载CodeArts工具链插件。
- 单击执行插件包中install.bat脚本，完成插件和KooCLI安装。
- 完成KooCLI初始化配置，将常用的永久AK/SK和区域信息存储在配置文件中，避免执行操作时频繁输入这些固定信息。
- 打开码道代码智能体聊天窗口，用自然语言告诉它你想做什么，就可以开始使用。
- 首次使用码道代码智能体执行需求管理相关操作时，分析过程时间较长，随着指令使用的次数增加，分析速度会逐步提升，响应时间逐渐缩短。
- 不同码道代码智能体客户端的界面风格有所差异，实际操作请以所用工具的显示为准。
场景示例
需求管理服务（CodeArts Req）的工作项管理、工作项状态流转、分解子工作项、关联工作项、工作项评论管理、工作项附件管理、计划管理、配置查询八大场景，均可让码道代码智能体完成。
场景一：工作项管理
- 创建工作项
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到工作项创建成功的结果信息。效果示例：
您可以在控制台的缺陷列表页看到新建的Bug工作项。
- 查询工作项数据
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到该工作项的详细信息。
效果示例：
- 更新工作项
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到更新计划完成时间成功的显示。
效果示例：
- 删除工作项
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。删除过程中将出现弹框确认，如下图所示。
回复确认删除后，码道代码智能体继续执行。执行成功后，您可以看到工作项删除成功。
效果示例：
在控制台缺陷列表页中无该工作项信息：
在回收站中可以看到该删除的工作项，可以根据需要对其进行恢复：
场景二：工作项状态流转
以执行如下指令流转工作项状态到分析为例，进行说明。
将云平台项目中的IR20260908171790状态流转到分析。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到状态流转成功。
效果示例：
场景三：分解子工作项
以执行如下指令分解子工作项为例，进行说明。
将云平台项目中的IR20260908171790工作项分解为2个SR。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到分解成功的2个SR基本信息。
效果示例：
在控制台研发需求列表页，你也可以查看子工作项信息。
场景四：关联工作项
以执行如下指令将两个工作项设置为关联项为例，进行说明。
在云平台项目中把IR20260908171790工作项和BUG20260908171775工作项关联起来。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到IR工作项与Bug工作项已成功建立关联关系。
效果示例：
您还可以在对应工作项详情页查看关联工作项信息。
场景五：工作项评论管理
以执行如下指令给工作项添加评论为例，进行说明。
在云平台项目中，给BUG20260908171775工作项添加评论“已修复”。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到给工作项添加评论成功。
效果示例：
您还可以在对应工作项详情页查看添加的评论信息。
场景六：工作项附件管理
以执行如下指令给工作项上传附件为例，进行说明。
在风险管理项目中，对mytest工作项上传附件D:\test\testbug.pdf。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到给工作项上传附件成功。
效果示例：
您还可以在工作项详情页查看上传的附件。
场景七：计划管理
以执行如下指令创建迭代为例，进行说明。
在风险管理项目中，创建一个名称为springtest，时间为当月的迭代。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到迭代创建成功。
效果示例：
您还可以在迭代页面查看新创建的迭代。
场景八：配置查询
以执行如下指令查询项目成员为例，进行说明。
查询风险管理项目的项目成员。
码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到项目成员信息。
效果示例：
相关文档
关于CodeArts工具链插件的更多使用场景，请参考通过CodeArts工具链插件开发旅游小助手。
