openfeel 1.1.4 → 1.1.6

package/dist/core/update.js

@@ -8,11 +8,12 @@
  */
 import { existsSync, readFileSync, mkdirSync } from 'node:fs';
 import { resolve, dirname, join, basename, isAbsolute, relative } from 'node:path';
-import { loadAgentTemplate, listAgentIds, loadTemplate } from './template-loader.js';
+import { loadAgentTemplate, listAgentIds, loadTemplate, loadClaudeConstraintTemplate, loadClaudeAgentTemplate, listClaudeAgentIds } from './template-loader.js';
 import { recordProjectLang } from './workspace/identity.js';
 import { t, getCliLang } from './i18n.js';
-import { getOpencodeGlobalDir, getGlobalAgentsDir, getGlobalSkillsDir, getGlobalCoreMdPath, getGlobalAgentsMdPath, getGlobalOpencodeJsoncPath, getGlobalUpdateStatePath } from './global-paths.js';
+import { getOpencodeGlobalDir, getGlobalAgentsDir, getGlobalSkillsDir, getGlobalCoreMdPath, getGlobalAgentsMdPath, getGlobalOpencodeJsoncPath, getGlobalUpdateStatePath, getClaudeAgentsDir, getClaudeSkillsDir, getClaudeMdPath, getClaudeSettingsPath } from './global-paths.js';
 import { mergeGlobalOpencodeJsonc, buildProjectOpencodeJsoncObj } from './opencode-config.js';
+import { applyClaudeSettings } from './claude-settings.js';
 import { atomicWriteFileSync } from './fs/atomic-write.js';
 import { withFileLock, globalLockPath } from './fs/file-lock.js';
 import { detectFileType, normalize, splitFrontmatter, parseRegion, wrapRegion, replaceRegion, mergeFrontmatter, serializeFrontmatter } from './managed-region.js';
@@ -29,8 +30,13 @@ export const supportedTools = [
         description: 'OpenCode AI 编码助手 — 生成 Agent 定义和 openfeel-* 技能',
         enabled: true,
     },
+    {
+        id: 'claude',
+        name: 'Claude Code',
+        description: 'Anthropic Claude Code CLI — 生成 CLAUDE.md、Claude subagent 定义与共享 openfeel-* 技能',
+        enabled: false,
+    },
     // 后续扩展：
