@chenmk/superflow 0.1.0

package/assets/context-templates/incidents.md

@@ -0,0 +1,89 @@
+# 历史事故
+
+> **初始版来源**：`openspec/changes/v1.1-add-charging-package-suite/bug-archive/yunxiao-2026-06-02-pending-confirmation/`（云效 2026-06-02 待确认批次）+ sdd-cli 引用过的 P 编号
+> **维护方**：测试 + 开发
+> **自动化率**：20-40%（commit "fix" + 注释 "FIX" 可挖，PR 描述/issue tracker 不可访问——私有仓）
+
+## 1. v1.1 充电套餐批次（2026-06-02 云效待确认）
+
+来源目录：`openspec/changes/v1.1-add-charging-package-suite/bug-archive/yunxiao-2026-06-02-pending-confirmation/`
+原始文件：HTML（云效导出） + `raw-bugs.json`（待解析）
+
+### 1.1 套餐运营商 / 站点相关
+
+| CDPT | 标题 | 状态 | 关联规则 |
+|------|------|------|---------|
+| CDPT-165 | 创建套餐的查询条件，运营商与查询结果不匹配，创建的套餐是其他运营商的 | 待修复 | [business-rules §1.1](./business-rules.md#11-套餐业务) |
+| CDPT-171 | 应限制同一个站点不能创建相同名称的优惠套餐 | 待修复 | §1.1 |
+| CDPT-192 | 修改充电套餐的适用站点后，已开通套餐的记录，适用站点没有更新 | 待修复 | §1.1 |
+| CDPT-166 | 创建套餐页面，导出 Excel 中的使用站点列展示错误 | 待修复 | §4 |
+| CDPT-158 | 充电套餐的有效时段，应该允许跨天 | 待修复 | §1.1 |
+| CDPT-175 | 同车牌不同套餐、不同有效时间段 — 应该允许开通 | 待修复 | §1.1 |
+
+### 1.2 退款 / 对账 / 权益同步
+
+| CDPT | 标题 | 状态 | 关联规则 |
+|------|------|------|---------|
+| CDPT-186 | 充电套餐退款后，停车月票权益在 BEM 没有同步退款 | 待修复 | [business-rules §1.2](./business-rules.md#12-计费--退款--对账) |
+| CDPT-189 | 已退款的优惠套餐订单，扫码开票提示需优化 | 待修复 | §3 |
+| CDPT-169 | 续费充电套餐（停车月票），BEM 没有对该月票订单续费 | 待修复 | §6 |
+| CDPT-193 | 充电套餐适用多个站点时，无法开票 | 待修复 | §1.1 |
+
+### 1.3 批量开通 / 续费 / 退款
+
+| CDPT | 标题 | 状态 | 关联规则 |
+|------|------|------|---------|
+| CDPT-185 | 批量开通、续费、退款模板中手机号应支持填写 1 个或 2 个手机号 | 待修复 | [business-rules §2.1](./business-rules.md#21-批量开通--续费--退款) |
+| CDPT-180 | 批量开通、续费、退费时，遇到错误/异常数据整批数据都不插入业务系统，明确提示哪一行，哪个字段数据异常 | 待修复 | §2.1 |
+| CDPT-181 | 问题 1：批量开通上传文件类型错误时的提示需优化；问题 2：导入空的 Excel 模板也提示成功 | 待修复 | §2.1、§2.2 |
+| CDPT-178 | 批量开通、续费、退费模版字段，必填字段应加入【必填】两个字 | 待修复 | §2.1 |
+| CDPT-179 | 批量开通充电套餐，选择当天，1 天有效期，开通记录显示已过期。在页面开通显示生效中 | 待修复 | §2.1 |
+| CDPT-198 | 批量导入车位枪的文件格式错误，提示需优化 | 待修复 | §2.2 |
+| CDPT-199 | 站点没有绑定车位枪时，站点的【启用车位枪】按钮不允许打开 | 待修复 | [business-rules §1.3](./business-rules.md#13-车位--设备) |
+
+### 1.4 导出 / 查询 / 字段
+
+| CDPT | 标题 | 状态 | 关联规则 |
+|------|------|------|---------|
+| CDPT-188 | 套餐开通记录导出，剩余充电额度为不限额时，导出内容错误 | 待修复 | [business-rules §4](./business-rules.md#4-数据权限--字段约束) |
+| CDPT-177 | 开通套餐记录导出的 Excel 中不要合并不连续的有效期 | 待修复 | §4 |
+| CDPT-173 | 开通套餐页面的查询条件，【车牌号码】应支持模糊查询 | 待修复 | §4 |
+| CDPT-164 | 开通套餐的记录中，最近操作人取值错误（admin 后台开通） | 待修复 | §4 |
+| CDPT-163 | 开通充电套餐后，扫码开启充电，没有套餐可用 | 待修复 | §3 |
+| CDPT-194 | 停车权益记录，适用车场的名称没展示 | 待修复 | §4 |
+
+## 2. 历史 P 编号记录（sdd-cli 引用过）
+
+来源：`sdd-cli/assets/skills/superflow-implement/SKILL.md` 等地方提到的 P 编号示例
+
+| P 编号 | 描述 | 备注 |
+|--------|------|------|
+| P50 | worktree 启动端口示例（base 9250 → 9300） | 端口计算约定 |
+| P64 | prompt 命名示例（p64-export-plot-display.md） | 命名约定 |
+
+> **注**：完整 P 编号历史应从 git log + openspec/changes/archive/ 反推。本文件仅记录 sdd-cli 显式引用的。
+
+## 3. 事故复盘模板
+
+每条事故建议补充以下信息（自动化扫不到，需人工补）：
+
+```markdown
+### CDPT-XXX: <标题>
+
+- **发现时间**：YYYY-MM-DD
+- **发现渠道**：云效 / QA / 线上报警 / 客户反馈
+- **根因**：（一句话说清楚，不要泛泛说"业务逻辑错误"）
+- **影响范围**：（哪些模块 / 哪些数据 / 多少用户 / 持续多久）
+- **修复 commit**：（`git log --grep="CDPT-XXX"` 拿 SHA）
+- **修复时间**：YYYY-MM-DD
+- **复盘人**：<name>
+- **预防措施**：（代码 / 流程 / 测试 哪一层加固）
+- **关联规则**：[business-rules.md §X.Y](./business-rules.md)
+```
+
+## 4. 维护提示
+
+- **不要直接复制云效 HTML**——内容里含截图/附件链接，存 md 里维护性差
+- 建议用 `raw-bugs.json` 解析后写本文件（一次性脚本）
+- 后期可让 LLM 帮补全"根因 / 影响范围"等结构化字段
+- 修复完成后这条记录可以从"待修复"挪到"已闭环"区

package/assets/manifest.json

@@ -0,0 +1,53 @@
+{
+  "version": "0.1.0",
+  "agents": ["claude", "codex"],
+  "skills": [
+    "openspec-apply-change",
+    "openspec-archive-change",
+    "openspec-explore",
+    "openspec-propose",
+    "superflow-archive",
+    "superflow-clarify",
+    "superflow-design",
+    "superflow-docs",
+    "superflow-hotfix",
+    "superflow-implement",
+    "superflow-pipeline",
+    "superflow-table-impact-analysis",
+    "superflow-tweak",
+    "superflow-verify"
+  ],
+  "rules": [
+    "superflow-phase-guard.md"
+  ],
+  "scripts": [
+    "superflow-verify-integration.sh",
+    "superflow-delivery-check.sh",
+    "superflow-sql-sync-hook.py",
+    "superflow-contract-hooks.sh",
+    "superflow-enforce-hook.sh",
+    "superflow-hook-guard.sh",
+    "superflow-dependency-update-hook.sh",
+    "superflow-integration-evidence-hook.sh",
+    "superflow-test-report-lint.py",
+    "install-sql-pre-commit.sh",
+    "sync-settings-json.py"
+  ],
+  "agentScripts": {
+    "claude": ["claude-auto-backup-hook.sh"],
+    "codex": ["codex-auto-backup-hook.sh"]
+  },
+  "hooks": [
+    "superflow-enforce-hook.sh",
+    "superflow-hook-guard.sh",
+    "superflow-contract-hooks.sh",
+    "superflow-dependency-update-hook.sh",
+    "superflow-sql-sync-hook.py",
+    "superflow-delivery-check.sh",
+    "superflow-integration-evidence-hook.sh"
+  ],
+  "agentHooks": {
+    "claude": ["claude-auto-backup-hook.sh"],
+    "codex": ["codex-auto-backup-hook.sh"]
+  }
+}

package/assets/prompts/superflow-archive.md

@@ -0,0 +1,9 @@
+---
+description: Archive a verified SuperBridge Flow change
+argument-hint: change directory
+---
+
+Use the `superflow-archive` skill for this request.
+
+Archive only after verification has passed and the user confirms lifecycle
+closeout. Run the archive guard and keep final state files consistent.

package/assets/prompts/superflow-clarify.md

@@ -0,0 +1,10 @@
+---
+description: Clarify and freeze a complex SuperBridge Flow requirement
+argument-hint: requirement source or section
+---
+
+Use the `superflow-clarify` skill for this request.
+
+Read the requested source in bounded sections, freeze one feature or section at
+a time, and stop for missing product/API/DB facts before OpenSpec artifacts are
+created.

package/assets/prompts/superflow-design.md

@@ -0,0 +1,10 @@
+---
+description: Create source-level SuperBridge Flow technical design
+argument-hint: change directory
+---
+
+Use the `superflow-design` skill for this request.
+
+Let Superpowers handle source-level HOW: inspect real code, reverse impact,
+field references, TDD strategy, worker split, worktree and port planning. Do not
+rewrite OpenSpec contracts unless a conflict is found and returned to docs.

package/assets/prompts/superflow-docs.md

@@ -0,0 +1,10 @@
+---
+description: Generate or strengthen SuperBridge Flow contract documents
+argument-hint: change directory or requirement
+---
+
+Use the `superflow-docs` skill for this request.
+
+Keep OpenSpec as the source of WHAT and contracts. Ensure API, DB, tests,
+traceability, quality gates, and handoff files are complete before technical
+design starts.

package/assets/prompts/superflow-implement.md

@@ -0,0 +1,10 @@
+---
+description: Create SuperBridge Flow implementation prompts
+argument-hint: change directory or task id
+---
+
+Use the `superflow-implement` skill for this request.
+
+Generate bounded implementation prompts that inherit the latest handoff hash,
+include concrete interface/database/log verification, and preserve root document
+closeout ownership.

package/assets/prompts/superflow-pipeline.md

@@ -0,0 +1,13 @@
+---
+description: Run the SuperBridge Flow router
+argument-hint: requirement or change description
+---
+
+Use the `superflow-pipeline` skill for this request.
+
+Route the work through the correct SuperBridge Flow phase. OpenSpec owns WHAT
+and contracts; Superpowers owns source-level HOW. Preserve handoff state and run
+the required SuperBridge Flow guards before phase transitions.
+
+Input: treat the argument after `/superflow-pipeline` as the requirement,
+document path, or change description.

package/assets/prompts/superflow-verify.md

@@ -0,0 +1,10 @@
+---
+description: Verify a SuperBridge Flow change
+argument-hint: change directory
+---
+
+Use the `superflow-verify` skill for this request.
+
+Reload the handoff and verification evidence from files, run the required
+guards and review checks, and only advance when implementation evidence is
+current and complete.

package/assets/rules/superflow-phase-guard.md

@@ -0,0 +1,50 @@
+# SDD Phase Guard
+
+This rule is a lightweight anti-drift reminder for Codex and Claude Code.
+When an active SDD/OpenSpec change exists, read
+`openspec/changes/<name>/.sdd/state.yaml` before editing files or running
+phase-changing commands.
+
+## Phase Awareness
+
+| phase | allowed | blocked |
+| --- | --- | --- |
+| `docs` | clarify requirements, OpenSpec artifacts, SDD contract docs, handoff | runtime code changes |
+| `design` | Superpowers technical design, reverse impact analysis, TDD strategy | runtime code changes before design guard |
+| `implement` | implementation, TDD, worktree coordination, task checkoff | skipping plan/user decisions |
+| `verify` | verification, code review, branch/worktree closeout | hiding failed or partial evidence |
+| `archive` | final user confirmation, archive script | source code changes |
+| `done` | read-only inspection | lifecycle changes without reopen |
+
+## Required Checkpoints
+
+- Use `.sdd/handoff/brainstorm-summary.md` during changing requirements or
+  design discussion; separate confirmed, candidate, pending, and rejected
+  content.
+- After `brainstorm-summary.md` is finalized and before creating or rewriting
+  `design.md`, perform the active context-compression gate or get explicit user
+  confirmation to continue.
+- Before Superpowers planning or implementation prompts, generate
+  `.sdd/handoff/sdd-context.*` and record its hash in SDD quality gates.
+- During `phase: design`, create
+  `docs/superpowers/specs/*-technical-design.md`, record it as
+  `technical_design` in `.sdd/state.yaml`, and keep it limited to source-level
+  HOW. OpenSpec/SDD still owns requirements, API, DB, tests, SQL, and gates.
+- During `phase: implement`, `prompt/implementation.md` and task prompts under
+  `prompt/<task-name>.md` must exist and be cross-linked from tasks,
+  traceability, quality gate, and test-report before verification.
+- After context compression, agent switch, worktree switch, or parallel terminal
+  handoff, run `superflow-state.sh recover <change-dir>` and follow the printed
+  recovery action.
+- If `build_pause: plan-ready`, do not regenerate the plan unless the plan file
+  is missing or the user explicitly asks for a rewrite.
+- If `build_mode: subagent-driven-development`, the main session coordinates
+  only; read `.sdd/subagent-progress.md` and do not execute worker tasks
+  directly.
+- Build must complete `requesting-code-review` before transitioning to verify.
+- Verify must use `verification-before-completion`; archive requires explicit
+  user confirmation and `superflow-archive.sh`.
+
+OpenSpec/SDD documents remain the design source of truth. Handoff and rules are
+recovery aids; when they conflict with source documents, read and fix the source
+documents first.

package/assets/scripts/claude-auto-backup-hook.sh

@@ -0,0 +1,313 @@
+#!/bin/bash
+# Claude Code global experience auto backup hook.
+# Syncs curated ~/.claude development experience into code-cli-config/claude-code-setup,
+# then commits the backup repository. Push requires explicit --push-once.
+
+set -u
+
+CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
+CONFIG_REPO="${CLAUDE_CONFIG_REPO:-/Users/chenmankun/cmk-project/code-cli-config}"
+BACKUP_ROOT="$CONFIG_REPO/claude-code-setup"
+LOCK_DIR="${TMPDIR:-/tmp}/claude-auto-backup.lock"
+
+usage() {
+  cat <<'USAGE'
+用法:
+  claude-auto-backup-hook.sh [--force] [--dry-run] [--push-once]
+
+环境变量:
+  CLAUDE_AUTO_BACKUP_DISABLE=1  临时关闭自动备份
+  CLAUDE_AUTO_BACKUP_DRY_RUN=1  只同步检查，不提交
+  CLAUDE_CONFIG_REPO=/path       指定 code-cli-config 仓库路径
+USAGE
+}
+
+FORCE=0
+PUSH_ONCE=0
+DRY_RUN="${CLAUDE_AUTO_BACKUP_DRY_RUN:-0}"
+
+for arg in "$@"; do
+  case "$arg" in
+    --force) FORCE=1 ;;
+    --push-once) FORCE=1; PUSH_ONCE=1 ;;
+    --dry-run) DRY_RUN=1 ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+  esac
+done
+
+if [ "${CLAUDE_AUTO_BACKUP_DISABLE:-0}" = "1" ]; then
+  exit 0
+fi
+
+log() {
+  echo "[Claude 自动备份] $1" >&2
+}
+
+classify_backup_path() {
+  local path="$1"
+  case "$path" in
+    claude-code-setup/superflow-*|claude-code-setup/*.skill)
+      echo "SuperBridge Flow 技能"
+      ;;
+    claude-code-setup/openspec-*)
+      echo "OpenSpec 技能"
+      ;;
+    claude-code-setup/scripts/*)
+      echo "脚本"
+      ;;
+    claude-code-setup/agents/*)
+      echo "Agent"
+      ;;
+    claude-code-setup/commands/*)
+      echo "命令"
+      ;;
+    claude-code-setup/skills/*)
+      echo "技能"
+      ;;
+    claude-code-setup/settings/*)
+      echo "配置"
+      ;;
+    claude-code-setup/CLAUDE.md)
+      echo "全局指令"
+      ;;
+    claude-code-setup/output-styles/*)
+      echo "输出样式"
+      ;;
+    *)
+      echo "Claude 配置"
+      ;;
+  esac
+}
+
+build_commit_subject() {
+  local categories
+  categories="$(
+    git diff --cached --name-only |
+      while IFS= read -r path; do
+        classify_backup_path "$path"
+      done |
+      awk '!seen[$0]++'
+  )"
+
+  local first second third extra
+  first="$(printf '%s\n' "$categories" | sed -n '1p')"
+  second="$(printf '%s\n' "$categories" | sed -n '2p')"
+  third="$(printf '%s\n' "$categories" | sed -n '3p')"
+  extra="$(printf '%s\n' "$categories" | sed -n '4p')"
+
+  if [ -z "$first" ]; then
+    echo "自动备份 Claude：同步配置变化"
+  elif [ -z "$second" ]; then
+    echo "自动备份 Claude：更新 $first"
+  elif [ -z "$third" ]; then
+    echo "自动备份 Claude：更新 $first 和 $second"
+  elif [ -z "$extra" ]; then
+    echo "自动备份 Claude：更新 $first、$second 和 $third"
+  else
+    echo "自动备份 Claude：更新多类全局配置"
+  fi
+}
+
+build_commit_body() {
+  {
+    echo "本次自动备份包含："
+    git diff --cached --name-status |
+      sed -n '1,20p' |
+      sed 's/^/- /'
+  }
+}
+
+if ! mkdir "$LOCK_DIR" 2>/dev/null; then
+  log "已有备份任务在执行，跳过本次触发"
+  exit 0
+fi
+trap 'rmdir "$LOCK_DIR" 2>/dev/null || true' EXIT
+
+INPUT="$(cat 2>/dev/null || true)"
+
+json_value() {
+  local key="$1"
+  printf '%s' "$INPUT" | python3 -c "
+import json, sys
+try:
+    data = json.load(sys.stdin)
+except Exception:
+    print('')
+    raise SystemExit
+tool_input = data.get('tool_input', {})
+print(tool_input.get('$key', '') or '')
+" 2>/dev/null
+}
+
+TOUCH_PATH="$(json_value file_path)"
+COMMAND="$(json_value command)"
+if [ -z "$COMMAND" ]; then
+  COMMAND="$(json_value cmd)"
+fi
+CWD="$(json_value cwd)"
+
+should_trigger() {
+  if [ "$FORCE" = "1" ]; then
+    return 0
+  fi
+
+  case "$TOUCH_PATH" in
+    "$CLAUDE_HOME"/skills/*|"$CLAUDE_HOME"/scripts/*|"$CLAUDE_HOME"/agents/*|"$CLAUDE_HOME"/commands/*|"$CLAUDE_HOME"/output-styles/*)
+      return 0
+      ;;
+    "$CLAUDE_HOME"/CLAUDE.md|"$CLAUDE_HOME"/settings.json|"$CLAUDE_HOME"/settings.local.json)
+      return 0
+      ;;
+  esac
+
+  case "$CWD" in
+    "$CLAUDE_HOME"|"$CLAUDE_HOME"/*)
+      return 0
+      ;;
+  esac
+
+  case "$COMMAND" in
+    *"$CLAUDE_HOME"/skills*|*"$CLAUDE_HOME"/scripts*|*"$CLAUDE_HOME"/agents*|*"$CLAUDE_HOME"/commands*|*"$CLAUDE_HOME"/output-styles*|*"$CLAUDE_HOME"/CLAUDE.md*|*"$CLAUDE_HOME"/settings.json*|*"$CLAUDE_HOME"/settings.local.json*|*"~/.claude/skills"*|*"~/.claude/scripts"*|*"~/.claude/agents"*|*"~/.claude/commands"*|*"~/.claude/output-styles"*|*"~/.claude/CLAUDE.md"*|*"~/.claude/settings.json"*|*"~/.claude/settings.local.json"*)
+      return 0
+      ;;
+  esac
+
+  return 1
+}
+
+if ! should_trigger; then
+  exit 0
+fi
+
+if [ ! -d "$CLAUDE_HOME" ]; then
+  log "Claude 目录不存在: $CLAUDE_HOME"
+  exit 0
+fi
+
+if [ ! -d "$CONFIG_REPO/.git" ]; then
+  log "备份仓库不存在或不是 Git 仓库: $CONFIG_REPO"
+  exit 0
+fi
+
+log "同步 ~/.claude 到 claude-code-setup"
+
+# 确保备份目录存在
+mkdir -p "$BACKUP_ROOT/settings" \
+  "$BACKUP_ROOT/agents" \
+  "$BACKUP_ROOT/commands" \
+  "$BACKUP_ROOT/output-styles" \
+  "$BACKUP_ROOT/scripts" \
+  "$BACKUP_ROOT/skills"
+
+# 1. CLAUDE.md
+if [ -f "$CLAUDE_HOME/CLAUDE.md" ]; then
+  cp "$CLAUDE_HOME/CLAUDE.md" "$BACKUP_ROOT/CLAUDE.md"
+fi
+
+# 2. settings.json（过滤运行时状态）
+if [ -f "$CLAUDE_HOME/settings.json" ]; then
+  python3 "$BACKUP_ROOT/scripts/sync-settings-json.py" \
+    "$CLAUDE_HOME/settings.json" \
+    "$BACKUP_ROOT/settings/settings.json"
+fi
+
+# 3. settings.local.json
+if [ -f "$CLAUDE_HOME/settings.local.json" ]; then
+  cp "$CLAUDE_HOME/settings.local.json" "$BACKUP_ROOT/settings/settings.local.json"
+fi
+
+# 4. agents
+if [ -d "$CLAUDE_HOME/agents" ]; then
+  rsync -a --delete "$CLAUDE_HOME/agents/" "$BACKUP_ROOT/agents/"
+fi
+
+# 5. commands
+if [ -d "$CLAUDE_HOME/commands" ]; then
+  rsync -a --delete "$CLAUDE_HOME/commands/" "$BACKUP_ROOT/commands/"
+fi
+
+# 6. output-styles
+if [ -d "$CLAUDE_HOME/output-styles" ]; then
+  rsync -a --delete "$CLAUDE_HOME/output-styles/" "$BACKUP_ROOT/output-styles/"
+fi
+
+# 7. scripts（排除备份脚本自身，避免循环）
+if [ -d "$CLAUDE_HOME/scripts" ]; then
+  rsync -a --delete \
+    --exclude='claude-auto-backup-hook.sh' \
+    "$CLAUDE_HOME/scripts/" "$BACKUP_ROOT/scripts/"
+fi
+
+# 8. skills：只同步两边都存在的（用户显式维护的），不自动添加新 skill
+if [ -d "$CLAUDE_HOME/skills" ]; then
+  for skill_dir in "$CLAUDE_HOME"/skills/*; do
+    [ -d "$skill_dir" ] || continue
+    skill_name="$(basename "$skill_dir")"
+    case "$skill_name" in
+      .backups|.system)
+        continue
+        ;;
+    esac
+    # 只备份备份目录中已存在的 skills（不自动引入 marketplace skills）
+    if [ -d "$BACKUP_ROOT/skills/$skill_name" ] && [ -f "$skill_dir/SKILL.md" ]; then
+      rsync -a --delete "$skill_dir/" "$BACKUP_ROOT/skills/$skill_name/"
+    fi
+  done
+fi
+
+chmod +x "$BACKUP_ROOT/scripts/"*.sh \
+  "$BACKUP_ROOT/scripts/"*.py 2>/dev/null || true
+
+if [ "$DRY_RUN" = "1" ]; then
+  log "dry-run 模式，仅完成同步，不提交"
+  exit 0
+fi
+
+log "提交 code-cli-config"
+
+STAGE_PATHS=(
+  "claude-code-setup/CLAUDE.md"
+  "claude-code-setup/settings/settings.json"
+  "claude-code-setup/settings/settings.local.json"
+  "claude-code-setup/agents"
+  "claude-code-setup/commands"
+  "claude-code-setup/output-styles"
+  "claude-code-setup/scripts"
+  "claude-code-setup/skills"
+)
+
+(
+  cd "$CONFIG_REPO" || exit 0
+
+  for path in "${STAGE_PATHS[@]}"; do
+    if [ -e "$path" ]; then
+      git add "$path"
+    fi
+  done
+
+  if git diff --cached --quiet; then
+    log "没有需要提交的 Claude 配置变化"
+    if [ "$PUSH_ONCE" != "1" ]; then
+      exit 0
+    fi
+  else
+    commit_subject="$(build_commit_subject)"
+    commit_body="$(build_commit_body)"
+    log "提交说明: $commit_subject"
+    git commit -m "$commit_subject" -m "$commit_body"
+    if [ "$PUSH_ONCE" != "1" ]; then
+      log "已完成本地提交；如需推送，请手动执行: $0 --push-once"
+      exit 0
+    fi
+  fi
+
+  current_branch="$(git branch --show-current)"
+  if [ -z "$current_branch" ]; then
+    log "当前仓库不在普通分支，跳过推送"
+    exit 0
+  fi
+  git push origin "$current_branch"
+)