@newpeak/barista-cli 0.1.8 → 0.1.10

package/docs/commands/liberica/teams/projects/list.md

@@ -0,0 +1,179 @@
+# barista liberica teams projects list
+
+分页查询团队项目列表。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams projects list` |
+| 功能描述 | 分页查询团队项目列表 |
+| HTTP方法 | GET |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ⬜ 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
+        └── EnterpriseTeamProjectController.java
+            └── page(@GetResource(path = "/page"))
+                └── public ResponseData<PageResult<TeamProjectResponse>> page(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject TeamProjectQueryRequest teamProjectQueryRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamProjectQueryRequest.java
+            ├── pageNo: Long (分页当前页，0-based)
+            ├── pageSize: Long (分页大小)
+            ├── teamProjectId: Long (项目ID)
+            ├── projectCode: String (项目代号，模糊搜索)
+            ├── projectName: String (项目名称，模糊搜索)
+            ├── parentProjectId: Long (父项目ID)
+            ├── projectLevel: Integer (项目级别)
+            ├── projectDesc: String (项目描述)
+            ├── teamProjectStatus: String (项目状态)
+            └── teamProjectIdList: Set<Long> (项目ID集合)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamProjectResponse.java
+            ├── teamProjectId: Long
+            ├── projectCode: String
+            ├── projectName: String
+            ├── parentProjectId: Long
+            ├── projectLevel: Integer
+            ├── projectDesc: String
+            ├── teamProjectStatus: String
+            ├── createTime: String
+            └── updateTime: String
+```
+
+### 分页包装器
+```
+cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
+    ├── totalRows: long
+    ├── pageSize: long
+    ├── pageNo: long
+    └── rows: List<TeamProjectResponse>
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams projects list [options]
+```
+
+### Usage
+```bash
+barista liberica teams projects list
+barista liberica teams projects list --page 2 --size 50
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --page | -p | number | ⬜ | 1 | 页码（1-based） | pageNo |
+| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
+| --code | -c | string | ⬜ | - | 按项目代号搜索 | projectCode |
+| --name | -n | string | ⬜ | - | 按项目名称模糊搜索 | projectName |
+| --status | — | string | ⬜ | - | 按状态筛选 | teamProjectStatus |
+| --parent-id | — | string | ⬜ | - | 按父项目ID筛选 | parentProjectId |
+| --level | -l | number | ⬜ | - | 按项目级别筛选 | projectLevel |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --page / -p | pageNo | number→Long, CLI page - 1 | >= 0 |
+| --size / -s | pageSize | number→Long | > 0 |
+| --code / -c | projectCode | 直接传递 | max=50 |
+| --name / -n | projectName | 直接传递 | max=200 |
+| --status | teamProjectStatus | 直接传递 | max=20 |
+| --parent-id | parentProjectId | string→Long | - |
+| --level / -l | projectLevel | number→Integer | - |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamProjectExceptionEnum.java
+            └── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001957001 | 团队项目不存在 | 详情/编辑/删除时ID不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | `@GetResource(path = "/page")` | 无 requiredPermission（列表查询无需权限码） |
+
+**注意**：list 和 page 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
+
+## 2.7 实现要点
+
+1. **分页默认值**：page=1, size=20
+2. **分页转换**：CLI 使用 1-based 页码，API 使用 0-based，转换公式 `pageNo = options.page - 1`
+3. **响应字段**：后端返回 `rows`、`totalRows`、`pageNo`、`pageSize`，不使用 `records` 或 `total`
+4. **ID 类型处理**：`teamProjectId`、`parentProjectId` 等 ID 字段后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
+5. **无结果处理**：返回空列表，不抛出异常
+6. **输出格式**：表格形式展示 ID、Code、Name、Level、Status
+
+## 2.8 示例用法
+
+```bash
+# 默认分页
+barista liberica teams projects list
+
+# 指定页码和每页条数
+barista liberica teams projects list --page 2 --size 50
+
+# 按状态筛选
+barista liberica teams projects list --status ACTIVE
+
+# 按项目代号搜索
+barista liberica teams projects list --code "ERP"
+
+# 按项目名称搜索
+barista liberica teams projects list --name "生产系统"
+
+# 按父项目ID筛选
+barista liberica teams projects list --parent-id 123456789
+
+# 按项目级别筛选
+barista liberica teams projects list --level 1
+
+# 组合筛选
+barista liberica teams projects list --status ACTIVE --level 1
+
+# JSON 输出
+barista liberica teams projects list --json
+```

package/docs/commands/liberica/teams/projects/update.md

@@ -0,0 +1,175 @@
+# barista liberica teams projects update
+
+更新团队项目。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams projects update <project-id>` |
+| 功能描述 | 更新已有团队项目的字段信息 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
+        └── EnterpriseTeamProjectController.java
+            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TeamProjectPermissionConstants.EDIT_TEAM_PROJECT))
+                └── public ResponseData<? extends TeamProjectResponse> edit(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.edit.class) TeamProjectRequest teamProjectRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamProjectRequest.java
+            ├── teamProjectId: Long (@NotNull on edit)
+            ├── projectCode: String (@NotBlank, max=50)
+            ├── projectName: String (@NotBlank, max=200)
+            ├── parentProjectId: Long
+            ├── projectLevel: Integer (@NotNull on edit)
+            ├── projectDesc: String
+            ├── teamProjectStatus: String (@NotBlank, max=20)
+            └── tenantId: Long
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamProjectResponse.java
+            ├── teamProjectId: Long
+            ├── projectCode: String
+            ├── projectName: String
+            ├── parentProjectId: Long
+            ├── projectLevel: Integer
+            ├── projectDesc: String
+            ├── teamProjectStatus: String
+            ├── createTime: String
+            └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams projects update <project-id> [options]
+```
+
+### Usage
+```bash
+barista liberica teams projects update 123456789 --name "新名称"
+barista liberica teams projects update 123456789 --status INACTIVE
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| project-id | string | ✅ | 要更新的项目ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --name | -n | string | ⬜ | - | 项目名称 | projectName |
+| --code | -c | string | ⬜ | - | 项目代号 | projectCode |
+| --desc | -d | string | ⬜ | - | 项目描述 | projectDesc |
+| --status | -s | string | ⬜ | - | 项目状态 | teamProjectStatus |
+| --parent-id | — | string | ⬜ | - | 父项目ID | parentProjectId |
+| --level | -l | number | ⬜ | - | 项目级别 | projectLevel |
+| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| project-id (位置参数) | teamProjectId | string→Long | @NotNull |
+| --name / -n | projectName | 直接传递 | @NotBlank, max=200 |
+| --code / -c | projectCode | 直接传递 | @NotBlank, max=50 |
+| --desc / -d | projectDesc | 直接传递 | - |
+| --status / -s | teamProjectStatus | 直接传递 | @NotBlank, max=20 |
+| --parent-id | parentProjectId | string→Long | - |
+| --level / -l | projectLevel | number→Integer | @NotNull |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamProjectExceptionEnum.java
+            └── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
+```
+
+### Service层业务校验
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-business/
+    └── src/main/java/com/newpeak/liberica/team/modular/business/
+        └── TeamProjectBusiness.java
+            └── edit(TeamProjectRequest request)
+                └── 检查团队项目是否存在
+                    └── throw new TeamServiceException(TeamProjectExceptionEnum.TEAM_PROJECT_NOT_EXIST)
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001957001 | 团队项目不存在 | 更新的 project-id 不存在或已被删除 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamProjectPermissionConstants.EDIT_TEAM_PROJECT` | Controller层 `@PostResource(requirePermissionCode = "EDIT_TEAM_PROJECT")` |
+
+## 2.7 实现要点
+
+1. **必填参数**：`project-id` 作为位置参数必须提供
+2. **部分更新**：只传入的选项才会被包含在请求体中，未传入的字段保持原值
+3. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+4. **ID 类型处理**：`teamProjectId`、`parentProjectId` 后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
+5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
+
+## 2.8 示例用法
+
+```bash
+# 更新名称
+barista liberica teams projects update 123456789 --name "修正后的名称"
+
+# 更新状态
+barista liberica teams projects update 123456789 --status INACTIVE
+
+# 更新代号
+barista liberica teams projects update 123456789 --code "NEW-CODE"
+
+# 更新父项目和级别
+barista liberica teams projects update 123456789 \
+  --parent-id 987654321 \
+  --level 2
+
+# Dry-run 预览
+barista liberica teams projects update 123456789 --name "测试更新" --dry-run
+
+# JSON 输出
+barista liberica teams projects update 123456789 --name "测试更新" --json
+```

