# 通过华为云码道CodeArts代码智能体实现需求管理智能化 需求管理服务（CodeArts Req）支持以"CodeArts工具链插件"形式与[华为云码道CodeArts代码智能体](https://codearts.huaweicloud.com/)集成。CodeArts工具链插件通过灵活配置提示词（Prompt）、技能（Skill）等指令可让智能体更高效完成需求管理相关任务操作。 无需学习控制台的相关操作，就可以直接在华为云码道CodeArts代码智能体聊天窗口通过自然语言指令，实现智能化需求管理。 #### 核心价值 - **免切换操作**：无需登录需求管理控制台，无需在控制台各个界面来回操作切换，即可在智能体聊天窗完成需求管理相关操作。 - **自然语言交互**: "对话即操作"，通过指令即可完成智能化需求管理。 - **全场景覆盖**：工作项管理、工作项状态流转、分解子工作项、关联工作项、工作项评论管理、工作项附件管理、计划管理、配置查询八大场景。 - **研发流程贯通：**与流水线、测试计划等服务联动，实现端到端研发流程。 #### 工作原理 需求管理服务通过CodeArts工具链插件，将自身API能力提供给华为云码道CodeArts代码智能体调用。码道代码智能体理解用户的自然语言指令后，通过KooCLI调用需求管理API执行对应操作，并将结果返回至聊天窗口。 交互流程如[图1]所示。 图1交互流程图 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002742171687.png "点击放大") #### CodeArts工具链插件 CodeArts工具链插件将需求管理、代码托管、代码检查、测试、流水线与编译构建、制品管理、部署发布等CodeArts研发服务以技能（Skill）和子代理（Subagent）形式集成在代码智能体中。用户安装插件后，无需切换控制台，直接在智能体聊天窗口通过自然语言指令即可触发对应服务操作。主Agent接收用户指令后，通过Skill获取执行规范与路由策略：交互式操作由Skill引导完成，复杂编排任务委托SubAgent在隔离上下文中自主执行并返回结果**。** CodeArts工具链插件包含的Skill及Subagent详情请查阅[CodeArts全量Subagent和Skill](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0055.html#section1)。 需求管理服务在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代码智能体完成。 | 场景分类 | 场景说明 | 自然语言指令示例 | |:---|:---|:---| | 工作项管理 | 支持创建工作项、查询工作项、更新工作项、删除工作项。 | - 创建工作项示例：在云平台项目中创建一个名称为my-test-bug的Bug工作项。 - 查询工作项示例：查询云平台项目中的Bug工作项数据。 - 更新工作项示例：更新云平台项目中的my-test-bug工作项计划完成时间为明天。 - 删除工作项示例：删除云平台项目中的my-test-bug工作项。 | | 工作项状态流转 | 按照工作流配置对工作项进行状态流转。 | 将云平台项目中的IR20260908171790状态流转到分析。 | | 分解子工作项 | 按照工作项类型模板的配置，对工作项进行拆解，分解为更细粒度的子工作项。 | 将云平台项目中的IR20260908171790工作项分解为2个SR。 | | 关联工作项 | 按照工作项关联关系的配置，对工作项设置关联项。 | 在云平台项目中把IR20260908171790工作项和BUG20260908171775工作项关联起来。 | | 工作项评论管理 | 支持对工作项添加评论并对发表后的评论进行回复、编辑、置顶、删除操作。 | 在云平台项目中，给BUG20260908171775工作项添加评论"已修复"。 | | 工作项附件管理 | 支持对工作项上传附件，并对上传的附件进行下载、删除操作。 | 在风险管理项目中，对mytest工作项上传附件D:\\test\\testbug.pdf。 | | 计划管理 | 支持新建发布计划和迭代计划、并对发布计划/迭代计划进行基线和取消基线操作、更新发布/迭代状态等操作。 | 在风险管理项目中，创建一个名称为springtest，时间为当月的迭代。 | | 配置查询 | 支持查询工作项状态、工作项字段、项目成员、工作流配置等信息。 | 查询风险管理项目的项目成员。 | #### 前提条件 ![](https://support.huaweicloud.com/usermanual-projectman/public_sys-resources/caution_3.0-zh-cn.png) 本操作执行工具调用、大模型推理会消耗码道代码智能体账号下的token或者积分。 | 序号 | 条件项 | 说明 | |:---|:---|:---| | 1 | 已安装[华为云码道CodeArts代码智能体](https://support.huaweicloud.com/qs-codeartsagent/codeartsagent_qs_0001.html)并完成账号登录。 | 需求管理智能化需在码道代码智能体中体现。 | | 2 | 已[购买需求管理服务](https://support.huaweicloud.com/usermanual-projectman/codeartsreq_29_0015.html#codeartsreq_29_0015__zh-cn_topic_0000001727259969_zh-cn_topic_0000001596418622_section1374218911912)。 | 通过码道代码智能体使用需求管理服务的相关功能，需已购买需求管理服务。 | | 3 | 已[配置CodeArts Req项目级角色权限](https://support.huaweicloud.com/productdesc-projectman/projectman_07_0005.html#section1)。 | 通过码道代码智能体使用需求管理服务的相关功能，需已配置完相关权限。 | #### 操作步骤 1. 单击[下载CodeArts工具链插件](https://cnnorth4-cloudide-marketplace.obs.cn-north-4.myhuaweicloud.com/codearts/codeartsplugin/1.0.0/CodeArtsPlugin_resource_26.0924.1549_all.tar.gz)。 2. 单击执行插件包中install.bat脚本，完成插件和KooCLI安装。 3. 完成[KooCLI初始化配置](https://support.huaweicloud.com/usermanual-hcli/hcli_03_002.html)，将常用的永久AK/SK和区域信息存储在配置文件中，避免执行操作时频繁输入这些固定信息。 4. 打开码道代码智能体聊天窗口，用自然语言告诉它你想做什么，就可以开始使用。 ![](https://support.huaweicloud.com/usermanual-projectman/public_sys-resources/note_3.0-zh-cn.png) - 首次使用码道代码智能体执行需求管理相关操作时，分析过程时间较长，随着指令使用的次数增加，分析速度会逐步提升，响应时间逐渐缩短。 - 不同码道代码智能体客户端的界面风格有所差异，实际操作请以所用工具的显示为准。 #### 场景示例 需求管理服务（CodeArts Req）的工作项管理、工作项状态流转、分解子工作项、关联工作项、工作项评论管理、工作项附件管理、计划管理、配置查询八大场景，均可让码道代码智能体完成。 #### 场景一：工作项管理 - 创建工作项 以执行如下指令创建工作项为例，进行说明。 ``` 在云平台项目中创建一个名称为my-test-bug的Bug工作项。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到工作项创建成功的结果信息。效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749255055.png "点击放大") 您可以在控制台的缺陷列表页看到新建的Bug工作项。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749375155.png "点击放大") - 查询工作项数据 以执行如下指令查询工作项数据为例，进行说明。 ``` 查询云平台项目中的Bug工作项数据。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到该工作项的详细信息。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719935698.png "点击放大") - 更新工作项 以执行如下指令更新工作项计划完成时间为例，进行说明。 ``` 更新云平台项目中的my-test-bug工作项计划完成时间为明天。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到更新计划完成时间成功的显示。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749264117.png "点击放大") - 删除工作项 以执行如下指令删除工作项为例，进行说明。 ``` 删除云平台项目中的my-test-bug工作项。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。删除过程中将出现弹框确认，如下图所示。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749386287.png "点击放大") 回复确认删除后，码道代码智能体继续执行。执行成功后，您可以看到工作项删除成功。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719790068.png "点击放大") 在控制台缺陷列表页中无该工作项信息： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719790114.png "点击放大") 在回收站中可以看到该删除的工作项，可以根据需要对其进行恢复： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749390025.png "点击放大") #### 场景二：工作项状态流转 以执行如下指令流转工作项状态到分析为例，进行说明。 ``` 将云平台项目中的IR20260908171790状态流转到分析。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到状态流转成功。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749393819.png "点击放大") #### 场景三：分解子工作项 以执行如下指令分解子工作项为例，进行说明。 ``` 将云平台项目中的IR20260908171790工作项分解为2个SR。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到分解成功的2个SR基本信息。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719957548.png "点击放大") 在控制台研发需求列表页，你也可以查看子工作项信息。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719958026.png "点击放大") #### 场景四：关联工作项 以执行如下指令将两个工作项设置为关联项为例，进行说明。 ``` 在云平台项目中把IR20260908171790工作项和BUG20260908171775工作项关联起来。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到IR工作项与Bug工作项已成功建立关联关系。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749278449.png "点击放大") 您还可以在对应工作项详情页查看关联工作项信息。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719959722.png "点击放大") #### 场景五：工作项评论管理 以执行如下指令给工作项添加评论为例，进行说明。 ``` 在云平台项目中，给BUG20260908171775工作项添加评论“已修复”。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到给工作项添加评论成功。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719961782.png "点击放大") 您还可以在对应工作项详情页查看添加的评论信息。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719804028.png "点击放大") #### 场景六：工作项附件管理 以执行如下指令给工作项上传附件为例，进行说明。 ``` 在风险管理项目中，对mytest工作项上传附件D:\test\testbug.pdf。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到给工作项上传附件成功。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749420653.png "点击放大") 您还可以在工作项详情页查看上传的附件。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002719980770.png "点击放大") #### 场景七：计划管理 以执行如下指令创建迭代为例，进行说明。 ``` 在风险管理项目中，创建一个名称为springtest，时间为当月的迭代。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到迭代创建成功。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002720340766.png "点击放大") 您还可以在迭代页面查看新创建的迭代。 ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002749838595.png "点击放大") #### 场景八：配置查询 以执行如下指令查询项目成员为例，进行说明。 ``` 查询风险管理项目的项目成员。 ``` 码道代码智能体开始分析任务并执行，整个过程在对话流里实时显示。执行成功后，您可以看到项目成员信息。 效果示例： ![](https://support.huaweicloud.com/usermanual-projectman/zh-cn_image_0000002754342901.png "点击放大") #### 相关文档 关于CodeArts工具链插件的更多使用场景，请参考[通过CodeArts工具链插件开发旅游小助手](https://support.huaweicloud.com/bestpractice-codeartsagent/codeartsagent_bp_0052.html)。