# 假设主项目路径为: ~/dev/my-project

# 1. 添加 Worktree 并创建新分支 (推荐)
# 语法: git worktree add -b <新分支名> <新路径> <基准分支>
$ git worktree add -b feat/user-auth ../my-project-auth main

# 2. 添加 Worktree 并检出已有分支
$ git worktree add ../my-project-hotfix release/v1.0

# 3. 查看当前所有 Worktree
$ git worktree list
# 输出:
# /Users/dev/my-project        (main)
# /Users/dev/my-project-auth   (feat/user-auth)

# 1. 移除 Worktree
$ git worktree remove ../my-project-auth

# 2. 强制清理（当目录被手动删除后，清理无效的引用）
$ git worktree prune

~/Development/
├── my-app-main/          <-- [主控] 人类开发者工作区 (Main Repo)
├── my-app-ai-feature1/   <-- [代理] Claude 任务 1 (Worktree)
└── my-app-ai-fix/        <-- [代理] Claude 任务 2 (Worktree)

cd ~/Development/my-app-main

# 为 Claude 创建一个基于 main 分支的独立环境
# 命名规范建议：使用 ai/ 前缀以便于区分分支用途
git worktree add -b ai/refactor-core ../my-app-ai-refactor main

cd ../my-app-ai-refactor

# 1. 复制环境配置 (如果 .env 被 gitignore)
cp ../my-app-main/.env .

# 2. 安装依赖 (因为 node_modules 是物理隔离的)
# 这确保了 AI 的修改不会破坏主目录的依赖树
npm install

# 在 my-app-ai-refactor 目录中
claude

cd ../my-app-main
# 拉取 AI 的分支进行合并
git merge ai/refactor-core

# 或者推送到远端发起 Pull Request 进行审查
git push origin ai/refactor-core

# 快速创建名为 ai-worker 的 worktree
function git-ai() {
    local branch_name="ai/$1"
    local dir_name="../$(basename $(pwd))-ai-$1"
    git worktree add -b "$branch_name" "$dir_name"
    echo "AI Worktree created at: $dir_name"
    echo "Tip: Don't forget to cp .env and npm install!"
}

---
allowed-tools: [Bash(git:*), Read(*), Grep(*), LS(*)]
description: Add and commit with conventional style
version: "1.0.0"
.claude/commands/git-add-commit.md
---

# Intelligent Git Commit Command

You are creating a git commit with the following features:

- **Default language**: Chinese (中文) for commit messages
- **Conventional Commit style**: Use conventional commit format (type(scope): description)
- **User context integration**: Accept and incorporate user-provided additional context

## Configuration Settings

    default_language: "zh-CN"
    commit_style: "conventional"
    types:
      - feat: 新功能
      - fix: 修复bug
      - docs: 文档更新
      - style: 代码格式调整
      - refactor: 重构
      - perf: 性能优化
      - test: 测试相关
      - build: 构建系统
      - ci: CI/CD配置
      - chore: 其他更改
      - revert: 回滚提交

## Workflow

1. **Analyze current changes**:
   - Run `git status` to check for uncommitted changes
   - Run `git diff --cached` to see staged changes
   - Run `git diff` to see unstaged changes
   - Identify the main type of changes and affected scope

2. **Parse user input**:
   - Check if user provided additional context or specific requirements
   - Extract any specific commit type or scope preferences
   - Consider any attention points mentioned by the user

3. **Generate commit message**:
   - Use conventional commit format: `(): `
   - Write description in Chinese by default
   - Incorporate user's additional context if provided
   - Keep the subject line under 50 characters
   - Add detailed body if needed (wrapped at 72 characters)
   - add Contributors by use: "Co-Authored-By: Claude <noreply@anthropic.com>", there should be a blank line between contributors commit message.

4. **Stage and commit**:
   - Ask user to confirm which files to stage (if not already staged)
   - Show the commit result to the user and ask user to confirm
   - Create the commit with the generated message

## Example Usage

When the user runs `/git-add-commit`, you should:

1. First check the git status and changes
2. Analyze what type of changes were made
3. Generate an appropriate conventional commit message in Chinese
4. If the user provided additional context like "注意性能优化部分", incorporate it
5. Create the commit

## Important Notes

- Always analyze the TARGET directory where the command is run
- Do NOT assume anything about the current directory structure
- Support both staged and unstaged changes
- Allow user to override language or commit style if specified
- Ensure commit messages are meaningful and descriptive

## User Input Parameters

The user can provide additional context in several ways:

- Direct description: Additional text after `/git-add-commit`
- Type override: Specify a different commit type
- Language override: Request English or other language
- Scope specification: Define a specific scope for the commit

Generate appropriate conventional commit messages based on the actual changes in the target repository.

// .claude/settings.local.json
{
    "permissions":{
        "allow":[
            "Bash(find:*)",
            "Bash(git add:*)",
            "Bash(git commit:*)",
            "Bash(mkdir:*)",
        ],
        "deny":[]
    }
}