{
  "scenario": "auto-compose-commit",
  "locale": "zh-CN",
  "version": "1.4.0",
  "syntax": "handlebars",
  "syntaxVersion": "1.0",
  "author": "PCode Team",
  "description": "AI 自动组合提交提示词（分析所有未提交变更，智能分组并生成多提交，中文版）",
  "image": {
    "stageStyleKey": "commit-modular-infographic",
    "artStyle": "模块化信息图风",
    "displayMode": "infographic-grid",
    "aspectRatio": "16:9",
    "alt": "AI 自动组合提交提示词（分析所有未提交变更，智能分组并生成多提交，中文版）",
    "stageStyleLabel": "Modular commit infographic",
    "promptDirection": "提交分组、变更打包、节奏组织"
  },
  "lastModified": "2026-03-29",
  "tags": [
    "ai-commit",
    "multi-commit",
    "CustomExecutor"
  ],
  "parameters": [
    {
      "name": "projectPath",
      "type": "string",
      "required": true,
      "description": "项目根目录的绝对路径，AI 将使用此路径获取所有未提交的文件变更并进行分析"
    },
    {
      "name": "needPush",
      "type": "boolean",
      "required": false,
      "default": false,
      "description": "是否在提交创建后推送到远程仓库。当为 true 时，系统将在所有提交创建后尝试推送，并进行 fastforward 安全检查。当为 false 时，仅创建本地提交。"
    },
    {
      "name": "pullRebaseBeforePush",
      "type": "boolean",
      "required": false,
      "default": false,
      "description": "控制在启用推送且目标为当前分支时，是否在推送前先执行 git pull --rebase。"
    },
    {
      "name": "targetBranchMode",
      "type": "string",
      "required": false,
      "default": "current",
      "description": "目标分支策略：current（保持当前分支）、new-custom（从当前分支创建自定义名称新分支）、ai-generated-new（从当前分支创建 AI 命名新分支）。"
    },
    {
      "name": "targetBranchName",
      "type": "string",
      "required": false,
      "description": "自定义目标分支名称，仅当 targetBranchMode=new-custom 时提供。"
    },
    {
      "name": "repositoryPath",
      "type": "string",
      "required": false,
      "description": "MonoSpecs 子仓库相对路径，用于在正确仓库中校验和执行分支相关操作。"
    },
    {
      "name": "gitProfileName",
      "type": "string",
      "required": false,
      "description": "从前端 Git Profile 选择器注入的 Git 身份名称，在自动提交时同时用于 Author 和 Committer。"
    },
    {
      "name": "gitProfileEmail",
      "type": "string",
      "required": false,
      "description": "从前端 Git Profile 选择器注入的 Git 身份邮箱，在自动提交时同时用于 Author 和 Committer。"
    },
    {
      "name": "signedOffByEnabled",
      "type": "boolean",
      "required": false,
      "default": true,
      "description": "控制本次自动组合提交是否必须生成 Git 标准 Signed-off-by 尾注。"
    },
    {
      "name": "coAuthoredByTrailer",
      "type": "string",
      "required": false,
      "description": "当前运行在需要追加尾注时应使用的 Co-Authored-By trailer。"
    },
    {
      "name": "coAuthoredBySource",
      "type": "string",
      "required": false,
      "description": "当前 Co-Authored-By trailer 的来源：project、global、default 或 custom。"
    },
    {
      "name": "coAuthoredByMode",
      "type": "string",
      "required": false,
      "default": "default",
      "description": "当前运行的 Co-Authored-By 模式：default、custom 或 none。"
    },
    {
      "name": "coAuthoredByName",
      "type": "string",
      "required": false,
      "description": "custom 模式下当前运行生效的 Co-Authored-By 名称。"
    },
    {
      "name": "coAuthoredByEmail",
      "type": "string",
      "required": false,
      "description": "custom 模式下当前运行生效的 Co-Authored-By 邮箱。"
    },
    {
      "name": "coAuthoredByIsCustom",
      "type": "boolean",
      "required": false,
      "description": "标记当前运行是否使用自定义 Co-Authored-By trailer。"
    },
    {
      "name": "coAuthoredByIsNone",
      "type": "boolean",
      "required": false,
      "description": "标记当前运行是否需要完全跳过 Co-Authored-By。"
    }
  ],
  "dungeon": {
    "enabled": true,
    "scriptKey": "autotask.auto-compose-commit",
    "groupKey": "autotask",
    "sortOrder": 110,
    "displayNameKey": "hero.dungeon.catalog.autotask.autoComposeCommit.name",
    "descriptionKey": "hero.dungeon.catalog.autotask.autoComposeCommit.description",
    "displayName": "自动组合提交",
    "description": "用于自动组合提交任务的运行时成员路由配置。"
  }
}
