ai: Prioritize succinct commit messages with optional lists
Add guidance to start with a single sentence, use lists only when multiple
distinct reasons require explanation, otherwise keep to one paragraph.

Assisted-by: Claude Haiku 4.5 via Claude Code
change vvqywtytnutkmtnvllmlvymvvrooomwq
commit 9478810f108b1bd319f48f58f52a6801b394439c
author Alpha Chen <alpha@kejadlen.dev>
date
parent srromzvu
diff --git a/ai/claude/commands/commit.md b/ai/claude/commands/commit.md
index 860ec81c..7ec7d6be 100644
--- a/ai/claude/commands/commit.md
+++ b/ai/claude/commands/commit.md
@@ -13,15 +13,18 @@ When committing:
 2. If a fileset is provided, use `jj commit <fileset>` to commit only
 matching files
 3. If no fileset is provided, use `jj commit` to commit all changes
-4. Invoke the `writing` skill for assistance with commit message style
-and conventions
+4. Use any available writing skills for assistance with commit message style
+and conventions (e.g., elements-of-style)
 5. Draft a clear, concise commit message:
+   - Start with a single sentence that captures the change's purpose
    - Focus on why the change was made, not what changed (the diff shows
      what changed)
    - CRITICAL: Do NOT include information that is obvious from reading
      the diff. The reviewer has the diff; your message should provide
      context and reasoning that cannot be inferred from the code changes
      alone
+   - Only use a bulleted list if multiple distinct reasons or changes
+     require explanation; otherwise keep the message to one paragraph
    - Avoid describing file changes, added/removed lines, or renamed
      variables unless the reason for these changes is non-obvious
    - Follow repository conventions