-    // { id: 'claude', name: 'Claude Code', description: 'Anthropic Claude Code CLI', enabled: false },
     // { id: 'cursor', name: 'Cursor', description: 'Cursor IDE', enabled: false },
 ];
 /**
@@ -55,23 +61,51 @@ export async function selectTools() {
     }
     catch {
         // 交互不可用时（如非 TTY 环境），回退到全部启用项
-        console.log('（非交互环境，使用默认工具列表）');
+        console.log(t('update.nonInteractiveToolsTmpl', getCliLang(process.cwd())));
         return supportedTools.filter((t) => t.enabled).map((t) => t.id);
     }
 }
+/**
+ * 解析 `--tools` 逗号分隔列表。
+ * @returns tools=合法 id（保序去重）；invalid=非法项。空串/纯空白视为非法（触发 exit 1）。
+ */
+export function parseToolList(raw) {
+    if (raw.trim() === '') {
+        return { tools: [], invalid: [''] };
+    }
+    const valid = new Set(supportedTools.map((t) => t.id));
+    const tools = [];
+    const invalid = [];
+    for (const part of raw.split(',')) {
+        const v = part.trim();
+        if (v === '') {
+            continue;
+        } // 忽略尾随/空段
+        if (!valid.has(v)) {
+            invalid.push(v);
+            continue;
+        }
+        if (!tools.includes(v)) {
+            tools.push(v);
+        }
+    }
+    return { tools, invalid };
+}
 // ─── Agent 定义由 template-loader.ts 统一管理 ──────────────────────────
 // ─── Skill 定义内容 ─────────────────────────────────────────────────
 // AUTO-GENERATED-BEGIN: SKILL_DEFINITIONS
 export const SKILL_DEFINITIONS = {
     'openfeel-agent-model-check': `---
 name: openfeel-agent-model-check
-description: Agent 模型检查与修复。当 Agent 报 "Model not found" 或需要排查模型配置时使用。涵盖 auth.json 校验（opencode 适配器）、provider key 匹配、模型能力确认、openfeel-vision 多模态专项指南。
+description: Agent 模型检查与修复。当 Agent 报 "Model not found" 或需要排查模型配置时使用。涵盖 auth.json 校验（opencode 适配器）、provider key 匹配、模型能力确认、openfeel-vision 多模态专项指南、Claude Code 侧模型（\`/model\`、网关）。
 ---
 
 # Skill: openfeel-agent-model-check
 
 # Agent 模型检查与修复
 
+> 正文以**能力名**叙述；平台差异见 \`### opencode 适配器\` / \`### Claude Code 适配器\` 两小节。
+
 ## 何时使用
 
 - Agent 调度时报 \`Model not found: xxx\`
@@ -89,22 +123,6 @@ Model not found: {provider_key}/{model_id}
 
 注意是否有 \`Did you mean: xxx\` 提示——如有，直接使用建议的模型名。
 
-### 第二步：读取 auth.json 确认实际 provider key
-
-\`\`\`bash
-# Windows PowerShell / macOS / Linux
-cat ~/.local/share/opencode/auth.json
-\`\`\`
-
-**关键点**：模型引用中的 provider 部分必须与 \`auth.json\` 中的 key 完全一致，而非 \`opencode.jsonc\` 中 \`provider.name\` 或 \`provider.id\`。
-
-常见 provider key 示例：
-- \`alibaba-cn\` — 阿里云中国区（DashScope）
-- \`deepseek\` — DeepSeek
-- \`anthropic\` — Anthropic
-- \`openai\` — OpenAI
-- \`zhipuai\` — 智谱 AI
-
 ### 第三步：确认模型是否支持目标能力
 
 查阅 [Models.dev](https://models.dev) 确认模型属性：
@@ -121,7 +139,31 @@ cat ~/.local/share/opencode/auth.json
 - \`deepseek-flash\` 支持多模态图像输入（openfeel-vision 现用模型）
 - 备选视觉模型：\`qwen3-vl-plus\`（模型名中的 \`vl\` 表示 Vision-Language）
 
-### 第四步：检查 opencode.jsonc 配置
+### 第六步：验证
+
+重启后调度目标 Agent 执行简单测试任务，确认无报错。
+
+## 平台适配
+
+### opencode 适配器
+
+#### 第二步：读取 auth.json 确认实际 provider key
+
+\`\`\`bash
+# Windows PowerShell / macOS / Linux
+cat ~/.local/share/opencode/auth.json
+\`\`\`
+
+**关键点**：模型引用中的 provider 部分必须与 \`auth.json\` 中的 key 完全一致，而非 \`opencode.jsonc\` 中 \`provider.name\` 或 \`provider.id\`。
+
+常见 provider key 示例：
+- \`alibaba-cn\` — 阿里云中国区（DashScope）
+- \`deepseek\` — DeepSeek
+- \`anthropic\` — Anthropic
+- \`openai\` — OpenAI
+- \`zhipuai\` — 智谱 AI
+
+#### 第四步：检查 opencode.jsonc 配置
 
 \`\`\`jsonc
 {
@@ -139,13 +181,15 @@ cat ~/.local/share/opencode/auth.json
 3. 不要随意添加前缀（如 \`alibaba/\`、\`Alibaba(China)/\`）
 4. 如果不需要自定义 provider 选项（如 baseURL），可以完全不写 \`provider\` 块
 
-### 第五步：修改并重启
+#### 第五步：修改并重启
 
 修改 \`opencode.jsonc\` 后**必须重启 opencode** 才能生效。运行中的会话使用启动时加载的配置。
 
-### 第六步：验证
+### Claude Code 适配器
 
-重启后调度目标 Agent 执行简单测试任务，确认无报错。
+- Claude Code **无 \`auth.json\`**。
+- 模型/provider 由 **Claude 侧**决定（\`/model\`、\`settings.json\`/\`env\`、网关如 cc-switch）。
+- Claude Code **无 \`opencode.jsonc\`**，模型引用不进 jsonc。
 
 ## 快速诊断清单
 
@@ -156,6 +200,7 @@ cat ~/.local/share/opencode/auth.json
 | 模型支持目标能力 | 查阅 models.dev | Input/Tool Call 等字段 = Yes |
 | opencode.jsonc 语法 | 检查 JSON 格式 | 无语法错误 |
 | 重启生效 | 重启 opencode 后重新测试 | 无 Model not found 报错 |
+| 模型由 Claude 侧配置 | \`/model\` 或 settings/env | 模型可用 |
 
 ## 多模态（openfeel-vision）Agent 专项
 
@@ -170,6 +215,8 @@ openfeel-vision Agent 必须配置多模态模型。当前默认使用 \`deepsee
 
 **推荐**：优先使用 \`deepseek-flash\`（已内置多模态）；如需更大上下文可备选 \`qwen3-vl-plus\`。
 
+> **Claude Code 适配器**：多模态由 Claude 侧模型决定；\`openfeel-vision\` subagent 须选支持图像输入的模型。
+
 ## 常见错误与修复
 
 | 错误信息 | 原因 | 修复 |
@@ -178,6 +225,8 @@ openfeel-vision Agent 必须配置多模态模型。当前默认使用 \`deepsee
 | \`Model not found: alibaba/xxx\` | 内置 key 与实际注册的 key 不一致 | 检查 auth.json，使用实际 key |
 | \`Model not found: xxx. Did you mean: yyy\` | 模型名拼写错误或不存在 | 使用 \`Did you mean\` 建议的名称 |
 | Agent 调度成功但无法处理图片 | 配置了纯文本模型 | 改为支持图像输入的模型（如 \`deepseek-flash\`） |
+
+> **Claude Code 适配器**：以上排查针对 opencode 的 \`auth.json\`/\`opencode.jsonc\`；Claude 侧的模型解析以 \`/model\`、\`settings.json\`/\`env\` 或网关配置为准。
 `,
     'openfeel-bug-acceptance': `---
 name: openfeel-bug-acceptance
@@ -322,7 +371,10 @@ description: 渐进式查阅 .openfeel/kb/ 项目知识库，按当前任务需
    💡 如需确保索引为最新，可运行: python scripts/build_kb_index.py --dry-run
    \`\`\`
 
-> 注：语义检索是 \`openfeel-check-kb\` 的内置回退能力。调用方只需 \`skill("openfeel-check-kb")\` 一次，无需再手动调用 \`openfeel-search-kb\`。
+> 注：语义检索是 \`openfeel-check-kb\` 的内置回退能力。调用方只需加载一次：
+> - opencode 适配器：\`skill("openfeel-check-kb")\`；
+> - Claude Code 适配器：以 \`Skill\` 工具加载 \`openfeel-check-kb\`（工具名映射见 \`openfeel-tool-usage\`）。
+> 无需再手动调用 \`openfeel-search-kb\`。
 
 ### 6. 强制检索标记
 
@@ -336,7 +388,7 @@ Skill 加载后，根据步骤 3 的匹配结果决定是否追加提示：
 `,
     'openfeel-cli-usage': `---
 name: openfeel-cli-usage
-description: OpenFeel CLI 命令用法参考：命令清单与关键参数、15 个 phase 枚举与转移表、stageId 命名与目录映射约定、v1.1.2 新增能力（自描述/可纠错、--json 结构化输出、health --fix、scheme draft、knowledge dedup、纠正清理侧命令面）、v1.1.4 新增能力（checkpoint 选择性恢复 --stage/--dry-run、flow stage reset 精准复位、故障恢复路径）。当需要查询 CLI 命令、参数、phase、stageId、阶段命名时加载。
+description: OpenFeel CLI 命令用法参考：命令清单与关键参数、15 个 phase 枚举与转移表、stageId 命名与目录映射约定、v1.1.2 新增能力（自描述/可纠错、--json 结构化输出、health --fix、scheme draft、knowledge dedup、纠正清理侧命令面）、v1.1.4 新增能力（checkpoint 选择性恢复 --stage/--dry-run、flow stage reset 精准复位、故障恢复路径）、v1.1.5 新增能力（setup --check [--json] 诊断 / 被动部署提示）、v1.1.6 新增能力（Claude Code 适配器 \`--tools claude\` / settings 注入）。当需要查询 CLI 命令、参数、phase、stageId、阶段命名时加载。
 ---
 
 # OpenFeel CLI 用法参考
@@ -346,8 +398,9 @@ description: OpenFeel CLI 命令用法参考：命令清单与关键参数、15
 - 定位：**查询型参考手册**（只读，不自执行）。回答「命令是什么、参数怎么给、phase/stageId 规则如何」。
 - 边界：**执行型交互向导**请用 \`openfeel-wizard\` skill（跑 \`openfeel flow wizard\` 推进流水线）；本 skill 只承载静态知识查阅。
 - 与 \`openfeel-tool-usage\` 协同：工具选择规范见该 skill；本 skill 补充 CLI 命令细节。
+- 正文以**能力名**叙述；平台差异见 \`### opencode 适配器\` / \`### Claude Code 适配器\` 两小节。
 
-> 本文档为 v1.1.4 快照；命令/参数细节以 \`openfeel <cmd> --help\`（本仓执行）实时输出为准（CLI 演进后本文档可能滞后）。
+> 本文档为 v1.1.6 快照；命令/参数细节以 \`openfeel <cmd> --help\`（本仓执行）实时输出为准（CLI 演进后本文档可能滞后）。
 >
 > ⚠️ **本仓自举**：本仓（openfeel 源码仓库）开发/执行时请用 \`node bin/openfeel.js <cmd>\`；安装后使用 \`openfeel <cmd>\`。
 
@@ -356,8 +409,8 @@ description: OpenFeel CLI 命令用法参考：命令清单与关键参数、15
 | 命令 | 用途 | 关键参数 |
 |------|------|----------|
 | \`openfeel init [path]\` | 初始化项目工作区 | \`--lang <zh-CN\\|en>\`、\`--demo\`、\`--workspace-only\`、\`--non-interactive\` |
-| \`openfeel setup\` | 部署全局框架配置（不建项目 \`.openfeel/\`） | \`--lang <zh-CN\\|en>\` |
-| \`openfeel update [path]\` | 部署适配文件到目标项目 | \`--lang\`、\`--force\` |
+| \`openfeel setup\` | 部署全局框架配置（不建项目 \`.openfeel/\`）；\`--check\` 只读诊断全局部署一致性 | \`--lang <zh-CN\\|en>\`、\`--check [--json]\`、\`--tools <list>\` |
+| \`openfeel update [path]\` | 部署适配文件到目标项目 | \`--lang\`、\`--force\`、\`--tools <list>\` |
 | \`openfeel migrate [path]\` | Legacy 布局迁移（检测/备份/迁移/回滚） | \`--dry-run\`、\`--remap-assignee\`、\`--clean-global-core-md\`；\`migrate rollback\` |
 | \`openfeel flow ...\` | 流水线状态管理 | 见下「flow 子命令」 |
 | \`openfeel flow checkpoint restore\` | Checkpoint 恢复（全量 / 选择性 / 预览） | \`<file> [--force] [--stage <id>] [--dry-run]\`（无 \`--stage\`=全量覆盖，最后手段；\`--stage\`=按阶段回退；\`--dry-run\`=零写盘预览） |
@@ -381,6 +434,39 @@ description: OpenFeel CLI 命令用法参考：命令清单与关键参数、15
 
 > 命令职责分层：\`plan stage add\`（完整，推荐）> \`flow stage add\`（仅注册 \`flow.json\`，不建目录）> \`stage create\`（已弃用）。
 
+## v1.1.6 新增能力（stage-68~73）
+
+- **多 harness 并存**：\`openfeel setup\` / \`openfeel update\` 新增 \`--tools <逗号列表>\`（如 \`opencode,claude\`）；非法值 **exit 1** 前置校验零写盘；默认仅 \`opencode\`。
+- **Claude Code 适配器资产**：\`--tools claude\` 部署 \`~/.claude/\`——\`CLAUDE.md\`（全局约束，用户已有内容 append 不覆盖）、\`agents/\`（**9 个**，含 \`feel\`）、\`skills/\`（**17 个**共享源）、\`settings.json\`（注入 \`"agent":"feel"\` + \`"permissions":{"defaultMode":"auto"}\`，用户既有键逐字保留）；默认零触（不带 \`--tools\` 时 \`~/.claude/\` 零变化）。
+
+## v1.1.5 新增能力（stage-67）
+
+- **主动诊断 \`openfeel setup --check [--json]\`**：只读检测全局部署版本（\`~/.openfeel/update_state.json.openfeel_version\`）与 CLI 版本一致性，**不执行部署**；一致退出 \`0\`，\`mismatch\`/\`missing\`/\`unknown\` 退出 \`1\`；\`--json\` 输出 \`{schemaVersion,status,cliVersion,deployedVersion}\`（\`status\` ∈ \`ok|mismatch|missing|unknown\`）。
+- **被动部署提示**：任意命令 / REPL 在 TTY 下检测到全局部署漂移（\`mismatch\`）或缺失（\`missing\`）时，向 **stderr** 提示运行 \`openfeel setup\`；**每进程一次**；\`--json\`/\`--quiet\`/\`--version\`/\`--help\`、CI、\`OPENFEEL_NO_UPDATE_CHECK\` 及部署类命令（\`setup\`/\`update\`/\`init\`/\`migrate\`）静默；\`unknown\`（state 损坏）被动静默、仅 \`--check\` 显式报告；**不改退出码、不写盘**。
+
+## 升级流程
+
+### opencode 适配器
+
+\`\`\`bash
+npm i -g openfeel@latest   # 1. 升级 CLI
+openfeel setup             # 2. 重跑部署，刷新全局 AGENTS.md/agents/skills/opencode.jsonc
+# 3. 重启 harness（opencode）以加载新的全局配置
+\`\`\`
+
+仅 \`npm i -g\` 不会刷新全局资产，须重跑 \`openfeel setup\` 并重启 harness。\`openfeel setup --check\` 可诊断全局部署版本与 CLI 版本是否一致（一致退出 0，否则退出 1）。
+
+### Claude Code 适配器
+
+\`\`\`bash
+npm i -g openfeel@latest       # 1. 升级 CLI
+openfeel setup --tools claude  # 2. 重跑部署（claude 目标）
+\`\`\`
+
+- **\`--tools\` 由 v1.1.6 提供**：\`openfeel setup --tools claude\`；首次创建 \`~/.claude/{agents,skills}\` 后**重启会话或 \`/reload-skills\`** 使新 skill/agent 生效。
+- 首次创建 \`~/.claude/{agents,skills}\` 后需**重启会话或 \`/reload-skills\`** 使新 skill/agent 生效。
+- \`CLAUDE.md\` 于**下次会话**生效。
+
 ## v1.1.2 新增能力（stage-41~55）
 
 > 以下为 v1.1.2 相对上版的增量能力（分组摘要，细节以 \`<cmd> --help\` 为准）。
@@ -454,11 +540,19 @@ plan_pending → plan_review → plan_passed → scheme_pending → scheme_revie
 
 ## 权限模型要点
 
+### opencode 适配器
+
 - 9 个 agent 内联 \`permission:\` 白名单，均含 \`external_directory: "allow"\`（单一键，无读写粒度）。
 - **合并语义**：agent \`.md\` frontmatter 与 \`opencode.jsonc\` 按权限键**深合并**，同名键以 agent \`.md\` 为准（配置文件无法覆盖已声明键）。
 - **收紧入口**：项目根 \`.opencode/agent/<name>.md\` 覆盖全局同名 agent 并重写完整 \`permission\` 块；勿手改全局 agent frontmatter（会被 \`update\` 覆盖）。
 - 详 \`.openfeel/manual/core/permission.md\`。
 
+### Claude Code 适配器
+
+- subagent 于 frontmatter 声明 \`tools\`（白名单，未列即不可用）、\`disallowedTools\`（黑名单）与 \`permissionMode\`。
+- **无 \`external_directory\` 对等概念**。
+- \`settings.json\` 由 \`openfeel setup/update --tools claude\` 注入（\`agent:"feel"\` + \`permissions.defaultMode:"auto"\`，用户键保留），**v1.1.6 起**。
+
 ## 与 openfeel-wizard 的区别
 
 | 维度 | \`openfeel-cli-usage\`（本 skill） | \`openfeel-wizard\` |
@@ -573,7 +667,9 @@ description: 读取 .openfeel/plan/{series}/{stage}/status.md，判断当前子
    - \`deps_satisfied = true\`（本 Skill 递归判断）
    - \`状态\` 为 \`ready_for_code\` 或 \`auto_running\`
    - \`自动推进\` 为 \`enabled\`（若 status.md 未填则回退到 config.yaml \`auto_advance\`）
-2. 收集为 \`parallel_candidates\` 列表，供 Feel 批量调度执行。
+2. 收集为 \`parallel_candidates\` 列表，供主会话（Feel）批量调度执行。
+
+> 口径：**subagent 不互调**（不直接调用其他 subagent）；需向用户确认的事项一律由主会话负责。
 
 ### 5. 判断自动推进资格
 
@@ -620,8 +716,8 @@ description: 读取 .openfeel/plan/{series}/{stage}/status.md，判断当前子
 | \`coding\` | openfeel-executor 正在开发 |
 | \`ready_for_review\` | openfeel-executor 可启动 openfeel-reviewer 审查，或等待用户触发 |
 | \`review_failed\` | openfeel-reviewer 可启动 openfeel-executor 修复审查问题 |
-| \`review_passed\` | Feel 可推进到 ready_for_test |
-| \`ready_for_test\` | Feel 可启动 openfeel-feel-tester |
+| \`review_passed\` | 主会话可推进到 ready_for_test |
+| \`ready_for_test\` | 主会话可启动 openfeel-feel-tester |
 | \`test_writing\` | openfeel-feel-tester 正在写测试 |
 | \`testing\` | openfeel-feel-tester 正在测试 |
 | \`bug_found\` | openfeel-feel-tester 可启动 openfeel-executor 修复 Bug |
@@ -654,16 +750,18 @@ description: 加载流水线健康检查结果，供 Agent 判断 flow.json 与
 `,
     'openfeel-model-check': `---
 name: openfeel-model-check
-description: Feel 自检时检查所有 Agent 的模型配置状态，识别期望模型 vs 实际模型的差距，引导用户在目标工具中完成配置。首次配置后存储为部署模板，新项目可直接复用。
+description: 主会话（Feel）自检时检查所有 Agent 的模型配置状态，识别期望模型 vs 实际模型的差距，引导用户在目标工具中完成配置。首次配置后存储为部署模板，新项目可直接复用。
 ---
 
 # 模型配置检查
 
 > ⚠️ **本仓自举**：本仓（openfeel 源码仓库）开发/执行时请用 \`node bin/openfeel.js <cmd>\`；安装后使用 \`openfeel <cmd>\`。
 
+> 正文以**能力名**叙述；平台差异见 \`### opencode 适配器\` / \`### Claude Code 适配器\` 两小节。
+
 ## 触发时机
 
-Feel Agent 在以下时机加载本 Skill：
+主会话在以下时机加载本 Skill：
 - 会话启动自检（每次）
 - 用户请求检查模型配置（按需）
 - 新项目首次初始化后（\`openfeel init\`）
@@ -672,19 +770,11 @@ Feel Agent 在以下时机加载本 Skill：
 
 ### 1. 识别当前平台
 
-读取 \`opencode.jsonc\`（或对应平台的配置文件），确定当前适配器平台：
-
-| 配置文件 | 平台 |
-|----------|------|
-| \`opencode.jsonc\` | OpenCode（当前适配器） |
-| \`kilo/kilo.json\` | Kilo |
-| \`claude/claude.json\` | Claude |
-
-若无平台配置文件，提示用户当前不在支持的平台中。
+读取当前 harness 的平台配置文件，确定当前适配器平台（已知平台配置文件与 agents 目录差异见 \`## 平台适配\`）。
 
 ### 2. 扫描 Agent 定义
 
-扫描 \`.opencode/agents/\`（或对应平台的 agents/ 目录）下所有 \`.md\` 文件，提取每个 Agent 的模型需求。
+扫描 agents 目录（目录差异见 \`## 平台适配\`）下所有 \`.md\` 文件，提取每个 Agent 的模型需求。
 
 **提取规则（优先级从高到低）**：
 
@@ -761,7 +851,7 @@ models:
 \`\`\`markdown
 | Agent | 角色要求 | 实际模型 | 配置来源 | 状态 |
 |-------|----------|----------|----------|:--:|
-| Feel | 主力推理 | deepseek-v4-pro | default | ⚠️ |
+| 主会话 | 主力推理 | deepseek-v4-pro | default | ⚠️ |
 | openfeel-reviewer | **异种推理** | deepseek-v4-pro | default | ❌ 与主力相同！ |
 | openfeel-executor | 快速 | deepseek-v4-pro | default | ⚠️ 未使用快速模型 |
 \`\`\`
@@ -773,7 +863,7 @@ models:
 \`\`\`markdown
 ## 🔍 模型配置检查报告
 
-**平台**：OpenCode（当前适配器）
+**平台**：当前 harness（opencode 适配器 / Claude Code 适配器）
 **配置文件**：.openfeel/config.yaml
 **检查时间**：yyyy-mm-dd HH:MM
 
@@ -801,12 +891,12 @@ models:
 
 ### 6. 引导用户配置
 
-若检查发现以下任一问题，**必须**使用 \`question\` 工具引导用户：
+若检查发现以下任一问题，**必须**使用向用户提问工具（opencode 适配器：\`question\`；Claude Code 适配器：\`AskUserQuestion\`）引导用户：
 
 | 触发条件 | 引导内容 |
 |----------|----------|
 | \`models\` 节不存在 | "未检测到模型配置。你需要为不同角色分配模型吗？" → 引导创建 |
-| openfeel-reviewer 使用与主力相同模型 | "⚠️ openfeel-reviewer 当前与 Feel 使用相同模型，异种交叉审查的核心优势无法发挥。建议为 openfeel-reviewer 配置不同的模型系列。" |
+| openfeel-reviewer 使用与主力相同模型 | "⚠️ openfeel-reviewer 当前与主会话使用相同模型，异种交叉审查的核心优势无法发挥。建议为 openfeel-reviewer 配置不同的模型系列。" |
 | openfeel-executor 使用推理模型 | "⚠️ openfeel-executor 建议使用快速模型以节省成本。是否配置？" |
 | 关键 Agent 无任何配置 | "以下 Agent 无模型配置：{列表}。请配置。" |
 
@@ -826,7 +916,7 @@ models:
 # 或直接复制此文件到 .openfeel/ 并重命名为 config.yaml（需合并其他节）
 #
 # 最近配置时间：yyyy-mm-dd HH:MM
-# 平台：OpenCode（当前适配器）
+# 平台：当前 harness（opencode 适配器 / Claude Code 适配器）
 
 models:
   default:
@@ -845,6 +935,31 @@ models:
 
 此模板在下次 \`openfeel init\` 或新项目部署时自动检测并建议复用。
 
+## 平台适配
+
+### opencode 适配器
+
+平台配置文件：
+
+| 配置文件 | 平台 |
+|----------|------|
+| \`opencode.jsonc\` | OpenCode（当前适配器） |
+| \`kilo/kilo.json\` | Kilo |
+
+若无平台配置文件，提示用户当前不在支持的平台中。
+
+- agents 目录：\`.opencode/agents/\`（或对应平台的 agents/ 目录）下所有 \`.md\` 文件。
+- 报告/模板中的平台标签：\`**平台**：OpenCode（当前适配器）\`（原文标签，正文已改为中性表述「当前 harness（opencode 适配器 / Claude Code 适配器）」）。
+- 向用户提问使用 \`question\` 工具。
+
+### Claude Code 适配器
+
+- Claude Code **无平台配置文件**（原平台识别表中指向 Claude 的错误配置行已删除）。
+- 全局约束：\`~/.claude/CLAUDE.md\`；本期由 **stage-73** 注入 \`settings.json\`。
+- agents 目录：\`~/.claude/agents/\`。
+- 报告平台标签：\`Claude Code 适配器\`。
+- 向用户提问使用 \`AskUserQuestion\` 工具。
+
 ## 输出规范
 
 - 状态图标：✅ 已满足、⚠️ 降级使用（可接受但非最优）、❌ 缺失或严重不匹配
@@ -853,13 +968,15 @@ models:
 `,
     'openfeel-model-config': `---
 name: openfeel-model-config
-description: 查找和配置 Agent 模型。当 Agent 报 "Model not found" 或需要调整/新增 Agent 模型时使用。覆盖 opencode.jsonc 配置（opencode 适配器）、模型名查找方法、多模态模型（openfeel-vision）特殊注意事项。
+description: 查找和配置 Agent 模型。当 Agent 报 "Model not found" 或需要调整/新增 Agent 模型时使用。覆盖模型配置位置与优先级链（opencode 适配器 / Claude Code 适配器）、模型名查找方法、多模态模型（openfeel-vision）特殊注意事项。
 ---
 
 # Skill: openfeel-model-config
 
 # Agent 模型查找与配置
 
+> 正文以**能力名**叙述；平台差异见 \`### opencode 适配器\` / \`### Claude Code 适配器\` 两小节。
+
 ## 何时使用
 
 - Agent 调用时报 \`Model not found: xxx\`
@@ -869,6 +986,8 @@ description: 查找和配置 Agent 模型。当 Agent 报 "Model not found" 或
 
 ## 配置位置
 
+### opencode 适配器
+
 Agent 模型配置在 **\`opencode.jsonc\`**（项目根目录）中：
 
 \`\`\`jsonc
@@ -885,6 +1004,12 @@ Agent 模型配置在 **\`opencode.jsonc\`**（项目根目录）中：
 
 > 💡 **推荐**：可用 \`openfeel model set/get/list --scope default|global|project\` 一键读写三层级模型（工具默认 / 全局 / 当前项目），无需手工定位文件。
 
+### Claude Code 适配器
+
+- Agent 模型配置在 Claude Code 侧的 \`~/.claude/agents/*.md\` frontmatter \`model\` 字段。
+- 模型配置经 \`/model\`、\`settings.json\`/\`env\` 或网关（如 cc-switch）等途径确定。
+- \`settings.json\`（本期由 stage-73 注入）仅作参考，模板默认 \`model: inherit\`。
+
 ## 查找可用模型名
 
 当收到 \`"Model not found: xxx. Did you mean: aaa, bbb?"\` 错误时：
@@ -894,6 +1019,8 @@ Agent 模型配置在 **\`opencode.jsonc\`**（项目根目录）中：
 
 ## Agent 定义文件中的 model 字段
 
+### opencode 适配器
+
 \`.opencode/agents/<name>.md\` 的 frontmatter \`model:\` 字段**是生效的，且优先于** \`opencode.jsonc\` 的 \`agent.<name>.model\`（stage-40 REV-1606 实测）。opencode 模型解析优先级链：
 
 \`\`\`
@@ -904,21 +1031,31 @@ Agent 模型配置在 **\`opencode.jsonc\`**（项目根目录）中：
 1. 修改 \`.opencode/agents/<name>.md\` 的 frontmatter \`model:\`（模板源 \`src/core/templates-data/opencode/agents/\` 同步）
 2. （可选，保持一致）同步修改 \`opencode.jsonc\` 的 \`agent.<name>.model\`
 
+### Claude Code 适配器
+
+Claude Code 模型解析优先级链：项目 \`.claude/agents\` > 用户 \`~/.claude/agents\`；frontmatter \`model\` **优先于** \`inherit\`。
+
 ## 多模态（openfeel-vision）模型特殊规则
 
-- Feel 的主力模型（DeepSeek V4 Pro）不支持图片输入
-- 遇到图片输入时 Feel 会自动委托 openfeel-vision Agent
+### opencode 适配器
+
+- 主会话（Feel）的主力模型（DeepSeek V4 Pro）不支持图片输入
+- 遇到图片输入时主会话会自动委托 openfeel-vision Agent
 - openfeel-vision Agent 需要配置多模态模型（现用 \`deepseek-flash\`，备选 \`qwen3-vl-plus\`）
 - 模型名不要随意添加前缀（如 \`alibaba/\`），以平台提示的可用名为准
 - **模型引用格式**：\`{auth.json中的key}/{模型ID}\`，不是 \`provider.name\` 也不是 \`provider.id\`
 - 读取 \`~/.local/share/opencode/auth.json\` 确认实际 provider key（常见：\`alibaba-cn\`、\`deepseek\`、\`zhipuai\`）
 - \`provider\` 块中的 \`name\` 和 \`id\` 仅用于显示，不影响模型解析
 
+### Claude Code 适配器
+
+- 多模态由 Claude 侧模型决定；\`openfeel-vision\` subagent 须选支持图像输入的模型。
+
 ## 项目 Agent 模型概览
 
 | Agent | 模型类型 | 备注 |
 |-------|---------|------|
-| Feel（总统领） | 推理模型 | DeepSeek V4 Pro — 不支持多模态 |
+| 主会话（Feel） | 推理模型 | DeepSeek V4 Pro — 不支持多模态 |
 | openfeel-planner | 推理模型 | — |
 | openfeel-schemer | 推理模型 | — |
 | openfeel-executor | 快速模型 (Flash) | — |
@@ -1181,7 +1318,7 @@ description: Agent 工具使用规范（todowrite/question/task/skill 四工具
 触发条件（任一必问）：需求歧义 / 多个同等合理方案 / 不可逆后果 / 架构决策。使用要求：(Recommended) 标记、选项附后果、≤3 选项、高风险含"取消"。禁止：模糊时自行假设、多方案不选直接实施。
 
 ### 3. task — 子 Agent 调度
-触发条件：并行探索多代码区 / 复杂多步委托 general / 下游 Agent（经 Feel）。使用要求：并行一条消息多 task、prompt 含任务描述+期望返回、明确只读/可写。
+触发条件：并行探索多代码区 / 复杂多步委托 general / 下游 Agent（经主会话（Feel））。使用要求：并行一条消息多 task、prompt 含任务描述+期望返回、明确只读/可写。
 
 ### 4. skill — 技能加载
 触发条件：查阶段状态→openfeel-get-stage-status / 查知识库→openfeel-check-kb / 取 Bug→openfeel-get-bugs。使用要求：会话开始载 check-kb、处理阶段任务前载 get-stage-status、不凭记忆跳过。
@@ -1194,6 +1331,23 @@ description: Agent 工具使用规范（todowrite/question/task/skill 四工具
 | 探索代码 | task(explore) | 手动逐个 grep/read |
 | 获取状态 | skill(openfeel-get-stage-status) | 凭记忆推断 |
 | 批量文件操作 | task(general) | 串行逐个处理 |
+
+## 工具名映射（跨 harness）
+
+本 skill 的四种核心工具（\`todowrite\`/\`question\`/\`task\`/\`skill\`）在各 harness 的等价工具名见下表；**不改变**既有触发条件/使用要求/优先级表语义。
+
+| opencode（小写） | Claude Code | 说明 |
+|------|------|------|
+| \`bash\` | \`Bash\` | 命令执行 |
+| \`read\` | \`Read\` | 读文件 |
+| \`write\` | \`Write\` | 写文件 |
+| \`edit\` | \`Edit\` | 编辑文件 |
+| \`glob\` | \`Glob\` | 文件匹配 |
+| \`grep\` | \`Grep\` | 内容检索 |
+| \`todowrite\` | \`TodoWrite\` | 任务列表 |
+| \`skill\` | \`Skill\` | 技能加载 |
+| \`task\` | \`Task\` | 子 Agent 调度 |
+| \`question\` | \`AskUserQuestion\` | 向用户提问 |
 `,
     'openfeel-update-stage-status': `---
 name: openfeel-update-stage-status
@@ -1371,9 +1525,9 @@ description: 会话启动时检查并补齐 .openfeel/ 工作区目录结构与
 \`.openfeel/users/{username}/dev_last.md\`（**索引**；同名目录 \`dev_last/\` 存主题文件，**文件名英文**）
 
 ### 6. 增量更新复核
-检查 \`~/.openfeel/update_infos.md\`，若存在未修复条目（追加/异常），提醒用户重启会话或委托 Feel 处理；本 Agent 不自行修改该文件。
+检查 \`~/.openfeel/update_infos.md\`，若存在未修复条目（追加/异常），提醒用户重启会话或委托主会话（Feel）处理；本 Agent 不自行修改该文件。
 
-> 目录结构语义、公共/私域分区、用户身份约束、路径自校验规则见全局 AGENTS.md（约束）；本 skill 仅承载操作步骤。
+> 目录结构语义、公共/私域分区、用户身份约束、路径自校验规则见全局规则文件（opencode 适配器：\`~/.config/opencode/AGENTS.md\`；Claude Code 适配器：\`~/.claude/CLAUDE.md\`）（约束）；本 skill 仅承载操作步骤。
 `,
 };
 // AUTO-GENERATED-END: SKILL_DEFINITIONS
