codearts-issue（代码艺术问题）

codearts-issue (v1)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../codearts-shared/SKILL.md 了解配置与认证。

CodeArts ProjectMan 工作项（IPD）管理。所有命令均使用 config.json 中的 projectId——若未配置，先执行 codearts-cli config set projectId <uuid>。

issue_type 取值

不同项目类型支持的 issue_type 不同：

命令

issue list

查询项目工作项列表。--issue-type 必填。

# 最简
codearts-cli issue list --issue-type Bug

# 查"我名下的 Bug"（assignee = config 中的 userId）
codearts-cli issue list --issue-type Bug \
  --filter "[{\"assignee\":{\"values\":[\"$(codearts-cli config show | jq -r .userId)\"],\"operator\":\"||\"}}]"

# 多类型 + 分页 + 排序
codearts-cli issue list --issue-type US,Task \
  --page-no 1 --page-size 50 \
  --sort-field created_date --sort-asc

# 按自定义字段过滤（直接用 code 作字段名，例：Task 任务类型 = 设计）
codearts-cli issue list --issue-type Task \
  --filter '[{"c7447378174477062144":{"values":["1255457356664852481"],"operator":"||"}}]'

API 参考: ListIpdProjectIssues

filter 参数结构

[ { "<字段名>": { "values": ["..."], "operator": "||" } } ]

数组的每个元素是一个以字段名为 key 的 map；值是 ConditionVO。

operator 取值：||（OR，默认）、!（NOT）、=（等于单值）、<> / < / >（日期/数字范围）。

issue show

查询单个工作项详情。

codearts-cli issue show <issue_id> --issue-type US

API 参考: ShowIssueDetail

issue create

创建工作项。

# 最简（assignee 从 config userId 自动填充）
codearts-cli issue create \
  --title "修复登录超时" \
  --description "用户反馈在弱网环境下登录超时" \
  --category Bug

# 显式指定 assignee
codearts-cli issue create \
  --title "接入 CodeArts CLI" \
  --description "完成 AK/SK 与 RunPipeline 接入" \
  --category US \
  --assignee <user_id_32char>

# 完整字段用 body-file（自定义字段如 Task 任务类型也走这条路径）
codearts-cli issue create --body-file task.json
# task.json 含 "custom_fields":[{"code":"c7447378174477062144","value":"<id>"}]

API 参考: CreateIpdProjectIssue

*使用 --body / --body-file 时不需要这些 flag。

Task 任务类型字段

Task 的「任务类型」是项目级单选枚举自定义字段。code 与 value id 项目级（换项目用 issue show 重取），创建/修改走 custom_fields:[{code,value}]，过滤走 list --filter 用 code 作字段名——示例分别见 issue create / issue batch-update / issue list。

字段 code：c7447378174477062144

⚠️ 写错格式时服务端静默返 status:"success" 但不更新，必须 issue show <id> --issue-type Task 回查 .result[0].c7447378174477062144.display_value 确认。

issue batch-update

批量更新工作项。

# 更新多个 issue 的 priority
codearts-cli issue batch-update \
  --id 111,222 --id 333 \
  --category Bug \
  --attribute '{"priority":"中"}'

API 参考: BatchUpdateIpdIssues

*category 也可在 --attribute JSON 中提供。

attribute 常用字段（完整列表见 API 参考，仅 category 必填，其余按需传）：

示例：

# 挂到父工作项 + 关联其它工作项
codearts-cli issue batch-update --id 111,222 --category US \
  --attribute '{"parent_id":"1001","link":"2001,2002"}'

# 批量改状态
codearts-cli issue batch-update --id 111,222 --category Bug \
  --attribute '{"status":"Delivered"}'

# 改自定义字段（例：Task 任务类型 -> 测试，详见「Task 任务类型字段」）
codearts-cli issue batch-update --id <task_id> --category Task \
  --attribute '{"custom_fields":[{"code":"c7447378174477062144","value":"1255457356664852482"}]}'

issue relations

查询工作项的端到端追溯关系（E2E 图）——父/子工作项、关联提交 / MR / 分支 / 测试用例 / 测试计划 / 文档。

# 查询一个 US 的追溯图
codearts-cli issue relations <issue_id> --category US

# 跨项目（上游 / 下游）
codearts-cli issue relations <issue_id> --category Bug --is-src true

