# issue +create

> **前置条件：** 先阅读 [`../gitlink-shared/SKILL.md`](../../gitlink-shared/SKILL.md) 了解认证、全局参数和安全规则。

Create a new issue in the current repository. Uses the v1 API which requires `status_id` and `priority_id` — the CLI automatically sets defaults (`status_id: 1` = open, `priority_id: 2` = normal).

## 命令

```bash
# Create issue with title only
gitlink-cli issue +create -t "Bug: login page crashes"

# Create issue with title and description
gitlink-cli issue +create -t "Feature request" -b "Add dark mode support"

# Create issue with assignee and milestone
gitlink-cli issue +create -t "Fix CI pipeline" -b "Flaky tests" -a user123 -m 5
```

## 参数

| 参数 | 必填 | 说明 |
|------|------|------|
| `--title, -t` | **是** | Issue 标题（映射为 API 字段 `subject`） |
| `--body, -b` | 否 | Issue 描述（映射为 API 字段 `description`） |
| `--assignee, -a` | 否 | 指派人登录名（映射为 API 字段 `assigned_to_id`） |
| `--milestone, -m` | 否 | 里程碑 ID（映射为 API 字段 `fixed_version_id`） |
| `--label` | 否 | 标签 ID |
| `--owner` | 否 | 仓库所有者（自动从 git remote 解析） |
| `--repo` | 否 | 仓库名称（自动从 git remote 解析） |
| `--format` | 否 | 输出格式: `json`/`table`/`yaml` |
| `--debug` | 否 | 开启调试输出 |

## API

```
POST /v1/{owner}/{repo}/issues
Body: { "subject": title, "status_id": 1, "priority_id": 2, "done_ratio": 0, "description": body, ... }
```

## Workflow

1. **Confirm** the issue title (and optional body) with the user before creating.
2. **Execute** `gitlink-cli issue +create -t "..." -b "..."`.
3. **Report** the created issue number and URL to the user.

> [!CAUTION]
> This is a **Write Operation** -- confirm user intent before executing.

## References

- [gitlink-issue](../SKILL.md)
- [gitlink-shared](../../gitlink-shared/SKILL.md)
