高效敏捷的项目看板管家

Fizzy 官方 CLI 工具文档技能，支持看板/卡片/任务全流程管理，需配置 Token 连接自托管或云端服务。

基本信息

• 技能名称?fizzy
• 中文名称?高效敏捷的项目看板管家
• 作者?Portavion
• 分类?专业技能
• 版本?v1.0.0
• 标签?project-program-management, productivity, api, automation, backend, devops

使用方法

使用说明
核心用法
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 的读写权限管理
   潜在缺点与局限性
6. 学习成本较高 ：需要理解 ID 与 Number 的双标识符系统，以及卡片列表与详情返回字段不一致的设计
7. 依赖外部 CLI ：必须预先通过 Homebrew 安装 fizzy-cli ，增加了环境配置复杂度
8. 无原生图形界面 ：纯命令行交互对非技术用户不够友好
9. 分页限制 ：列表命令不支持 --limit ，需配合 jq 手动截取
10. 步骤数据获取受限 ： steps 仅在 card show 中返回，无法批量获取
    适合的目标群体
    技术团队开发者、项目经理，习惯命令行工作流
    需要自动化项目管理流程的 DevOps 工程师
    使用 Fizzy 作为看板工具且偏好 CLI 效率的中小团队
    需要与自托管 Fizzy 实例集成的企业用户
    使用风险
11. Token 安全管理 ： FIZZY_TOKEN 需妥善保管，避免硬编码或日志泄露
12. 命令注入风险 ：用户输入通过 CLI 参数传递，需确保特殊字符正确转义
13. 网络依赖 ：所有操作依赖 Fizzy API 可用性，离线场景无法使用
14. 版本兼容性 ：fizzy-cli 更新可能导致命令行为变化，需关注版本锁定