env-setup

AGI 环境一键同步工具

从 GitHub 仓库一键同步所有配置到本地 AI 开发环境，支持多平台。

支持的平台

功能概述

同步内容

快速开始

一、克隆仓库

# 克隆到任意位置
git clone https://github.com/aAAaqwq/cc-skills.git ~/​cc-skills

二、运行同步

# 同步到所有平台
python ~/​cc-skills/​env-setup/​scripts/​sync_env.py --target all

# 只同步到 Claude Code
python ~/​cc-skills/​env-setup/​scripts/​sync_env.py --target claude

# 只同步到 OpenClaw
python ~/​cc-skills/​env-setup/​scripts/​sync_env.py --target openclaw

# 只同步到 Codex
python ~/​cc-skills/​env-setup/​scripts/​sync_env.py --target codex

三、命令行选项

# 基本用法
python scripts/​sync_env.py

# 指定目标平台
python scripts/​sync_env.py --target claude|openclaw|codex|pi|all

# 强制覆盖
python scripts/​sync_env.py --force

# 只同步特定组件
python scripts/​sync_env.py --components skills mcp_config prompts

# 显示详细信息
python scripts/​sync_env.py --verbose

同步选项：

• skills - 同步技能库
• output_styles - 同步对话风格
• prompts - 同步全局提示词
• mcp_config - 同步 MCP 配置

仓库结构

cc-skills/                    (GitHub 仓库)
├── README.md                 # 仓库说明
├── env-setup/                # 环境同步 skill
│   ├── SKILL.md
│   └── scripts/
│       └── sync_env.py       # 主同步脚本
├── config/                   # 配置模板
│   ├── output-styles/        # 对话风格
│   ├── CLAUDE.md             # Claude Code 全局提示词
│   ├── AGENTS.md             # OpenClaw/​Codex 全局提示词
│   └── mcp_config.json       # MCP 服务器配置
├── pass-secrets/             # 密钥管理 skill
├── model-fallback/           # 模型降级 skill
├── openclaw-config/          # OpenClaw 配置 skill
└── ... (其他 skills)

配置文件格式

mcp_config.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/​server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/​context7-mcp", "--api-key", "${CONTEXT7_API_KEY}"]
    }
  },
  "allowedTools": [
    "mcp__github__*",
    "mcp__context7__*"
  ]
}

注意：

• 使用 ${VAR_NAME} 引用环境变量
• 敏感信息建议使用 Pass 管理：pass api/​github

AGENTS.md (OpenClaw/​Codex 全局提示词)

# AGENTS.md - Your Workspace

## First Run
...

## Memory
...

## Safety
...

CLAUDE.md (Claude Code 全局提示词)

# CLAUDE.md

## 身份
...

## 工作风格
...

平台特定配置

Claude Code

# 配置位置
~/​.claude.json              # MCP 配置
~/​.claude/​CLAUDE.md         # 全局提示词
~/​.claude/​output-styles/    # 对话风格
~/​.claude/​skills/           # Skills 目录

OpenClaw

# 配置位置
~/​.openclaw/​openclaw.json                    # 主配置
~/​.openclaw/​agents/​main/​agent/​models.json    # 模型配置
~/​clawd/​AGENTS.md                            # 全局提示词
~/​clawd/​SOUL.md                              # 身份配置
~/​clawd/​skills/                              # Skills 目录

Codex CLI

# 配置位置
~/​.codex/​config.json        # 主配置
~/​.codex/​AGENTS.md          # 全局提示词
~/​.codex/​skills/            # Skills 目录

MCP 配置同步

MCP 配置会同步到所有支持的平台：

同步行为

• 合并模式（默认）：保留现有配置，添加/更新新配置
• 替换模式：完全替换 MCP 配置

# 合并模式
python scripts/​sync_env.py --components mcp_config

# 替换模式
python scripts/​sync_env.py --components mcp_config --replace

使用场景

场景 1：新设备快速配置

# 1. 克隆仓库
git clone https://github.com/aAAaqwq/cc-skills.git ~/​cc-skills

# 2. 同步到所有平台
python ~/​cc-skills/​env-setup/​scripts/​sync_env.py --target all --force

# 3. 导入 GPG 密钥（用于 Pass）
gpg --import gpg-private-key.asc

# 4. 克隆密钥库
git clone https://github.com/aAAaqwq/password-store.git ~/​.password-store

场景 2：多平台开发

# 在 Claude Code 中开发
# 配置自动同步到 ~/​.claude/

# 切换到 OpenClaw
python scripts/​sync_env.py --target openclaw

# 切换到 Codex
python scripts/​sync_env.py --target codex

场景 3：团队共享配置

# 团队成员克隆仓库
git clone https://github.com/team/shared-skills.git ~/​shared-skills

# 同步配置
python ~/​shared-skills/​env-setup/​scripts/​sync_env.py --target all

场景 4：配置版本管理

# 更新配置后提交
git add .
git commit -m "Update MCP config"
git push

# 其他设备同步
git pull
python scripts/​sync_env.py --target all

密钥管理集成

使用 pass-secrets skill 管理敏感信息：

# 存储 API 密钥
pass insert api/​github
pass insert api/​openai

# 在 MCP 配置中引用
{
  "env": {
    "GITHUB_TOKEN": "$(pass api/​github)"
  }
}

# 或使用启动脚本
export GITHUB_TOKEN=$(pass api/​github)

故障排查

同步失败

问题： "Permission denied"

• 解决： 检查目标目录权限

问题： "Config file not found"

• 解决： 确认平台已安装并运行过一次

问题： MCP 配置没有生效

• 解决： 重启对应的 IDE/​Agent

平台检测

# 检测已安装的平台
python scripts/​sync_env.py --detect

# 输出示例：
# Claude Code: ✅ ~/​.claude/
# OpenClaw: ✅ ~/​.openclaw/
# Codex CLI: ❌ not found
# Pi Agent: ❌ not found

高级用法

自定义目标目录

python scripts/​sync_env.py \
  --claude-dir "/​custom/​path/​.claude" \
  --openclaw-dir "/​custom/​path/​.openclaw"

排除特定 Skills

python scripts/​sync_env.py --exclude backend-tester moltbook-integration

只同步特定 Skills

python scripts/​sync_env.py --include pass-secrets model-fallback openclaw-config

自动化同步

创建 cron 任务：

# 每天同步一次
0 9 * * * cd ~/​cc-skills && git pull && python env-setup/​scripts/​sync_env.py --target all

相关 Skills

• pass-secrets - 密钥管理
• openclaw-config - OpenClaw 配置
• model-fallback - 模型降级
• mcp-installer - MCP 安装

---

由小a维护 - AGI 通用技能库