5.2a Agent 快速入门

用户 ←→ Primary Agent (build/plan)
              ↓
         Task Tool (创建独立 Session)
              ↓
         Subagent (explore/general/你的自定义 Agent)
              ↓
         返回结果给 Primary

agent.temperature（用户设置） > 模型默认值 > undefined

┌─────────────────────────────────────────────────────────────┐
│  1. Agent prompt  或  Provider 默认提示词（二选一）          │
│     ├─ 有 prompt → 使用你定义的                              │
│     └─ 无 prompt → 使用模型默认（如 anthropic.txt）          │
├─────────────────────────────────────────────────────────────┤
│  2. 环境信息 + 指令文件（始终添加）                          │
│     工作目录、git 状态、平台、日期                           │
│     AGENTS.md、CLAUDE.md 等全局规则文件                      │
└─────────────────────────────────────────────────────────────┘

You are OpenCode, the best coding agent on the planet.

You are an interactive CLI tool that helps users with software engineering tasks.
Use the instructions below and the tools available to you to assist the user.

# Tone and style
- Only use emojis if the user explicitly requests it
- Your responses should be short and concise
- Output text to communicate with the user

# Task Management
You have access to the TodoWrite tools to help you manage and plan tasks.
Use these tools VERY frequently...

You are opencode, an agent - please keep going until the user's query
is completely resolved, before ending your turn and yielding back to the user.

You MUST iterate and keep going until the problem is solved.

THE PROBLEM CAN NOT BE SOLVED WITHOUT EXTENSIVE INTERNET RESEARCH.
You must use the webfetch tool to recursively gather all information...

你是代码审查专家，专注于安全和性能...    ← 你的 prompt（替代默认）
You are powered by the model named...     ← 环境信息
Working directory: /path/to/project       ← 环境信息
...                                       ← AGENTS.md 内容（如有）

You are OpenCode, the best coding agent... ← Provider 默认
You are powered by the model named...       ← 环境信息
Working directory: /path/to/project         ← 环境信息
...                                         ← AGENTS.md 内容（如有）

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "code-reviewer": {
      "description": "代码审查专家，专注安全、性能、可维护性。适用于 PR 审查、代码健康检查。",
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4-20250514",
      "temperature": 0.2,
      "steps": 30,
      "color": "#4CAF50",
      "prompt": "你是代码审查专家。\n\n## 检查要点\n- 安全漏洞（SQL注入、XSS、硬编码密钥）\n- 性能问题（时间复杂度、资源泄漏）\n- 代码风格（命名、结构、可读性）\n- 可维护性（耦合度、测试覆盖）\n\n## 输出格式\n- 🔴 严重问题（必须修复，说明风险和修复方案）\n- 🟡 建议改进（推荐修复，说明原因）\n- 🟢 优点（值得保持）\n\n## 约束条件\n- ✅ 问题要具体到行号\n- ✅ 每个问题都要有修复建议\n- ❌ 避免只批评不给方案"
    }
  }
}

{
  "agent": {
    "code-reviewer": {
      "description": "代码审查专家",
      "mode": "subagent",
      "prompt": "{file:./prompts/code-reviewer.txt}"
    }
  }
}

@docs-writer 帮我写一个 README

{
  "agent": {
    "explore": {
      "disable": true
    },
    "general": {
      "disable": true
    }
  }
}

{
  "default_agent": "plan"  // 默认使用 plan agent
}