zcf 3.4.2 → 3.4.3

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { ak as ensureI18nInitialized, al as i18n, aN as readCcrConfig, aI as isCcrInstalled, aJ as installCcr, aO as configureCcrFeature, ao as promptBoolean, aP as handleExitPromptError, aQ as handleGeneralError, aR as COMETIX_COMMAND_NAME, aS as COMETIX_COMMANDS, aT as installCometixLine, am as addNumbersToChoices, aU as checkAndUpdateTools, aV as runCodexUpdate, aW as resolveCodeType$1, at as readJsonConfig, aX as writeJsonConfig, q as ZCF_CONFIG_FILE, aD as readZcfConfig, D as DEFAULT_CODE_TOOL_TYPE, u as isCodeToolType, aY as displayBanner, aB as updateZcfConfig, aZ as version, a_ as resolveAiOutputLanguage, a$ as updatePromptOnly, b0 as selectAndInstallWorkflows, b1 as checkClaudeCodeVersionAndPrompt, w as resolveCodeToolType$1, b2 as displayBannerWithInfo, s as CODE_TOOL_BANNERS, b3 as runCodexUninstall, b4 as configureCodexMcp, b5 as configureCodexApi, b6 as runCodexWorkflowImportWithLanguageSelection, b7 as runCodexFullInit, i as init, b8 as switchCodexProvider, b9 as listCodexProviders, ax as readCodexConfig, ba as switchToOfficialLogin, bb as switchToProvider, bc as readZcfConfigAsync, bd as initI18n, be as selectScriptLanguage, aC as changeLanguage } from './chunks/simple-config.mjs';
+import { ak as ensureI18nInitialized, al as i18n, aO as readCcrConfig, aJ as isCcrInstalled, aK as installCcr, aP as configureCcrFeature, ao as promptBoolean, aQ as handleExitPromptError, aR as handleGeneralError, aS as COMETIX_COMMAND_NAME, aT as COMETIX_COMMANDS, aU as installCometixLine, am as addNumbersToChoices, aV as checkAndUpdateTools, aW as runCodexUpdate, aX as resolveCodeType$1, at as readJsonConfig, aY as writeJsonConfig, q as ZCF_CONFIG_FILE, aE as readZcfConfig, D as DEFAULT_CODE_TOOL_TYPE, u as isCodeToolType, aZ as displayBanner, aC as updateZcfConfig, a_ as version, a$ as resolveAiOutputLanguage, b0 as updatePromptOnly, b1 as selectAndInstallWorkflows, b2 as checkClaudeCodeVersionAndPrompt, w as resolveCodeToolType$1, b3 as displayBannerWithInfo, s as CODE_TOOL_BANNERS, b4 as runCodexUninstall, b5 as configureCodexMcp, b6 as configureCodexApi, b7 as runCodexWorkflowImportWithLanguageSelection, b8 as runCodexFullInit, i as init, b9 as switchCodexProvider, ba as listCodexProviders, ay as readCodexConfig, bb as switchToOfficialLogin, bc as switchToProvider, bd as readZcfConfigAsync, be as initI18n, bf as selectScriptLanguage, aD as changeLanguage } from './chunks/simple-config.mjs';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import inquirer from 'inquirer';
@@ -687,7 +687,7 @@ class ZcfUninstaller {
         result.removed.push(".claude.json (includes MCP configuration)");
       }
       try {
-        const { uninstallCodeTool } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bn; });
+        const { uninstallCodeTool } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bo; });
         const success = await uninstallCodeTool("claude-code");
         if (success) {
           result.removed.push("@anthropic-ai/claude-code");
@@ -923,7 +923,7 @@ async function uninstall(options = {}) {
     }
     const uninstaller = new ZcfUninstaller(options.lang || "en");
     if (codeType === "codex") {
-      const { runCodexUninstall } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bm; });
+      const { runCodexUninstall } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bn; });
       await runCodexUninstall();
       return;
     }
@@ -1193,7 +1193,7 @@ async function update(options = {}) {
       }
       return;
     }
