feat(prompts): add configurable commit message styles with custom template support

Author: uaoa

README.md

@@ -16,7 +16,9 @@ You're already investing in Claude Code – whether it's Pro, Max ×5, or Max ×
 
 - **One-click commit message generation**: The sparkle button ✨ you know and love, right in VS Code's Source Control panel
 - **Powered by your Claude CLI**: Uses your existing Claude installation – no extra API keys or subscriptions needed
-- **Context-aware analysis**: Understands your git diff to generate meaningful, conventional commit messages
+- **Context-aware analysis**: Understands your git diff to generate meaningful commit messages
+- **Flexible commit styles**: Choose from conventional commits, prefix-only, simple descriptions, or create your own custom template
+- **Custom prompt templates**: Full control over AI prompts with `{diff}` and `{stats}` template variables
 - **Edit with feedback**: Not satisfied? Click "Edit with feedback" to refine the message with AI assistance
 - **Multi-line commit support**: Generate detailed commits with body and footer for complex changes
 - **Model selection**: Choose between Haiku (fast), Sonnet (balanced), or Opus (most capable)
@@ -77,6 +79,8 @@ This extension keeps it simple with optional settings:
 * `claudeCommit.keepCoAuthoredBy`: Keep Co-Authored-By signature in commit message (only works in Claude Code managed mode) – defaults to `false`
 * `claudeCommit.messageAutoCloseSeconds`: Auto-close timeout for success message in seconds (0 to disable) – defaults to `5`
 * `claudeCommit.privacyMode`: Restrict temporary prompt file permissions to owner-only on Linux/macOS – defaults to `false`
+* `claudeCommit.commitStyle`: Commit message style format (`conventional`, `prefix`, `default`, or `custom`) – defaults to `conventional`
+* `claudeCommit.customPromptTemplate`: Custom prompt template with `{diff}` and `{stats}` variables (only used when commitStyle is `custom`) – defaults to empty
 
 ## Configuration Examples
 
