AgentSkillsCN

copilot-commit-style

当用户要求撰写、生成、起草或格式化 Git 提交信息时，此技能将为您提供有力支持。它严格遵循 Conventional Commits 规范，强制要求使用表情符号，并严格执行格式化规则。

SKILL.md
--- frontmatter
name: copilot-commit-style
description: Use this skill when the user asks to write, generate, draft, or format a git commit message. It enforces the Conventional Commits specification with mandatory emojis and strict formatting rules.

Copilot Commit Style Instructions

This skill provides the mandatory rules for formatting git commit messages according to the project's Conventional Commits specification.

Commit Message Format

Every commit message MUST follow this exact format:

code
<emoji> <type>(<scope>): <description>

[optional body]

[optional footer(s)]

Constraints:

  • •Emoji is REQUIRED: Every commit must start with a relevant emoji.
  • •Scope is REQUIRED: You must specify a scope in parentheses. Format: type(scope): description.
  • •Lowercase Types: <type> must be in lowercase.
  • •Separation: A colon and space must follow the scope.
  • •Single Line Only: The commit header must be a single line. No newline characters within the header.
  • •Length Limit: The entire commit header (including emoji and scope) must be less than 80 characters.

Allowed Types & Emojis

EmojiTypeMeaningSemVer
✨featNew featureMINOR
🐛fixBug fixPATCH
📝docsDocumentation changesNone
🎨styleFormatting, missing semi-colons, etc.None
♻️refactorCode change that neither fixes a bug nor adds a featureNone
⚡️perfCode change that improves performancePATCH
✅testAdding missing tests or correcting existing testsNone
👷buildChanges that affect the build system or external dependenciesNone
💚ciChanges to CI configuration files and scriptsNone
🔧choreOther changes that don't modify src or test filesNone
⏪revertReverts a previous commitNone

Note: A BREAKING CHANGE (which triggers a MAJOR version bump) is signaled by adding a ! after the type/scope or by including BREAKING CHANGE: in the footer.

Examples

✅ Correct Format:

  • •✨ feat(auth): add OAuth2 login flow
  • •🐛 fix(api): resolve memory leak in worker
  • •📝 docs(readme): update installation guide
  • •⚡️ perf(db)!: optimized query for user lookup

❌ Incorrect Format:

  • •feat: add something (Missing scope and emoji)
  • •✨ feat: add something (Missing scope)
  • •feat(ui): add something (Missing emoji)
  • •✨ fix memory leak (Missing type/scope format)
  • •⚡️ fix(stock): very long description that exceeds the character limit of eighty characters per line (Over 80 chars)
  • •🐛 fix(api): first line\nsecond line (Contains multiple lines in header)

Links