jvibe 1.1.7 → 1.1.9

package/CHANGELOG.md

@@ -0,0 +1,118 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.8] - 2026-01-19
+
+### Added
+
+- **Agent I/O 协议统一** (`agent-contracts.yaml`)
+  - 新增 `docs/.jvibe/agent-contracts.yaml` 作为 subagent 输入输出的单一事实来源
+  - 定义了 `planner`、`developer`、`tester`、`bugfix`、`doc-sync` 的 `task_input` 与输出结构
+  - 包含硬规则 (HR-001 ~ HR-003) 约束 subagent 行为
+
+- **插件管理配置** (`plugins.yaml`)
+  - 新增 `docs/.jvibe/plugins.yaml` 管理工具与插件启用状态
+  - 区分 `core_plugins`（核心工具）与 `project_plugins`（项目按需）
+  - SessionStart hook 会从 `plugins.yaml` 注入 Core Tools 摘要到上下文
+  - 新增 `jvibe plugins core`：将缺失的 Core MCP Server 追加写入 `.claude/settings.local.json`（已存在则跳过）
+
+- **上下文最小化原则**
+  - 所有 Agent 新增"硬规则"章节，禁止全仓库扫描
+  - `developer`: 只在 `code_roots`/`test_roots` 范围内读取与修改
+  - `tester`: 新增 `mode: targeted | discover` 双模式
+  - `bugfix`: 优先使用 tester 报告的 `failures`/`modules_hit`/`files`
+
+- **Tester 双模式支持**
+  - `targeted`: 给定 `files`，精确限制测试范围
+  - `discover`: 允许从测试输出反推落点文件，解决"用户报错但不知道 F-XXX"场景
+  - 新增 `issue` 字段用于 discover 模式的问题描述
+
+- **Keepgo 用户报错判定**
+  - 新增关键词匹配（报错/失败/异常/bug/error 等）自动识别用户报告的问题
+  - 支持 `feature_id=null` 时进入 discover 测试流程
+  - 新增 `user_reported_issue`、`user_reported_feature_id`、`user_issue` 状态字段
+
+### Changed
+
+- **测试失败分流策略**
+  - 从简单的 `return_to_developer` 改为 `triage_then_fix` 策略
+  - 多模块/核心模块/用户强制 → 调用 `bugfix`
+  - 单模块/简单问题 → 回退到 `developer`
+
+- **Handoff Payload 结构**
+  - 新增 `mode` 字段（`targeted`/`discover`）
+  - `files` 字段在 targeted 模式下必填且非空
+  - `feature_id` 允许为 `null`
+
+- **文档更新条件**
+  - `doc_updates` 仅在 `pass` 且 `feature_id` 非空时执行
+  - 避免无法关联功能编号时错误更新状态
+
+- **Standards.md**
+  - 新增 §2.6 Tools & Plugins 章节说明工具与插件概念
+
+### Fixed
+
+- **Hook 脚本 grep 错误处理**
+  - 修复 `grep -c ... || true` 导致空字符串的问题
+  - 改为 `|| echo 0` 确保输出为数字，避免后续算术运算错误
+  - 影响文件：`load-context.sh`、`load-jvibe-full-context.sh`、`sync-jvibe-context.sh`
+
+- **UserPromptSubmit hook 错误处理**
+  - 移除 `set -eo pipefail`，改用 fail-open trap 机制
+  - 添加 `_JVIBE_HOOK_SUCCESS` 标记避免重复输出
+  - 修复 Project.md 摘要提取时 grep 管道无匹配导致的错误
+  - 确保非 JVibe 项目也能正常放行
+
+- **TUI 插件选择写回**
+  - 修复已有 `docs/.jvibe/plugins.yaml` 时项目插件勾选不生效的问题
+  - 默认更新 `project_plugins`；勾选 Force Overwrite 会重置整个文件
+
+## [1.1.7] - 2026-01-18
+
+### Added
+
+- Hooks 自动加载和同步 JVibe 上下文
+
+### Fixed
+
+- Hooks 脚本 jq-free 重写，fail-open 模式
+
+## [1.1.6] - 2026-01-17
+
+### Added
+
+- Context hooks 自动加载功能
+
+---
+
+## Summary of v1.1.8
+
+This release introduces a major architectural improvement focused on **context minimization** and **unified I/O contracts** for subagents:
+
+1. **Single Source of Truth**: `agent-contracts.yaml` defines all subagent input/output schemas
+2. **Dual-mode Testing**: `targeted` (precise) vs `discover` (user-reported issues without F-XXX)
+3. **Smarter Dispatch**: Main agent no longer directly fixes code; uses `bugfix` for complex issues
+4. **Robust Hooks**: Fixed shell script arithmetic errors with proper fallback values
+
+## [1.1.9] - 2026-01-20
+
+### Added
+
+- **Project Tools 注册表**：新增 `lib/plugins/registry.json` 的 Project Tools 完整条目（含 MCP 模板与依赖）
+- **Core Tools: Skill 支持**：支持 Core Tools 以 `skill` 形态集成（Agent Browser）
+  - 固定 Agent Browser Skill 到 `v0.6.0`，并将 `SKILL.md` vendoring 到 `template/.claude/skills/agent-browser/SKILL.md`
+
+### Changed
+
+- **Core Tools 配置输出**：分离 MCP Server 与 Skill 的计数与提示（init/setup/plugins core）
+
+### Fixed
+
+- **Core Tools env 占位符**：写入 `.claude/settings.local.json` 时自动填充当前环境变量，并避免写入未解析的 `{{VAR}}` 占位符
+- **Skill 下载鲁棒性**：为 Skill 下载增加超时/重定向/体积上限，避免卡死或异常大文件
+- **非交互 stdin**：`jvibe plugins core` 在 CI/重定向 stdin 下默认跳过交互安装提示，避免挂起

