中文文档

📝 This document is automatically generated and maintained by the GitHub Manager skill (AI-assisted). Do not edit manually — changes will be overwritten on the next update.

GitHub Manager

A Claude Code skill that automates publishing and maintaining your projects on GitHub — from first commit to ongoing updates.

Overview

GitHub Manager handles everything involved in putting your project on GitHub: smart .gitignore generation, bilingual README creation (English + Chinese), code commenting, semantic commits, and intelligent README updates as your project evolves.

It detects your situation automatically and follows the right workflow — whether you're publishing for the first time, pushing a major refactor, or just committing today's changes.

Features

• Smart scenario detection — automatically identifies whether this is a new project, a major update, or a routine commit
• Bilingual README generation — creates README.md (English) and README_ZH.md (Chinese) with language toggle badges
• Smart .gitignore — detects your language/framework and filters out build artifacts, secrets, and OS files
• Semantic commit messages — generates Conventional Commits format messages (feat, fix, refactor, feat! for breaking changes)
• Smart README merge — on updates, reads existing README and merges intelligently instead of overwriting
• BREAKING CHANGE detection — identifies API changes and flags them in commit messages and documentation
• Safety-first — always shows proposed actions before executing, confirms before pushing, never force-pushes

Installation

This is a Claude Code skill. Install it by placing the github-manager/ folder in your Claude skills directory:

~/.claude/skills/github-manager/

Once installed, the skill activates automatically when you ask Claude to publish or manage a GitHub project.

Usage

Just describe what you want in natural language. Examples:

"我有个 Python 爬虫项目，想发到 GitHub 上，帮我搞一下"
"帮我 push 今天改的代码，顺便写个 commit message"
"我的项目重构完了，帮我更新一下 README 和提交"
"publish my project to GitHub"
"push today's changes with a good commit message"

Claude will detect your scenario and guide you through the process step by step.

Scenarios

Scenario	Trigger	What happens
New project	No git repo, no remote	Full setup: .gitignore, repo creation, bilingual README, code comments, initial commit
Major update	Existing repo, significant changes	Analyzes diff, smart-merges README, generates semantic commit with BREAKING CHANGE if needed
Routine commit	Existing repo, small changes	Shows diff, generates commit message, skips README if unchanged

Project Structure

github-manager/
├── SKILL.md          # Skill instructions for Claude
├── README.md         # This file (English)
├── README_ZH.md      # Chinese version
└── evals/
    └── evals.json    # Test cases

Requirements

• Claude Code CLI
• GitHub CLI (gh) — installed and authenticated via gh auth login
• Git

License

MIT License