chore(git-workflow): add 3-repo feature branch skills + helper scripts
This commit is contained in:
parent
730147d690
commit
645f89b816
10 changed files with 500 additions and 0 deletions
50
.claude/skills/git-feature-start/SKILL.md
Normal file
50
.claude/skills/git-feature-start/SKILL.md
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
---
|
||||
name: git-feature-start
|
||||
description: Create a new feature branch across all 3 repos (root + kicad + wxwidgets submodules). Fetches each repo's main, fast-forward pulls, and creates the same feature branch in each. Usage - "/git-feature-start <branch-name>", e.g. "/git-feature-start feature/new-foo".
|
||||
---
|
||||
|
||||
# git-feature-start
|
||||
|
||||
Create a new feature branch in all 3 repos (root, kicad submodule, wxwidgets submodule), based on each repo's main branch.
|
||||
|
||||
Per-repo main mapping (hardcoded in `scripts/git-workflow/repos.sh`):
|
||||
- root → `main`
|
||||
- kicad → `wasm-port`
|
||||
- wxwidgets → `wasm-port`
|
||||
|
||||
## Arguments
|
||||
|
||||
A single positional argument: the feature branch name (e.g. `feature/my-thing`).
|
||||
|
||||
If the user invoked the skill without a branch name, ask for one via `AskUserQuestion` before proceeding.
|
||||
|
||||
## Steps
|
||||
|
||||
1. **Pre-flight: assert all 3 repos are clean.** Run `bash /Users/torcsi/dev/kicad-wasm/scripts/git-workflow/assert-clean.sh`. If it exits non-zero, STOP and tell the user which repos are dirty and that they need to commit, stash, or discard before starting a new feature.
|
||||
|
||||
2. **Pre-flight: check no repo is already on a non-main branch.** Run `bash /Users/torcsi/dev/kicad-wasm/scripts/git-workflow/repo-status.sh` and inspect each line's `branch` field. If any repo's `branch` is not its `main` (or is empty meaning detached HEAD), STOP and tell the user. Suggest: `/git-feature-sync` if they're already mid-feature, or manually checkout the main in that repo first. Do NOT silently switch off in-progress work.
|
||||
|
||||
3. **For each repo** in order [root, kicad, wxwidgets], run these commands. Echo what you're about to do in chat before each repo.
|
||||
- `git -C <path> fetch origin`
|
||||
- `git -C <path> checkout <main>`
|
||||
- `git -C <path> pull --ff-only origin <main>`
|
||||
- `git -C <path> checkout -b <branch-name>` — this hits the `ask` permission rule, so it will prompt. Also, you should prose-ask the user "About to create branch `<name>` in <repo> — proceed?" before invoking it (belt + suspenders per project rule).
|
||||
|
||||
4. **Report.** Print a summary table:
|
||||
```
|
||||
root: created <branch> from main@<sha>
|
||||
kicad: created <branch> from wasm-port@<sha>
|
||||
wxwidgets: created <branch> from wasm-port@<sha>
|
||||
```
|
||||
|
||||
5. Suggest `/git-feature-commit` as the next step when the user has changes to record.
|
||||
|
||||
## Failure handling
|
||||
|
||||
If any step fails partway (e.g. checkout fails in wxwidgets after root and kicad succeeded), STOP and report exactly which repos already have the new branch and which don't. The user can manually finish or `/git-feature-finish` won't run until all 3 are aligned anyway.
|
||||
|
||||
## Safety
|
||||
|
||||
- Never use `-f` / `--force` flags.
|
||||
- Never delete branches in this skill.
|
||||
- Always echo the command before running it.
|
||||
Loading…
Reference in a new issue