gitcode

GitCode Skill

GitCode platform (gitcode.com) operations via REST API. No local CLI or MCP needed.

Prerequisites

1. Obtain a GitCode personal access token with scopes: api, read_repository, write_repository
2. Set environment variable: GITCODE_TOKEN (preferred) or pass as --token in API calls
3. Base URL: https://gitcode.com/api/v5

Dispatch Logic

See workflows.md for detailed instructions per workflow.

Intent	Trigger keywords	API endpoints
Auth / Status	"login", "whoami", "token"	GET /user
Create Issue	"create issue", "report bug", "feature request"	POST /repos/{owner}/{repo}/issues
Create PR	"create PR", "pull request", "open PR"	POST /repos/{owner}/{repo}/pulls
Review PR	"review", "code review", "check PR"	GET /repos/{owner}/{repo}/pulls/{number}, GET /repos/{owner}/{repo}/pulls/{number}/files, POST /repos/{owner}/{repo}/pulls/{number}/reviews
Merge PR	"merge", "merge PR"	PUT /repos/{owner}/{repo}/pulls/{number}/merge
List Repos	"list repos", "my repos", "search"	GET /user/repos, GET /repos/{owner}/{repo}
Create Repo	"create repo", "new repo", "init"	POST /user/repos
Fork Repo	"fork", "fork repo"	POST /repos/{owner}/{repo}/forks
Branches	"branch", "branches", "create branch"	GET /repos/{owner}/{repo}/branches, POST /repos/{owner}/{repo}/branches
File Ops	"read file", "update file", "create file"	GET /repos/{owner}/{repo}/contents/{path}, PUT /repos/{owner}/{repo}/contents/{path}
Release	"release", "publish", "changelog"	POST /repos/{owner}/{repo}/releases
Comments	"comment", "reply"	POST /repos/{owner}/{repo}/issues/{number}/comments

Authentication

All API requests need header:

Authorization: Bearer $GITCODE_TOKEN
Content-Type: application/json

Token优先从环境变量 GITCODE_TOKEN 读取。未设置时提示用户去 https://gitcode.com/-/user_settings/personal_access_tokens 创建。

Common Patterns

Create Issue

POST /api/v5/repos/{owner}/{repo}/issues
Body: {"title": "...", "body": "...", "labels": ["bug"], "assignee_ids": []}

Create PR

POST /api/v5/repos/{owner}/{repo}/pulls
Body: {"title": "...", "head": "feature-branch", "base": "master", "body": "..."}

Merge PR

PUT /api/v5/repos/{owner}/{repo}/pulls/{number}/merge
Body: {"merge_method": "squash"}

Create Release

POST /api/v5/repos/{owner}/{repo}/releases
Body: {"tag_name": "v1.0.0", "name": "v1.0.0", "body": "Release notes"}

Full API reference: api.md

Cross-Skill Flow

Step	Skill	Role
1. Understand requirements	gitcode	Read Issue content and comments
2. Locate code	gitcode	Read repo files to find relevant areas
3. Write code	dotnet / bash / powershell	Actual implementation
4. Submit PR	gitcode	Create PR with Conventional Commits title
5. Code review	gitcode	Multi-dimension review, post findings
6. Merge & Release	gitcode	Merge PR, create release with changelog