⚡

Gemini工作空间桥接Skill gemini-workspace-bridge

本技能用于管理Claude和Gemini AI工具之间的共享工作空间架构，定义目录结构、文件存储策略和跨工具协作流程。关键词：工作空间管理、跨AI协作、DevOps、文件存储、AI工具整合、架构设计、双CLI工作流。

架构设计 0 次安装 0 次浏览 更新于 3/11/2026

名称: gemini-workspace-bridge 描述: Claude-Gemini共享工作空间架构的中央权威。定义目录结构、工件交换和文件命名约定。用于设置双CLI工作流程、决定存储AI工件的位置或管理跨CLI文件交换。 允许工具: 读取, 全局, 查找, Bash

Gemini工作空间桥接

文档委托

文档来源: 对于权威的工作空间模式和当前约定，查询gemini-cli-docs技能。 此技能提供集成指导；gemini-cli-docs提供官方Gemini CLI文档。

概述

此技能定义了Claude Code和Gemini CLI协作的混合工作空间架构。它建立了文件存储、工件交换和跨CLI通信的约定。

何时使用此技能

关键词: 工作空间结构、工件存储、跨cli、共享文件、gemini工件、claude工件、文件位置、存储位置

使用此技能当:

  • 为双CLI工作流程设置项目
  • 决定存储AI生成工件的位置
  • 理解混合跟踪/gitignored策略
  • 管理跨CLI文件交换

核心架构

混合方法

工作空间使用混合策略：

  • 跟踪文件: 内存文件、有价值的工件（计划、报告）
  • Gitignored临时文件: 会话状态、缓存、临时输出

目录结构

项目根目录/
├── CLAUDE.md                    # 真相来源（跟踪）
├── GEMINI.md                    # 指向CLAUDE.md + 覆盖（跟踪）
│
├── .claude/
│   ├── settings.json            # Claude Code配置
│   └── temp/                    # （gitignored）会话工件
│       └── gemini-results/      # 解析的Gemini输出
│
├── .gemini/
│   ├── settings.json            # Gemini CLI配置
│   └── temp/                    # （gitignored）Gemini会话状态
│
└── docs/                        # （跟踪）持久AI工件
    └── ai-artifacts/            # 版本控制报告
        ├── explorations/        # 代码库探索报告
        └── plans/               # 实施计划

工件位置指南

决策树

此工件是否有长期价值？
├── 是：其他人是否应在git历史中看到它？
│   ├── 是 → docs/ai-artifacts/
│   └── 否  → .claude/temp/ 或 .gemini/temp/
└── 否：是否与会话相关？
    ├── 是 → .claude/temp/ 或 .gemini/temp/
    └── 否  → 考虑不存储它

位置矩阵

工件类型 位置 跟踪？ 理由
内存/上下文 CLAUDE.md, GEMINI.md 是 核心项目知识
实施计划 docs/ai-artifacts/plans/ 是 希望看到演变
探索报告 docs/ai-artifacts/explorations/ 是 参考材料
会话结果 .claude/temp/gemini-results/ 否 临时
第二意见 .claude/temp/gemini-results/ 否 临时
检查点 ~/.gemini/history/<hash>/ 否 系统管理
同步状态 .claude/temp/sync-state.json 否 内部跟踪

Gitignore推荐

添加到项目.gitignore：

# AI会话工件（临时）
.claude/temp/
.gemini/temp/

# 系统管理
.gemini/history/

# 保持这些跟踪：
# CLAUDE.md
# GEMINI.md
# docs/ai-artifacts/

文件命名约定

时间戳工件

格式：{类型}-{范围}-{时间戳}.md

# 探索报告
exploration-architecture-2025-11-30T12-00-00Z.md
exploration-dependencies-2025-11-30T14-30-00Z.md

# 实施计划
plan-add-auth-2025-11-30T12-00-00Z.md
plan-refactor-db-2025-11-30T14-30-00Z.md

会话结果

格式：{操作}-{时间戳}.{json|md}

# 原始Gemini结果
query-2025-11-30T12-00-00Z.json
analysis-2025-11-30T12-00-00Z.json

# 处理结果
analysis-summary-2025-11-30T12-00-00Z.md

工作空间初始化

初始化双CLI

