mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
97 lines
1.9 KiB
Markdown
97 lines
1.9 KiB
Markdown
# Git Tools
|
|
|
|
## Read Operations
|
|
|
|
| Tool | Purpose |
|
|
|------|---------|
|
|
| `roboco_git_status` | View working tree status |
|
|
| `roboco_git_log` | View commit history |
|
|
| `roboco_git_branch_list` | List branches |
|
|
| `roboco_git_diff` | View changes |
|
|
|
|
## Status and Diff
|
|
|
|
```python
|
|
# Check status
|
|
status = roboco_git_status(project_slug="roboco")
|
|
|
|
# View changes
|
|
diff = roboco_git_diff(project_slug="roboco")
|
|
|
|
# View history
|
|
log = roboco_git_log(
|
|
project_slug="roboco",
|
|
branch="feature/backend/a1b2c3d4"
|
|
)
|
|
```
|
|
|
|
## Branch Operations
|
|
|
|
**Branches are auto-created when tasks are claimed:**
|
|
- Root task claim → `feature/team/ROOT_ID`
|
|
- Subtask claim → `feature/team/ROOT_ID/SUB_ID`
|
|
- Sub-subtask claim → `feature/team/ROOT_ID/SUB_ID/SUBSUB_ID`
|
|
|
|
No manual branch creation needed.
|
|
|
|
```python
|
|
# List branches
|
|
branches = roboco_git_branch_list(project_slug="roboco")
|
|
|
|
# Checkout branch (if needed)
|
|
roboco_git_checkout(
|
|
project_slug="roboco",
|
|
branch="feature/backend/a1b2c3d4"
|
|
)
|
|
```
|
|
|
|
## Commit and Push
|
|
|
|
```python
|
|
# Commit with task link
|
|
roboco_git_commit(
|
|
project_slug="roboco",
|
|
task_id=task_id,
|
|
message="Add rate limiting endpoint",
|
|
commit_type="feat" # Required
|
|
)
|
|
# Creates: [a1b2c3d4] feat: Add rate limiting endpoint
|
|
|
|
# Push to remote
|
|
roboco_git_push(project_slug="roboco", task_id=task_id)
|
|
```
|
|
|
|
## Pull Requests
|
|
|
|
```python
|
|
# Create PR
|
|
roboco_git_create_pr(
|
|
project_slug="roboco",
|
|
task_id=task_id,
|
|
title="[TASK-a1b2c3d4] Add rate limiting",
|
|
body="## Summary\n..."
|
|
)
|
|
|
|
# Merge PR (PM only)
|
|
roboco_git_merge_pr(
|
|
project_slug="roboco",
|
|
pr_number=123,
|
|
task_id=task_id,
|
|
merge_method="squash" # squash, merge, rebase
|
|
)
|
|
```
|
|
|
|
## Branch Naming
|
|
|
|
```
|
|
{type}/{team}/{task-id-prefix}
|
|
```
|
|
|
|
| Type | Use |
|
|
|------|-----|
|
|
| `feature/` | New functionality |
|
|
| `bug/` | Bug fixes |
|
|
| `chore/` | Maintenance |
|
|
| `docs/` | Documentation |
|
|
| `hotfix/` | Urgent fixes |
|