# 反馈协作与 Plane 项目管理

平台通过 Plane 做问题反馈与项目管理。共有三组工具：

- `service_feedback_*` — 面向终端用户的反馈提交（首选）。
- `data_plane_*` — 平台封装的 Plane **V1 API**，多数无需 workspace/project 参数，直接查当前配置的项目。**只读**。
- `plane_*` — Plane 官方 MCP 工具，需显式传 `workspace_slug` / `project_id`，覆盖更完整的对象层级。**只读**。

优先级：普通反馈用 `service_feedback_*`；查看/分析项目数据优先 `data_plane_*`（参数少）；需要跨工作空间或更细粒度对象时用 `plane_*`。

## 1. 反馈提交（service_feedback_*）

| 工具 | 参数 | 说明 |
|------|------|------|
| `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 直查（data_plane_*，参数简洁）

项目 / 成员 / 状态 / 标签：
| 工具 | 参数 |
|------|------|
| `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）。