名称: planka
描述: 通过自定义 Python CLI 管理 Planka(看板)项目、面板、列表、卡片和通知。
元数据: {"clawdbot":{"emoji":"📋","requires":{"bins":["planka-cli"]}}}
本技能提供了一个围绕 plankapy 库的 CLI 封装,用于与 Planka 实例进行交互。
通过 Homebrew tap 安装:
bash
brew tap voydz/homebrew-tap
brew install planka-cli
配置:
使用 login 命令存储凭据:
bash
planka-cli login --url https://planka.example --username alice --password secret
# 或:python3 scripts/planka_cli.py login --url https://planka.example --username alice --password secret
使用已安装的 planka-cli 二进制文件运行 CLI:
# 显示帮助
planka-cli
# 检查连接状态
planka-cli status
# 登录到 Planka 实例
planka-cli login --url https://planka.example --username alice --password secret
# 移除已存储的凭据
planka-cli logout
# 列出项目
planka-cli projects list
# 列出面板(可按项目 ID 筛选)
planka-cli boards list [PROJECT_ID]
# 列出面板中的列表
planka-cli lists list <BOARD_ID>
# 列出列表中的卡片
planka-cli cards list <LIST_ID>
# 创建卡片
planka-cli cards create <LIST_ID> "卡片标题"
# 更新卡片
planka-cli cards update <CARD_ID> --name "新标题"
planka-cli cards update <CARD_ID> --list-id <LIST_ID>
planka-cli cards update <CARD_ID> --list-id <LIST_ID> --position top
# 删除卡片
planka-cli cards delete <CARD_ID>
# 通知管理
planka-cli notifications all
planka-cli notifications unread
列出所有面板:
planka-cli boards list
显示列表 ID 为 1619901252164912136 中的卡片:
planka-cli cards list 1619901252164912136
在列表 ID 为 1619901252164912136 中创建卡片:
planka-cli cards create 1619901252164912136 "发布 CLI"
将卡片移动到另一个列表:
planka-cli cards update 1619901252164912137 --list-id 1619901252164912136
将卡片移动到另一个列表并置顶:
planka-cli cards update 1619901252164912137 --list-id 1619901252164912136 --position top
通过更新卡片名称标记为完成:
planka-cli cards update 1619901252164912137 --name "完成:发布 CLI"