名称： plane
描述： "使用 plane CLI 管理 Plane.so 项目和工作项。可列出项目，创建/更新/搜索问题，管理周期和模块，添加评论，以及分配成员。"
元数据： {"moltbot":{"requires":{"bins":["plane"],"env":["PLANE_API_KEY","PLANE_WORKSPACE"]},"primaryEnv":"PLANE_API_KEY","emoji":"✈️","homepage":"https://github.com/JinkoLLC/plane-skill","install":[{"id":"github","kind":"download","url":"https://raw.githubusercontent.com/JinkoLLC/plane-skill/main/scripts/plane","targetDir":"~/.local/bin/","bins":["plane"],"label":"从 GitHub 下载 plane CLI"}]}}

Plane 技能

通过 plane CLI 与 Plane.so 项目管理工具进行交互。

安装

下载 CLI 脚本并赋予可执行权限：

curl -o ~/.local/bin/plane https://raw.githubusercontent.com/JinkoLLC/plane-skill/main/scripts/plane
chmod +x ~/.local/bin/plane

请确保 ~/.local/bin 已添加到您的 PATH 环境变量中。

配置

export PLANE_API_KEY="您的API密钥"
export PLANE_WORKSPACE="您的工作区标识"

获取 API 密钥的路径：Plane → 个人资料设置 → 个人访问令牌

工作区标识是 URL 路径中的一段（例如，对于 https://app.plane.so/my-team/，标识为 my-team）。

命令

当前用户

plane me                      # 显示已认证用户信息

工作区成员

plane members                 # 列出所有工作区成员（姓名、邮箱、角色、ID）

项目

plane projects list                                      # 列出所有项目
plane projects get PROJECT_ID                            # 获取项目详情
plane projects create --name "我的项目" --identifier "PROJ"  # 创建项目

工作项（问题）

# 列出工作项
plane issues list -p PROJECT_ID
plane issues list -p PROJECT_ID --priority high --assignee USER_ID

# 获取详情
plane issues get -p PROJECT_ID ISSUE_ID

# 创建
plane issues create -p PROJECT_ID --name "修复登录Bug" --priority high
plane issues create -p PROJECT_ID --name "新功能" --assignee USER_ID --label LABEL_ID

# 更新
plane issues update -p PROJECT_ID ISSUE_ID --state STATE_ID --priority medium

# 分配给成员
plane issues assign -p PROJECT_ID ISSUE_ID USER_ID_1 USER_ID_2

# 删除
plane issues delete -p PROJECT_ID ISSUE_ID

# 在整个工作区搜索
plane issues search "登录Bug"

评论

plane comments list -p PROJECT_ID -i ISSUE_ID            # 列出工作项的评论
plane comments list -p PROJECT_ID -i ISSUE_ID --all      # 显示所有活动（不仅是评论）
plane comments add -p PROJECT_ID -i ISSUE_ID "看起来不错，现在合并"  # 添加评论

周期（迭代）

plane cycles list -p PROJECT_ID
plane cycles get -p PROJECT_ID CYCLE_ID
plane cycles create -p PROJECT_ID --name "迭代 1" --start 2026-01-27 --end 2026-02-10

模块

plane modules list -p PROJECT_ID
plane modules get -p PROJECT_ID MODULE_ID
plane modules create -p PROJECT_ID --name "认证模块" --description "认证相关功能"

状态与标签

plane states -p PROJECT_ID    # 列出工作流状态（用于获取状态ID）
plane labels -p PROJECT_ID    # 列出标签（用于获取标签ID）

输出格式

默认输出为格式化表格。如需原始 JSON 数据，请添加 -f json 参数：

plane projects list -f json
plane issues list -p PROJECT_ID -f json

典型工作流

1. plane projects list — 查找您的项目 ID
2. plane states -p PROJECT_ID — 查看可用状态
3. plane members — 查找成员 ID 用于分配
4. plane issues create -p PROJECT_ID --name "任务" --priority high --assignee USER_ID
5. plane comments add -p PROJECT_ID -i ISSUE_ID "已开始处理此项"