Planka看板管理

技能简介

该技能通过Python CLI封装plankapy库，提供对Planka看板系统的完整操作能力，包括项目、面板、列表、卡片及通知的管理。

业务背景

团队通过命令行直接操控Planka看板，无需打开浏览器即可完成项目结构调整、任务卡片流转和进度追踪。适合开发运维人员快速批量处理任务，或将看板操作嵌入自动化脚本，减少上下文切换带来的效率损耗。

落地案例：某技术团队每日站会前，负责人运行一条命令获取所有未读通知，筛选出阻塞状态的卡片ID，再批量移动到"待评审"列表。遇到紧急缺陷时，工程师直接在终端创建卡片并指派给同事，全程不离开IDE环境，保持开发心流。

能做什么

• 查看和管理Planka项目与面板结构
• 创建、更新、移动和删除任务卡片
• 查询卡片详情及附件信息
• 获取系统通知（全部或未读）
• 本地存储登录凭证，避免重复输入

使用说明

安装步骤：

1. 添加Homebrew仓库：brew tap voydz/homebrew-tap
2. 安装CLI工具：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

输入与输出

见下方输入与输出表格。

风险提示

• 密码以明文形式存储在本地配置文件，多人共用设备时存在泄露风险
• 删除卡片操作不可逆，执行前请确认卡片ID
• 频繁调用API可能触发Planka服务器的速率限制
• 网络不稳定时可能导致凭证保存失败或命令超时

来源信息

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