# course delete

一句话：删除整门课程（连带全部章/节），不可逆；仅下架课程可删，仅机构管理员可执行。

高风险命令：不带 `--yes` 会以 exit 10 拦截。确认流程见 [`zeyiji-shared`](../../zeyiji-shared/SKILL.md) 的高风险审批协议，Agent 不得自行添加 `--yes`。

向用户汇报前 MUST 遵循 [课程对外表达](zeyiji-course-presentation.md)。

## 命令

```bash
# 查看可删除的下架课程
zeyiji-cli course list --status 2 --jq ".records[] | {id, name, status}"

# 预览删除请求（不实际执行，不触发门禁）
zeyiji-cli course delete --course-id 123 --dry-run

# 删除（先按 shared 协议获得用户明确同意，再追加 --yes 重试）
zeyiji-cli course delete --course-id 123

# 上架课程先下架
zeyiji-cli course edit --id 123 --status 2
```

## 参数要点

| 参数 | 说明 |
|---|---|
| `--course-id` | 必填，课程 ID（通过 `course list` 获取） |
| `--yes` | 用户明确同意后由 Agent 追加，不可自行添加 |

## 对外结果

- 删除成功：说「已删除课程《课程名称》，相关章节目录已一并删除」。
- 用户确认阶段只说明课程名称、上下架状态和删除影响；不要展示请求 JSON、字段名或数字枚举。

## 常见错误

| 现象 | 处理 |
|---|---|
| 课程ID不能为空 | 补 `--course-id` |
| 当前为上架状态，无法删除 | 先 `course edit --id <ID> --status 2` |
| exit 10（confirmation_required） | 按 shared 审批协议向用户确认后加 `--yes` 重试 |
| 课程不存在 | 用 `course list` 核对 ID |