Files
hermes-agent/skills/github/github-pr-workflow/references/conventional-commits.md
T
红尘 d73ff9b0fb
Deploy Site / deploy-vercel (push) Has been cancelled
Deploy Site / deploy-docs (push) Has been cancelled
Docker / shell lint / Lint Dockerfile (hadolint) (push) Has been cancelled
Docker / shell lint / Lint docker/ shell scripts (shellcheck) (push) Has been cancelled
Docker Build and Publish / build-amd64 (push) Has been cancelled
Docker Build and Publish / build-arm64 (push) Has been cancelled
Lint (ruff + ty) / ruff + ty diff (push) Has been cancelled
Lint (ruff + ty) / ruff enforcement (blocking) (push) Has been cancelled
Lint (ruff + ty) / Windows footguns (blocking) (push) Has been cancelled
Nix Lockfile Fix / auto-fix-main (push) Has been cancelled
Nix Lockfile Fix / fix (push) Has been cancelled
Nix / nix (macos-latest) (push) Has been cancelled
Nix / nix (ubuntu-latest) (push) Has been cancelled
OSV-Scanner / Scan lockfiles (push) Has been cancelled
Build Skills Index / build-index (push) Has been cancelled
Tests / test (1) (push) Has been cancelled
Tests / test (2) (push) Has been cancelled
Tests / test (3) (push) Has been cancelled
Tests / test (4) (push) Has been cancelled
Tests / test (5) (push) Has been cancelled
Tests / test (6) (push) Has been cancelled
Tests / e2e (push) Has been cancelled
uv.lock check / uv lock --check (push) Has been cancelled
Docker Build and Publish / merge (push) Has been cancelled
Build Skills Index / trigger-deploy (push) Has been cancelled
Tests / save-durations (push) Has been cancelled
Initial import of NousResearch/hermes-agent
2026-05-31 09:36:58 +08:00

2.4 KiB

Conventional Commits Quick Reference

Format: type(scope): description

Types

Type When to use Example
feat New feature or capability feat(auth): add OAuth2 login flow
fix Bug fix fix(api): handle null response from /users endpoint
refactor Code restructuring, no behavior change refactor(db): extract query builder into separate module
docs Documentation only docs: update API usage examples in README
test Adding or updating tests test(auth): add integration tests for token refresh
ci CI/CD configuration ci: add Python 3.12 to test matrix
chore Maintenance, dependencies, tooling chore: upgrade pytest to 8.x
perf Performance improvement perf(search): add index on users.email column
style Formatting, whitespace, semicolons style: run black formatter on src/
build Build system or external deps build: switch from setuptools to hatch
revert Reverts a previous commit revert: revert "feat(auth): add OAuth2 login flow"

Scope (optional)

Short identifier for the area of the codebase: auth, api, db, ui, cli, etc.

Breaking Changes

Add ! after type or BREAKING CHANGE: in footer:

feat(api)!: change authentication to use bearer tokens

BREAKING CHANGE: API endpoints now require Bearer token instead of API key header.
Migration guide: https://docs.example.com/migrate-auth

Multi-line Body

Wrap at 72 characters. Use bullet points for multiple changes:

feat(auth): add JWT-based user authentication

- Add login/register endpoints with input validation
- Add User model with argon2 password hashing
- Add auth middleware for protected routes
- Add token refresh endpoint with rotation

Closes #42

Linking Issues

In the commit body or footer:

Closes #42          ← closes the issue when merged
Fixes #42           ← same effect
Refs #42            ← references without closing
Co-authored-by: Name <email>

Quick Decision Guide

  • Added something new? → feat
  • Something was broken and you fixed it? → fix
  • Changed how code is organized but not what it does? → refactor
  • Only touched tests? → test
  • Only touched docs? → docs
  • Updated CI/CD pipelines? → ci
  • Updated dependencies or tooling? → chore
  • Made something faster? → perf