gitee-comments
Installation
SKILL.md
Gitee 评审评论(文件/文档行级意见)
对 Gitee 仓库的当前分支某文件某几行进行评审评论管理(承载 commit 与隐藏规则见「机制事实」)。评审意见存在 Gitee 服务端,不进入 git 对象,对 git 本身零影响。
本 skill 只做「评审评论」域(增删查改回)。不做 PR/Issue 操作——那是 Gitee 官方 MCP 的职责。
机制事实
commit 对用户隐藏:下述 commit 仅是底层实现载体,向用户沟通时只讲「文件:行区间」,不要出现 sha/commit 字样。承载 commit 由 skill 自动选定(默认当前分支最新提交),用户无感。
- 评论必然依托某个 commit:创建端点是
POST /repos/{owner}/{repo}/commits/{sha}/comments,sha是必填路径参数;GET /repos/{owner}/{repo}/comments及其/{id}管理端点注释均为「Commit 评论」。没有不挂 commit 的独立仓库评论。 - Gitee 不支持真正的行锚定:尽管官方文档为
POST /comments列出path(文件相对路径)+position(Diff 相对行数),实测服务器会静默忽略这两个参数——POST 后响应仅含id/body/user/source/target(issue:null,pull:null)/时间,无任何行/文件字段。即无法像 GitHub/GitLab 那样把评论精确锚定到某文件某行。 - 定位只能靠 body 内的
location文本约定:如location: docs/L1/USER-STORY.md:55-69。这就是本 skill 把「文件:行区间」写进 body 的原因。