-    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bl; });
+    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.bm; });
     const configLang = await resolveTemplateLanguage(
       options.configLang,
       // Command line option
@@ -1906,7 +1906,9 @@ function customizeHelp(sections) {
       `  ${ansis.green("--api-key, -k")} <key>       ${i18n.t("cli:help.optionDescriptions.apiKey")}`,
       `  ${ansis.green("--api-url, -u")} <url>       ${i18n.t("cli:help.optionDescriptions.customApiUrl")}`,
       `  ${ansis.green("--api-model, -M")} <model>   ${i18n.t("cli:help.optionDescriptions.apiModel")} (e.g., claude-sonnet-4-5)`,
-      `  ${ansis.green("--api-fast-model, -F")} <model> ${i18n.t("cli:help.optionDescriptions.apiFastModel")} (e.g., claude-haiku-4-5)`,
+      `  ${ansis.green("--api-haiku-model, -H")} <model> ${i18n.t("cli:help.optionDescriptions.apiHaikuModel")} (e.g., claude-haiku-4-5)`,
+      `  ${ansis.green("--api-sonnet-model, -S")} <model> ${i18n.t("cli:help.optionDescriptions.apiSonnetModel")} (e.g., claude-sonnet-4-5)`,
+      `  ${ansis.green("--api-opus-model, -O")} <model> ${i18n.t("cli:help.optionDescriptions.apiOpusModel")} (e.g., claude-opus-4-5)`,
       `  ${ansis.green("--ai-output-lang, -a")} <lang> ${i18n.t("cli:help.optionDescriptions.aiOutputLanguage")}`,
       `  ${ansis.green("--all-lang, -g")} <lang>     ${i18n.t("cli:help.optionDescriptions.setAllLanguageParams")}`,
       `  ${ansis.green("--config-action, -r")} <action> ${i18n.t("cli:help.optionDescriptions.configHandling")} (${i18n.t("cli:help.defaults.prefix")} backup)`,
@@ -1972,7 +1974,7 @@ async function setupCommands(cli) {
   cli.command("", "Show interactive menu (default)").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").action(await withLanguageResolution(async (options) => {
     await showMainMenu({ codeType: options.codeType });
   }));
-  cli.command("init", "Initialize Claude Code configuration").alias("i").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--ai-output-lang, -a <lang>", "AI output language").option("--force, -f", "Force overwrite existing configuration").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").option("--config-action, -r <action>", `Config handling (new/backup/merge/docs-only/skip), ${i18n.t("cli:help.defaults.prefix")} backup`).option("--api-type, -t <type>", "API type (auth_token/api_key/ccr_proxy/skip)").option("--api-key, -k <key>", "API key (used for both API key and auth token types)").option("--api-url, -u <url>", "Custom API URL").option("--api-model, -M <model>", "Primary API model (e.g., claude-sonnet-4-5)").option("--api-fast-model, -F <model>", "Fast API model (e.g., claude-haiku-4-5)").option("--provider, -p <provider>", "API provider preset (302ai, glm, minimax, kimi, custom)").option("--mcp-services, -m <services>", `Comma-separated MCP services to install (context7,mcp-deepwiki,Playwright,exa), "skip" to skip all, "all" for all non-key services, ${i18n.t("cli:help.defaults.prefix")} all`).option("--workflows, -w <workflows>", `Comma-separated workflows to install (sixStepsWorkflow,featPlanUx,gitWorkflow,bmadWorkflow), "skip" to skip all, "all" for all workflows, ${i18n.t("cli:help.defaults.prefix")} all`).option("--output-styles, -o <styles>", `Comma-separated output styles (engineer-professional,nekomata-engineer,laowang-engineer,default,explanatory,learning), "skip" to skip all, "all" for all custom styles, ${i18n.t("cli:help.defaults.prefix")} all`).option("--default-output-style, -d <style>", `Default output style, ${i18n.t("cli:help.defaults.prefix")} engineer-professional`).option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").option("--install-cometix-line, -x <value>", `Install CCometixLine statusline tool (true/false), ${i18n.t("cli:help.defaults.prefix")} true`).option("--api-configs <configs>", "API configurations as JSON string for multiple profiles").option("--api-configs-file <file>", "Path to JSON file containing API configurations").action(await withLanguageResolution(async (options) => {
+  cli.command("init", "Initialize Claude Code configuration").alias("i").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--ai-output-lang, -a <lang>", "AI output language").option("--force, -f", "Force overwrite existing configuration").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").option("--config-action, -r <action>", `Config handling (new/backup/merge/docs-only/skip), ${i18n.t("cli:help.defaults.prefix")} backup`).option("--api-type, -t <type>", "API type (auth_token/api_key/ccr_proxy/skip)").option("--api-key, -k <key>", "API key (used for both API key and auth token types)").option("--api-url, -u <url>", "Custom API URL").option("--api-model, -M <model>", "Primary API model (e.g., claude-sonnet-4-5)").option("--api-haiku-model, -H <model>", "Default Haiku model (e.g., claude-haiku-4-5)").option("--api-sonnet-model, -S <model>", "Default Sonnet model (e.g., claude-sonnet-4-5)").option("--api-opus-model, -O <model>", "Default Opus model (e.g., claude-opus-4-5)").option("--provider, -p <provider>", "API provider preset (302ai, glm, minimax, kimi, custom)").option("--mcp-services, -m <services>", `Comma-separated MCP services to install (context7,mcp-deepwiki,Playwright,exa), "skip" to skip all, "all" for all non-key services, ${i18n.t("cli:help.defaults.prefix")} all`).option("--workflows, -w <workflows>", `Comma-separated workflows to install (sixStepsWorkflow,featPlanUx,gitWorkflow,bmadWorkflow), "skip" to skip all, "all" for all workflows, ${i18n.t("cli:help.defaults.prefix")} all`).option("--output-styles, -o <styles>", `Comma-separated output styles (engineer-professional,nekomata-engineer,laowang-engineer,default,explanatory,learning), "skip" to skip all, "all" for all custom styles, ${i18n.t("cli:help.defaults.prefix")} all`).option("--default-output-style, -d <style>", `Default output style, ${i18n.t("cli:help.defaults.prefix")} engineer-professional`).option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").option("--install-cometix-line, -x <value>", `Install CCometixLine statusline tool (true/false), ${i18n.t("cli:help.defaults.prefix")} true`).option("--api-configs <configs>", "API configurations as JSON string for multiple profiles").option("--api-configs-file <file>", "Path to JSON file containing API configurations").action(await withLanguageResolution(async (options) => {
     await init(options);
   }));
   cli.command("update", "Update Claude Code prompts only").alias("u").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").action(await withLanguageResolution(async (options) => {

