ai-commit

使用 Codex 根据 git diff 生成符合 Conventional Commits 的提交信息。

功能

• 读取暂存区或工作区 diff（优先暂存区）
• 自动忽略常见锁文件与日志文件
• 生成单行 commit message，长度不超过 50 个字符
• Codex 失败时自动回退为本地摘要

安装

pnpm add -D @ckpack/ai-commit

或全局安装：

pnpm add -g @ckpack/ai-commit

使用

在包含变更的 git 仓库中运行：

ai-commit codex

输出示例：

feat: add commit message generator

你也可以直接调用源码（开发时）：

pnpm dev -- codex

环境变量

• CODEX_BIN：Codex 可执行文件名，默认 codex
• CODEX_ARGS：传给 Codex 的参数，默认 exec

示例：

CODEX_BIN=codex CODEX_ARGS="exec" ai-commit codex

生成逻辑

• 优先读取 git diff --staged，为空则读取 git diff
• 默认忽略：**/*.log、**/pnpm-lock.yaml、**/package-lock.json、**/yarn.lock
• 生成的消息需匹配 Conventional Commits： type(scope?): description，描述不超过 50 个字符
• Codex 返回异常或不符合规范时，回退为 chore: update <files>

开发

pnpm dev        # 运行源码
pnpm build      # 构建 dist
pnpm typecheck  # TS 类型检查
pnpm lint       # 修复 lint

许可

MIT