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 更新可能导致命令行为变化，需关注版本锁定

核心用法

Fizzy Skill 是一款纯文档型 CLI 工具使用指南，用于管理 Fizzy 看板系统中的看板、卡片、任务步骤、评论和反应。用户通过 Homebrew 安装 fizzy-cli 后，配合 Personal Access Token 即可通过命令行完成完整的项目管理操作。

主要功能覆盖：

• 看板管理：创建、更新、删除看板，设置访问权限和自动延期周期
• 卡片操作：CRUD 完整支持，支持富文本描述、内联图片、背景图片、标签管理和状态流转（创建→分配→延期→关闭）
• 任务步骤：为卡片添加待办事项，追踪完成状态
• 评论与反应：支持 HTML 富文本评论和 emoji 反应
• 高级查询：通过 jq 配合多维度过滤（状态、标签、负责人、专栏等）

关键设计： 卡片使用双标识系统——number（如 579）用于 CLI 命令，id（长字符串）仅用于 API 响应。所有列表操作支持 --all 分页获取和 --page 分页浏览。

显著优点

1. 零运行时风险：纯 Markdown 文档，无可执行代码、无依赖、无网络请求，安全审计满分
2. 命令覆盖完整：从基础 CRUD 到复杂工作流（带图片卡片创建、专栏流转、批量查询）均有示例
3. jq 集成友好：提供 15+ 个实用的 JSON 处理模式，大幅降低输出解析成本
4. 富文本支持完善：明确区分 signed_id（背景图）与 attachable_sgid（内联图）的使用场景
5. 多账户支持：通过 --account 和环境变量灵活切换工作空间

潜在局限

1. 依赖外部 CLI：必须预先安装 fizzy-cli，Skill 本身不封装安装逻辑
2. T3 来源可信度：维护者为个人开发者（portavion），非知名组织，长期维护存在不确定性
3. 无实时验证：文档示例中的占位符（如 https://fizzy.domain.net/）需用户自行替换，无配置校验机制
4. 版本耦合风险：fizzy-cli 升级可能导致命令参数变更，Skill 文档存在滞后可能

适合人群

• 已使用或计划使用 Fizzy 看板的团队
• 偏好命令行工作流、需要自动化项目管理的开发者
• 熟悉 jq 等 JSON 处理工具的技术用户
• 对安全敏感、需要纯文档型 Skill 的企业环境

常规风险

• 凭证管理：用户需自行安全存储 FIZZY_TOKEN，避免硬编码泄露
• 误操作覆盖：card update 等命令无交互确认，批量脚本需谨慎测试
• 数据归属：Skill 本身不传输数据，但 fizzy-cli 会将数据发送至用户配置的 API 端点，需确保端点可信