# 创建目录结构
mkdir -p .claude/temp/gemini-results
mkdir -p .gemini/temp
mkdir -p docs/ai-artifacts/explorations
mkdir -p docs/ai-artifacts/plans

# 如果GEMINI.md不存在则创建
if [ ! -f "GEMINI.md" ]; then
  cat > GEMINI.md << 'EOF'
# GEMINI.md

@CLAUDE.md

## Gemini特定覆盖

您是Gemini CLI。您有权访问：
- 大上下文窗口（超出典型LLM限制）
- 交互式PTY shell（vim, git rebase -i）
- 带即时回滚的检查点
- 工具控制策略引擎

处理此代码库时，优先考虑受益于您大上下文的批量分析和探索任务。
EOF
fi

# 更新.gitignore
grep -q ".claude/temp/" .gitignore 2>/dev/null || echo ".claude/temp/" >> .gitignore
grep -q ".gemini/temp/" .gitignore 2>/dev/null || echo ".gemini/temp/" >> .gitignore

工件交换模式

模式1: Claude → Gemini（上下文交接）

# Claude准备上下文
cat CLAUDE.md relevant-files/* > .claude/temp/context-bundle.txt

# Gemini消费
cat .claude/temp/context-bundle.txt | gemini "分析此上下文"

模式2: Gemini → Claude（结果消费）

# Gemini生成结果
gemini "探索架构" --output-format json > .claude/temp/gemini-results/exploration.json

# Claude解析结果
cat .claude/temp/gemini-results/exploration.json | jq -r '.response'

模式3: 持久工件

# 对于应跟踪的有价值工件
result=$(gemini "创建实施计划" --output-format json)
echo "$result" | jq -r '.response' > docs/ai-artifacts/plans/plan-feature-$(date -u +%Y-%m-%dT%H-%M-%SZ).md

清理策略

自动清理（基于会话）

# 清理超过7天的工件
find .claude/temp/gemini-results -type f -mtime +7 -delete
find .gemini/temp -type f -mtime +7 -delete

手动清理

# 清除所有会话工件
rm -rf .claude/temp/*
rm -rf .gemini/temp/*

选择性清理

# 保留最近，删除旧的
find .claude/temp/gemini-results -name "*.json" -mtime +3 -delete

最佳实践

1. 单一真相来源

  • CLAUDE.md是权威内存文件
  • GEMINI.md从CLAUDE.md导入并添加覆盖
  • 不要重复信息

2. 工件生命周期

  • 从临时目录开始
  • 将有价值工件提升到docs/ai-artifacts/
  • 定期清理

3. 清晰命名

  • 使用描述性前缀（exploration-, plan-, analysis-）
  • 包含时间戳以排序
  • 使用ISO 8601格式（可排序）

4. Gitignore纪律

  • 临时目录应始终gitignored
  • 内存文件应始终跟踪
  • docs/ai-artifacts/应跟踪

相关技能

  • gemini-memory-sync - CLAUDE.md ↔ GEMINI.md同步
  • gemini-exploration-patterns - 探索输出标准
  • gemini-context-bridge - 传统上下文共享模式

相关命令

  • /sync-context - 同步内存文件
  • /gemini-explore - 生成探索报告
  • /gemini-plan - 生成实施计划

测试场景

场景1: 工作空间设置

查询: “如何为Claude和Gemini协作设置项目？” 预期行为:

  • 技能在"工作空间结构"或"跨cli"时激活
  • 提供目录结构和初始化脚本 成功标准: 用户收到完整工作空间设置工作流程

场景2: 工件位置

查询: “我应该在哪里存储Gemini探索结果？” 预期行为:

  • 技能在"工件存储"或"存储位置"时激活
  • 提供位置矩阵（跟踪vs gitignored） 成功标准: 用户收到关于临时vs持久存储的清晰指导

场景3: 跨CLI交换

查询: “如何将上下文从Claude传递给Gemini？” 预期行为:

  • 技能在"工件交换"或"共享文件"时激活
  • 提供上下文交接模式 成功标准: 用户收到基于文件的交换工作流程

版本历史

  • v1.1.0 (2025-12-01): 添加了MANDATORY部分、测试场景、版本历史
  • v1.0.0 (2025-11-25): 初始发布