shield_lock
金大哥
← 返回 Skill 列表
extension
分类: 开发与工程无需 API Key

commit

当用户请求“commit”、“git commit”、“create commit”，或者想要按照常规提交格式提交已暂存/未暂存的更改时，应使用此技能。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

Background Knowledge

Format: <type>[scope]: <description> + mandatory body + optional footers

  • Title: ALL LOWERCASE, <50 chars, imperative mood, no period. Add ! for breaking changes
  • Types: feat, fix, docs, refactor, perf, test, chore, build, ci, style
  • Body (REQUIRED): Bullet summary (- prefix, imperative verbs) + explanation paragraph. ≤72 chars/line
  • Footer: Co-Authored-By REQUIRED; optional Closes #123, BREAKING CHANGE: ...

See references/format-rules.md for complete specification and examples.

Phase 1: Configuration Verification

Goal: Load project-specific git configuration and valid scopes.

Actions:

  1. FIRST: Read .claude/git.local.md to load project configuration
  2. If file not found, load git:config-git skill using the Skill tool to create it
  3. Extract valid scopes from scopes: list in YAML frontmatter
  4. Store these scopes for validation in Phase 3 and Phase 5

Phase 2: Safety Validation

Goal: Perform safety checks before committing.

Actions:

  1. Detect sensitive files (credentials, secrets, .env files)
  2. Warn about large files (>1MB) and large commits (>500 lines)
  3. Use AskUserQuestion tool for confirmation if issues found

Phase 3: Change Analysis

Goal: Identify logical units of work and infer commit scopes.

Actions:

  1. Run git diff --cached and git diff to get code differences (MUST NOT traverse files directly)
  2. Analyze diff to identify coherent logical units
  3. Infer scope(s) from file paths and changes using the valid scopes loaded in Phase 1
  4. If inferred scope not in the valid scopes list, load git:config-git skill using the Skill tool to update configuration

Phase 4: AI Code Quality Check

Goal: Remove AI-generated slop before committing.

Actions:

  1. Run git diff main...HEAD to compare against main branch
  2. Remove AI patterns: extra comments, unnecessary defensive checks, any casts, inconsistent style
  3. Ensure changes follow project's established patterns

Phase 5: Commit Creation

Goal: Create atomic commits following Conventional Commits format.

Actions (repeat for each logical unit):

  1. Draft commit message per references/format-rules.md
  2. Validate: title <50 chars lowercase imperative; body has bullets + explanation paragraph; footer has Co-Authored-By
  3. Stage relevant files and create commit