46 posts tagged with "AI Agent"

Claude Code 的所有配置都遵循同一套三层作用域规则。

1. User：存在 ~/.claude/，仅本机生效但跨项目共享
2. Project：存在 .claude/，通过 git 同步给所有团队成员
3. Local：存在 .claude/settings.local.json，git 忽略，仅本机生效

优先级：Local > Project > User。所有层级的配置都会加载，相同 key 时高优先级覆盖。

核心原则：越私有、越具体的配置，优先级越高。

实操：团队规范走 Project，个人偏好走 User，本机调试/密钥走 Local。

多个维度（Instructions / Skills / Commands / Agents / Hooks / Rules / MCP / 配置文件）逐项拆解

• 直接读：skills 文件内容基本上能得到三家互认。
• 搬目录：commands / agents 从 .claude/ 复制到 .opencode/，内容通常能复用。
• 要重写：hooks（配置 vs JS/TS 模块）/ config（JSON vs TOML）范式不同。
• 软链共享：用 .shared/ + 软链把 skills / AGENTS.md 做成单一源；其他目录格式 / 范式不同，必须独立维护。
• Skills 互认：遵循 Agent Skills 开放标准，最低 SKILL.md 可直接迁移。

omo 是 OpenCode 最值得装的增强套件，专为复杂代码库设计。把单代理的原生 OpenCode 升级为多代理、多 MCP 的 AI 编程团队。

1. 定位：插件层，不改 OpenCode 命令体系
2. 规模：11 个 agents + 54+ hooks + 5 MCPs
3. 王牌命令：ultrawork，一个词启动全部代理
4. Team Mode（v4.0）：主代理 + 8 个并行成员，tmux 可视化
5. 热度：62k+ stars，Anthropic 曾因此封禁 OpenCode

OpenCode 是当前最值得认真看的一款开源 AI 编程 Agent。

1. 定位：100% 开源的 AI 编程终端，跟 Claude Code、Codex CLI 同台对位
2. 双主代理：内置 build（写）和 plan（只读），Tab 键切换
3. 子代理机制：复杂搜索 / 多步任务交给 @general 子代理
4. 多端入口：终端、桌面 App、IDE 插件一套命令通吃
5. 选型结论：想换模型就选 OpenCode，锁定 Claude 就用 Claude Code

OpenCode 的配置和 1M 上下文模型是两个最容易踩坑的地方——一个是 schema 字段没文档，一个是变体名写错直接走默认。

1. 两份 JSON Schema：opencode.json / opencode.jsonc 主配置 + tui.json TUI 专属，schema URL 是 opencode.ai/config.json。
2. 1M 模型写法：model ID 后面挂 [1m] 后缀，比如 anthropic/claude-sonnet-4-6[1m]，Anthropic 官方约定。
3. TUI 显示百分比自动归一化：换 1M 模型后同样的 token 数，百分比变成原来的 1/5，不用额外配。
4. Provider 实际限制：qwen3.7-plus 在 OpenCode 上硬卡 200k（issue #30838），即使模型标称 1M。
5. 计费警告：1M 上下文分段计费——200k 之内一个价，200k 以上另一个价（贵几倍）。

OpenCode 里两个最高频的快捷语法——@path 拉文件、!cmd 跑 shell。看着简单，踩坑的姿势不少。

1. @ 引用文件：@src/components/Button.tsx 自动把文件读进上下文，比手动复制路径再让 OpenCode 读快得多。
2. ! 调用 Shell：!ls -la src/ 在 OpenCode 里直接跑命令，输出回传到对话里。
3. 大文件踩坑：引用 >500 行的文件会爆 token，先 head / Grep -n 截取 再 @。
4. 高频用法：!pnpm test 看测试输出、!git status 看状态、!ps aux | grep node 查进程。
5. 核心区别：@ 是"读进来作为上下文"，! 是"执行命令拿到结果"——前者进了历史，后者也是。

OpenCode 命令体系 纯 markdown 驱动，工作流可沉淀成可复用命令——零代码扩展，迁过来上手成本低。

1. 核心命令 4 条：/init / /compact / /clear / /undo，覆盖会话生命周期。
2. 自定义命令：.opencode/command/*.md 放 markdown 即生效，业务团队也能贡献。
3. 高频工作流：新项目 /init → 改 AGENTS.md → 写专属命令；改 Bug 走 /undo 兜底。
4. 更新机制：默认启动自检；手动 opencode upgrade，跨大版本前看 CHANGELOG。
5. 选型标准：多 provider 切选 OpenCode，只用 Claude 选 Claude Code。

OpenCode 的 sub-agent 机制和 Claude Code 不太一样——sub-agent 是 primary agent 派出去的临时会话，通过 @ 触发，跑起来后开 child session，主对话窗口原地不动。

1. 触发方式：@explore / @scout / @general 派 sub-agent 干活，主对话窗口不动。
2. 内置三类 sub-agent：Explore（只读扫代码）、Scout（只读研究外部）、General（通用可并行）。
3. 跳转快捷键：<Leader>+down 进 child session，up 回 parent，<Leader>+l 看所有 session。
4. 关键约束：sub-agent 上下文独立，主对话讨论过的约束必须显式写在 @ 任务里，否则按通用默认来。
5. 多层嵌套：sub-agent 又调 sub-agent 就多按几下 up 往上爬。

TUI 右下角才显示 60%、70%，自动 compact 突然就触发了——这是用 OpenCode 最高频的困惑。原因不止一个，按可能性从高到低排：

1. 给输出 token 预留 buffer：TUI 显示 80% 触发压缩，真正留给"历史"的安全位可能只有 50% 左右。
2. Tool calls 占空间：一次 Bash 输出几百行、一次大文件读取直接干到 10k+ tokens，这才是隐形杀手。
3. Provider 实际限制比标称小：qwen3.7-plus 在 OpenCode 上硬卡 200k（issue #30838），即使模型标称 1M。
4. Compaction 循环 bug：issue #29450 报过一句话烧光 200k 的 case，先升级 / 换 provider 再说。
5. 手动控制：用 /compact 自己把握时机，/compact 50 保留最近 50 条消息不压。

Loop Engineering 不是写更好的 prompt，是把"下指令的人"从自己换成一套你设计好的系统。

• Boris Cherny（Claude Code 负责人）："我已经不 prompt Claude 了，我的工作是写 loops"
• 从 ReAct 到 Ralph Loop 到 Claude Code /goal，底层逻辑是从"手工"到"工业"的范式迁移
• 六大构件：自动化触发、工作区隔离、技能沉淀、MCP 连接器、子代理分离、外部状态持久
• 关键前提：任务高度重复，验证可自动化，团队有充足 Token 预算
• 适合 CI 故障排查、依赖更新等标准化流程；不适合架构重构等需要人类判断的决策

Loop 越顺畅，人越容易停止思考——验证偷懒和理解债比 token 账单更危险。