@@ -1522,8 +1676,10 @@ export function updateProject(projectPath, selectedTools = ["opencode"], lang =
     const state = loadUpdateState(projectPath);
     const globalState = loadGlobalUpdateState();
     const conflicts = [];
-    // 过滤：仅处理选中的工具
-    if (!selectedTools.includes('opencode')) {
+    // 过滤：仅处理选中的工具（两工具都未选才早退）
+    const wantOpencode = selectedTools.includes('opencode');
+    const wantClaude = selectedTools.includes('claude');
+    if (!wantOpencode && !wantClaude) {
         return { created: [], updated: [], skipped: [], conflicts: [], appended: [] };
     }
     // N8：检测项目内遗留 .opencode/{agents,skills,instructions}，只提示不迁移
@@ -1532,12 +1688,6 @@ export function updateProject(projectPath, selectedTools = ["opencode"], lang =
     if (legacyDirs.length > 0) {
         console.warn(t('update.legacyLayoutWarnTmpl', getCliLang(projectPath), { dirs: legacyDirs.join(',') }));
     }
-    // 全局部署目标（D1）
-    const agentsDir = getGlobalAgentsDir();
-    const skillsDir = getGlobalSkillsDir();
-    // 确保全局目标目录存在
-    mkdirSync(agentsDir, { recursive: true });
-    mkdirSync(skillsDir, { recursive: true });
     // 记录项目语言映射到全局配置
     // 使用 options?.lang（用户通过 --lang 显式指定的语言）优先，
     // 回退到 lang（getCliLang 三级回退结果）。确保记录的语言与实际部署语言一致。
@@ -1557,85 +1707,132 @@ export function updateProject(projectPath, selectedTools = ["opencode"], lang =
         globalState.files[getGlobalAgentsMdPath()] = globalState.files[staleCoreKey];
         delete globalState.files[staleCoreKey];
     }
-    // 0. 生成全局框架约束 AGENTS.md（~/.config/opencode/AGENTS.md）
-    const agentsMdPath = getGlobalAgentsMdPath();
-    const agentsMdContent = loadTemplate(lang, 'agents-md');
-    {
-        const action = deployGlobalAsset(agentsMdPath, agentsMdContent, newGlobalState, 'update');
-        pushAction(action, agentsMdPath, created, updated, skipped, appended);
-    }
-    // 1. 生成 Agent 定义文件到全局 agents 目录（绝对路径作 state key）
-    for (const name of listAgentIds(lang)) {
-        const content = loadAgentTemplate(lang, name);
-        const filePath = join(agentsDir, `${name}.md`);
-        const action = deployGlobalAsset(filePath, content, newGlobalState, 'update');
-        pushAction(action, filePath, created, updated, skipped, appended);
-    }
-    // 2. 生成 Skill 定义文件到全局 skills 目录（每个 Skill 一个子目录，包含 SKILL.md）
-    for (const [name, content] of Object.entries(SKILL_DEFINITIONS)) {
-        const skillSubDir = join(skillsDir, name);
-        mkdirSync(skillSubDir, { recursive: true });
-        const filePath = join(skillSubDir, 'SKILL.md');
-        const action = deployGlobalAsset(filePath, content, newGlobalState, 'update');
-        pushAction(action, filePath, created, updated, skipped, appended);
-    }
-    // 3. 全局 opencode.jsonc：深度合并（保留用户字段），加全局锁 + 原子写
-    const globalJsoncPath = getGlobalOpencodeJsoncPath();
-    try {
-        // 写前备份（B3）：备份须在 jsonc 锁之外（之前）完成，避免 backup 锁与 jsonc 锁嵌套
-        const globalJsoncBackup = backupFileBeforeWrite(globalJsoncPath, { command: 'update' });
-        if (globalJsoncBackup) {
-            appendUpdateInfo('backed', { absolutePath: globalJsoncPath, backupRel: globalJsoncBackup.backupRel, command: 'update' });
-            notifyBackupIfTTY(globalJsoncBackup.backupRel);
+    // opencode 分支（步骤 0~4）——原样保留
+    if (wantOpencode) {
+        // 全局部署目标（D1）
+        const agentsDir = getGlobalAgentsDir();
+        const skillsDir = getGlobalSkillsDir();
+        // 确保全局目标目录存在
+        mkdirSync(agentsDir, { recursive: true });
+        mkdirSync(skillsDir, { recursive: true });
+        // 0. 生成全局框架约束 AGENTS.md（~/.config/opencode/AGENTS.md）
+        const agentsMdPath = getGlobalAgentsMdPath();
+        const agentsMdContent = loadTemplate(lang, 'agents-md');
+        {
+            const action = deployGlobalAsset(agentsMdPath, agentsMdContent, newGlobalState, 'update');
+            pushAction(action, agentsMdPath, created, updated, skipped, appended);
+        }
+        // 1. 生成 Agent 定义文件到全局 agents 目录（绝对路径作 state key）
+        for (const name of listAgentIds(lang)) {
+            const content = loadAgentTemplate(lang, name);
+            const filePath = join(agentsDir, `${name}.md`);
+            const action = deployGlobalAsset(filePath, content, newGlobalState, 'update');
+            pushAction(action, filePath, created, updated, skipped, appended);
+        }
+        // 2. 生成 Skill 定义文件到全局 skills 目录（每个 Skill 一个子目录，包含 SKILL.md）
+        for (const [name, content] of Object.entries(SKILL_DEFINITIONS)) {
+            const skillSubDir = join(skillsDir, name);
+            mkdirSync(skillSubDir, { recursive: true });
+            const filePath = join(skillSubDir, 'SKILL.md');
+            const action = deployGlobalAsset(filePath, content, newGlobalState, 'update');
+            pushAction(action, filePath, created, updated, skipped, appended);
         }
-        // REV-1805：read-merge-write 全部置于锁内，消除与 model-config 锁内读写的 TOCTOU 竞态
-        const globalJsoncNew = withFileLock(globalLockPath('global-opencode-jsonc'), () => {
-            // 安全读取（T50）：目录占位/不可读 → null，跳过合并与写入，按空配置继续
-            const current = readJsoncFile(globalJsoncPath);
-            if (current === null) {
-                return null;
+        // 3. 全局 opencode.jsonc：深度合并（保留用户字段），加全局锁 + 原子写
+        const globalJsoncPath = getGlobalOpencodeJsoncPath();
+        try {
+            // 写前备份（B3）：备份须在 jsonc 锁之外（之前）完成，避免 backup 锁与 jsonc 锁嵌套
+            const globalJsoncBackup = backupFileBeforeWrite(globalJsoncPath, { command: 'update' });
+            if (globalJsoncBackup) {
+                appendUpdateInfo('backed', { absolutePath: globalJsoncPath, backupRel: globalJsoncBackup.backupRel, command: 'update' });
+                notifyBackupIfTTY(globalJsoncBackup.backupRel);
             }
-            let merged;
-            // 合并可能因块注释 parse 失败抛异常（parseJsonc 边界）：降级为「跳过合并、保留原文件」并告警
-            try {
-                merged = mergeGlobalOpencodeJsonc(current);
+            // REV-1805：read-merge-write 全部置于锁内，消除与 model-config 锁内读写的 TOCTOU 竞态
+            const globalJsoncNew = withFileLock(globalLockPath('global-opencode-jsonc'), () => {
+                // 安全读取（T50）：目录占位/不可读 → null，跳过合并与写入，按空配置继续
+                const current = readJsoncFile(globalJsoncPath);
+                if (current === null) {
+                    return null;
+                }
+                let merged;
+                // 合并可能因块注释 parse 失败抛异常（parseJsonc 边界）：降级为「跳过合并、保留原文件」并告警
+                try {
+                    merged = mergeGlobalOpencodeJsonc(current);
+                }
+                catch (err) {
+                    console.warn(t('update.globalJsoncParseSkipTmpl', getCliLang(projectPath), { err: err.message }));
+                    merged = current;
+                }
+                atomicWriteFileSync(globalJsoncPath, merged);
+                return merged;
+            });
+            if (globalJsoncNew !== null) {
+                updateFileHash(newGlobalState, globalJsoncPath, globalJsoncNew);
             }
-            catch (err) {
-                console.warn(t('update.globalJsoncParseSkipTmpl', getCliLang(projectPath), { err: err.message }));
-                merged = current;
+        }
+        catch (err) {
+            if (err instanceof BackupError) {
+                // 备份失败（REV-011-A）：跳过全局 jsonc 写入、记 anomaly、继续其余步骤（对齐 B3 幂等语义）
+                appendUpdateInfo('anomaly', { absolutePath: globalJsoncPath, note: 'backup_failed' });
+                console.warn(t('update.globalJsoncWriteSkipTmpl', getCliLang(projectPath), { err: err.message }));
+            }
+            else {
+                throw err; // 非备份错误照旧上抛（锁超时等不回退）
             }
-            atomicWriteFileSync(globalJsoncPath, merged);
-            return merged;
-        });
-        if (globalJsoncNew !== null) {
-            updateFileHash(newGlobalState, globalJsoncPath, globalJsoncNew);
         }
-    }
-    catch (err) {
-        if (err instanceof BackupError) {
-            // 备份失败（REV-011-A）：跳过全局 jsonc 写入、记 anomaly、继续其余步骤（对齐 B3 幂等语义）
-            appendUpdateInfo('anomaly', { absolutePath: globalJsoncPath, note: 'backup_failed' });
-            console.warn(t('update.globalJsoncWriteSkipTmpl', getCliLang(projectPath), { err: err.message }));
+        // 4. 项目 opencode.jsonc：不存在则写最小 { $schema }；已存在则保留（旧非法字段清理属 stage-39）
+        const projectJsoncPath = resolve(projectPath, 'opencode.jsonc');
+        if (!existsSync(projectJsoncPath)) {
+            atomicWriteFileSync(projectJsoncPath, JSON.stringify(buildProjectOpencodeJsoncObj(), null, 2) + '\n');
+            created.push('opencode.jsonc');
         }
         else {
-            throw err; // 非备份错误照旧上抛（锁超时等不回退）
+            skipped.push('opencode.jsonc (use existing)');
         }
     }
-    // 4. 项目 opencode.jsonc：不存在则写最小 { $schema }；已存在则保留（旧非法字段清理属 stage-39）
-    const projectJsoncPath = resolve(projectPath, 'opencode.jsonc');
-    if (!existsSync(projectJsoncPath)) {
-        atomicWriteFileSync(projectJsoncPath, JSON.stringify(buildProjectOpencodeJsoncObj(), null, 2) + '\n');
-        created.push('opencode.jsonc');
-    }
-    else {
-        skipped.push('opencode.jsonc (use existing)');
+    // claude 分支：CLAUDE.md + 9 agent + 17 共享 skill + settings.json（stage-73）
+    if (wantClaude) {
+        const claudeAgentsDir = getClaudeAgentsDir();
+        const claudeSkillsDir = getClaudeSkillsDir();
+        mkdirSync(claudeAgentsDir, { recursive: true });
+        mkdirSync(claudeSkillsDir, { recursive: true });
+        // 1c. CLAUDE.md（受管区三态复用 deployGlobalAsset；用户已有 → append 不覆盖）
+        const claudeMd = getClaudeMdPath();
+        pushAction(deployGlobalAsset(claudeMd, loadClaudeConstraintTemplate(lang), newGlobalState, 'update'), claudeMd, created, updated, skipped, appended);
+        // 2c. 9 agents（含 feel）
+        for (const name of listClaudeAgentIds(lang)) {
+            const p = join(claudeAgentsDir, `${name}.md`);
+            pushAction(deployGlobalAsset(p, loadClaudeAgentTemplate(lang, name), newGlobalState, 'update'), p, created, updated, skipped, appended);
+        }
+        // 3c. 17 共享 skills
+        for (const [name, content] of Object.entries(SKILL_DEFINITIONS)) {
+            const dir = join(claudeSkillsDir, name);
+            mkdirSync(dir, { recursive: true });
+            const p = join(dir, 'SKILL.md');
+            pushAction(deployGlobalAsset(p, content, newGlobalState, 'update'), p, created, updated, skipped, appended);
+        }
+        // 4c. settings.json（与 setup 对称，共享 applyClaudeSettings，杜绝双实现漂移）
+        const settingsPath = getClaudeSettingsPath();
+        pushAction(applyClaudeSettings(newGlobalState, 'update', getCliLang(projectPath)), settingsPath, created, updated, skipped, appended);
     }
-    // 重启提醒（仅在 opencode 全局 agent 配置更新时，且为交互模式）
-    if (updated.some((f) => f.startsWith(getGlobalAgentsDir())) && process.stdout.isTTY) {
+    // 重启提醒（按 harness 组合；isTTY 守卫、非交互静默）
+    if (process.stdout.isTTY) {
         const reminderLang = getCliLang(projectPath);
-        console.log(reminderLang === 'en'
-            ? 'opencode global configuration updated. Please restart opencode to load the new configuration.'
-            : 'opencode 全局配置已更新，请重启 opencode 以加载新配置。');
+        const opencodeChanged = updated.some((f) => f.startsWith(getGlobalAgentsDir()));
+        const claudeChanged = [...created, ...updated, ...appended].some((f) => f.startsWith(getClaudeAgentsDir()) || f.startsWith(getClaudeSkillsDir())
+            || f === getClaudeMdPath() || f === getClaudeSettingsPath());
+        const harnesses = [];
+        if (opencodeChanged) {
+            harnesses.push('opencode');
+        }
+        if (claudeChanged) {
+            harnesses.push('Claude Code');
+        }
+        if (harnesses.length > 0) {
+            console.log(t('update.restartHarnessTmpl', reminderLang, { harness: harnesses.join(' / ') }));
+            if (claudeChanged) {
+                console.log(t('update.claudeReloadHintTmpl', reminderLang));
+            }
+        }
     }
     // ── 写入冲突标记文件 ──
     if (conflicts.length > 0) {
@@ -1692,6 +1889,8 @@ export function updateProject(projectPath, selectedTools = ["opencode"], lang =
     // 更新时间戳
     newState.last_update = new Date().toISOString();
     newGlobalState.last_update = new Date().toISOString();
+    // stage-66/D-A：部署完成即刷新「已部署版本」事实源（既有 state 与首次创建均覆盖）
+    newGlobalState.openfeel_version = getOpenfeelVersion();
     // 持久化双 state
     saveUpdateState(projectPath, newState);
     saveGlobalUpdateState(newGlobalState);
@@ -1741,6 +1940,18 @@ function getIncomingContent(relativePath, lang) {
         const name = basename(dirname(relativePath));
         return SKILL_DEFINITIONS[name] ?? '';
     }
+    // Claude 全局约束 CLAUDE.md
+    if (relativePath === getClaudeMdPath()) {
+        return loadClaudeConstraintTemplate(lang);
+    }
+    // Claude agent：位于 getClaudeAgentsDir() 下的 {name}.md
+    if (relativePath.startsWith(getClaudeAgentsDir())) {
+        return loadClaudeAgentTemplate(lang, basename(relativePath, '.md'));
+    }
+    // Claude skill：位于 getClaudeSkillsDir() 下的 {name}/SKILL.md
+    if (relativePath.startsWith(getClaudeSkillsDir()) && basename(relativePath) === 'SKILL.md') {
+        return SKILL_DEFINITIONS[basename(dirname(relativePath))] ?? '';
+    }
     // 项目 opencode.jsonc
     if (relativePath === 'opencode.jsonc') {
         return JSON.stringify(buildProjectOpencodeJsoncObj(), null, 2) + '\n';