# 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-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent-Manager

一个智能体的管理器，方便团队快速获取技能，并完成相关配置。目前以 Claude Code 为主。

## 概述

本项目作为 Claude Code 相关工具和配置的集中管理中心，通过软连接方式让 `~/.claude` 目录能够加载这些工具。

## 安装

```bash
# 1. 克隆项目（含子模块）
git clone --recursive https://gitee.com/workingbird/agent-manager.git

# 如果已克隆但子模块为空
cd agent-manager
git submodule update --init --recursive

# 网络不通时使用代理
proxychains git submodule update --init --recursive

# 2. 创建全局软链接（将所有技能安装到 ~/.claude/skills/）
# 参见下方「工具安装」章节
```

## 文件组织

### 目录结构

```
Agent-Manager/
├── README.md               # 项目简介
├── CLAUDE.md               # 详细规范和指南（给 Claude Code）
├── .gitignore              # 忽略敏感目录
├── .gitmodules             # 子模块配置
├── me/                     # 本地自定义技能（项目自有，可直接编辑）
│   ├── doc-driven-workflow/
│   │   ├── SKILL.md
│   │   └── prompts/        # 提示词文件
│   ├── pyramid-writing/
│   └── ...
├── vendors/                # 第三方库（Git Submodule，指向上游仓库）
│   ├── anthropics/skills/  # → github.com/anthropics/skills
│   ├── obra/superpowers/   # → github.com/obra/superpowers
│   ├── mattpocock/skills/  # → github.com/mattpocock/skills
│   └── ...
└── .claude/skills/         # 项目级技能软链接（指向 me/ 或 vendors/）
```

### 子模块管理（只读 + 本地覆盖）

**原则**：`vendors/` 下的子模块保持只读，所有自定义内容存放在 `me/` 目录。

```
vendors/obra/superpowers/     ← 上游原始内容（只读）
  ↓ 不修改
me/xxx/SKILL.md               ← 自定义版本（可自由编辑）
  ↑
.claude/skills/xxx -> me/xxx/ ← 软链接指向自定义版本
~/.claude/skills/xxx -> ...   ← 全局软链接也指向自定义版本
```

**更新上游代码**：由于子模块保持只读，可以放心 pull：

```bash
# 更新某个子模块到最新
cd vendors/obra/superpowers
git pull origin main
cd ../../..
git add vendors/obra/superpowers
git commit -m "chore: update superpowers to latest"

# 批量更新所有子模块
git submodule update --remote
git add vendors/
git commit -m "chore: update all submodules"
```

**自定义第三方技能**：需要修改上游技能时，复制到 `me/` 目录再编辑：

```bash
# 1. 复制上游文件到 me/ 目录
cp -r vendors/obra/superpowers/skills/brainstorming me/brainstorming

# 2. 编辑自定义版本
vim me/brainstorming/SKILL.md

# 3. 创建项目级软链接（指向 me/）
cd .claude/skills
ln -s ../../me/brainstorming brainstorming

# 4. 创建全局软链接
ln -s /home/zhuzhen/works/agent-manager/me/brainstorming ~/.claude/skills/brainstorming
```

## 工具安装

### 创建全局软链接

本项目下所有技能都需要安装到 `~/.claude/skills/`：

```bash
# 安装单个技能
ln -s /home/zhuzhen/works/agent-manager/me/xxx ~/.claude/skills/xxx

# 批量安装所有项目级技能（遍历 .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 "安装: $name"
done
```

### 验证安装

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

## 工具类型

| 类型 | 安装方式 | 说明 |
|------|---------|------|
| Claude Code 原生 | 纯配置/脚本，软连接 | Skills, Commands, Hooks |
| npm 依赖 | `npm install` 后软连接 | 需要 node_modules 的工具 |
| Python 依赖 | `pip install` 后软连接 | 需要 site-packages 的工具 |
| npx 运行 | 无需安装，直接 npx 调用 | 如 `npx playwright` |
| 外部工具依赖 | 系统级安装 | 如 git, docker, browser |

## 代理访问

对无法直接访问的地址，可以使用 proxychains：

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

### 安装 proxychains

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

# macOS
brew install proxychains-ng
```

### 配置 proxychains

编辑配置文件 `/etc/proxychains4.conf`（macOS 为 `/usr/local/etc/proxychains.conf`）：

```ini
# 末尾添加代理服务器地址（根据实际代理修改）
# 格式: 类型 地址 端口
socks5 127.0.0.1 1080
# http 127.0.0.1 7890
```

验证配置：

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

## 文档说明

| 文件 | 说明 |
|------|------|
| `README.md` | 项目简介和使用指南 |
| `CLAUDE.md` | 详细规范和指南（给 Claude Code 的项目上下文） |