| name | plane |
| description | 管理 Plane 工作项与项目能力。当用户提到工作项标识(如 GAEA-30)或需要查询/维护 Plane 项目、工作项、评论、链接、关系、附件、成员、features、子工作项时使用。 |
Plane Skill
通过本机安装的 plane 命令管理 Plane。
严格要求
- 优先使用
plane 命令,不要手写 curl 直接调 Plane API
- 自动化消费结果时,优先加
--json
- 用户消息中只要出现工作项标识(如
GAEA-30、TEST-12),优先先查询该工作项
- API key 模式不能依赖自动发现 workspace;若命令提示 workspace 缺失,先让用户配置或切换 workspace
- 如果提交代码,commit message 必须包含带
# 前缀的工作项标识与工时,格式:
<type>(scope): <summary> #<工作项标识> Cost:<工时>
示例:
feat(cli): 完善 issue 链接管理 #GAEA-30 Cost:30m
意图判断
用户提到:
GAEA-30、TEST-12、OPS-7 这类标识
- 工作项 / issue / work item
- 项目 / project
- 标签 / label
- 评论 / comment
- 活动 / activity
- 链接 / link
- 关系 / relation
- 附件 / attachment
- 成员 / members
- features / 自动化开关
则应优先考虑使用本技能。
触发规则
1. 工作项标识触发
如果用户消息中直接提到工作项标识,默认先查详情:
plane issue get GAEA-30 --json
如果需要继续操作,沿用同一个 key:
plane issue comments ls GAEA-30 --json
plane issue links add GAEA-30 --url 'https://example.com/doc' --json
plane issue attachments upload GAEA-30 --file ./spec.pdf --json
2. 多 workspace 场景
如果账号下存在多个 workspace,先确认当前 workspace:
plane workspace current
plane workspace ls
plane workspace use <slug>
如果 API key 无法列出 workspace,直接显式配置已知 workspace:
plane config set --workspace <slug>
3. 代码提交场景
如果当前任务涉及代码实现、修复、重构、测试补充,并且要提交代码,则 commit message 使用:
<type>(scope): <summary> #GAEA-30 Cost:30m
细化规则如下:
- 只有在实际提交代码时才追加
#<工作项标识> Cost:<工时>
- 若本次改动没有明确工作项标识,则不要伪造工作项标识
- 工作项标识在 commit message 中必须写成
#GAEA-30、#TEST-12 这种形式,不能省略 #
- 若本次改动明确只对应一个工作项,则追加一个标识:
feat(cli): 完善 issue 链接管理 #GAEA-30 Cost:30m
- 若本次改动同时覆盖多个工作项,优先拆分为多个提交;若确实只能一次提交,则在同一条 commit message 末尾顺序追加多个标识:
refactor(cli): 收敛 issue 帮助信息 #GAEA-30 Cost:20m #GAEA-31 Cost:15m
type(scope): summary 仍然遵循仓库原有提交规范,工作项信息只是追加在末尾,不替代原规范
type 建议使用:feat / fix / refactor / docs / test / chore
scope 尽量使用实际改动范围,如:cli、issue、project、config
summary 使用简洁中文动词短句,不加句号
Cost 使用本次提交对应工作项的实际处理耗时,可使用小时、分钟,或小时+分钟组合,推荐格式:
Cost:30m
Cost:2h
Cost:1h30m
30 分钟写成:Cost:30m
2 小时写成:Cost:2h
1 小时 30 分钟写成:Cost:1h30m
Cost 不写小数,不写中文单位,例如以下都不推荐:
Cost:0.5h
Cost:30分钟
Cost:0h30m
Cost:1h0m
Cost:0h0m
- 如果本次只是查询、分析、讨论,且没有提交代码,不要附加该标记
高频命令
基础
plane me
plane workspace current
plane workspace ls
plane workspace use <slug>
plane config list
Project
plane project ls --json
plane project get <project-id> --json
plane project summary <project-id> --json
plane project create --name Demo --identifier DEMO --json
plane project update <project-id> --description 'updated description' --json
plane project members workspace --json
plane project members ls --project <project-id> --json
plane project members add --project <project-id> --member <user-id> --role member --json
plane project features get <project-id> --json
plane project features set <project-id> --epics on --milestones on --auto-transition on --json
Issue / Work Item
plane issue ls --project <project-id> --json
plane issue mine --json
plane issue todo --json
plane issue get GAEA-30 --json
plane issue key GAEA-30 --json
plane issue search --query login --workspace-search --json
plane issue create --project <project-id> --name "First work item" --json
plane issue create --parent GAEA-30 --name "Child work item" --json
plane issue update --project <project-id> <issue-id> --priority high --json
Labels / Comments / Activities
plane issue labels ls --project <project-id> --json
plane issue labels create --project <project-id> --name backend --color '#ff6600' --json
plane issue comments ls GAEA-30 --json
plane issue comments add GAEA-30 --html '<p>Need follow-up</p>' --json
plane issue comments update GAEA-30 <comment-id> --html '<p>Updated</p>' --json
plane issue activities ls GAEA-30 --json
Links / Relations / Attachments
plane issue links ls GAEA-30 --json
plane issue links add GAEA-30 --url 'https://example.com/doc' --json
plane issue links update GAEA-30 <link-id> --url 'https://example.com/doc-v2' --json
plane issue relations ls GAEA-30 --json
plane issue relations add GAEA-30 --relation-type blocking --issues '<other-issue-id>' --json
plane issue attachments ls GAEA-30 --json
plane issue attachments upload GAEA-30 --file ./spec.pdf --json
参数规则
指定 Assignee
issue create 与 issue update 的 --assignees 支持:
如需查看可分配成员:
plane project members workspace --json
Issue Key 自动解析
以下命令支持直接使用 GAEA-30 这类 key,而无需显式传 --project:
issue get
issue comments ls/add/update
issue activities ls
issue links ls/add/update
issue relations ls/add
issue attachments ls/upload
issue create --parent GAEA-30
输出约定
- 人类阅读:默认输出
- 机器消费:
--json
- 当命令失败时,
--json 返回结构化错误对象
限制
- 不提供 project/workspace 删除命令
- 子资源删除命令必须显式传
--confirm
project members ls 受 Plane 外部 API 返回结构限制,仅稳定返回用户资料
- 某些写操作在启用读副本的实例上,可能存在短暂回读延迟