plane-collaboration.md 4.1 KB
反馈协作与 Plane 项目管理
平台通过 Plane 做问题反馈与项目管理。共有三组工具：
service_feedback_*— 面向终端用户的反馈提交（首选）。data_plane_*— 平台封装的 Plane V1 API，多数无需 workspace/project 参数，直接查当前配置的项目。只读。plane_*— Plane 官方 MCP 工具，需显式传workspace_slug/project_id，覆盖更完整的对象层级。只读。
优先级：普通反馈用 service_feedback_*；查看/分析项目数据优先 data_plane_*（参数少）；需要跨工作空间或更细粒度对象时用 plane_*。
1. 反馈提交（servicefeedback*）
| 工具 | 参数 | 说明 |
|---|---|---|
service_feedback_create [写操作] |
title(必填)、type(bug/feature,必填)、category、priority、description |
创建 Plane Intake Issue |
service_feedback_history |
无 | 查带 Feedback 标签的提交历史 |
category：bug 类 =bug/ui/performance/other；feature 类 =new/improvement/experience。priority：urgent/high/medium/low/none（默认 medium）。
2. Plane V1 直查（dataplane*，参数简洁）
项目 / 成员 / 状态 / 标签：
| 工具 | 参数 |
|------|------|
| data_plane_list_projects | 无 |
| data_plane_get_project | project_id |
| data_plane_get_project_summary | project_id、fields(逗号分隔) |
| data_plane_list_project_members | 无 |
| data_plane_list_workspace_members | 无 |
| data_plane_list_states | 无 |
| data_plane_list_labels | 无 |
工作项（Work Item）：
| 工具 | 参数 |
|------|------|
| data_plane_list_work_items | assignee、label、priority、state（均可选过滤） |
| data_plane_get_work_item | work_item_id |
| data_plane_get_work_item_by_identifier | identifier(如 PROJ)、sequence_id(如 42) |
| data_plane_search_work_items | query、limit(默认20) |
| data_plane_list_work_item_activities | work_item_id |
| data_plane_list_work_item_comments | work_item_id |
| data_plane_list_work_item_attachments | work_item_id |
| data_plane_list_work_item_links | work_item_id |
| data_plane_list_work_item_relations | work_item_id |
迭代（Cycle） / 模块（Module） / Intake：
| 工具 | 参数 |
|------|------|
| data_plane_list_cycles | 无 |
| data_plane_get_cycle | cycle_id |
| data_plane_list_cycle_issues | cycle_id |
| data_plane_list_modules | 无 |
| data_plane_get_module | module_id |
| data_plane_list_module_issues | module_id |
| data_plane_get_intake_issue_list | 无 |
| data_plane_get_intake_issue_detail | intake_id |
典型流程：list_projects → list_work_items（按 state/assignee 过滤）→ get_work_item + list_work_item_comments/activities 看详情；或用 get_work_item_by_identifier（PROJ-42）直达。
3. Plane 官方工具（plane_*，需 workspace_slug/project_id）
用于需要指定工作空间/项目的场景。先 plane_list_workspaces 拿 slug，再 plane_list_projects 拿 project_id。
工作空间 / 项目：
plane_list_workspaces(无)、plane_get_workspace(workspace_slug)、plane_list_workspace_members(workspace_slug)、plane_list_stickies(workspace_slug)、plane_list_projects(workspace_slug)、plane_get_project(workspace_slug,project_id)、plane_list_project_members、plane_list_states、plane_list_labels（后三者均需 workspace_slug+project_id）。
工作项 / 收件箱：
plane_list_issues(workspace_slug,project_id)、plane_get_issue(+issue_id)、plane_get_issue_activity(+issue_id)、plane_get_sub_issues(+issue_id)、plane_list_intake_issues(workspace_slug,project_id,status)、plane_get_intake_issue(+issue_id)。
status过滤如-2,-1,0,1,2。
迭代 / 模块 / 页面：
plane_list_cycles、plane_get_cycle(+cycle_id)、plane_list_modules、plane_get_module(+module_id)、plane_list_pages、plane_get_page(+page_id)、plane_get_page_description(+page_id)（均需 workspace_slug+project_id，get 类再加对应对象 id）。