API 参考: ListE2EGraphsOpenAPI

返回值：id、project_id、domain_id、category、number、status（初始/分析/测试/开发/完成）、title，以及 trace_list 数组 —— 元素包含：

• parent_issues / child_issues — 父/子工作项
• associate_workitems — 关联的其它工作项
• associate_commits / associate_branches / associate_mergerequest — 关联的代码资产
• associate_testcases / associate_testplans — 关联的测试资产
• associate_documents — 关联的文档

issue members

查询当前 projectId 下的所有项目成员。

codearts-cli issue members

API 参考: ListProjectUsers

返回值：result 数组，每条 UserVO 包含：

• user_id（32 位 UUID，用于 issue create --assignee 和 issue list --filter 的 assignee 字段）
• user_num_id（整数短 ID）
• user_name、nick_name、domain_id、domain_name（租户名）
• role_id / role_name（多个角色逗号分隔）

典型用法：给 issue create 找 --assignee 时，先跑 issue members | jq '.result[] | {user_id, user_name, nick_name}' 拿到真实的 user_id —— 不要把 tenant_id 当 user_id 传（格式都是 32 位 UUID 但含义不同，会触发 PM.02177003 非目标项目成员）。

issue statuses

查询某个工作项类型（category_id）在项目里配置的状态定义。

codearts-cli issue statuses <category_id>

API 参考: ListIssueStatues

有效 category_id 取值（API 文档枚举）：10001 / 10020 / 10021 / 10022 / 10023 / 10027 / 10028 / 10029 / 10033 / 10065。

注意：字符串分类名（Bug/Task/US/…）与 category_id 的映射是项目级配置，不同项目不同 —— 不要硬编码。在 CodeArts Req 控制台 工作项类型 设置页或其它接口的返回里查一次，本地记下来。

返回值：result 数组，每条含 name（状态名，如 "新建"/"开发中"/"已关闭"）与 belonging（生命周期分桶：START / IN_PROGRESS / END）。

issue comment list

查询某个工作项的评论 / 回复 / 操作日志列表。

# 默认拉评论 + 回复 + 操作日志
codearts-cli issue comment list <issue_id>

# 只看用户评论，倒序，每页 50
codearts-cli issue comment list <issue_id> \
  --category comment --date-desc true --page-size 50

# 跨项目查询
codearts-cli issue comment list <issue_id> --target-project-id <other-project-uuid>

API：GET /v1/ipdprojectservice/projects/{project_id}/issues/{issue_id}/comments（无公开文档，从 UI 反推并验证）

⚠️ 上游对 category 是必填校验，缺失会返回 200 但 status:"failed" —— CLI 默认值已覆盖 UI 的合集，无需手填。

category 取值：

返回值：result.comment_list[]，每条含：

• id、issue_id、type（comment / reply / operation）、category（Comment / Reply / Operation，首字母大写）
• description —— HTML 体
• creator_info —— {user_id, user_name, nick_name, domain_id, domain_name,...}
• created_date —— 毫秒时间戳字符串
• top / top_flag —— 是否置顶
• extend_attribute / extend_attribute_obj —— 仅 Operation 类型有，记录字段变更详情（如状态从 _Start_ 改为 Start）

issue comment add

给某个工作项发评论。

codearts-cli issue comment add <issue_id> \
  --issue-category Task \
  --description "<p>评审通过</p>"

# 长文本走文件
codearts-cli issue comment add <issue_id> --issue-category Task --description-file note.html

# 完整 JSON
codearts-cli issue comment add <issue_id> --body-file comment.json

API：POST /v1/ipdprojectservice/projects/{project_id}/issues/{issue_id}/comments（无公开文档，从 UI 反推并验证）

• 用 --body / --body-file 时不需要这两个 flag。

body 字段（直接给 --body-file 用）：

{ "category": "comment", "issue_category": "Task", "description": "<p>...</p>" }

返回值：result 是单个对象，含 id（新评论 ID）、issue_id、description、created_by、creator_info 等。

常见错误

• PM.02177003 非目标项目成员：assignee 的 user_id 不是项目成员。注意不要把 tenant_id 当 user_id（格式相同但含义不同）。
• issue_type 不支持：检查项目类型（系统设备 / 独立软件 / 云服务）是否支持该 issue_type。