菜单
Implements Conventional Commits workflow. Ensures proper commit message formatting with structured body, footer, and skill signature. Facilitates semantic versioning compliance and clean project history.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
在每次回复中使用固定前缀并列出本次实际参考的指令/文件，便于校验是否遵循上下文与规则。
自动汇总当前分支相对主分支的提交摘要，用于 PR/说明对齐。
Perform code quality checks before commit. Validates code standards, security, architectural consistency. Runs TypeScript compilation, linting, test coverage verification.
Evolution capability meta-skill. Identifies evolutionary scenarios (repeated errors, user feedback, complex workflows) and crystallizes experience into reusable skills or instruction updates.
执行前检查清单。每次回复前必须自动进行的自我检查，确保没有遗漏强制规则。
创建/输出文件的安全约束。禁止 HERE 文档创建文件；大文件输出需分段写入同一文件，避免会话超限。
| name | git-commit |
| description | Implements Conventional Commits workflow. Ensures proper commit message formatting with structured body, footer, and skill signature. Facilitates semantic versioning compliance and clean project history. |
Standardizes git commit process using Conventional Commits format. Replaces inline commit messages with structured .github/COMMIT_DESCRIPTION.local.md file for clarity and consistency.
When to use: Every code change, feature, fix, or documentation update
Key principle: Never use git commit -m "..." for complex commits - use structured file format instead
<type>(<scope>): <subject>
<body>
<footer>
Where:
feat, fix, docs, style, refactor, test, chore, perf, ciauth, ui, core)Fixes #123) or breaking changes| Type | Purpose | Example |
|---|---|---|
feat | New feature | feat(auth): add OAuth integration |
fix | Bug fix | fix(ui): correct button alignment |
docs | Documentation | docs: update API reference |
style | Code style | style: format TypeScript files |
refactor | Code restructure | refactor: simplify state management |
test | Testing | test: add auth integration test |
chore | Maintenance | chore: upgrade dependencies |
perf | Performance | perf: optimize database queries |
ci | CI/CD changes | ci: add test coverage workflow |
Always explicitly stage files (never use git add .):
# Stage specific files only
git add src/file1.ts src/file2.ts
# Or review changes before staging
git diff --name-only
git add <files>
Copy template, fill in details, maintain required signature:
# Copy template and edit
cat .agent/skills/_git-commit/references/commit_template.md > .github/COMMIT_DESCRIPTION.local.md
# Then edit with actual changes
Template structure (keep all sections):
feat(scope): Brief description
## Changes
- Change 1
- Change 2
## Technical Details
- Implementation notes
## Testing
- What was tested
---
🤖 Generated by _git-commit skill
Check before committing:
# Verify signature exists
grep -i "git-commit\|🤖" .github/COMMIT_DESCRIPTION.local.md
# Verify type format on first line
head -1 .github/COMMIT_DESCRIPTION.local.md | grep -E "^(feat|fix|docs|style|refactor|test|chore|perf|ci)"
git commit -F .github/COMMIT_DESCRIPTION.local.md
rm .github/COMMIT_DESCRIPTION.local.md
Complete workflow in one command:
git add src/file.ts && \
git commit -F .github/COMMIT_DESCRIPTION.local.md && \
rm .github/COMMIT_DESCRIPTION.local.md
fix(storage): correct database transaction timeout
Transactions failed when processing >1000 records.
Split into batches of 100 using segment transactions.
Fixes #456
feat(core): implement caching layer
Reduces database load by caching query results.
## Changes
- Add CacheManager class
- Configure TTL (default 5 min, configurable)
- Add unit tests
## Performance
- 40% reduction in database queries
- Query latency improved from 200ms to 50ms
Fixes #123
refactor(api): unify provider interfaces
Consolidates multiple provider implementations into single factory pattern.
## Breaking Changes
BREAKING CHANGE: Removed legacy Provider class, use ProviderFactory instead
## Migration
1. Update imports to use ProviderFactory.create()
2. Review error handling (new ProviderError type)
Fixes #789
❌ Prohibited:
git commit -m "inline message" (use file instead)git add . (explicitly list files)✅ Required:
git add🤖 Generated by _git-commit skillMissing signature:
🤖 Generated by _git-commit skillAccidentally in master:
# Create feature branch
git checkout -b feature/name
git cherry-pick <commit> # Move commits if needed
Wrong type:
git commit --amendForgot to clean up .local.md:
Before committing:
git add .).github/COMMIT_DESCRIPTION.local.md