Gitai 自动化 — AI 驱动的 Git 工作流

借助智能、自动化的提交管理，彻底革新您的开发工作流。

Gitai 分析您的代码变更，依据 Conventional Commits 规范自动生成准确、描述性强的提交信息。它消除了手动撰写提交信息的繁琐过程，确保 Git 历史记录干净、语义清晰且专业，全程自动化完成。

核心能力：

• 多语言通用支持：支持分析 Node.js、Python、Java、Go、PHP 等多种语言项目。
• 多 LLM 后端支持：可自由选择您偏好的 AI 引擎——OpenAI（GPT）、Anthropic（Claude）或 Groq。
• 工作流自动化：单条命令即可完成暂存（stage）、提交（commit）与推送（push）全流程。
• 标准化历史记录：统一保障项目版本历史的一致性与规范性。

📦 前置条件（必需）

本技能要求系统中已安装并配置好 @notyped/gitai CLI 工具，且必须在代理（agent）运行前完成。

代理（AGENT）不得尝试安装该包或执行任何配置操作。

1. 检查 gitai 是否可用：

   command -v gitai
   

2. 若未安装，立即中止并提示用户：

   “gitai CLI 工具尚未安装。请先全局安装（例如执行 npm install -g @notyped/gitai），并完成配置后，再使用本技能。”

3. 检查 ~/.gitai 文件是否存在。

4. 若不存在，立即中止并提示用户：

   “gitai 工具已安装但尚未配置。请在终端中运行 gitai 命令以完成初始化设置。”

5. 仅当以上两项检查均通过时，方可继续执行后续操作。

🚀 使用方式与工作流

命令结构

基于 gitai --help 输出：

gitai [options] [projectPath] [baseMessage]

参数说明：

• projectPath：项目路径（默认为当前目录 .）。
• baseMessage：基础提交信息（可选）。

选项说明：

• -p, --push：提交后是否自动推送至远程仓库（默认：false）。
• -V, --version：输出当前 Gitai 版本号。
• -h, --help：显示该命令的帮助信息。

标准工作流

验证

查看当前激活的 Gitai 版本：

gitai --version

⚠️ 故障排查

• 交互式向导卡住：若 gitai 卡在等待用户输入状态，说明 ~/.gitai 文件缺失或内容无效。请按步骤 2 手动创建该文件。
• Node 版本错误：请确认当前使用的 Node.js 版本为 18 或更高版本（执行 node -v 查看）。
• API 错误：请检查 ~/.gitai 中配置的 API_KEY 是否正确有效。

链接

• GitHub: https://github.com/leandrosilvaferreira/gitai-skill
• 问题反馈（Issues）: https://github.com/leandrosilvaferreira/gitai-skill/issues

作者

• Leandro Zuck
• GitHub: https://github.com/leandrosilvaferreira
• 邮箱: leandrosilvaferreira@gmail.com

许可证

MIT