package/docs/commands/liberica/teams/tasks/create.md

@@ -0,0 +1,163 @@
+# barista liberica teams tasks create
+
+创建新的团队任务。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams tasks create` |
+| 功能描述 | 创建新的团队任务 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
+        └── EnterpriseTeamTaskController.java
+            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = TeamTaskPermissionConstants.ADD_TEAM_TASK))
+                └── public ResponseData<TeamTaskResponse> add(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.add.class) TeamTaskRequest teamTaskRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamTaskRequest.java
+            ├── taskCode: String (max=255, 可选，为空则后端可自动生成)
+            ├── taskName: String (@NotBlank, max=255)
+            ├── taskDescription: String
+            ├── priority: String (max=255)
+            ├── status: String (max=255)
+            ├── creator: String (max=255)
+            ├── creatorName: String (max=255)
+            ├── assignTo: String (@NotBlank, max=255)
+            ├── assignToName: String (max=255)
+            ├── startTime: Instant
+            ├── endTime: Instant
+            ├── completionRate: BigDecimal
+            ├── tags: String (max=512)
+            └── refId: String (max=255)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── TeamTaskResponse.java
+            ├── taskId: Long
+            ├── taskCode: String
+            ├── taskName: String
+            ├── taskDescription: String
+            ├── priority: String
+            ├── status: String
+            ├── creator: String
+            ├── creatorName: String
+            ├── assignTo: String
+            ├── assignToName: String
+            ├── startTime: Instant
+            ├── endTime: Instant
+            ├── completionRate: BigDecimal
+            ├── tags: String
+            └── refId: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams tasks create [options]
+```
+
+### Usage
+```bash
+barista liberica teams tasks create --title "示例任务" --assign-to "user123"
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --title | -t | string | ✅ | - | 任务标题 | taskName |
+| --desc | -d | string | ⬜ | - | 任务描述 | taskDescription |
+| --priority | -p | string | ⬜ | MEDIUM | 优先级 | priority |
+| --status | -s | string | ⬜ | OPEN | 任务状态 | status |
+| --assign-to | -a | string | ✅ | - | 负责人ID或账号 | assignTo |
+| --tags | — | string | ⬜ | - | 标签，逗号分隔 | tags |
+| --task-code | — | string | ⬜ | - | 任务编码 | taskCode |
+| --start-time | — | string | ⬜ | - | 开始时间(ISO-8601) | startTime |
+| --end-time | — | string | ⬜ | - | 结束时间(ISO-8601) | endTime |
+| --completion-rate | — | number | ⬜ | - | 完成率(0-100) | completionRate |
+| --ref-id | — | string | ⬜ | - | 引用ID | refId |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --title / -t | taskName | 直接传递 | @NotBlank, max=255 |
+| --desc / -d | taskDescription | 直接传递 | - |
+| --priority / -p | priority | 直接传递 | max=255 |
+| --status / -s | status | 直接传递 | max=255 |
+| --assign-to / -a | assignTo | 直接传递 | @NotBlank, max=255 |
+| --tags | tags | 直接传递 | max=512 |
+| --task-code | taskCode | 直接传递 | max=255 |
+| --start-time | startTime | string→Instant | ISO-8601 |
+| --end-time | endTime | string→Instant | ISO-8601 |
+| --completion-rate | completionRate | number→BigDecimal | 0-100 |
+| --ref-id | refId | 直接传递 | max=255 |
+
+**自动填充字段（不通过CLI参数）：**
+| 字段 | 来源 |
+|------|------|
+| tenantId | 后端从 X-TENANT-ID header 注入 |
+| creator | 当前认证用户上下文自动填充 |
+| creatorName | 当前认证用户上下文自动填充 |
+| taskCode | 为空时后端可自动生成编码 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamTaskExceptionEnum.java
+            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001952001 | 团队任务不存在 | 复制/编辑时引用的原任务不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamTaskPermissionConstants.ADD_TEAM_TASK` | Controller层 `@PostResource(requirePermissionCode = "ADD_TEAM_TASK")` |
+
+## 2.7 实现要点
+
+1. **必填字段**：`--title`、`--assign-to` 必须提供
+2. **默认值**：`--priority` 默认 `MEDIUM`，`--status` 默认 `OPEN`
+3. **Creator 自动填充**：`creator`、`creatorName` 从当前认证用户上下文获取
+4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+5. **tenantId 来源**：来自 X-TENANT-ID header，不通过请求体传递
+6. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取