package/dist/i18n/locales/en/cli.json

@@ -24,7 +24,9 @@
   "help.optionDescriptions.apiKey": "API key (for both types)",
   "help.optionDescriptions.customApiUrl": "Custom API URL",
   "help.optionDescriptions.apiModel": "Primary API model",
-  "help.optionDescriptions.apiFastModel": "Fast API model",
+  "help.optionDescriptions.apiHaikuModel": "Default Haiku model",
+  "help.optionDescriptions.apiSonnetModel": "Default Sonnet model",
+  "help.optionDescriptions.apiOpusModel": "Default Opus model",
   "help.optionDescriptions.aiOutputLanguage": "AI output language",
   "help.optionDescriptions.setAllLanguageParams": "Set all language params",
   "help.optionDescriptions.configHandling": "Config handling",

package/dist/i18n/locales/en/configuration.json

@@ -15,7 +15,9 @@
   "currentModel": "Current model",
   "defaultModelOption": "Default - Let Claude Code choose",
   "defaultStyle": "Default style",
-  "enterFastModel": "Enter fast model name for background tasks",
+  "enterHaikuModel": "Enter default Haiku model",
+  "enterSonnetModel": "Enter default Sonnet model",
+  "enterOpusModel": "Enter default Opus model",
   "enterPrimaryModel": "Enter primary model name",
   "envImportSuccess": "Environment variables imported",
   "existingConfig": "Existing config detected. How to proceed?",

package/dist/i18n/locales/en/errors.json

@@ -12,7 +12,7 @@
   "invalidWorkflow": "Invalid workflow: {workflow}. Available workflows: {validWorkflows}",
   "invalidModel": "Invalid model: {model}. Expected 'opus', 'sonnet', or 'sonnet[1m]'",
   "invalidApiModel": "Invalid API model parameter: {value}",
-  "invalidApiFastModel": "Invalid fast model parameter: {value}",
+  "invalidModelParam": "Invalid model parameter {key}: {value}",
   "invalidEnvConfig": "Invalid env configuration: expected object",
   "invalidBaseUrl": "Invalid ANTHROPIC_BASE_URL: expected string",
   "invalidApiKeyConfig": "Invalid ANTHROPIC_API_KEY: expected string",

package/dist/i18n/locales/en/updater.json

