介绍
# Fizzy CLI Skill
使用此技能通过 `fizzy-cli` 命令操作 Fizzy 看板。它涵盖了身份验证、配置和常见的 CRUD 工作流程。
## 快速开始
1) 身份验证 - 令牌： - `fizzy-cli auth login --token $FIZZY_TOKEN` - 魔法链接： - `fizzy-cli auth login --email [email protected]` - 如果是非交互模式，请传递 `--code ABC123`。
2) 设置默认值 - 仅设置账户：`fizzy-cli account set 897362094` - 持久化基础 URL + 账户：`fizzy-cli config set --base-url https://app.fizzy.do --account 897362094`
3) 验证访问权限 - `fizzy-cli auth status` - `fizzy-cli account list`
## 常见任务
### 看板 - 列表：`fizzy-cli board list` - 创建：`fizzy-cli board create --name "Roadmap"` - 更新：`fizzy-cli board update <board-id> --name "New name"` - 删除：`fizzy-cli board delete <board-id>`
### 卡片 - 列出看板上的卡片： - `fizzy-cli card list --board-id <board-id>` - 创建卡片： - `fizzy-cli card create --board-id <board-id> --title "Add dark mode" --description "Switch theme"` - 上传图片： - `fizzy-cli card create --board-id <board-id> --title "Add hero" --image ./hero.png` - 更新卡片： - `fizzy-cli card update <card-number> --title "Updated" --tag-id <tag-id>` - 移至“稍后处理”： - `fizzy-cli card not-now <card-number>` - 关闭 / 重新打开： - `fizzy-cli card close <card-number>` - `fizzy-cli card reopen <card-number>` - 分类 / 取消分类： - `fizzy-cli card triage <card-number> --column-id <column-id>` - `fizzy-cli card untriage <card-number>`
### 评论 - 列出评论： - `fizzy-cli comment list <card-number>` - 创建评论： - `fizzy-cli comment create <card-number> --body "Looks good"`
### 标签、列、用户、通知 - 标签：`fizzy-cli tag list` - 列：`fizzy-cli column list --board-id <board-id>` - 用户：`fizzy-cli user list` - 通知：`fizzy-cli notification list --unread`
## 输出模式 - 默认：人类可读的表格。 - 机器输出： - `--json` 用于获取原始 API JSON。 - `--plain` 用于获取稳定的基于行的输出。
## 配置与身份验证说明 - 配置文件：`~/.config/fizzy/config.json`。 - 环境变量：`FIZZY_BASE_URL`、`FIZZY_TOKEN`、`FIZZY_ACCOUNT`、`FIZZY_CONFIG`。 - 优先级：flags > env > config file > defaults。
## 故障排除 - 如果请求因身份验证错误而失败，请运行 `fizzy-cli auth status` 并重新登录。 - 如果缺少账户，请通过 `fizzy-cli account set <slug>` 或 `fizzy-cli config set --account <slug>` 进行设置。 - 使用 `fizzy-cli --help` 或 `fizzy-cli help <command>` 查看完整用法。