菜单
Generate final mainline squash commit messages with archive trailers.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | git-mainline-squash |
| description | Generate final mainline squash commit messages with archive trailers. |
| metadata | {"version":"0.1.0","license":"AGPL-3.0-only"} |
Use this skill after a task branch is complete and ready to become one coherent
commit on main. This skill writes the commit message and checks the archive
metadata; it does not push, delete, rename, or otherwise mutate branches unless
the user separately asks for that operation.
Use this skill only for final integration commits onto main, including
mainline snapshot commits and feature, fix, or refactor squash commits with
archive trailers.
For ordinary work-in-progress or task-branch commits, use git-commit. For
branch and worktree lifecycle operations, use git-worktree.
Gather or infer:
feat/crawler-preview-routingarchive/260606-feat-crawler-preview-routingIf metadata is missing, state exactly which value is missing and show a draft with placeholders rather than inventing SHAs or branch names.
Use this structure:
<type>(<optional scope>): <subject>
<body>
Archive-ref: archive/YYMMDD-type-topic
Archive-tip: <feature-tip-sha>
Feature-base: <feature-base-sha>
Original-branch: <original-branch>
Pull-request: #123
Omit Pull-request only when there is no PR. For one-off mainline cutovers,
use cutover trailers instead of feature trailers:
chore: establish mainline snapshot
Create the new main integration baseline from the current repository state.
Archive-ref: archive/260606-mainline-dev-before-main
Archive-tip: <archived-dev-tip-sha>
Original-branch: dev
Mainline-reset: 2026-06-06
The subject is the Conventional Commit first line. Pick the type from the integrated result:
| Type | Use when |
|---|---|
feat | Adds a user-facing or system capability |
fix | Corrects broken behavior |
refactor | Restructures code without intended behavior change |
perf | Improves performance |
test | Changes test coverage only |
docs | Changes documentation only |
chore | Repository, tooling, or operational maintenance |
Use a short noun scope when it clarifies the affected area. Keep the subject lowercase after the type prefix, imperative/result-oriented, and without a period.
The body is the GitHub squash UI's commit description. Generate it from the final integrated change, not from the archive metadata.
For a small change, a single body sentence is enough.
Archive trailers are custom Git trailers. Keep each token stable and dash-separated:
Archive-ref: remote archive branch preserving development-level historyArchive-tip: final commit SHA of the archived branchFeature-base: merge-base or recorded branch base before feature work beganOriginal-branch: active branch name before archivingPull-request: PR number, if anyMainline-reset: absolute date for repository baseline cutovers onlyNever use fake SHAs. Prefer full 40-character SHAs when recording final metadata; abbreviated SHAs are acceptable only in drafts.
Show the final message in a fenced block. If the user asked to commit, still ask
for explicit confirmation before running git commit.
When committing from the CLI, use one body argument or a commit message file for
multi-line bodies. Do not pass each body bullet as a separate -m; Git turns
separate -m arguments into separate paragraphs.
基于 SOC 职业分类
Use the repo headed Playwright workbench to investigate live URLs, selectors, locators, text matches, computed styles, and pages blocked by Cloudflare/login/captcha flows.
Use for rezics UI design, JSX/CSS styling, tokens, typography, spacing, icons, and visual reviews.
Apply a code-first plan — route each durable item to its home in code (types/tests/comments), then make the source document disposable. No validation CLI, no state machine. Use when implementing a plan/proposal.
Use for rezics UI design, JSX/CSS styling, tokens, typography, spacing, icons, and visual reviews.
Create conventional git commits and commit messages for repo changes.
Create, merge, list, or clean up git worktrees for parallel development.
