| name | yx-commands-workitems |
| description | 列出云效工作项(我负责的,含需求、任务、缺陷) |
列出当前用户在云效中负责的工作项(需求、任务、缺陷)。用户 ID 会在首次运行时通过 token 自动获取并缓存。
步骤:
- 列出我负责的未完成工作项(默认,按类别分组展示):
yx-code workitems
- 按状态过滤:
yx-code workitems --status all
yx-code workitems --status 开发中
yx-code workitems --project <项目标识符>
- 获取完整 JSON 数据(供 AI 整理展示):
yx-code workitems --json
参数说明:
| 参数 | 说明 | 可选值 | 默认值 |
|---|
--status / -s | 状态过滤 | undone(排除已完成)/ all / 中文状态名 | undone |
--project / -p | 指定项目 | 项目标识符或名称 | 全部项目 |
--json | JSON 格式输出 | - | false |
AI 整理展示格式:
当用户请求查看工作项时,执行 yx-code workitems --json,然后将 JSON 数据整理成以下格式展示:
## 我负责的工作项(未完成)
### 需求(N 项)
| 编号 | 标题 | 状态 | 优先级 | 创建人 | 所在项目 | 创建日期 |
|------|------|------|--------|--------|----------|----------|
| XJHS-1898 | 太保:兼容团险网点人员 | 处理中 | 中 | 谢思超 | 芯计划书 | 2024-11-26 |
### 任务(N 项)
| 编号 | 标题 | 状态 | 优先级 | 创建人 | 所在项目 | 创建日期 |
|------|------|------|--------|--------|----------|----------|
...
### 缺陷(N 项)
| 编号 | 标题 | 状态 | 优先级 | 创建人 | 所在项目 | 创建日期 |
|------|------|------|--------|--------|----------|----------|
...
规则:
- 按 category 字段分组:
Req=需求、Task=任务、Bug=缺陷
- 若某类别无数据则跳过
- 标题过长时截断显示(保留前 30 个字符)
- 若
parent_id 非空,在标题后附注"(子项)"
- 优先级为空时显示"-"