commit-standards
AsiaOstrich/universal-dev-skills
Formatieren Sie Commit-Meldungen gemäß dem „Conventional Commits“-Standard. Anwendungsbereiche: Verfassen von Commit-Meldungen, `git commit`, Überprüfen des Commit-Verlaufs. Stichwörter: Commit, Git, Meldung, Conventional, 提交, 訊息, Feature, Fehlerbehebung, Refactoring.
...Alle erweiternÜber „commit-standards“
Die Funktion „commit-standards“ sorgt für eine einheitliche Formatierung von Commit-Meldungen, indem sie den „Conventional Commits“-Standard befolgt. Dadurch wird sichergestellt, dass Commit-Meldungen klar, prägnant und informativ sind. Sie löst das Problem inkonsistenter oder vager Commit-Meldungen, indem sie einen strukturierten Ansatz für das Verfassen von Meldungen bietet und so für einen besser organisierten und verständlichen Commit-Verlauf sorgt. Dieser Standard ist besonders nützlich für die Zusammenarbeit in Softwareentwicklungsprojekten, in denen eine klare Versionierung und Änderungsdokumentation sowohl für Teams als auch für automatisierte Systeme unerlässlich sind.
Die Funktion wurde entwickelt, um eine einfache und intuitive Möglichkeit zur Formatierung von Commit-Meldungen zu bieten. Sie nutzt eine Reihe vordefinierter Commit-Typen wie „feat“, „fix“, „refactor“ und andere, um Änderungen effektiv zu kategorisieren. Benutzer können einem strengen Format folgen, das eine Betreffzeile, einen Haupttext und eine Fußzeile umfasst, mit spezifischen Regeln für die Länge der Betreffzeile, die Großschreibung und die Zeichensetzung. Die Funktion unterstützt zudem mehrsprachige Formate für Commit-Meldungen, darunter Englisch, traditionelles Chinesisch und zweisprachige Optionen, um den Anforderungen verschiedener Entwicklungsumgebungen gerecht zu werden.
Diese Funktion ist ideal für Entwickler, Teams und Open-Source-Mitwirkende, die bei Commit-Meldungen einen einheitlichen und professionellen Ansatz verfolgen möchten. Sie ist besonders nützlich für Code-Reviewer, Verantwortliche für die Versionskontrolle und alle Beteiligten, die sich auf den Commit-Verlauf stützen, um Code-Änderungen nachzuvollziehen. Das Konfigurationssystem des Skills ermöglicht eine flexible Anpassung an die Projektvorlieben, sodass er sich an verschiedene Arbeitsabläufe und Teamanforderungen anpassen lässt.
FAQ
Wie konfiguriere ich die Sprache der Commit-Meldungen?
Sie können die Sprache der Commit-Meldungen in der Datei „CONTRIBUTING.md“ Ihres Projekts konfigurieren. Wird keine Konfiguration gefunden, verwendet das System standardmäßig Englisch. Die verfügbaren Optionen sind Englisch, traditionelles Chinesisch und zweisprachig.
Was passiert, wenn meine Commit-Meldung nicht dem Standard entspricht?
Die Skill meldet keine Fehler automatisch, empfiehlt jedoch Best Practices für Konsistenz und Klarheit. Es liegt an Ihrem Team, sicherzustellen, dass die Meldungen dem Format entsprechen.
Kann ich diese Funktion auch für Projekte außerhalb der Softwareentwicklung nutzen?
Ja, obwohl die Funktion in erster Linie für Softwareprojekte konzipiert wurde, kann jedes Projekt, das eine klare Versionierung und Dokumentation von Änderungen erfordert, von dieser Funktion profitieren.
Unterstützt diese Funktion mehrere Sprachen in Commit-Meldungen?
Ja, das Tool unterstützt Commit-Meldungen in Englisch, traditionellem Chinesisch und zweisprachigen Formaten. Sie können Ihre bevorzugte Sprachkonfiguration in der Datei „CONTRIBUTING.md“ auswählen.
Welche Commit-Typen werden von dieser Funktion unterstützt?
Die Funktion unterstützt verschiedene Commit-Typen, darunter „feat“, „fix“, „refactor“, „docs“, „style“, „test“, „perf“, „build“, „ci“, „chore“, „revert“ und „security“.
Commit Message Standards
This skill ensures consistent, meaningful commit messages following conventional commits.
Quick Reference
Basic Format
<type>(<scope>): <subject><body><footer>Commit Types
| English | 中文 | When to Use |
|---|---|---|
feat | 新增 | New feature |
fix | 修正 | Bug fix |
refactor | 重構 | Code refactoring (no functional change) |
docs | 文件 | Documentation only |
style | 樣式 | Formatting (no code logic change) |
test | 測試 | Adding or updating tests |
perf | 效能 | Performance improvement |
build | 建置 | Build system or dependencies |
ci | 整合 | CI/CD pipeline changes |
chore | 維護 | Maintenance tasks |
revert | 回退 | Revert previous commit |
security | 安全 | Security vulnerability fix |
Subject Line Rules
- Length: ≤72 characters (50 ideal)
- Tense: Imperative mood ("Add feature" not "Added feature")
- Capitalization: First letter capitalized
- No period: Don't end with a period
Detailed Guidelines
For complete standards, see:
- Conventional Commits Guide
- Language Options
Examples
✅ Good Examples (English)
feat(auth): Add OAuth2 Google login supportfix(api): Resolve memory leak in user session cacherefactor(database): Extract query builder to separate classdocs(readme): Update installation instructions for Node 20✅ Good Examples (中文)
新增(認證): 實作 OAuth2 Google 登入支援修正(API): 解決使用者 session 快取記憶體洩漏重構(資料庫): 提取查詢建構器為獨立類別✅ Good Example (Bilingual)
feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。Implement Google OAuth2 authentication flow for user login.實作 Google OAuth2 認證流程供使用者登入。Closes #123❌ Bad Examples
fixed bug # Too vague, no scopefeat(auth): added google login # Past tenseUpdate stuff. # Period, vagueWIP # Not descriptiveBody Guidelines
Use the body to explain WHY the change was made:
fix(api): Resolve race condition in concurrent user updatesWhy this occurred:- Two simultaneous PUT requests could overwrite each other- No optimistic locking implementedWhat this fix does:- Add version field to User model- Return 409 Conflict if version mismatchFixes #789Breaking Changes
Always document breaking changes in footer:
feat(api): Change user endpoint response formatBREAKING CHANGE: User API response format changedMigration guide:1. Update API clients to remove .data wrapper2. Use created_at instead of createdAtIssue References
Closes #123 # Automatically closes issueFixes #456 # Automatically closes issueRefs #789 # Links without closingConfiguration Detection
This skill supports project-specific language configuration.
Detection Order
- Check
CONTRIBUTING.mdfor "Commit Message Language" section - If found, use the specified option (English / Traditional Chinese / Bilingual)
- If not found, default to English for maximum tool compatibility
First-Time Setup
If no configuration found and context is unclear:
- Ask the user: "This project hasn't configured commit message language preference. Which option would you like to use? (English / 中文 / Bilingual)"
- After user selection, suggest documenting in
CONTRIBUTING.md:
## Commit Message LanguageThis project uses **[chosen option]** commit types.<!-- Options: English | Traditional Chinese | Bilingual -->
Configuration Example
In project's CONTRIBUTING.md:
## Commit Message LanguageThis project uses **English** commit types.### Allowed Typesfeat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security
License: CC BY 4.0 | Source: universal-dev-standards
Alle Dateien
3 Dateiencommit-standards installieren
Laden Sie die Skill-Dateien herunter und entpacken Sie sie in Ihr Verzeichnis „.claude/skills/“.
ZIP herunterladenKlonen Sie das Repository und kopieren Sie die Skill-Dateien in Ihr Projekt.
git clone https://github.com/AsiaOstrich/universal-dev-skills/blob/main/skills/commit-standards/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Kopieren





Heim