@@ -1,5 +1,6 @@
 {
   "autoUpdating": "Auto-updating {tool}...",
+  "usingSudo": "Detected non-root Linux user. Using sudo for update (password prompt may appear).",
   "cannotCheckVersion": "Cannot check latest version",
   "ccrNotInstalled": "CCR is not installed",
   "ccrUpToDate": "CCR is up to date (v{version})",

package/dist/i18n/locales/zh-CN/cli.json

@@ -24,7 +24,9 @@
   "help.optionDescriptions.apiKey": "API密钥（适用于所有类型）",
   "help.optionDescriptions.customApiUrl": "自定义API地址",
   "help.optionDescriptions.apiModel": "主API模型",
-  "help.optionDescriptions.apiFastModel": "快速API模型",
+  "help.optionDescriptions.apiHaikuModel": "默认 Haiku 模型",
+  "help.optionDescriptions.apiSonnetModel": "默认 Sonnet 模型",
+  "help.optionDescriptions.apiOpusModel": "默认 Opus 模型",
   "help.optionDescriptions.aiOutputLanguage": "AI输出语言",
   "help.optionDescriptions.setAllLanguageParams": "统一设置所有语言参数",
   "help.optionDescriptions.configHandling": "配置处理",

package/dist/i18n/locales/zh-CN/configuration.json

@@ -15,7 +15,9 @@
   "currentModel": "当前模型",
   "defaultModelOption": "默认 - 让 Claude Code 自动选择",
   "defaultStyle": "默认风格",
-  "enterFastModel": "请输入后台任务的快速模型名称",
+  "enterHaikuModel": "请输入默认 Haiku 模型名称",
+  "enterSonnetModel": "请输入默认 Sonnet 模型名称",
+  "enterOpusModel": "请输入默认 Opus 模型名称",
   "enterPrimaryModel": "请输入主要使用的模型名称",
   "envImportSuccess": "环境变量已导入",
   "existingConfig": "检测到已有配置文件，如何处理？",

package/dist/i18n/locales/zh-CN/errors.json

@@ -12,7 +12,7 @@
   "invalidWorkflow": "无效的工作流：{workflow}。可用的工作流：{validWorkflows}",
   "invalidModel": "无效的模型：{model}。期望的值：'opus', 'sonnet', 或 'sonnet[1m]'",
   "invalidApiModel": "无效的 API 模型参数：{value}",
-  "invalidApiFastModel": "无效的快速模型参数：{value}",
+  "invalidModelParam": "无效的模型参数 {key}：{value}",
   "invalidEnvConfig": "无效的环境配置：期望对象类型",
   "invalidBaseUrl": "无效的 ANTHROPIC_BASE_URL：期望字符串类型",
   "invalidApiKeyConfig": "无效的 ANTHROPIC_API_KEY：期望字符串类型",

package/dist/i18n/locales/zh-CN/updater.json

@@ -1,5 +1,6 @@
 {
   "autoUpdating": "正在自动更新 {tool}...",
+  "usingSudo": "检测到 Linux 非 root 用户，正在使用 sudo 提升权限进行更新（可能需要输入密码）。",
   "cannotCheckVersion": "无法检查最新版本",
   "ccrNotInstalled": "CCR 未安装",
   "ccrUpToDate": "CCR 已是最新版本 (v{version})",

package/dist/index.d.mts

@@ -52,7 +52,9 @@ interface InitOptions {
     apiKey?: string;
     apiUrl?: string;
     apiModel?: string;
-    apiFastModel?: string;
+    apiHaikuModel?: string;
+    apiSonnetModel?: string;
+    apiOpusModel?: string;
     provider?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
@@ -159,9 +161,11 @@ declare function mergeConfigs(sourceFile: string, targetFile: string): void;
 /**
  * Update custom model configuration using environment variables
  * @param primaryModel - Primary model name for general tasks
- * @param fastModel - Fast model name for background tasks (optional)
+ * @param haikuModel - Default Haiku model (optional)
+ * @param sonnetModel - Default Sonnet model (optional)
+ * @param opusModel - Default Opus model (optional)
  */
-declare function updateCustomModel(primaryModel?: string, fastModel?: string): void;
+declare function updateCustomModel(primaryModel?: string, haikuModel?: string, sonnetModel?: string, opusModel?: string): void;
 /**
  * Update the default model configuration in settings.json
  * @param model - The model type to set: opus, sonnet, sonnet[1m], default, or custom

package/dist/index.d.ts

@@ -52,7 +52,9 @@ interface InitOptions {
     apiKey?: string;
     apiUrl?: string;
     apiModel?: string;
-    apiFastModel?: string;
+    apiHaikuModel?: string;
+    apiSonnetModel?: string;
+    apiOpusModel?: string;
     provider?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
@@ -159,9 +161,11 @@ declare function mergeConfigs(sourceFile: string, targetFile: string): void;
 /**
  * Update custom model configuration using environment variables
  * @param primaryModel - Primary model name for general tasks
- * @param fastModel - Fast model name for background tasks (optional)
+ * @param haikuModel - Default Haiku model (optional)
+ * @param sonnetModel - Default Sonnet model (optional)
+ * @param opusModel - Default Opus model (optional)
  */
-declare function updateCustomModel(primaryModel?: string, fastModel?: string): void;
+declare function updateCustomModel(primaryModel?: string, haikuModel?: string, sonnetModel?: string, opusModel?: string): void;
 /**
  * Update the default model configuration in settings.json
  * @param model - The model type to set: opus, sonnet, sonnet[1m], default, or custom

package/dist/index.mjs

@@ -11,9 +11,9 @@ import 'pathe';
 import 'node:url';
 import 'inquirer-toggle';
 import 'ora';
+import 'tinyexec';
 import 'semver';
 import 'smol-toml';
-import 'tinyexec';
 import 'node:fs/promises';
 import 'i18next';
 import 'i18next-fs-backend';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "3.4.2",
+  "version": "3.4.3",
   "description": "Zero-Config Code Flow - One-click configuration tool for Code Cli",
   "author": {
     "name": "Miao Da",

package/templates/claude-code/en/workflow/git/commands/git-commit.md

@@ -66,7 +66,16 @@ This command works **without any package manager/build tools**, using only **Git
 4. **Commit Message Generation (Conventional with Optional Emoji)**
    - Auto-infer `type` (`feat`/`fix`/`docs`/`refactor`/`test`/`chore`/`perf`/`style`/`ci`/`revert`...) and optional `scope`.
    - Generate message header: `[<emoji>] <type>(<scope>)?: <subject>` (first line ≤ 72 chars, imperative mood, emoji included only with `--emoji` flag).
-   - Generate message body: bullet points (motivation, implementation details, impact scope, BREAKING CHANGE if any).
+   - Generate message body:
+     - Must have a blank line after the subject.
+     - Use list format, each item starts with `-`.
+     - Each item **must use imperative verb-first sentences** (e.g., "add…", "fix…", "update…").
+     - **Colon-separated formats are prohibited** (e.g., ~~"Feature: description"~~, ~~"Impl: content"~~).
+     - Describe the motivation, implementation details, or impact scope (3 items or fewer recommended).
+   - Generate message footer (if any):
+     - Must have a blank line after the Body.
+     - **BREAKING CHANGE**: If there are breaking changes, must include `BREAKING CHANGE: <description>`, or add exclamation mark after type (e.g., `feat!:`).
+     - Other footers use git trailer format (e.g., `Closes #123`, `Refs: #456`, `Reviewed-by: Name`).
    - Select message language to match the predominant language in Git history. Inspect recent commit subjects (e.g., `git log -n 50 --pretty=%s`) to decide Chinese vs English; if unclear, fall back to the repository's primary locale or English.
    - Write draft to `.git/COMMIT_EDITMSG` for use with `git commit`.
 
@@ -83,8 +92,8 @@ This command works **without any package manager/build tools**, using only **Git
 
 - **Atomic commits**: One commit does one thing, easier to trace and review.
 - **Group before committing**: Split by directory/module/feature.
-- **Clear subject**: First line ≤ 72 chars, imperative mood (e.g., "add... / fix...").
-- **Body with context**: Explain motivation, solution, impact scope, risks, and next steps.
+- **Clear subject**: First line ≤ 72 chars, imperative mood.
+- **Body with context**: Explain motivation, solution, and impact scope (colon-separated formats prohibited).
 - **Follow Conventional Commits**: `<type>(<scope>): <subject>`.
 
 ---
@@ -122,6 +131,7 @@ This command works **without any package manager/build tools**, using only **Git
 
 **Good (with --emoji)**
 
+```text
 - ✨ feat(ui): add user authentication flow
 - 🐛 fix(api): handle token refresh race condition
 - 📝 docs: update API usage examples
@@ -129,9 +139,11 @@ This command works **without any package manager/build tools**, using only **Git
 - ✅ test: add unit tests for rate limiter
 - 🔧 chore: update git hooks and repository settings
 - ⏪️ revert: revert "feat(core): introduce streaming API"
+```
 
 **Good (without --emoji)**
 
+```text
 - feat(ui): add user authentication flow
 - fix(api): handle token refresh race condition
 - docs: update API usage examples
@@ -139,13 +151,48 @@ This command works **without any package manager/build tools**, using only **Git
 - test: add unit tests for rate limiter
 - chore: update git hooks and repository settings
 - revert: revert "feat(core): introduce streaming API"
+```
+
+**Good (with Body)**
+
+```text
+feat(auth): add OAuth2 login flow
+
+- implement Google and GitHub third-party login
+- add user authorization callback handling
+- improve login state persistence logic
+
+Closes #42
+```
+
+```text
+fix(ui): fix button spacing on mobile devices
+
+- adjust button padding to fit small screens
+- fix styling issues on iOS Safari
+- optimize touch target size
+```
+
+**Good (with BREAKING CHANGE)**
+
+```text
+feat(api)!: redesign authentication API
+
+- migrate from session-based to JWT authentication
+- update all endpoint signatures
+- remove deprecated login methods
+
+BREAKING CHANGE: authentication API has been completely redesigned, all clients must update their integration
+```
 
 **Split Example**
 
+```text
 - `feat(types): add new type defs for payment method`
 - `docs: update API docs for new types`
 - `test: add unit tests for payment types`
 - `fix: address linter warnings in new files` ← (if your repo has hook errors)
+```
 
 ---
 

package/templates/claude-code/zh-CN/workflow/git/commands/git-commit.md

@@ -66,7 +66,16 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 4. **提交信息生成（Conventional 规范，可选 Emoji）**
    - 自动推断 `type`（`feat`/`fix`/`docs`/`refactor`/`test`/`chore`/`perf`/`style`/`ci`/`revert` …）与可选 `scope`。
    - 生成消息头：`[<emoji>] <type>(<scope>)?: <subject>`（首行 ≤ 72 字符，祈使语气，仅在使用 `--emoji` 时包含 emoji）。
-   - 生成消息体：要点列表（动机、实现要点、影响范围、BREAKING CHANGE 如有）。
+   - 生成消息体：
+     - 必须在 subject 之后空一行。
+     - 使用列表格式，每项以 `-` 开头。
+     - 每项**必须使用动词开头的祈使句**（如 "add…"、"fix…"、"update…"）。
+     - **禁止使用冒号分隔的格式**（如 ~~"Feature: description"~~、~~"Impl: content"~~）。
+     - 说明变更的动机、实现要点或影响范围（3 项以内为宜）。
+   - 生成消息脚注（如有）：
+     - 必须在 Body 之后空一行。
+     - **BREAKING CHANGE**：若存在破坏性变更，必须包含 `BREAKING CHANGE: <description>`，或在类型后添加感叹号（如 `feat!:`）。
+     - 其它脚注采用 git trailer 格式（如 `Closes #123`、`Refs: #456`、`Reviewed-by: Name`）。
    - 根据 Git 历史提交的主要语言选择提交信息语言。优先检查最近提交主题（例如 `git log -n 50 --pretty=%s`）判断中文/英文；若无法判断，则回退到仓库主要语言或英文。
    - 将草稿写入 `.git/COMMIT_EDITMSG`，并用于 `git commit`。
 
@@ -83,8 +92,8 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 
 - **Atomic commits**：一次提交只做一件事，便于回溯与审阅。
 - **先分组再提交**：按目录/模块/功能点拆分。
-- **清晰主题**：首行 ≤ 72 字符，祈使语气（如 “add… / fix…”）。
-- **正文含上下文**：说明动机、方案、影响范围、风险与后续工作。
+- **清晰主题**：首行 ≤ 72 字符，祈使语气。
+- **正文含上下文**：说明动机、方案、影响范围（禁止冒号分隔格式）。
 - **遵循 Conventional Commits**：`<type>(<scope>): <subject>`。
 
 ---
@@ -122,6 +131,7 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 
 **Good (使用 --emoji)**
 
+```text
 - ✨ feat(ui): add user authentication flow
 - 🐛 fix(api): handle token refresh race condition
 - 📝 docs: update API usage examples
@@ -129,9 +139,11 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 - ✅ test: add unit tests for rate limiter
 - 🔧 chore: update git hooks and repository settings
 - ⏪️ revert: revert "feat(core): introduce streaming API"
+```
 
 **Good (不使用 --emoji)**
 
+```text
 - feat(ui): add user authentication flow
 - fix(api): handle token refresh race condition
 - docs: update API usage examples
@@ -139,13 +151,48 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 - test: add unit tests for rate limiter
 - chore: update git hooks and repository settings
 - revert: revert "feat(core): introduce streaming API"
+```
+
+**Good (包含 Body)**
+
+```text
+feat(auth): add OAuth2 login flow
+
+- implement Google and GitHub third-party login
+- add user authorization callback handling
+- improve login state persistence logic
+
+Closes #42
+```
+
+```text
+fix(ui): fix button spacing on mobile devices
+
+- adjust button padding to fit small screens
+- fix styling issues on iOS Safari
+- optimize touch target size
+```
+
+**Good (包含 BREAKING CHANGE)**
+
+```text
+feat(api)!: redesign authentication API
+
+- migrate from session-based to JWT authentication
+- update all endpoint signatures
+- remove deprecated login methods
+
+BREAKING CHANGE: authentication API has been completely redesigned, all clients must update their integration
+```
 
 **Split Example**
 
+```text
 - `feat(types): add new type defs for payment method`
 - `docs: update API docs for new types`
 - `test: add unit tests for payment types`
 - `fix: address linter warnings in new files` ←（如你的仓库有钩子报错）
+```
 
 ---
 

package/templates/codex/en/workflow/git/prompts/git-commit.md

@@ -66,7 +66,16 @@ This command works **without any package manager/build tools**, using only **Git
 4. **Commit Message Generation (Conventional with Optional Emoji)**
    - Auto-infer `type` (`feat`/`fix`/`docs`/`refactor`/`test`/`chore`/`perf`/`style`/`ci`/`revert`...) and optional `scope`.
    - Generate message header: `[<emoji>] <type>(<scope>)?: <subject>` (first line ≤ 72 chars, imperative mood, emoji included only with `--emoji` flag).
-   - Generate message body: bullet points (motivation, implementation details, impact scope, BREAKING CHANGE if any).
+   - Generate message body:
+     - Must have a blank line after the subject.
+     - Use list format, each item starts with `-`.
+     - Each item **must use imperative verb-first sentences** (e.g., "add…", "fix…", "update…").
+     - **Colon-separated formats are prohibited** (e.g., ~~"Feature: description"~~, ~~"Impl: content"~~).
+     - Describe the motivation, implementation details, or impact scope (3 items or fewer recommended).
+   - Generate message footer (if any):
+     - Must have a blank line after the Body.
+     - **BREAKING CHANGE**: If there are breaking changes, must include `BREAKING CHANGE: <description>`, or add exclamation mark after type (e.g., `feat!:`).
+     - Other footers use git trailer format (e.g., `Closes #123`, `Refs: #456`, `Reviewed-by: Name`).
    - Select message language to match the predominant language in Git history. Inspect recent commit subjects (e.g., `git log -n 50 --pretty=%s`) to decide Chinese vs English; if unclear, fall back to the repository's primary locale or English.
    - Write draft to `.git/COMMIT_EDITMSG` for use with `git commit`.
 
@@ -83,8 +92,8 @@ This command works **without any package manager/build tools**, using only **Git
 
 - **Atomic commits**: One commit does one thing, easier to trace and review.
 - **Group before committing**: Split by directory/module/feature.
-- **Clear subject**: First line ≤ 72 chars, imperative mood (e.g., "add... / fix...").
-- **Body with context**: Explain motivation, solution, impact scope, risks, and next steps.
+- **Clear subject**: First line ≤ 72 chars, imperative mood.
+- **Body with context**: Explain motivation, solution, and impact scope (colon-separated formats prohibited).
 - **Follow Conventional Commits**: `<type>(<scope>): <subject>`.
 
 ---
@@ -122,6 +131,7 @@ This command works **without any package manager/build tools**, using only **Git
 
 **Good (with --emoji)**
 
+```text
 - ✨ feat(ui): add user authentication flow
 - 🐛 fix(api): handle token refresh race condition
 - 📝 docs: update API usage examples
@@ -129,9 +139,11 @@ This command works **without any package manager/build tools**, using only **Git
 - ✅ test: add unit tests for rate limiter
 - 🔧 chore: update git hooks and repository settings
 - ⏪️ revert: revert "feat(core): introduce streaming API"
+```
 
 **Good (without --emoji)**
 
+```text
 - feat(ui): add user authentication flow
 - fix(api): handle token refresh race condition
 - docs: update API usage examples
@@ -139,13 +151,48 @@ This command works **without any package manager/build tools**, using only **Git
 - test: add unit tests for rate limiter
 - chore: update git hooks and repository settings
 - revert: revert "feat(core): introduce streaming API"
+```
+
+**Good (with Body)**
+
+```text
+feat(auth): add OAuth2 login flow
+
+- implement Google and GitHub third-party login
+- add user authorization callback handling
+- improve login state persistence logic
+
+Closes #42
+```
+
+```text
+fix(ui): fix button spacing on mobile devices
+
+- adjust button padding to fit small screens
+- fix styling issues on iOS Safari
+- optimize touch target size
+```
+
+**Good (with BREAKING CHANGE)**
+
+```text
+feat(api)!: redesign authentication API
+
+- migrate from session-based to JWT authentication
+- update all endpoint signatures
+- remove deprecated login methods
+
+BREAKING CHANGE: authentication API has been completely redesigned, all clients must update their integration
+```
 
 **Split Example**
 
+```text
 - `feat(types): add new type defs for payment method`
 - `docs: update API docs for new types`
 - `test: add unit tests for payment types`
 - `fix: address linter warnings in new files` ← (if your repo has hook errors)
+```
 
 ---
 

package/templates/codex/zh-CN/workflow/git/prompts/git-commit.md

@@ -66,7 +66,16 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 4. **提交信息生成（Conventional 规范，可选 Emoji）**
    - 自动推断 `type`（`feat`/`fix`/`docs`/`refactor`/`test`/`chore`/`perf`/`style`/`ci`/`revert` …）与可选 `scope`。
    - 生成消息头：`[<emoji>] <type>(<scope>)?: <subject>`（首行 ≤ 72 字符，祈使语气，仅在使用 `--emoji` 时包含 emoji）。
-   - 生成消息体：要点列表（动机、实现要点、影响范围、BREAKING CHANGE 如有）。
+   - 生成消息体：
+     - 必须在 subject 之后空一行。
+     - 使用列表格式，每项以 `-` 开头。
+     - 每项**必须使用动词开头的祈使句**（如 "add…"、"fix…"、"update…"）。
+     - **禁止使用冒号分隔的格式**（如 ~~"Feature: description"~~、~~"Impl: content"~~）。
+     - 说明变更的动机、实现要点或影响范围（3 项以内为宜）。
+   - 生成消息脚注（如有）：
+     - 必须在 Body 之后空一行。
+     - **BREAKING CHANGE**：若存在破坏性变更，必须包含 `BREAKING CHANGE: <description>`，或在类型后添加感叹号（如 `feat!:`）。
+     - 其它脚注采用 git trailer 格式（如 `Closes #123`、`Refs: #456`、`Reviewed-by: Name`）。
    - 根据 Git 历史提交的主要语言选择提交信息语言。优先检查最近提交主题（例如 `git log -n 50 --pretty=%s`）判断中文/英文；若无法判断，则回退到仓库主要语言或英文。
    - 将草稿写入 `.git/COMMIT_EDITMSG`，并用于 `git commit`。
 
@@ -83,8 +92,8 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 
 - **Atomic commits**：一次提交只做一件事，便于回溯与审阅。
 - **先分组再提交**：按目录/模块/功能点拆分。
-- **清晰主题**：首行 ≤ 72 字符，祈使语气（如 “add… / fix…”）。
-- **正文含上下文**：说明动机、方案、影响范围、风险与后续工作。
+- **清晰主题**：首行 ≤ 72 字符，祈使语气。
+- **正文含上下文**：说明动机、方案、影响范围（禁止冒号分隔格式）。
 - **遵循 Conventional Commits**：`<type>(<scope>): <subject>`。
 
 ---
@@ -122,6 +131,7 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 
 **Good (使用 --emoji)**
 
+```text
 - ✨ feat(ui): add user authentication flow
 - 🐛 fix(api): handle token refresh race condition
 - 📝 docs: update API usage examples
@@ -129,9 +139,11 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 - ✅ test: add unit tests for rate limiter
 - 🔧 chore: update git hooks and repository settings
 - ⏪️ revert: revert "feat(core): introduce streaming API"
+```
 
 **Good (不使用 --emoji)**
 
+```text
 - feat(ui): add user authentication flow
 - fix(api): handle token refresh race condition
 - docs: update API usage examples
@@ -139,13 +151,48 @@ argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <s
 - test: add unit tests for rate limiter
 - chore: update git hooks and repository settings
 - revert: revert "feat(core): introduce streaming API"
+```
+
+**Good (包含 Body)**
+
+```text
+feat(auth): add OAuth2 login flow
+
+- implement Google and GitHub third-party login
+- add user authorization callback handling
+- improve login state persistence logic
+
+Closes #42
+```
+
+```text
+fix(ui): fix button spacing on mobile devices
+
+- adjust button padding to fit small screens
+- fix styling issues on iOS Safari
+- optimize touch target size
+```
+
+**Good (包含 BREAKING CHANGE)**
+
+```text
+feat(api)!: redesign authentication API
+
+- migrate from session-based to JWT authentication
+- update all endpoint signatures
+- remove deprecated login methods
+
+BREAKING CHANGE: authentication API has been completely redesigned, all clients must update their integration
+```
 
 **Split Example**
 
+```text
 - `feat(types): add new type defs for payment method`
 - `docs: update API docs for new types`
 - `test: add unit tests for payment types`
 - `fix: address linter warnings in new files` ←（如你的仓库有钩子报错）
+```
 
 ---