spaceflow/docs/guide/commands/commit.md

commit — 智能提交

基于 AI 自动生成符合 Conventional Commits 规范的 commit message，并执行 git commit。

基本用法

# 自动生成 commit message 并提交
spaceflow commit

# 试运行，仅生成不提交
spaceflow commit --dry-run

# 智能拆分提交（按模块/功能自动拆分为多个 commit）
spaceflow commit --split

# 跳过 git hooks
spaceflow commit --no-verify

工作流程

普通模式

1. 检查暂存区 — 确认有 git add 过的文件
2. 获取上下文 — 读取暂存文件列表、diff、所属包信息、最近 commit 历史
3. 构建 Prompt — 将上下文和 Conventional Commits 类型规范发送给 LLM
4. 解析响应 — 从 AI 响应中提取 type、scope、subject、body
5. 执行提交 — 格式化为 type(scope): subject 并执行 git commit

Split 模式（--split）

1. 收集文件 — 获取暂存区或工作区的所有变更文件
2. 分组策略 — 根据配置的 scope 策略对文件分组：
   • package — 按 package.json 所属包分组（默认）
   • rules — 按自定义 glob 规则分组
   • rules-first — 优先规则匹配，未匹配的按包分组
3. AI 分析 — 单组时让 AI 进一步分析是否需要拆分
4. 并行生成 — 并行为每个组生成 commit message
5. 顺序提交 — 子包优先、根目录最后，逐个 git add + git commit

Scope 自动推断

Spaceflow 会自动根据文件所属的 package.json 推断 scope：

cli/src/commands/build/build.service.ts  → scope: cli
core/src/shared/logger/logger.ts         → scope: core
commands/review/src/review.service.ts    → scope: review
package.json                             → scope: (空，根目录)

Commit 类型

类型列表从 spaceflow.json 的 publish.changelog.preset.type 读取，默认值：

类型	含义
feat	新特性
fix	修复 BUG
perf	性能优化
refactor	代码重构
docs	文档更新
style	代码格式
test	测试用例
chore	其他修改

Scope 配置

在 spaceflow.json 中配置 commit 字段自定义 scope 策略：

{
  "commit": {
    "strategy": "rules-first",
    "rules": [
      { "pattern": "docs/**", "scope": "docs" },
      { "pattern": ".github/**", "scope": "ci" },
      { "pattern": "*.config.*", "scope": "config" }
    ]
  }
}

策略说明

策略	说明
package	按 package.json 所属包推断 scope（默认）
rules	仅使用自定义 glob 规则匹配
rules-first	优先规则匹配，未匹配的回退到包推断

命令行选项

选项	简写	说明
--dry-run	-d	试运行，仅生成 message 不提交
--split	-s	智能拆分为多个 commit
--no-verify	-n	跳过 git hooks
--verbose	-v	详细日志（-v 基本，-vv 详细）

示例

# 普通提交
git add .
spaceflow commit

# 预览生成的 message
git add .
spaceflow commit --dry-run

# 智能拆分（自动 git add 工作区文件）
spaceflow commit --split

# 拆分 + 预览
spaceflow commit --split --dry-run

# 详细日志查看 AI 交互过程
spaceflow commit -vv

输出示例

普通模式

正在生成 commit message...
──────────────────────────────────────────────────
feat(core): 添加 Logger 模块支持 TUI 和 Plain 两种渲染模式
──────────────────────────────────────────────────
提交成功

Split 模式

按包目录分组策略分组...
检测到 3 个分组
并行生成 3 个 commit message...
✅ Commit 1: feat(core): 添加 Logger 模块
✅ Commit 2: feat(cli): 集成 Logger 到 build 命令
✅ Commit 3: docs: 更新 Logger 文档
分批提交完成，共 3 个 commit