# Agent-Manager

**Repository Path**: workingbird/agent-manager

## Basic Information

- **Project Name**: Agent-Manager
- **Description**: 一个智能体的管理器，方便团队快速获取技能，并完成相关配置。目前以Claude Code为主。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-07-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent-Manager

An agent manager that helps teams quickly acquire skills and complete configuration. Currently focused on Claude Code.

## Overview

This project serves as a centralized management hub for Claude Code tools and configurations. Tools are made available to `~/.claude` via symbolic links.

## Installation

```bash
# 1. Clone the project (with submodules)
git clone --recursive https://gitee.com/workingbird/agent-manager.git

# If already cloned but submodules are empty
cd agent-manager
git submodule update --init --recursive

# Use proxy when network is restricted
proxychains git submodule update --init --recursive

# 2. Create global symlinks (install all skills to ~/.claude/skills/)
# See the "Tool Installation" section below
```

## File Organization

### Directory Structure

```
Agent-Manager/
├── README.md               # Project overview
├── CLAUDE.md               # Detailed specifications and guidelines (for Claude Code)
├── .gitignore              # Ignore sensitive directories
├── .gitmodules             # Submodule configuration
├── me/                     # Local custom skills (owned by project, editable)
│   ├── doc-driven-workflow/
│   │   ├── SKILL.md
│   │   └── prompts/        # Prompt files
│   ├── pyramid-writing/
│   └── ...
├── vendors/                # Third-party libraries (Git Submodules, pointing to upstream)
│   ├── anthropics/skills/  # → github.com/anthropics/skills
│   ├── obra/superpowers/   # → github.com/obra/superpowers
│   ├── mattpocock/skills/  # → github.com/mattpocock/skills
│   └── ...
└── .claude/skills/         # Project-level skill symlinks (pointing to me/ or vendors/)
```

### Submodule Management (Read-Only + Local Override)

**Principle**: Submodules under `vendors/` are kept read-only. All customizations are stored in the `me/` directory.

```
vendors/obra/superpowers/     ← Upstream original content (read-only)
  ↓ Do not modify
me/xxx/SKILL.md               ← Customized version (free to edit)
  ↑
.claude/skills/xxx -> me/xxx/ ← Symlink points to customized version
~/.claude/skills/xxx -> ...   ← Global symlink also points to customized version
```

**Updating upstream code**: Since submodules are read-only, you can safely pull:

```bash
# Update a specific submodule to latest
cd vendors/obra/superpowers
git pull origin main
cd ../../..
git add vendors/obra/superpowers
git commit -m "chore: update superpowers to latest"

# Batch update all submodules
git submodule update --remote
git add vendors/
git commit -m "chore: update all submodules"
```

**Customizing third-party skills**: When you need to modify an upstream skill, copy it to the `me/` directory first:

```bash
# 1. Copy upstream files to me/ directory
cp -r vendors/obra/superpowers/skills/brainstorming me/brainstorming

# 2. Edit the customized version
vim me/brainstorming/SKILL.md

# 3. Create project-level symlink (pointing to me/)
cd .claude/skills
ln -s ../../me/brainstorming brainstorming

# 4. Create global symlink
ln -s /home/zhuzhen/works/agent-manager/me/brainstorming ~/.claude/skills/brainstorming
```

## Tool Installation

### Creating Global Symlinks

All skills in this project need to be installed to `~/.claude/skills/`:

```bash
# Install a single skill
ln -s /home/zhuzhen/works/agent-manager/me/xxx ~/.claude/skills/xxx

# Batch install all project-level skills (iterate symlinks under .claude/skills/)
PROJECT=/home/zhuzhen/works/agent-manager
for link in "$PROJECT/.claude/skills/"*; do
  name=$(basename "$link")
  target=$(readlink -f "$link")
  [ ! -e ~/.claude/skills/"$name" ] && ln -s "$target" ~/.claude/skills/"$name" && echo "Installed: $name"
done
```

### Verify Installation

```bash
ls -la ~/.claude/skills/ | grep agent-manager
```

## Tool Types

| Type | Installation | Description |
|------|-------------|-------------|
| Claude Code Native | Pure config/scripts, symlink | Skills, Commands, Hooks |
| npm Dependencies | `npm install` then symlink | Tools requiring node_modules |
| Python Dependencies | `pip install` then symlink | Tools requiring site-packages |
| npx Runtime | No install needed, call via npx | e.g. `npx playwright` |
| External Dependencies | System-level install | e.g. git, docker, browser |

## Proxy Access

For addresses that cannot be accessed directly, use proxychains:

```bash
proxychains git clone https://github.com/xxx/xxx.git
proxychains git submodule update --init vendors/obra/superpowers
```

### Installing proxychains

```bash
# Ubuntu/Debian
sudo apt install proxychains4

# macOS
brew install proxychains-ng
```

### Configuring proxychains

Edit the config file `/etc/proxychains4.conf` (`/usr/local/etc/proxychains.conf` on macOS):

```ini
# Add your proxy server at the end (adjust to your actual proxy)
# Format: type address port
socks5 127.0.0.1 1080
# http 127.0.0.1 7890
```

Verify the configuration:

```bash
proxychains4 curl -I https://www.google.com
```

## Documentation

| File | Description |
|------|-------------|
| `README.md` | Project overview and usage guide |
| `CLAUDE.md` | Detailed specifications and guidelines (context for Claude Code) |