git-commit

分类: 工具与效率 | 上传者: mrclrchtr | 下载: 0 | 版本: v1.0（最新）

创建提交：检测约定，有意分阶段，编写清晰的主题，在有用时添加简洁的正文，然后提交。

更新日志: Source: GitHub https://github.com/mrclrchtr/skills

目录结构

当前层级: tree/main/.agents/skills/git-commit/

📁 agents/
- 📄 openai.yaml 211 B
📄 SKILL.md 2.1 KB

SKILL.md

---
name: git-commit
description: "Creates a commit: detects conventions, stages intentionally, writes a clear subject, add a concise body when useful, and commits."
---

# Git Commit

## Goal

Make a logical, reviewable concise commit using the commit style of the repository.

## Guardrails

- If potential secrets are found: **STOP and ask** what to do.
- No `--no-verify`, no `--amend`/rebase/force-push, no pushing unless asked.
- If changes look like multiple commits: **STOP and propose a split plan** (don’t commit yet).

## Fast workflow

1) Gather information

    ```bash
    echo "## DATE" \
    && date \
    && echo "## BRANCH" \
    && git branch --show-current \
    && echo "## STATUS" \
    && git status --porcelain=v1 \
    && echo "## DIFF (unstaged)" \
    && git --no-pager diff \
    && echo "## DIFF (staged)" \
    && git --no-pager diff --staged \
    && echo "## LOG (last 20)" \
    && git --no-pager log --oneline -20 --graph
    ```

   > **NOTE**:
   > Run as one command.

2) Stage changes intentionally

   ```bash
   git add path/to/file1 path/to/file2
   # or:
   git add -A # when all changes belong to the commit to create
   ```

   If the staged diff contains unrelated changes, **STOP and ask** what to do.

3) Write a concise commit message

   Infer commit style from recent subjects:
    - If they look like `type(scope): msg` → use Conventional Commits.
    - Otherwise, match the common pattern (caps, prefixes, ticket IDs, etc.).

   Subject rules:
    - Imperative mood, no trailing period
    - Prefer ≤ 72 chars (or match repo norm)
    - Include scope only if the repo typically does

   Body rules:
    - Add a body **only** if it answers “why” or prevents confusion:
        - Why this change is needed
        - Key tradeoffs or constraints
        - Notable side effects/follow-ups

4) Commit and verify
   Use multiple `-m` flags for multi-line messages (no \n).

   ```bash
   git commit -m "type(scope): concise summary"
   # or with body:
   git commit -m "type(scope): concise summary" -m "Why this change was needed (brief)."
   ```

登录后下载/点赞/收藏 ❤ 6 | ★ 0

git-commit

目录结构

SKILL.md

举报内容

提示