package/docs/commands/liberica/teams/tasks/delete.md

@@ -0,0 +1,109 @@
+# barista liberica teams tasks delete
+
+删除团队任务。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica teams tasks delete <task-id>` |
+| 功能描述 | 删除指定的团队任务 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
+        └── EnterpriseTeamTaskController.java
+            └── delete(@PostResource(path = "/delete", requiredPermission = true, requirePermissionCode = TeamTaskPermissionConstants.DEL_TEAM_TASK))
+                └── public ResponseData<?> delete(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.delete.class) TeamTaskRequest teamTaskRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
+        └── TeamTaskRequest.java
+            └── taskId: Long (@NotNull for delete.class)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
+        └── SuccessResponseData<?>
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica teams tasks delete <task-id> [options]
+```
+
+### Usage
+```bash
+barista liberica teams tasks delete 123456789
+barista liberica teams tasks delete --task-id 123456789 --force
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式（不实际调用API） |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| <task-id> | — | string | ✅ | - | 任务ID（位置参数） | taskId |
+| --task-id | -i | string | ✅ | - | 任务ID（选项参数） | taskId |
+| --force | -f | boolean | ⬜ | false | 跳过确认直接删除 | - |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| <task-id> / --task-id | taskId | string→Long | @NotNull |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-team/team-api/
+    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
+        └── TeamTaskExceptionEnum.java
+            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001952001 | 团队任务不存在 | 任务ID不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `TeamTaskPermissionConstants.DEL_TEAM_TASK` | Controller层 `@PostResource(requirePermissionCode = "DEL_TEAM_TASK")` |
+
+## 2.7 实现要点
+
+1. **位置参数与选项参数**：同时支持 `barista liberica teams tasks delete <id>` 和 `barista liberica teams tasks delete --task-id <id>`
+2. **参数解析优先级**：选项参数 > 位置参数
+3. **确认提示**：默认删除前弹出确认提示，使用 `--force` 可跳过
+4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
+5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取