commit-best-practices

olioapps 的头像作者 olioapps

使用遵循最佳实践的 AI 生成消息创建 git 提交。当用户要求提交更改、提及"commit"、想要将工作保存到 git 或已准备好提交更改时使用。调用 /git-actions:commit 命令,该命令分析更改、生成符合仓库样式的简洁消息,并处理暂存/批准工作流。

📖 中文导读:使用遵循最佳实践的 AI 生成消息创建 git 提交。当用户要求提交更改、提及"commit"、想要将工作保存到 git 或已准备好提交更改时使用。调用 /git-actions:commit 命令,该命令分析更改、生成符合仓库样式的简洁消息,并处理暂存/批准工作流。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: commit-best-practices description: Create git commits with AI-generated messages following best practices. Use when the user asks to commit changes, mentions "commit", wants to save work to git, or has made changes ready to be committed. Invokes /git-actions:commit command which analyzes changes, generates concise messages matching repo style, and handles staging/approval workflow. allowed-tools: SlashCommand

Creating Commits with Best Practices

When the user needs to create a git commit, use the /git-actions:commit slash command. This command orchestrates the entire workflow with best practices built-in.

Usage

/git-actions:commit all      # Stage all changes and commit
/git-actions:commit staged   # Commit only staged changes
/git-actions:commit          # Auto-detect (staged if any, else all)

What the Command Does

  1. Stages files (if needed)
  2. Analyzes changes using git diff
  3. Reviews recent commit history to match repository style
  4. Generates a concise, information-dense commit message
  5. Presents the message for user approval
  6. Creates the commit after approval

The commit-writer Agent

The /git-actions:commit command invokes the commit-writer agent, which has commit best practices embedded:

  • Concise, information-dense messages (50-char subject limit)
  • Imperative mood ("Add" not "Added")
  • Explains WHAT and WHY, not HOW
  • Adapts to repository commit conventions
  • References issues when relevant
  • Atomic commits (one logical change)

Custom Instructions

You can pass additional context to override defaults:

/git-actions:commit all use conventional commits format
/git-actions:commit staged keep it under 40 chars
/git-actions:commit all emphasize performance improvements
/git-actions:commit staged no body

Examples

User: "I've updated the authentication logic, can you commit this?" You: Use /git-actions:commit all to stage all changes and create a commit with a well-crafted message.

User: "Commit my staged files" You: Use /git-actions:commit staged to commit only the staged changes.

User: "I need a brief commit message for this fix" You: Use /git-actions:commit all keep it under 40 chars to create a concise commit.