Planka看板管理

技能简介

planka-cli 是一个围绕 plankapy 库构建的命令行封装工具，用于在终端中直接操作 Planka 看板实例。无需打开浏览器即可完成项目、面板、列表、卡片的增删改查，同时支持通知查询。

业务背景

开发团队常需在服务器或终端环境中快速管理看板任务，频繁切换浏览器打断工作流。该工具让工程师直接在命令行完成Planka看板的全部操作，无需离开终端即可维护项目进度，特别适合自动化脚本集成和远程服务器运维场景。

落地案例：某后端工程师在排查生产问题时收到紧急需求，需将缺陷卡片从高优先级列表移至当前迭代。他直接在SSH终端执行planka-cli，凭已保存的凭证秒级登录，通过层级浏览定位目标卡片，一键调整列表归属并更新排序，全程无需打开浏览器，问题解决后立即回归原故障排查流程。

能做什么

• 登录并保存多实例凭证，快速切换工作环境
• 浏览项目层级结构：项目 → 面板 → 列表 → 卡片
• 创建、更新、删除卡片，调整所属列表与排序位置
• 查看全部或未读通知
• 验证与服务端的连接状态

使用说明

安装步骤

1. 添加 Homebrew tap 源：brew tap voydz/homebrew-tap
2. 安装二进制文件：brew install planka-cli

首次配置

planka-cli login --url https://planka.example --username alice --password secret

常用操作

# 检查连接
planka-cli status

# 列出所有项目
planka-cli projects list

# 创建卡片
planka-cli cards create <LIST_ID> "任务标题"

# 移动卡片到指定列表顶部
planka-cli cards update <CARD_ID> --list-id <LIST_ID> --position top

# 查看未读通知
planka-cli notifications unread

退出登录执行 planka-cli logout 清除本地凭证。

输入与输出

见下方输入与输出表格。

风险提示

• 密码以明文形式存储于本地配置文件，多人共用设备时存在泄露风险
• 删除卡片操作不可逆，执行前建议确认卡片 ID
• 频繁调用 API 可能触发 Planka 服务端速率限制
• 自托管实例若使用自签名证书，需提前配置系统信任

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/voydz/planka-cli/SKILL.md
来源类型：GitHub 仓库