Files
nix-config/agents/skills/git-delivery/examples.md
T
Ryan Yin 7bba1abbc9 feat(agents): cap delivery text and shorten git-delivery
Assisted-by: DeepSeek Harness (claude-opus-5-5, deepseek-flash, qwen3.8-flash-next iq3, gpt-6.1-sol, gpt-6-luna)
2026-10-10 19:49:44 +08:00

2.1 KiB

Git delivery examples

Illustrative messages that follow SKILL.md. Repository conventions still decide prefixes and trailers. Keep the important consequence in the commit; use the PR for context and review details.

A self-explaining change

feat(cli): add a --json flag to the status command

The flag explains its effect. Which script asked for machine-readable output belongs in the PR, not a commit body.

A deletion outside the diff

fix(logs): delete rotated logs older than seven days

Every nightly run deletes rotated logs older than seven days, including unshipped ones.
Logs already shipped to the archive are unaffected.

The body names the runtime deletion and what survives. These consequences matter when someone investigates missing logs; file lists and debugging history do not.

A stored format changes meaning

fix(config): store the sync interval as a duration string

Integer intervals are read as seconds once and rewritten on the next save.
Clients older than 2.4 cannot read the rewritten value.

The body records the compatibility effect. Upgrade order and measured impact belong in the PR when they help review.

Cite the commit being fixed

fix(logs): keep unshipped logs during rotation

Rotation skips unshipped logs again; logs it already deleted cannot be recovered.

Refs: 9f8e7d6 (fix(logs): delete rotated logs older than seven days)

A hash with its subject identifies the earlier change without a lookup. Use the repository's trailer format; required disclosure follows the body too.

Separate PR review points

Rotation keeps unshipped logs, so a slow archive upload no longer loses them. Review the shipping
check in `rotate.py` first.

- Logs deleted before this change cannot be recovered.
- Disk use grows while the archive is unreachable; the existing disk alert still fires at 90%.
- The rotation test now covers an unshipped log; no host has run the new rotation yet.

Distinct points get separate lines. Word limits bound the content; useful paragraph breaks and bullets do not spend that budget.