|
| 1 | +--- |
| 2 | +description: |
| 3 | +globs: |
| 4 | +alwaysApply: false |
| 5 | +--- |
| 6 | +# MCP-Gitee Cursor Rule |
| 7 | + |
| 8 | +## 1. 工具选择与基本规则 |
| 9 | + |
| 10 | +- 用户可通过工具名称(如 list_user_repos、create_issue、create_pull 等)选择所需操作。 |
| 11 | +- 每个工具均有简要描述,帮助用户理解其用途。 |
| 12 | +- 工具参数分为必填和可选,必填项未填写时禁止提交,可选项未填写时自动采用默认值。 |
| 13 | +- 参数类型、可选值、默认值均由系统自动校验和提示。 |
| 14 | + |
| 15 | +## 2. 参数填写与校验 |
| 16 | + |
| 17 | +- 所有参数均有类型校验(如数字、字符串、布尔值)。 |
| 18 | +- 枚举参数(如 visibility、state 等)仅允许选择指定范围内的值。 |
| 19 | +- project_id、program_id、assignee_id 等 ID 参数必须为数字,禁止填写名称或别名。 |
| 20 | +- 若参数为 ID 且用户不清楚,可先通过相关工具(如 search_users、list_user_repos)查询获取。 |
| 21 | + |
| 22 | +## 3. 工具组合与典型流程 |
| 23 | + |
| 24 | +### 3.1 仓库/项目管理 |
| 25 | + |
| 26 | +- 查询我的仓库:使用 list_user_repos,支持按 affiliation、type、visibility 等筛选。 |
| 27 | +- 查看仓库文件:选中仓库后,使用 get_file_content 查看 README 或其他文件。 |
| 28 | +- 在仓库下创建 Issue/Pull Request:结合 create_issue 或 create_pull 工具。 |
| 29 | + |
| 30 | +### 3.2 工作项流转 |
| 31 | + |
| 32 | +- 查找项目下工作项:先用 list_user_repos 找到仓库,再用 list_repo_issues。 |
| 33 | +- 筛选我负责的工作项:list_repo_issues 填写 assignee_id(数字)。 |
| 34 | +- 更新/评论工作项:选中 Issue 后,使用 update_issue 或 comment_issue。 |
| 35 | + |
| 36 | +### 3.3 协作与代码合并 |
| 37 | + |
| 38 | +- 发起 Pull Request:list_user_repos 找到仓库,create_pull 填写分支、assignees 等。 |
| 39 | +- 查看/评论 Pull Request:list_repo_pulls 查看,list_pull_comments 或 comment_pull 参与讨论。 |
| 40 | +- 合并 Pull Request:merge_pull 工具。 |
| 41 | + |
| 42 | +### 3.4 版本发布 |
| 43 | + |
| 44 | +- 查看 Release:list_releases。 |
| 45 | +- 创建 Release:create_release,填写版本号、描述、目标分支等。 |
| 46 | + |
| 47 | +## 4. 工具间参数传递 |
| 48 | + |
| 49 | +- 工具输出的仓库名、用户ID、项目ID等可直接作为下一个工具的输入。 |
| 50 | +- 复杂操作建议分步进行,每步均可利用工具的筛选、查询和补全能力。 |
| 51 | + |
| 52 | +## 5. 智能提示与交互 |
| 53 | + |
| 54 | +- 系统自动提示参数类型、可选值、必填项。 |
| 55 | +- 参数填写错误时,系统给出明确提示并指导修正。 |
| 56 | +- 支持下拉选择、自动补全,减少手动输入错误。 |
| 57 | +- 不确定参数含义时,可查看工具描述或帮助文档。 |
| 58 | + |
| 59 | +## 6. 典型操作流程示例 |
| 60 | + |
| 61 | +### 示例1:新建 Issue 并指派同事 |
| 62 | + |
| 63 | +1. list_user_repos 查询仓库 |
| 64 | +2. search_users 查询同事ID |
| 65 | +3. create_issue 填写 owner、repo、title、assignee(同事ID)、program(项目ID,数字) |
| 66 | + |
| 67 | +### 示例2:查找并处理我负责的工作项 |
| 68 | + |
| 69 | +1. list_user_repos 查询仓库 |
| 70 | +2. list_repo_issues 填写 assignee_id(你的ID) |
| 71 | +3. update_issue 或 comment_issue 处理任务 |
| 72 | + |
| 73 | +### 示例3:发起代码合并并通知评审 |
| 74 | + |
| 75 | +1. list_user_repos 查询仓库 |
| 76 | +2. create_pull 发起 PR,填写 assignees |
| 77 | +3. comment_pull 留言提醒评审 |
| 78 | + |
| 79 | +### 示例3:实现 Issue 并创建 Pull Request |
| 80 | +1. 获取 Issue 详情:get_repo_issue_detail |
| 81 | +2. 获取 Issue 评论:list_issue_comments |
| 82 | +3. 新建分支 |
| 83 | +4. 实现 Issue |
| 84 | +5. 推送至远端 && 创建 Pull Request:create_pull |
| 85 | + |
| 86 | +--- |
| 87 | + |
| 88 | +**本规则适用于所有 MCP-Gitee 工具的终端用户,旨在提升操作效率、减少出错,支持多工具组合与参数智能传递。** |
0 commit comments