@@ -177,6 +181,41 @@ Set to `0` to disable auto-close and keep the success message visible until manu
 ```
 Restricts temporary prompt file permissions to owner-only (0600) on Linux/macOS. Windows ignores this setting.
 
+### Commit message styles
+
+#### Conventional Commits (default)
+```json
+{
+    "claudeCommit.commitStyle": "conventional"
+}
+```
+Generates: `feat(auth): added user login`
+
+#### Prefix only (without scope)
+```json
+{
+    "claudeCommit.commitStyle": "prefix"
+}
+```
+Generates: `feat: added user login`
+
+#### Simple description (no prefix)
+```json
+{
+    "claudeCommit.commitStyle": "default"
+}
+```
+Generates: `added user login`
+
+#### Custom prompt template
+```json
+{
+    "claudeCommit.commitStyle": "custom",
+    "claudeCommit.customPromptTemplate": "Generate a concise commit message following our team's style.\n\nChanges:\n{stats}\n\nDiff (first 6000 chars):\n{diff}\n\nFormat: <category>: <description>\nCategories: feature, bugfix, refactor, docs, test, chore\nReturn only the commit message."
+}
+```
+Use `{diff}` for git diff content (automatically limited to first 6000 characters) and `{stats}` for change statistics. This allows complete control over the prompt sent to Claude.
+
 ## Troubleshooting
 
 ### Claude CLI not found

package.json

@@ -152,6 +152,31 @@
 					"default": false,
 					"markdownDescription": "Privacy mode: Restrict temporary prompt file permissions to owner-only (0600). When disabled, uses default permissions (0644). **Note: This option only takes effect on Linux/macOS. On Windows, file permissions are managed by the OS and this setting is ignored.**",
 					"order": 11
+				},
+				"claudeCommit.commitStyle": {
+					"type": "string",
+					"enum": [
+						"conventional",
+						"prefix",
+						"default",
+						"custom"
+					],
+					"default": "conventional",
+					"enumDescriptions": [
+						"Conventional Commits with scope - feat(auth): added user login",
+						"Type prefix only - feat: added user login",
+						"Simple description - added user login",
+						"Custom template using {diff} and {stats} variables"
+					],
+					"markdownDescription": "Commit message style format. Choose 'custom' to use your own prompt template.",
+					"order": 12
+				},
+				"claudeCommit.customPromptTemplate": {
+					"type": "string",
+					"default": "",
+					"markdownDescription": "Custom prompt template. Use `{diff}` for diff content and `{stats}` for change statistics. Only used when commitStyle is set to 'custom'. Example: `Generate a commit message for:\n\n{stats}\n\n{diff}`",
+					"editPresentation": "multilineText",
+					"order": 13
 				}
 			}
 		}

src/generators/commit.ts

@@ -64,8 +64,10 @@ export async function generateCommitMessage(
   }
 
   const multiLine = config.get<boolean>("multiLineCommit", false);
+  const commitStyle = config.get<string>("commitStyle", "conventional");
+  const customTemplate = config.get<string>("customPromptTemplate", "");
 
-  const prompt = createGenerationPrompt(diff, stats, language, multiLine);
+  const prompt = createGenerationPrompt(diff, stats, language, multiLine, commitStyle, customTemplate);
 
   let commitMessage: string | undefined;
   let cliNotFound = false;

src/prompts/en.ts

@@ -1,18 +1,44 @@
 export function getGenerationPrompt(
   diff: string,
   stats: string,
-  multiLine: boolean
+  multiLine: boolean,
+  commitStyle: string = "conventional"
 ): string {
+  const diffContent = diff.slice(0, 6000);
+
+  const styleInstructions = getStyleInstructions(commitStyle, multiLine);
+
   if (multiLine) {
-    return `Analyze git changes and generate detailed commit message in conventional commits format.
+    return `Analyze git changes and generate detailed commit message.
+
+Change statistics:
+${stats}
+
+Diff (first 6000 characters):
+${diffContent}
+
+${styleInstructions}
+
+Return ONLY the commit message in the specified format, no explanations.`;
+  }
+
+  return `Analyze git changes and generate commit message.
 
 Change statistics:
 ${stats}
 
 Diff (first 6000 characters):
-${diff.slice(0, 6000)}
+${diffContent}
 
-RESPONSE FORMAT:
+${styleInstructions}
+
+Return ONLY the commit message (one line), no explanations.`;
+}
+
+function getStyleInstructions(style: string, multiLine: boolean): string {
+  switch (style) {
+    case "conventional":
+      return multiLine ? `RESPONSE FORMAT:
 <type>(<scope>): <subject>
 
 <body>
@@ -33,20 +59,7 @@ Implemented authentication via Google OAuth 2.0.
 Added token handling and refresh mechanism.
 Updated configuration to support new providers.
 
-Closes #123
-
-Return ONLY the commit message in the specified format, no explanations.`;
-  }
-
-  return `Analyze git changes and generate commit message in conventional commits format.
-
-Change statistics:
-${stats}
-
-Diff (first 6000 characters):
-${diff.slice(0, 6000)}
-
-STRICT RULES:
+Closes #123` : `STRICT RULES:
 - Format: <type>(<scope>): <subject>
 - Type: feat/fix/refactor/docs/style/test/chore/perf
 - Subject in PAST TENSE (what WAS DONE), max 50 characters, no period
@@ -58,9 +71,79 @@ Examples:
 feat(auth): added Google OAuth provider
 fix(api): fixed validation error in user endpoint
 refactor(store): optimized cart state management
-docs(readme): updated installation instructions
+docs(readme): updated installation instructions`;
 
-Return ONLY the commit message (one line), no explanations.`;
+    case "prefix":
+      return multiLine ? `RESPONSE FORMAT:
+<type>: <subject>
+
+<body>
+
+<footer>
+
+RULES:
+- Subject: PAST TENSE, max 50 characters, no period
+- Body: detailed description of changes (what and why)
+- Footer: Breaking changes, issue references
+- Type: feat/fix/refactor/docs/style/test/chore/perf
+- Use verbs: added, fixed, updated, removed, refactored
+- NO SCOPE in parentheses
+
+Example:
+feat: added Google OAuth provider
+
+Implemented authentication via Google OAuth 2.0.
+Added token handling and refresh mechanism.
+
+Closes #123` : `STRICT RULES:
+- Format: <type>: <subject>
+- Type: feat/fix/refactor/docs/style/test/chore/perf
+- Subject in PAST TENSE (what WAS DONE), max 50 characters, no period
+- Use verbs like: added, fixed, updated, removed, refactored
+- NO SCOPE in parentheses
+
+Examples:
+feat: added Google OAuth provider
+fix: fixed validation error in user endpoint
+refactor: optimized cart state management
+docs: updated installation instructions`;
+
+    case "default":
+      return multiLine ? `RESPONSE FORMAT:
+<subject>
+
+<body>
+
+<footer>
+
+RULES:
+- Subject: PAST TENSE, clear description, max 50 characters, no period
+- Body: detailed description of changes (what and why)
+- Footer: Breaking changes, issue references
+- Use verbs: added, fixed, updated, removed, refactored
+- NO TYPE prefix, NO SCOPE
+
+Example:
+added Google OAuth provider
+
+Implemented authentication via Google OAuth 2.0.
+Added token handling and refresh mechanism.
+
+Closes #123` : `STRICT RULES:
+- Format: simple description without type/scope prefix
+- Subject in PAST TENSE (what WAS DONE), max 50 characters, no period
+- Use verbs like: added, fixed, updated, removed, refactored
+- NO TYPE prefix (feat/fix/etc), NO SCOPE
+
+Examples:
+added Google OAuth provider
+fixed validation error in user endpoint
+optimized cart state management
+updated installation instructions`;
+
+    default:
+      return getStyleInstructions("conventional", multiLine);
+  }
 }
 
 export function getManagedPrompt(keepCoAuthoredBy: boolean, multiline: boolean, diffSource: string, customPrompt: string): string {

src/prompts/generation.ts

@@ -9,10 +9,19 @@ export function createGenerationPrompt(
   diff: string,
   stats: string,
   lang: Language,
-  multiLine = false
+  multiLine = false,
+  commitStyle = "conventional",
+  customTemplate?: string
 ): string {
+  // If custom style and template provided, use it
+  if (commitStyle === "custom" && customTemplate) {
+    return customTemplate
+      .replace(/\{diff\}/g, diff.slice(0, 6000))
+      .replace(/\{stats\}/g, stats);
+  }
+
   const module = promptModules[lang];
-  return module.getGenerationPrompt(diff, stats, multiLine);
+  return module.getGenerationPrompt(diff, stats, multiLine, commitStyle);
 }
 
 export function createManagedPrompt(lang: Language, keepCoAuthoredBy: boolean, multiline: boolean, diffSource: string, customPrompt: string): string {