Fizzy CLI Skill 用于通过 fizzy-cli 命令操作 Fizzy 看板,覆盖认证、配置以及常见的 CRUD 工作流。
用途 该技能面向需要在命令行中管理 Fizzy 看板、卡片、评论、标签、列、用户和通知的用户,适合终端操作或脚本自动化场景。
主要能力
- 认证与配置:支持令牌登录和魔法链接登录,可设置默认账户、基础 URL,并查看认证状态与账户列表。
- 看板管理:列出、创建、更新、删除看板。
- 卡片管理:在指定看板上列出卡片,创建卡片(可附带描述或上传图片),更新卡片,将卡片移至 Not Now,关闭或重新打开卡片,以及进行 triage/untriage 操作。
- 评论管理:列出卡片评论、创建评论。
- 其他资源:列出标签、列、用户和通知(支持仅显示未读)。
- 输出模式:默认人类可读表格,支持 --json 输出原始 API JSON,--plain 输出稳定的逐行文本。
使用方式 快速开始: 认证(令牌):fizzy-cli auth login --token $FIZZY_TOKEN 认证(魔法链接):fizzy-cli auth login --email user@example.com,非交互时传入 --code ABC123。 设置默认值:仅设置账户使用 fizzy-cli account set 897362094;持久化基础 URL 与账户使用 fizzy-cli config set --base-url https://app.fizzy.do --account 897362094。 验证访问: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。
配置与认证说明 配置文件位于 ~/.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> 查看完整用法。
适用场景与限制 适用于在命令行或自动化流程中管理 Fizzy 看板相关资源。具体平台支持、收费、价格、效果等资料暂未提供。