34 lines
1.3 KiB
Markdown
34 lines
1.3 KiB
Markdown
---
|
||
title: "Agent Scopes"
|
||
type: concept
|
||
tags: []
|
||
last_updated: 2026-04-29
|
||
---
|
||
|
||
## Overview
|
||
Agent Scopes（Agent 作用域）指 AI 编码 Agent 的生效范围，决定了 Agent 配置是全局共享还是项目专用。这是 The Agency 集成架构中的重要维度。
|
||
|
||
## Home-Scoped Agent（全用户级 Agent）
|
||
- 安装位置：用户家目录（如 `~/.claude/agents/`、`~/.gemini/`）
|
||
- 生效范围：该用户所有项目均可用
|
||
- 安装方式：`./scripts/install.sh --tool <tool>`
|
||
- 代表工具：Claude Code、GitHub Copilot、Antigravity、Gemini CLI、OpenClaw、Kimi Code
|
||
|
||
## Project-Scoped Agent（项目级 Agent）
|
||
- 安装位置：项目根目录（如 `./.opencode/agents/`、`./.windsurfrules`）
|
||
- 生效范围：仅当前项目可用
|
||
- 安装方式：从项目根目录运行 `./scripts/install.sh --tool <tool>`
|
||
- 代表工具：OpenCode、Cursor、Aider、Windsurf、Qwen Code
|
||
|
||
## Key Differences
|
||
| 维度 | Home-Scoped | Project-Scoped |
|
||
|------|-------------|----------------|
|
||
| 安装路径 | `~/.tool/` | `./.tool/` |
|
||
| 多项目复用 | ✅ | ❌ |
|
||
| 项目定制化 | ❌ | ✅ |
|
||
| 权限控制 | 用户级 | 仓库级（可提交 git） |
|
||
| 冲突风险 | 高（同名覆盖） | 低（项目隔离） |
|
||
|
||
## Sources
|
||
- [[OpenCode Integration]]（`Agent/agency-agents/integrations/README.md`）
|