mcpField
G
gitee-pr

gitee-pr

github.com/bioshaunDevelopment036 installsUpdated 36w ago
Repository

About gitee-pr

gitee-pr is a script-based workflow for creating Gitee pull requests from a Git repository. It applies team rules to branch names, commit subjects, working-tree state, and Chinese PR content before pushing and creating the PR.

Key features

  1. 01Validate branch naming and commits
  2. 02Check working-tree state
  3. 03Enforce Chinese PR content template
  4. 04Push branches and create Gitee PRs
  5. 05Dry-run validation and body preview

Use cases

  1. 01Preparing a repository branch for a Gitee PR
  2. 02Checking commits against team conventions
  3. 03Previewing PR checks and generated content
  4. 04Auto-committing local changes before PR checks

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bioshaun/tc-skills --skill gitee-pr

After installing, type/gitee-prin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

gitee-pr-rules.md
agents/
openai.yaml
scripts/
create_gitee_pr.py

Details

From the project README

Gitee PR

Use scripts/create_gitee_pr.py to execute a rules-first PR workflow. Apply team rules from gitee-pr-rules.md before creating PR.

Rule Files

  • Main rules: gitee-pr-rules.md

Required Inputs

  • Set Gitee token: GITEE_TOKEN or --token.
  • Ensure remote is a Gitee repo or provide --repo owner/repo.
  • Run command inside a Git repository.

Workflow

  1. Resolve head and base branches.
  2. Enforce branch naming format: member/verb-description.
  3. Ensure working tree is clean before PR (or auto-commit when --auto-commit is enabled).
  4. Validate all commit subjects in remote/base..head with allowed prefixes:
    • feat:
    • fix:
    • docs:
    • refactor:
    • style:
    • test:
    • chore:
  5. Warn (non-blocking) when multiple core files are changed.
  6. Enforce Chinese PR content: title and body must include Chinese text.
  7. Enforce PR body template sections and order:
    • ## 改动了什么？
    • ## 为什么改动？
    • ## 测试结果？
    • ## 注意事项
  8. Push branch unless --no-push.
  9. Create PR via Gitee API and print PR URL.

Recommended Commands

export GITEE_TOKEN="<token>"
python3 scripts/create_gitee_pr.py \
  --base main \
  --title "修复：优化过滤逻辑"

# Auto-commit local changes before PR checks
python3 scripts/create_gitee_pr.py \
  --auto-commit \
  --commit-message "chore: prepare gitee pr changes" \
  --base main

# Validate checks and preview generated PR body without API call
python3 scripts/create_gitee_pr.py --base main --dry-run --no-push

# Keep custom body (must follow required template sections)
python3 scripts/create_gitee_pr.py \
  --base main \
  --body "$(cat pr-body.md)"

Default PR Body Template

When --body is not provided, script generates:

## 改动了什么？
- <commit summaries>

## 为什么改动？
- 请补充本次改动的业务背景和目标。

## 测试结果？
- 已检查提交前工作区为干净状态。
- 请补充本地测试命令与结果。

## 注意事项
- 无

Merge Cleanup

After PR merge, clean branch:

git branch -d <branch-name>
git push origin --delete <branch-name>

Comments

Markdown supported