AgentSkillsCN

contributing

按照约定创建提交和拉取请求

SKILL.md
--- frontmatter
name: contributing
description: Create commits and pull requests following conventions

Contributing

Pre-Submission Checklist

Before submitting changes:

  • • Run nix fmt to format code
  • • Run nix flake check (with devenv-root override)
  • • Test at least one affected host configuration
  • • Test at least one affected home configuration (if applicable)
  • • Verify commit message follows conventions

Commit Message Format

Use conventional commit format:

code
type(scope): brief summary

Optional body explaining why the change was made.

Types

TypeUse For
featNew feature or capability
fixBug fix
choreMaintenance, dependencies
refactorCode restructuring without behavior change
buildBuild system changes
ciCI/CD changes
styleFormatting, whitespace

Scopes

Scope should be the common directory path:

ScopeExample
home/racciChanges to racci's home config
hosts/serverChanges affecting server hosts
hosts/server/nixdevChanges specific to nixdev
modules/nixosNixOS module changes
modules/home-managerHome-Manager module changes
pkgsPackage changes
libLibrary function changes

Examples

code
feat(hosts/server/nixdev): add woodpecker CI runner

fix(modules/nixos/services): correct tailscale firewall rules

chore(flake): update nixpkgs input

refactor(lib/builders): simplify mkSystem arguments

Pull Request Guidelines

  • •Title should mirror the commit header
  • •Link related issues: Closes #123 or Fixes #123
  • •Describe changes and reasoning in the PR body
  • •Ensure CI passes before requesting review

PR Description Template

markdown
## Summary

Brief description of what this PR does and why.

## Changes

- Change 1
- Change 2

## Testing

- Tested on: <hostname>
- Home config tested: <user>@<host>

Closes #<issue>