fizzy.do - have your agent read, understand and update your fizzy.do boards

Fizzy CLI 综合评估

核心用法

Fizzy CLI 是 Fizzy 看板平台的官方命令行工具，提供完整的 CRUD 操作能力。用户可通过 Token 或 Magic Link 完成认证，支持账户配置持久化存储于 ~/.config/fizzy/config.json。

主要功能模块：

| 模块 | 典型操作 |

|------|---------|

| Boards | 列表/创建/更新/删除看板 |

| Cards | 卡片生命周期管理（创建、移动、关闭、重新打开、分类） |

| Comments | 评论的增删查 |

| Tags/Columns/Users | 元数据管理 |

| Notifications | 未读通知查询 |

输出格式：支持人类可读表格、--json 原始 API 返回、--plain 稳定行输出，便于脚本集成。

显著优点

1. 完整工作流覆盖：从认证到资源管理，覆盖看板操作全生命周期
2. 脚本友好：明确的退出码、稳定输出格式、环境变量支持（FIZZY_TOKEN 等）
3. 配置层级清晰：flags > 环境变量 > 配置文件 > 默认值，符合 12-Factor 应用原则
4. 非交互式支持：--code 参数支持 CI/CD 等自动化场景

潜在局限

• 平台锁定：专属于 Fizzy 生态，无法迁移至其他看板工具
• 网络依赖：所有操作需实时连接 Fizzy 云服务
• 功能边界：不支持离线模式或本地缓存同步
• 认证方式局限：Magic Link 需邮箱交互，可能不适用于纯自动化流水线

适合人群

• 需要批量操作看板卡的团队管理员
• 希望将看板状态集成到 CI/CD 管道的 DevOps 工程师
• 偏好终端工作流的开发者
• 需要自动化报告生成的项目经理

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| 凭证泄露 | Token 存储于环境变量或配置文件 | 使用密钥管理工具，避免提交至版本控制 |

| 误操作 | `delete`、`close` 等操作不可逆 | 操作前使用 `--json` 确认目标资源 |

| 权限边界 | CLI 权限与网页端一致 | 为自动化任务创建专用服务账号，最小权限原则 |

| 配置漂移 | 多环境（本地/CI）配置不一致 | 显式传递 `--account` 和 `--base-url` 参数 |

来源评估

由 tobiasbischoff 发布，版本 1.0，属官方工具文档。安全报告为系统占位符，未执行实际扫描。

核心用法

Fizzy CLI Skill 是一款纯文档型技能，专为 Fizzy 看板平台的命令行操作提供完整指南。用户通过 fizzy-cli 工具可实现身份认证、资源配置及全量 CRUD 操作。认证方式支持 Token 直接登录和邮箱魔法链接双模式，配置持久化至 ~/.config/fizzy/config.json 并支持环境变量覆盖（FIZZY_TOKEN、FIZZY_ACCOUNT 等）。

核心工作流覆盖六大对象类型：Boards（看板创建、重命名、删除）、Cards（卡片增删改、状态流转、列迁移、图片上传）、Comments（评论列表与创建）、Tags/Columns/Users/Notifications（元数据管理与消息中心）。输出格式支持三级切换：默认表格、JSON 原始数据、纯文本行格式，便于脚本集成与自动化流水线对接。

显著优点

1. 零安全风险架构：纯 Markdown 文档实现，无可执行代码、无外部依赖、无网络调用，CLS 认证达 S+ 顶级安全级别，适合高敏感环境部署。

2. 完整功能映射：文档覆盖 Fizzy 官方 CLI 全部核心能力，从认证到通知中心无一遗漏，可作为团队标准化操作手册直接使用。

3. 配置灵活性：支持 flags > 环境变量 > 配置文件 > 默认值的四级优先级覆盖，满足本地开发、CI/CD、多账号切换等复杂场景。

4. 自动化友好：--json 与 --plain 输出模式专为脚本设计，结合 triage/not-now 等状态流转命令，可快速搭建 GitOps 风格的工作流自动化。

潜在缺点与局限性

1. 纯文档无执行能力：Skill 本身不包含可执行逻辑，需用户本地预装 fizzy-cli 二进制工具，安装与版本管理需自行处理。

2. 平台绑定单一：仅支持 Fizzy 生态，无法迁移至 Trello、Notion、Linear 等其他看板工具，多平台用户需维护多套技能。

3. 高级功能缺失：未涉及 Webhook 配置、批量导入导出、权限细粒度管理等企业级功能，复杂组织治理场景可能力有未逮。

4. 社区维护属性：作者为个人开发者（Tobias Bischoff），无商业 SLA 保障，长期更新与兼容性适配存在不确定性。

适合的目标群体

• 开发者/DevOps 工程师：偏好命令行交互、需将看板操作嵌入 CI/CD 脚本的技术团队。
• 远程协作团队：追求标准化流程、希望通过 Git 管理看板配置的基础设施团队。
• 自动化爱好者：构建个人工作流机器人、定时同步任务状态的效率工具用户。
• 安全敏感组织：因合规要求拒绝运行任何可执行代码 Skill 的企业环境。

常规使用风险

1. 凭证管理风险：文档建议通过环境变量注入 Token，但用户若误将 $FIZZY_TOKEN 写入日志或提交至代码仓库，将导致账号泄露。建议配合 .env 文件与 direnv 等工具隔离敏感信息。

2. CLI 版本漂移：Fizzy 官方 CLI 迭代可能引入破坏性变更，Skill 文档若未及时同步，命令参数失效将导致脚本故障。建议锁定 CLI 版本并建立升级测试流程。

3. 误操作不可逆性：fizzy-cli board delete 等删除命令无交互确认（除非 CLI 自身实现），脚本批量执行时可能误删生产数据。建议操作前强制 --dry-run 或备份机制。

4. 网络与 API 可用性：虽 Skill 本身无网络调用，但实际 CLI 操作依赖 Fizzy 服务端（app.fizzy.do），服务中断或 API 限流将直接影响工作流连续性。

5. 配置冲突排查成本：多级配置覆盖机制虽灵活，但环境变量与配置文件的隐式交互可能导致预期外行为，需投入时间理解优先级规则。