功能描述

Boost developer productivity with Gitai: An AI-powered Git automation tool that analyzes code changes and generates semantic Conventional Commits instantly. Supports Node.js, Python, Java, Go, PHP, and more. Compatible with OpenAI, Anthropic, and Groq.

使用说明 (SKILL.md)

Gitai Automation - AI-Powered Git Workflow

Name: Gitai - Git Commit Automation
Author: leandrosilvaferreira

Transform your development workflow with intelligent, automated commit management.

Gitai analyzes your code changes to generate precise, descriptive commit messages following the Conventional Commits standard. It eliminates the friction of writing commit messages, ensuring a clean, semantic, and professional git history automatically.

Key capabilities:

Universal Language Support: Analyzes Node.js, Python, Java, Go, PHP, and more.
Multi-LLM Support: Choose your preferred AI brain—OpenAI (GPT), Anthropic (Claude), or Groq.
Workflow Automation: Stages, commits, and pushes changes in a single command.
Standardized History: Enforces consistency across your project's version history.

📦 Prerequisites (MANDATORY)

This skill requires the @notyped/gitai CLI tool to be installed and configured on the system BEFORE the agent can operate.

The AGENT MUST NOT attempt to install this package or configure it.

CHECK if gitai is available:
```
command -v gitai
```
IF MISSING, STOP immediately and inform the user:

"The gitai CLI tool is not installed. Please install it globally (e.g., npm install -g @notyped/gitai) and configure it before using this skill."
CHECK if ~/.gitai exists.
IF MISSING, STOP immediately and inform the user:

"The gitai tool is installed but not configured. Please run gitai in your terminal to complete the setup."
ONLY PROCEED if both checks pass.

🚀 Usage & Workflows

Command Structure

Based on gitai --help:

gitai [options] [projectPath] [baseMessage]

Arguments:

projectPath: The path to the project (default: ".").
baseMessage: The base commit message (Optional).

Options:

-p, --push: Whether to push after committing (default: false).
-V, --version: Output the version number.
-h, --help: Display help for command.

Standard Workflows

Command	Action Description
`gitai . ''`	Analyzes current folder, Generates message and commits
`gitai . '' --push`	Analyzes current folder, Generates message, commits, AND pushes to remote
`gitai ./frontend 'ui update'`	Analyzes only the `./frontend` directory, Generates message and commits

Verification

Check which version of Gitai is currently active:

gitai --version

⚠️ Troubleshooting

Interactive Wizard Hangs: If gitai hangs waiting for input, it means ~/.gitai is missing or invalid. create the file manually as described in Step 2.
Node Version Error: Ensure Node.js 18+ is active (node -v).
API Errors: Check the API_KEY in ~/.gitai.

Links

GitHub: https://github.com/leandrosilvaferreira/gitai-skill
Issues: https://github.com/leandrosilvaferreira/gitai-skill/issues

Author

Leandro Zuck
GitHub: https://github.com/leandrosilvaferreira
Email: [email protected]

License

MIT

安全使用建议

This skill is a thin instruction layer that expects you to have the third-party `gitai` CLI installed and configured. Before installing/using the skill: 1) Verify and inspect the external CLI (@notyped/gitai) from its upstream repository (the SKILL.md and README reference a GitHub URL) to ensure you trust it; 2) Check the ~/.gitai file for any API keys or provider configuration and make sure those credentials are intended for use; 3) Be cautious with workflows that include automatic --push (the agent can run commands that push to remotes); if you prefer, run the CLI manually or restrict the agent from pushing until you confirm behavior; 4) Because the skill is instruction-only, its safety depends on the external CLI — treat that dependency as the primary risk. If you want higher assurance, test the CLI locally in a disposable repo and review the GitHub source before enabling autonomous agent runs.

功能分析

