功能描述

Extend Git with utilities for changelogs, branch cleanup, and repo stats. Use when generating changelogs, squashing branches, or viewing repo statistics.

使用说明 (SKILL.md)

GitBuddy

Name: Gitbuddy
Author: bytesagain3

GitBuddy v2.0.0 — a developer toolkit for managing code quality workflows from the command line. Log checks, validations, lint results, diffs, fixes, and more. Each entry is timestamped and persisted locally. Works entirely offline — your data never leaves your machine.

Why GitBuddy?

Works entirely offline — your data never leaves your machine
Simple command-line interface with no GUI dependency
Export to JSON, CSV, or plain text at any time for sharing or archival
Automatic activity history logging across all commands
Each domain command doubles as both a logger and a viewer

Commands

Domain Commands

Each domain command works in two modes: log mode (with arguments) saves a timestamped entry, view mode (no arguments) shows the 20 most recent entries.

Command	Description
`gitbuddy check \x3Cinput>`	Log a check operation such as code quality checks, dependency audits, or pre-commit verification results. Track what was checked and the outcome.
`gitbuddy validate \x3Cinput>`	Log a validation entry for schema validations, test suite passes, or configuration checks. Record pass/fail status and details of what was validated.
`gitbuddy generate \x3Cinput>`	Log a generation task such as changelog generation, boilerplate scaffolding, or code generation results. Track what was generated and from what source.
`gitbuddy format \x3Cinput>`	Log a formatting operation including code formatter runs, style enforcement results, and auto-fix summaries. Record files affected and changes made.
`gitbuddy lint \x3Cinput>`	Log a lint result with error counts, warning details, and rule violations found. Useful for tracking code quality trends across commits and branches.
`gitbuddy explain \x3Cinput>`	Log an explanation entry for code review notes, architecture decisions, or complex logic documentation. Build a searchable knowledge base of explanations.
`gitbuddy convert \x3Cinput>`	Log a conversion task such as format migrations, encoding changes, or data transformations. Record source format, target format, and conversion outcomes.
`gitbuddy template \x3Cinput>`	Log a template operation for project scaffolding, commit message templates, or PR description templates. Track template creation and usage patterns.
`gitbuddy diff \x3Cinput>`	Log a diff result including lines added/removed, files changed, and branch comparison summaries. Essential for tracking code change patterns over time.
`gitbuddy preview \x3Cinput>`	Log a preview entry for build previews, deployment previews, or staged change reviews. Record what was previewed and the assessment.
`gitbuddy fix \x3Cinput>`	Log a fix operation for bug fixes, lint auto-fixes, or configuration corrections. Track what was broken, what was changed, and whether the fix resolved the issue.
`gitbuddy report \x3Cinput>`	Log a report entry for code quality summaries, sprint retrospectives, or weekly development reports. Capture key metrics and findings.

Utility Commands

Command	Description
`gitbuddy stats`	Show summary statistics across all log files, including entry counts per category and total data size on disk.
`gitbuddy export \x3Cfmt>`	Export all data to a file in the specified format. Supported formats: `json`, `csv`, `txt`. Output is saved to the data directory.
`gitbuddy search \x3Cterm>`	Search all log entries for a term using case-insensitive matching. Results are grouped by log category for easy scanning.
`gitbuddy recent`	Show the 20 most recent entries from the unified activity log, giving a quick overview of recent work across all commands.
`gitbuddy status`	Health check showing version, data directory path, total entry count, disk usage, and last activity timestamp.
`gitbuddy help`	Show the built-in help message listing all available commands and usage information.
`gitbuddy version`	Print the current version (v2.0.0).

Data Storage

All data is stored locally at ~/.local/share/gitbuddy/. Each domain command writes to its own log file (e.g., check.log, lint.log). A unified history.log tracks all actions across commands. Use export to back up your data at any time.

Requirements

Bash (4.0+)
No external dependencies — pure shell script
No network access required

When to Use

Tracking code quality checks and lint results across commits, branches, and releases over time
Logging validation outcomes and formatting operations for audit trails and compliance
Recording diffs and fix operations to maintain a searchable history of code changes
Generating development activity reports for sprint retrospectives or team reviews
Building a local knowledge base of code explanations, templates, and conversion records

Examples

# Log a lint result
gitbuddy lint "src/main.js — 0 errors, 3 warnings (no-unused-vars, prefer-const)"

# Log a validation
gitbuddy validate "schema v2.1 passes all 47 test cases, zero regressions"

# Record a fix
gitbuddy fix "Resolved null pointer in auth middleware — missing user check on line 142"

# Log a diff
gitbuddy diff "feature-branch vs main: +342 -128 lines across 14 files"

# Generate a report entry
gitbuddy report "Weekly code quality summary — 98.5% pass rate, down 2 warnings from last week"

# View all statistics
gitbuddy stats

# Export everything to CSV
gitbuddy export csv

# Search entries mentioning auth
gitbuddy search auth

# Check recent activity
gitbuddy recent

# Health check
gitbuddy status

Powered by BytesAgain | bytesagain.com | [email protected]

安全使用建议

This skill appears to do what it says: a small, offline shell tool that creates log files under ~/.local/share/gitbuddy and provides search/export/stats. Before installing, review the script yourself (it's plain Bash) and consider: any sensitive text you log will be written to that directory and included in exports, so avoid logging secrets; confirm you trust the unknown publisher (BytesAgain/contact info is present in files but package source is unknown); and be aware the export/search features will enumerate whatever you store locally.

功能分析

Type: OpenClaw Skill Name: gitbuddy Version: 2.0.0 The GitBuddy skill is a local activity logger for development workflows, storing entries in ~/.local/share/gitbuddy/. Analysis of scripts/script.sh and SKILL.md shows no network activity, no data exfiltration, and no suspicious execution patterns; it strictly performs file I/O for logging, searching, and exporting user-provided strings.

能力评估

✓ Purpose & Capability

Name/description (changelogs, branch cleanup, repo stats) match the included shell script and SKILL.md: the tool logs entries, provides stats, search, export, and status functionality. No extraneous credentials, binaries, or unrelated capabilities are requested.

✓ Instruction Scope

SKILL.md and the script limit actions to local file I/O (creating and writing logs under $HOME/.local/share/gitbuddy), printing status, searching logs, and exporting files. There are no instructions to read unrelated system configuration, shell history, or to transmit data externally.

✓ Install Mechanism

No install spec; this is instruction-only plus a single shell script. No remote downloads, package installs, or archive extraction are performed.

✓ Credentials

No environment variables, secrets, or external service credentials are required. The script only uses $HOME to build a local data directory, which is proportional to its stated behavior.

✓ Persistence & Privilege

Skill is not always-on and is user-invocable. It creates and modifies files only within its own data directory and does not modify other skills or system-wide settings.

版本历史

v2.0.0

Domain-specific upgrade

元数据

Slug gitbuddy

版本 2.0.0

许可证 MIT-0

累计安装 2

当前安装数 2

历史版本数 1

常见问题

Gitbuddy 是什么？

Extend Git with utilities for changelogs, branch cleanup, and repo stats. Use when generating changelogs, squashing branches, or viewing repo statistics. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 186 次。

如何安装 Gitbuddy？

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

Gitbuddy 是免费的吗？

是的，Gitbuddy 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Gitbuddy 支持哪些平台？

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

谁开发了 Gitbuddy？

由 bytesagain3（@bytesagain3）开发并维护，当前版本 v2.0.0。

Gitbuddy