菜单
Initialize a new feature branch with worktree, BRANCH.md from template, and environment setup
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when bringing the harness method to a NEW or non-sentropic repo — maps the repo's conventions into a harness profile so the same scope/branch/verify kernel applies anywhere.
Use before any creative/design work (a feature, a package, an evolution) — explores intent and design via the spec-ladder with multi-peer adversarial review BEFORE implementation.
Use on any bug, test failure, or unexpected behaviour BEFORE proposing a fix — runs the generic evidence-first root-cause loop.
Use when you have a spec/decisions and need an executable plan — writes a lot-based BRANCH.md from the template and completes with track for realization state.
Use when completing a feature, a design step, or before merging — runs a ≥2-peer consensus review and reconciles the findings, instead of a single rubber-stamp pass.
Use when adding or evolving tests for a feature/bugfix — applies the sentropic test-pyramid, scoped-test loop, environment isolation, and AI-flaky policy.
| name | branch-init |
| description | Initialize a new feature branch with worktree, BRANCH.md from template, and environment setup |
| allowed-tools | Read Write Bash Glob |
Workflow skill to initialize a new feature branch with proper worktree, BRANCH.md, and environment.
Create worktree
git worktree add tmp/<slug> -b <branch-type>/<slug> main
Where <branch-type> is one of: feat, fix, boot, doc, refactor.
Where <slug> is a short kebab-case identifier for the branch.
Verify branch
git -C tmp/<slug> branch --show-current
Must output <branch-type>/<slug>. Abort if mismatch.
Read template
Read plan/BRANCH_TEMPLATE.md in full. This is the formatting contract for BRANCH.md.
Create BRANCH.md from template Fill in the template with:
Makefile, docker-compose*.yml, .cursor/rules/**, plan/NN-BRANCH_*.mdBRxx-EXn exceptionBRANCH.md must follow plan/BRANCH_TEMPLATE.md strictly:
### headers## Feedback LoopAllocate ports based on branch index Convention for port allocation:
API_PORT=87<nn> (e.g., 8788, 8789, 8790...)UI_PORT=51<nn> (e.g., 5174, 5175, 5176...)MAILDEV_UI_PORT=10<nn> (e.g., 1084, 1085, 1086...)
Record port allocation in BRANCH.md Lot 0.
If PLAN.md exists, check existing branch port allocations to avoid conflicts.Commit
cd tmp/<slug>
git add BRANCH.md
make commit MSG="chore: init BRANCH.md for <branch-type>/<slug>"
git add . or git add -AENV must be last argument in all make commandsplan/BRANCH_TEMPLATE.md structure exactly — do not reinvent