名称： planka
描述： 通过自定义的 Python CLI 管理 Planka（看板）项目、面板、列表、卡片和通知。
元数据： {"clawdbot":{"emoji":"📋","requires":{"bins":["planka-cli"]}}}

Planka CLI

本技能提供了一个围绕 plankapy 库的 CLI 封装，用于与 Planka 实例进行交互。

安装与配置

1. 通过 Homebrew tap 安装：
   bash brew tap voydz/homebrew-tap brew install planka-cli
   通过源码或 pipx 安装需要 Python 3.11+ 以使用 plankapy v2。

2. 配置：
   使用 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>

# 显示卡片详情（包含附件URL和评论文本）
planka-cli cards show <CARD_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 为 1619901252164912137 的详细信息：

planka-cli cards show 1619901252164912137

在列表 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"