名称： fizzy-cli
描述： 使用 fizzy-cli 工具通过命令行进行身份验证，并管理 Fizzy 看板、卡片、评论、标签、列、用户和通知。当需要列出、创建、更新或删除 Fizzy 资源，或编写 Fizzy 工作流脚本时，可应用此技能。
元数据：
author: tobiasbischoff
version: "1.0"

Fizzy CLI 技能

使用此技能通过 fizzy-cli 命令操作 Fizzy 看板。内容涵盖身份验证、配置和常见的 CRUD 工作流。

快速开始

1) 身份验证
- 令牌方式：
- fizzy-cli auth login --token $FIZZY_TOKEN
- 魔法链接方式：
- fizzy-cli auth login --email user@example.com
- 在非交互式环境中，需传递 --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 "新名称"
• 删除：fizzy-cli board delete <board-id>

卡片

• 列出看板上的卡片：
• fizzy-cli card list --board-id <board-id>
• 创建卡片：
• fizzy-cli card create --board-id <board-id> --title "添加深色模式" --description "切换主题"
• 上传图片：
• fizzy-cli card create --board-id <board-id> --title "添加英雄图" --image ./hero.png
• 更新卡片：
• fizzy-cli card update <card-number> --title "已更新" --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 "看起来不错"

标签、列、用户、通知

• 标签：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。
• 优先级：命令行标志 > 环境变量 > 配置文件 > 默认值。

故障排除

• 如果请求因身份验证错误而失败，请运行 fizzy-cli auth status 并重新登录。
• 如果账户缺失，请通过 fizzy-cli account set <slug> 或 fizzy-cli config set --account <slug> 进行设置。
• 使用 fizzy-cli --help 或 fizzy-cli help <command> 查看完整用法。