fizzy

核心用法

Fizzy Skill 是一套完整的项目管理 CLI 工具使用指南，覆盖看板（Board）、卡片（Card）、步骤（Step）、评论（Comment）和反应（Reaction）的全生命周期管理。用户通过配置 FIZZY_TOKEN 和 FIZZY_ACCOUNT 环境变量完成认证后，即可使用 fizzy 命令行工具执行各类操作。

核心工作流包括：创建看板 → 添加卡片 → 分配任务步骤 → 协作评论 → 状态流转（triage/not-now/done）。卡片支持双标识符系统（内部 ID 与数字编号），所有 CLI 操作均使用数字编号。支持丰富的筛选和分页功能，如按列、标签、负责人过滤，以及 --all 批量获取。

显著优点

1. 完整的项目管理闭环：从创建到归档的全流程支持，包括独特的 "golden" 星标、 postpone 延迟队列等高级功能
2. 灵活的部署方式：同时支持官方云服务和自托管实例（FIZZY_API_URL）
3. 强大的数据处理能力：内置 jq 查询示例，支持复杂的 JSON 数据筛选和转换
4. 富文本与媒体支持：HTML 描述、内联图片、卡片头图等多媒体能力
5. 细粒度权限控制：基于 Personal Access Token 的读写权限管理

潜在缺点与局限性

1. 学习成本较高：需要理解 ID 与 Number 的双标识符系统，以及卡片列表与详情返回字段不一致的设计
2. 依赖外部 CLI：必须预先通过 Homebrew 安装 fizzy-cli，增加了环境配置复杂度
3. 无原生图形界面：纯命令行交互对非技术用户不够友好
4. 分页限制：列表命令不支持 --limit，需配合 jq 手动截取
5. 步骤数据获取受限：steps 仅在 card show 中返回，无法批量获取

适合的目标群体

• 技术团队开发者、项目经理，习惯命令行工作流
• 需要自动化项目管理流程的 DevOps 工程师
• 使用 Fizzy 作为看板工具且偏好 CLI 效率的中小团队
• 需要与自托管 Fizzy 实例集成的企业用户

使用风险

1. Token 安全管理：FIZZY_TOKEN 需妥善保管，避免硬编码或日志泄露
2. 命令注入风险：用户输入通过 CLI 参数传递，需确保特殊字符正确转义
3. 网络依赖：所有操作依赖 Fizzy API 可用性，离线场景无法使用
4. 版本兼容性：fizzy-cli 更新可能导致命令行为变化，需关注版本锁定