Type: OpenClaw Skill Name: gitai-skill Version: 1.0.2 The skill is designed to integrate with an external `gitai` CLI tool, but the `SKILL.md` explicitly instructs the AI agent NOT to install or configure this tool. The agent is only permitted to check for the presence of the `gitai` command and the existence of its configuration file (`~/.gitai`). While the skill uses broad permissions ('Run Command', 'Read File', 'Write File'), the instructions for the agent are highly constrained and defensive, preventing it from performing high-risk actions like installing software, reading sensitive configuration file content, or exfiltrating data. The `README.md` mentions installation scripts (`scripts/install.sh`, `scripts/install.ps1`), but these are not part of the analyzed skill bundle and the agent is explicitly forbidden from running them.

能力评估

✓ Purpose & Capability

The skill's name/description match the runtime instructions: it delegates work to a local `gitai` CLI for analyzing diffs and creating Conventional Commits. Requiring the CLI and its config file (~/.gitai) is coherent with the stated purpose.

ℹ Instruction Scope

SKILL.md instructs the agent to check for `gitai` on PATH and for the presence of ~/.gitai, and to stop if either is missing. It does not instruct the agent to install or modify unrelated system files. However the skill permits running commands that can stage/commit/push git changes — which will interact with repositories and remotes — so users should be aware the agent may perform networked git operations (e.g., push) if invoked.

✓ Install Mechanism

There is no install spec and no code files; the skill is instruction-only and requires the third-party `@notyped/gitai` CLI to be installed by the user. This minimizes supply-chain risk from the skill itself, but shifts trust to the external CLI package.

ℹ Credentials

The skill declares no required environment variables or credentials. It does rely on a user-controlled config file (~/.gitai) that the CLI uses for PROVIDER/API_KEY settings; the agent checks only for its existence but could be granted file-read capability. Ensure any API keys in that file are intended to be used by the local CLI.

✓ Persistence & Privilege

The skill is not always-enabled and allows normal autonomous invocation (platform default). It does not request persistent privileges or modify other skills/configs. Users should remember autonomous execution can run git/push commands if allowed by the agent.

版本历史

v1.0.2

- Removed installation and update scripts (`scripts/install.sh`, `scripts/update.sh`) from the project. - Updated documentation to require manual installation and configuration of the `@notyped/gitai` CLI tool before use. - Clarified that the agent must not attempt installation or configuration of dependencies. - Updated setup instructions to enforce prerequisite checks for both the CLI tool and its configuration file. - Removed all references to automated install/update commands from the usage guide.

v1.0.1

- Updated configuration instructions: users are now advised to launch the native setup wizard by running `gitai` in their terminal, rather than manually creating the `~/.gitai` file. - Removed previous manual API key and configuration steps to improve security and streamline setup. - No functional or code changes—documentation update only.

v1.0.0

- Initial release of gitai-automation. - AI-powered tool for generating Conventional Commit messages in Git. - Supports multiple programming languages including Node.js, Python, Java, Go, and PHP. - Compatible with OpenAI, Anthropic, and Groq models. - Automates staging, committing, and pushing with a single command. - Enforces standardized, semantic git commit history for improved collaboration.

元数据

Slug gitai-skill

版本 1.0.2

许可证 —

累计安装 8

当前安装数 8

历史版本数 3

常见问题

Gitai - Git Commit Automation 是什么？

Boost developer productivity with Gitai: An AI-powered Git automation tool that analyzes code changes and generates semantic Conventional Commits instantly. Supports Node.js, Python, Java, Go, PHP, and more. Compatible with OpenAI, Anthropic, and Groq. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 3125 次。

如何安装 Gitai - Git Commit Automation？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install gitai-skill」即可一键安装，无需额外配置。

Gitai - Git Commit Automation 是免费的吗？

是的，Gitai - Git Commit Automation 完全免费（开源免费），可自由下载、安装和使用。

Gitai - Git Commit Automation 支持哪些平台？

Gitai - Git Commit Automation 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Gitai - Git Commit Automation？

由 leandrosilvaferreira（@leandrosilvaferreira）开发并维护，当前版本 v1.0.2。

Gitai - Git Commit Automation