Gitee Contributing Guide

Welcome to the ParrotClaw project! This page walks through contributing via Gitee.

Workflow

1. Fork the project

On the Gitee project page, click the Fork button in the top-right corner to fork the repository to your Gitee account.

2. Clone it locally

git clone https://gitee.com/<your-username>/parrot_claw.git
cd parrot_claw

3. Add the upstream remote

git remote add upstream https://gitee.com/alexcai/parrot_claw.git

4. Create a feature branch

git checkout -b feat/your-feature-name

5. Make your changes and commit

git add .
git commit -m "feat: add xxx feature"

Commit messages are expected to follow the Conventional Commits convention:

Type	Meaning
feat	New feature
fix	Bug fix
docs	Documentation update
refactor	Refactor
chore	Build / tooling related

6. Push to your repository

git push origin feat/your-feature-name

7. Open a pull request

On Gitee, open your fork and click "Pull Request" → "New Pull Request", select your branch, and target the main branch of alexcai/parrot_claw. Describe your changes and submit.

Notes

• Discuss in an issue first — for larger changes, open an issue to agree on the direction before writing code
• Keep each PR focused — one PR solves one problem; do not mix unrelated changes
• Sync with upstream — pull the latest upstream code before opening a PR:

git fetch upstream
git rebase upstream/main

• Test — make sure the code compiles and flutter analyze reports no errors