package/JVIBE.md

@@ -75,7 +75,7 @@ TODO 完成情况 → 功能状态
 5. **测试自动派发**：TODO 包含“测试/test”时，进入测试阶段必须自动调用 tester，无需用户手动指定
 6. **已有项目初始化**：若项目已有代码/文档，/JVibe:init 应先扫描现有项目并用扫描结果填充 Project 与 Feature-List
 7. **Bugfix 调用**：tester 报告失败且问题涉及**多模块**或**核心模块**时才调用 bugfix；否则回退给 developer。用户明确要求时可直接调用
-8. **MCP 权限**：主 Agent 与所有 Sub-Agents 允许直接调用 MCP 工具进行查询/集成操作
+8. **Tools/Plugins 权限**：主 Agent 与所有 Sub-Agents 允许直接调用 Tools/Plugins 进行查询/集成操作（包括 MCP Server、Skills、Daemon 等）
 
 保持此管理块，以便 `jvibe upgrade` 更新指令。
 <!-- JVIBE:END -->

package/README.md

@@ -1,9 +1,40 @@
+<div align="center">
+
 # JVibe
 
-> 文档驱动的 AI 辅助开发系统
+**文档驱动的 AI 辅助开发系统**
+
+*Doc-driven AI-assisted Development System for Claude Code & OpenCode*
 
 [![npm version](https://badge.fury.io/js/jvibe.svg)](https://badge.fury.io/js/jvibe)
+[![npm downloads](https://img.shields.io/npm/dm/jvibe.svg)](https://www.npmjs.com/package/jvibe)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D16.0.0-brightgreen)](https://nodejs.org/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/9963KK/VibeCoding-Tech/pulls)
+
+[快速开始](#-快速开始) · [使用方法](#-使用方法一览) · [文档](#-文档) · [贡献](#-贡献)
+
+</div>
+
+---
+
+## 目录
+
+- [什么是 JVibe？](#-什么是-jvibe)
+- [为什么选择 JVibe？](#-为什么选择-jvibe)
+- [快速开始](#-快速开始)
+- [使用方法一览](#-使用方法一览)
+- [典型使用场景](#-典型使用场景)
+- [项目结构](#-项目结构)
+- [文档体系](#-文档体系)
+- [Agent 架构](#-agent-架构)
+- [CLI 命令](#-cli-命令)
+- [Core Tools 维护](#-core-tools-维护)
+- [核心原则](#-核心原则)
+- [���见问题](#-常见问题)
+- [文档](#-文档)
+- [贡献](#-贡献)
+- [许可证](#-许可证)
 
 ---
 
@@ -18,6 +49,35 @@ JVibe 是一个**文档驱动的 AI 辅助开发系统**，面向 Claude Code
 
 ---
 
+## 💡 为什么选择 JVibe？
+
+| 痛点 | JVibe 解决方案 |
+|------|---------------|
+| AI 缺乏项目上下文，每次都要重复解释 | 自动加载项目文档，AI 开箱即知项目全貌 |
+| 功能状态散落各处，难以追踪 | 单一事实来源（SoT），状态只在一处维护 |
+| AI 生成代码质量参差不齐 | 多 Agent 分工协作，专业的事交给专业的 Agent |
+| 文档与代码脱节，维护困难 | 文档驱动开发，代码变更自动触发文档同步 |
+| 团队协作时上下文丢失 | 结构化任务交接文件，无缝衔接工作进度 |
+
+**核心优势**：
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      JVibe 工作流                           │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│   需求 ──→ planner ──→ developer ──→ tester ──→ reviewer   │
+│     │                      │            │           │       │
+│     └──────────────────────┴────────────┴───────────┘       │
+│                            ↓                                │
+│                       doc-sync                              │
+│                    (自动同步状态)                            │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
 ## 🚀 快速开始
 
 ### 初始化方式（选一种）
@@ -270,6 +330,44 @@ TODO 完成情况 → 功能状态
 
 ---
 
+## 🔌 Core Tools 维护
+
+### Agent Browser Skill 更新
+
+Agent Browser Skill 当前固定在 **v0.6.0** 版本，以确保稳定性。如需更新到最新版本：
+
+#### 方法 1：手动更新（推荐）
+
+```bash
+# 1. 访问 GitHub Releases 页面查看最新版本
+# https://github.com/vercel-labs/agent-browser/releases
+
+# 2. 下载最新版本的 SKILL.md
+curl -o .claude/skills/agent-browser/SKILL.md \
+  https://raw.githubusercontent.com/vercel-labs/agent-browser/v0.7.0/skills/agent-browser/SKILL.md
+
+# 3. 更新 CLI 到对应版本
+npm install -g agent-browser@latest
+agent-browser install
+```
+
+#### 方法 2：修改 registry.json（高级用户）
+
+如果你想让 `jvibe plugins core` 自动使用新版本：
+
+1. 编辑 `lib/plugins/registry.json`
+2. 找到 `agent-browser` 配置（约第 80 行）
+3. 修改 `skillSource` 指向新版本：
+   ```json
+   "skillSource": "https://raw.githubusercontent.com/vercel-labs/agent-browser/v0.7.0/skills/agent-browser/SKILL.md"
+   ```
+4. 删除现有 Skill 文件：`rm -rf .claude/skills/agent-browser`
+5. 重新运行：`jvibe plugins core`
+
+> **注意**：更新前请查看 [Agent Browser Changelog](https://github.com/vercel-labs/agent-browser/releases) 确认兼容性。
+
+---
+
 ## 🎯 核心原则
 
 JVibe 基于以下原则设计：
@@ -281,12 +379,83 @@ JVibe 基于以下原则设计：
 
 ---
 
+## ❓ 常见问题
+
+<details>
+<summary><b>JVibe 支持哪些 AI 编码工具？</b></summary>
+
+目前支持：
+- **Claude Code** - Anthropic 官方 CLI 工具
+- **OpenCode** - 开源 AI 编码助手
+
+通过 `--adapter` 参数选择适配器，或使用 `--adapter=both` 同时支持两者。
+</details>
+
+<details>
+<summary><b>已有项目如何接入 JVibe？</b></summary>
+
+推荐使用 `/JVibe:init` 命令（在 Claude Code 中）或 `/jvibe-init`（在 OpenCode 中）。AI 会自动扫描现有代码和文档，生成符合项目现状的 Feature-List 和 Project 文档。
+</details>
+
+<details>
+<summary><b>CORE-DOCS 和 PROJECT-DOCS 有什么区别？</b></summary>
+
+- **CORE-DOCS**：固定 4 个核心文档，所有项目结构相同，自动存在
+- **PROJECT-DOCS**：按需创建的扩展文档（如 API 文档、数据库文档），必须在规范文档中注册
+
+详见 [CORE vs PROJECT 文档](docs/CORE_VS_PROJECT_DOCS.md)。
+</details>
+
+<details>
+<summary><b>如何升级到新版本？</b></summary>
+
+```bash
+# 检查是否有新版本
+jvibe upgrade --check
+
+# 执行升级（会提示确认）
+jvibe upgrade
+
+# 强制升级（跳过确认）
+jvibe upgrade --force
+```
+</details>
+
+<details>
+<summary><b>Agent 之间如何协作？</b></summary>
+
+JVibe 采用流水线式协作：
+1. `planner` 分析需求，拆解为 TODO 列表
+2. `developer` 逐项完成 TODO，编写代码
+3. `tester` 执行测试，验证功能
+4. `bugfix` 处理复杂 bug（多模块/核心模块问题）
+5. `reviewer` 代码审查，确保质量
+6. `doc-sync` 自动同步文档状态
+
+使用 `/JVibe:keepgo` 可自动推进到下一阶段。
+</details>
+
+<details>
+<summary><b>如何卸载 JVibe？</b></summary>
+
+```bash
+# 卸载项目内的 JVibe 配置
+jvibe uninstall
+
+# 全局卸载
+npm uninstall -g jvibe
+```
+</details>
+
+---
+
 ## 📖 文档
 
 - [快速开始指南](docs/GETTING_STARTED.md)
 - [CLI 命令参考](docs/CLI_COMMANDS.md)
 - [架构说明](docs/ARCHITECTURE.md)
 - [CORE vs PROJECT 文档](docs/CORE_VS_PROJECT_DOCS.md)
+- [Tools & Plugins（工具与插件）](docs/TOOLS_AND_PLUGINS.md)
 - [贡献指南](docs/CONTRIBUTING.md)
 
 ---
@@ -314,3 +483,15 @@ JVibe 基于以下原则设计：
 - [Claude Code 官方文档](https://docs.anthropic.com/claude-code)
 - [OpenCode 官方文档](https://opencode.ai/docs)
 - [OpenSpec](https://github.com/openspec/openspec) - 灵感来源
+- [GitHub Issues](https://github.com/9963KK/VibeCoding-Tech/issues) - 问题反馈
+- [NPM Package](https://www.npmjs.com/package/jvibe) - NPM 主页
+
+---
+
+<div align="center">
+
+**如果 JVibe 对你有帮助，请给个 ⭐ Star 支持一下！**
+
+Made with ❤️ by [9963KK](https://github.com/9963KK)
+
+</div>

package/bin/jvibe.js

@@ -69,25 +69,14 @@ program
 // upgrade 命令
 program
   .command('upgrade')
-  .description('升级到最新版本（默认卸载重装）')
+  .description('升级到最新版本（卸载重装）')
   .option('--check', '仅检查更新，不执行升级', false)
   .option('--force', '强制升级，跳过确认', false)
-  .option('--migrate', '仅执行迁移，不更新到最新版本', false)
   .action(async (options) => {
     const upgrade = require('../scripts/upgrade');
     await upgrade(options);
   });
 
-// migrate 命令（upgrade --migrate 的别名）
-program
-  .command('migrate')
-  .description('迁移旧版本配置到新格式')
-  .option('--force', '强制迁移，跳过确认', false)
-  .action(async (options) => {
-    const upgrade = require('../scripts/upgrade');
-    await upgrade({ ...options, migrate: true });
-  });
-
 // uninstall 命令
 program
   .command('uninstall')
@@ -120,6 +109,19 @@ program
     await validate();
   });
 
+// plugins 命令
+const plugins = program
+  .command('plugins')
+  .description('插件相关操作（Core Tools 等）');
+
+plugins
+  .command('core')
+  .description('配置 Core Tools（写入缺失的 MCP Server 到 .claude/settings.local.json）')
+  .action(async () => {
+    const { configureCore } = require('../scripts/plugins');
+    await configureCore();
+  });
+
 (async () => {
   try {
     const handled = await maybeRunSetup();

package/lib/migrate.js

@@ -471,6 +471,7 @@ async function inferOpencodeVersionFromStructure(opencodeDir) {
     path.join('agent', 'planner.md'),
     path.join('agent', 'developer.md'),
     path.join('agent', 'tester.md'),
+    path.join('agent', 'bugfix.md'),
     path.join('agent', 'reviewer.md'),
     path.join('agent', 'doc-sync.md')
   ];
@@ -584,16 +585,25 @@ async function checkContentMigration(projectDir, currentVersion) {
  * @returns {Promise<MigrationPlan>}
  */
 async function getMigrationPlan(projectDir, versionInfo) {
+  const latestVersion = pkg.version || null;
+  const currentVersion = versionInfo.version || null;
+  const versionMismatch = Boolean(latestVersion && currentVersion && currentVersion !== latestVersion);
+
   const plan = {
-    needsMigration: versionInfo.isLegacy,
+    // needsMigration 表示“是否需要执行自动迁移动作”，不等同于 isLegacy
+    needsMigration: false,
     needsAIMigration: versionInfo.contentMigration.required,
     tasks: [],
     aiTasks: [],
     details: {
       docsToMove: [],
+      hooksNeedUpdate: false,
       hooksToUpdate: [],
+      commandsNeedUpdate: false,
       commandsToRename: [],
+      agentsNeedUpdate: false,
       agentsToUpdate: [],
+      opencodeNeedUpdate: false,
       configToUpdate: false,
       contentChanges: versionInfo.contentMigration.changes || []
     }
@@ -606,7 +616,7 @@ async function getMigrationPlan(projectDir, versionInfo) {
     }
   }
 
-  if (!versionInfo.isLegacy && !versionInfo.contentMigration.required) {
+  if (!versionInfo.isLegacy && !versionInfo.contentMigration.required && !versionMismatch) {
     return plan;
   }
 
@@ -642,7 +652,8 @@ async function getMigrationPlan(projectDir, versionInfo) {
   if (await fs.pathExists(hooksDir)) {
     const hookFiles = await fs.readdir(hooksDir);
     const legacyHookIssues = await checkLegacyHooks(hooksDir);
-    if (legacyHookIssues.length > 0) {
+    if (legacyHookIssues.length > 0 || versionMismatch) {
+      plan.details.hooksNeedUpdate = true;
       plan.details.hooksToUpdate = hookFiles.filter(f => f.endsWith('.sh'));
       plan.tasks.push('更新 hooks 脚本到最新版本');
     }
@@ -660,21 +671,49 @@ async function getMigrationPlan(projectDir, versionInfo) {
       plan.details.commandsToRename.push({ from: cmd, to: newName });
       plan.tasks.push(`重命名 command: ${cmd} → ${newName}`);
     }
+
+    if (legacyCommands.length > 0 || versionMismatch) {
+      plan.details.commandsNeedUpdate = true;
+      if (legacyCommands.length === 0) {
+        plan.tasks.push('更新 commands 到最新版本');
+      }
+    }
   }
 
   // 4. 检查 agents 更新需求
   const agentsDir = path.join(projectDir, '.claude/agents');
   if (await fs.pathExists(agentsDir)) {
-    plan.details.agentsToUpdate = ['planner.md', 'developer.md', 'reviewer.md', 'doc-sync.md'];
+    plan.details.agentsNeedUpdate = true;
+    plan.details.agentsToUpdate = ['planner.md', 'developer.md', 'tester.md', 'reviewer.md', 'doc-sync.md', 'bugfix.md'];
     plan.tasks.push('更新所有 agents 到最新版本');
   }
 
-  // 5. 配置更新
-  if (!versionInfo.version) {
+  // 5. OpenCode 配置更新
+  const opencodeDir = path.join(projectDir, '.opencode');
+  if (await fs.pathExists(opencodeDir)) {
+    if (versionInfo.isLegacy || versionMismatch) {
+      plan.details.opencodeNeedUpdate = true;
+      plan.tasks.push('更新 OpenCode 配置到最新版本');
+    }
+  }
+
+  // 6. 配置更新
+  if (!versionInfo.version || versionMismatch) {
     plan.details.configToUpdate = true;
-    plan.tasks.push('更新 settings.json 添加版本信息');
+    plan.tasks.push('更新版本信息（settings.json / jvibe.json）');
   }
 
+  // 最终 needsMigration：只要存在任一自动迁移动作即可
+  plan.needsMigration = Boolean(
+    plan.details.docsToMove.length > 0 ||
+    plan.details.hooksNeedUpdate ||
+    plan.details.commandsNeedUpdate ||
+    plan.details.commandsToRename.length > 0 ||
+    plan.details.agentsNeedUpdate ||
+    plan.details.opencodeNeedUpdate ||
+    plan.details.configToUpdate
+  );
+
   return plan;
 }
 
@@ -760,30 +799,76 @@ async function migrateAgents(projectDir, templateDir) {
   console.log(chalk.gray('   已更新 agents'));
 }
 
+/**
+ * 执行 OpenCode 配置迁移（覆盖同步）
+ * @param {string} projectDir - 项目目录
+ * @param {string} templateDir - 模板目录
+ */
+async function migrateOpencode(projectDir, templateDir) {
+  const projectOpencodeDir = path.join(projectDir, '.opencode');
+  const templateOpencodeDir = path.join(templateDir, '.opencode');
+
+  if (!await fs.pathExists(projectOpencodeDir)) {
+    return;
+  }
+  if (!await fs.pathExists(templateOpencodeDir)) {
+    return;
+  }
+
+  await fs.copy(templateOpencodeDir, projectOpencodeDir, { overwrite: true });
+  console.log(chalk.gray('   已更新 OpenCode 配置'));
+}
+
 /**
  * 更新配置文件
  * @param {string} projectDir - 项目目录
  * @param {string} newVersion - 新版本号
  */
 async function updateConfig(projectDir, newVersion) {
-  const settingsPath = path.join(projectDir, '.claude/settings.json');
+  const migratedAt = new Date().toISOString();
 
-  let settings = {};
-  if (await fs.pathExists(settingsPath)) {
-    try {
-      settings = await fs.readJson(settingsPath);
-    } catch (e) {
-      // 如果读取失败，创建新的配置
+  // Claude Code settings
+  const claudeDir = path.join(projectDir, '.claude');
+  if (await fs.pathExists(claudeDir)) {
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    let settings = {};
+    if (await fs.pathExists(settingsPath)) {
+      try {
+        settings = await fs.readJson(settingsPath);
+      } catch (e) {
+        // 如果读取失败，创建新的配置
+      }
     }
+
+    settings.jvibe = {
+      ...settings.jvibe,
+      version: newVersion,
+      migratedAt
+    };
+
+    await fs.writeJson(settingsPath, settings, { spaces: 2 });
   }
 
-  settings.jvibe = {
-    ...settings.jvibe,
-    version: newVersion,
-    migratedAt: new Date().toISOString()
-  };
+  // OpenCode meta
+  const opencodeDir = path.join(projectDir, '.opencode');
+  if (await fs.pathExists(opencodeDir)) {
+    const opencodeMetaPath = path.join(opencodeDir, 'jvibe.json');
+    let meta = {};
+    if (await fs.pathExists(opencodeMetaPath)) {
+      try {
+        meta = await fs.readJson(opencodeMetaPath);
+      } catch (e) {
+        // ignore
+      }
+    }
+    meta = {
+      ...meta,
+      version: newVersion,
+      migratedAt
+    };
+    await fs.writeJson(opencodeMetaPath, meta, { spaces: 2 });
+  }
 
-  await fs.writeJson(settingsPath, settings, { spaces: 2 });
   console.log(chalk.gray('   已更新版本信息'));
 }
 
@@ -857,24 +942,30 @@ async function executeMigration(projectDir, templateDir, plan, newVersion) {
   await migrateFeatureList(projectDir);
 
   // 3. 迁移 hooks
-  if (plan.details.hooksToUpdate.length > 0) {
+  if (plan.details.hooksNeedUpdate) {
     console.log(chalk.gray('   更新 hooks...'));
     await migrateHooks(projectDir, templateDir);
   }
 
   // 4. 迁移 commands
-  if (plan.details.commandsToRename.length > 0) {
+  if (plan.details.commandsNeedUpdate || plan.details.commandsToRename.length > 0) {
     console.log(chalk.gray('   更新 commands...'));
     await migrateCommands(projectDir, templateDir, plan);
   }
 
   // 5. 迁移 agents
-  if (plan.details.agentsToUpdate.length > 0) {
+  if (plan.details.agentsNeedUpdate) {
     console.log(chalk.gray('   更新 agents...'));
     await migrateAgents(projectDir, templateDir);
   }
 
-  // 6. 更新配置
+  // 6. 迁移 OpenCode
+  if (plan.details.opencodeNeedUpdate) {
+    console.log(chalk.gray('   更新 OpenCode 配置...'));
+    await migrateOpencode(projectDir, templateDir);
+  }
+
+  // 7. 更新配置
   if (plan.details.configToUpdate) {
     console.log(chalk.gray('   更新配置...'));
     await updateConfig(projectDir, newVersion);
@@ -925,6 +1016,7 @@ module.exports = {
   migrateHooks,
   migrateCommands,
   migrateAgents,
+  migrateOpencode,
   migrateFeatureList,
   updateConfig
 };