jarvis-agent-factory 3.47.2 → 3.47.3

package/README.md

@@ -1,7 +1,7 @@
 # Jarvis Agent Factory · 贾维斯智能体工厂
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
-[![Version](https://img.shields.io/badge/version-v3.47.2-green)](https://github.com/Wjl1224734792/Jarvis-Agent-Factory/releases)
+[![Version](https://img.shields.io/badge/version-v3.47.3-green)](https://github.com/Wjl1224734792/Jarvis-Agent-Factory/releases)
 [![npm](https://img.shields.io/npm/v/jarvis-agent-factory)](https://www.npmjs.com/package/jarvis-agent-factory)
 [![Visual Primitives MCP](https://img.shields.io/badge/DeepSeek-Visual%20Primitives%20MCP-purple)](https://github.com/Wjl1224734792/visual-primitives-mcp)
 <br>💡 **纯文本模型（如 DeepSeek）主力用户** → 搭配 [Visual Primitives MCP](https://github.com/Wjl1224734792/visual-primitives-mcp) 获得视觉理解能力

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-agent-factory",
-  "version": "3.47.2",
+  "version": "3.47.3",
   "description": "Jarvis Agent Factory CLI — Claude Code 多智能体 AI 编程助手配置安装器 | Multi-agent AI coding assistant config installer for Claude Code",
   "keywords": [
     "jarvis",

package/dist/src/templates/platforms/claude/commands/publish.md

@@ -1,7 +1,7 @@
 ---
-description: 一键发布——质量门检查→测试→版本bump→commit→push→tag→PR→merge→release
+description: 一键发布——环境检测→质量门→测试→版本bump→commit→push→PR→合并→tag→发布
 argument-hint: [版本类型：patch|minor|major，默认patch]
-version: "3.46.3"
+version: "3.47.2"
 updated: "2026-05-14"
 ---
 
@@ -9,115 +9,237 @@ updated: "2026-05-14"
 
 立即执行以下初始化步骤：
 
-## 步骤 0：加载技能 + 前置检查
+## 步骤 0：加载技能 + 环境检测
 
 ```
 Skill("code-quality-gate")
 Skill("git-workflow-and-versioning")
 ```
 
-**前置检查（不可绕过）**：
+### 0.1 检测默认分支
 
-1. 检查当前分支：
-   - 必须在 `dev` 分支上。若不在 `dev`，报告当前分支并提示用户先切换到 `dev`。
-   - ```bash
-     git branch --show-current
-     ```
+```bash
+git remote show origin | grep "HEAD branch" | awk '{print $NF}'
+```
+
+默认分支通常为 `main` 或 `master`。记作 `<DEFAULT>`。
+
+若 `git remote show origin` 失败（无远程仓库），报告用户先配置远程仓库。
+
+### 0.2 检测工作分支
+
+```bash
+git branch --show-current
+```
+
+当前分支记作 `<CURRENT>`。
+
+- **若 `<CURRENT>` != `<DEFAULT>`**：将 `<CURRENT>` 作为工作分支使用，记作 `<WORK>`。
+- **若 `<CURRENT>` == `<DEFAULT>`**：提示用户确认工作分支名称（建议用 `dev`），然后执行：
+  ```bash
+  git checkout -b dev
+  ```
+  若 `dev` 已存在（本地或远程），改为 `git checkout dev && git pull origin dev`。
+  若用户指定了其他名称，使用用户指定的名称。记作 `<WORK>`。
+
+### 0.3 检测包管理器
+
+按优先级检测锁文件，优先使用已有锁文件的包管理器：
+
+| 锁文件 | 包管理器 | 运行脚本命令前缀 |
+|--------|---------|-----------------|
+| `package-lock.json` | npm | `npm run` |
+| `yarn.lock` | yarn | `yarn` |
+| `pnpm-lock.yaml` | pnpm | `pnpm` |
+
+若无任何锁文件，默认使用 `npm`。对应的前缀记作 `<PKG>`。以下各步骤中的脚本调用统一为 `<PKG> <script>` 格式。审计命令为 `<PKG> audit`。
 
-2. 检查工作区状态：
-   - 工作区必须干净（无未提交变更）。
-   - ```bash
-     git status --porcelain
-     ```
-   - 若有未提交变更，列出变更文件并提示用户先处理（提交或暂存）。
+### 0.4 检测版本文件
+
+按优先级检测版本声明文件：
+
+| 文件 | 项目类型 | 版本字段 |
+|------|---------|---------|
+| `package.json` | JS/TS | `version` |
+| `pyproject.toml` | Python | `[project] version` 或 `[tool.poetry] version` |
+| `Cargo.toml` | Rust | `[package] version` |
+
+若多个文件同时存在，优先使用 `package.json`。检测到的文件记作 `<VERSION_FILE>`，当前版本记作 `<CUR_VER>`。
+
+### 0.5 检测测试命令
+
+```bash
+# 若 package.json 存在且含 test 脚本
+<PKG> test -- --listTests 2>/dev/null; echo "found"
+```
+
+若检测到 `scripts.test` 则使用 `<PKG> test`，否则按以下优先级查找：
+- `Makefile` 中的 `test` 目标
+- `pytest`（Python）
+- `cargo test`（Rust）
+- `go test ./...`（Go）
+
+若无法自动检测，提示用户指定测试命令。
+
+### 0.6 汇总检测结果
+
+向用户展示并确认：
+
+```
+=== 环境检测结果 ===
+默认分支: <DEFAULT>
+工作分支: <WORK>
+包管理器: <npm|yarn|pnpm>
+版本文件: <VERSION_FILE>
+当前版本: <CUR_VER>
+测试命令: <TEST_CMD>
+===================
+```
+
+---
+
+## 步骤 1：前置检查（不可绕过）
+
+1. **工作区干净**：
+   ```bash
+   git status --porcelain
+   ```
+   若有未提交变更，列出文件并提示用户处理。
+
+2. **确认分支**：当前分支必须为 `<WORK>`（已由步骤 0.2 保证）。
+
+3. **与远程同步**：
+   ```bash
+   git fetch origin
+   git pull origin <WORK> --rebase
+   ```
 
 **前置条件不满足 → 立即停止，向用户报告具体问题和处理建议。**
 
 ---
 
-## 步骤 1：质量门（不可绕过）
+## 步骤 2：质量门（不可绕过）
+
+加载 `Skill("code-quality-gate")` 后执行四项检查。工具按项目特征自适应选择：
 
-加载 `Skill("code-quality-gate")` 后执行四项检查：
+### 2.1 Lint
 
+| 项目特征 | 检测方式 | 命令（优先脚本，回退直接调用） |
+|---------|---------|------------------------------|
+| `eslint` 配置存在 | `.eslintrc.*` / `eslint.config.*` | `<PKG> lint` 或 `npx eslint .` |
+| `oxlint` 配置存在 | `oxlintrc.*` | `<PKG> lint` 或 `npx oxlint` |
+| `ruff` 配置存在 | `ruff.toml` / `pyproject.toml[tool.ruff]` | `ruff check .` |
+| `golangci-lint` 配置 | `.golangci.yml` | `golangci-lint run` |
+| 无已知配置 | — | 跳过（标记 N/A） |
+
+### 2.2 类型检查
+
+| 项目特征 | 配置 | 命令 |
+|---------|------|------|
+| TypeScript | `tsconfig.json` | `<PKG> type-check` 或 `npx tsc --noEmit` |
+| Python + mypy | `mypy.ini` / `pyproject.toml[tool.mypy]` | `mypy .` |
+| 无类型检查配置 | — | 跳过（标记 N/A） |
+
+### 2.3 构建
+
+```bash
+<PKG> build
 ```
-┌─────────────────────────────────────────────┐
-│  质量门检查（全部通过才继续）                  │
-│                                             │
-│  1. Lint（eslint / ruff / golangci-lint）    │
-│  2. Type-check（tsc --noEmit）               │
-│  3. Build（npm run build）                   │
-│  4. Deps Audit（npm audit）                  │
-└─────────────────────────────────────────────┘
+
+若无 `build` 脚本，尝试项目级构建命令（如 `go build ./...`），无则跳过（标记 N/A）。
+
+### 2.4 依赖审计
+
+```bash
+<PKG> audit
 ```
 
-**全部通过 → 进入步骤 2**
+审计命令不可用时跳过（标记 N/A，注明该包管理器不提供审计功能）。
+
+```
+┌─────────────────────────────────────────────────┐
+│  质量门检查（全部通过才继续）                      │
+│                                                 │
+│  1. Lint（自适应: eslint/ruff/golangci-lint/...）│
+│  2. Type-check（自适应: tsc/mypy/...）           │
+│  3. Build（自适应）                             │
+│  4. Deps Audit（自适应: npm auditor/...）       │
+└─────────────────────────────────────────────────┘
+```
+
+**全部通过 → 进入步骤 3**
 
 **任意项失败**：
 1. 输出失败项的详细错误信息
 2. **立即停止**，不继续后续步骤
 3. 向用户报告：哪个检查失败、具体错误、修复建议
-4. 用户修复后重新执行 `/publish` 从步骤 1 开始
+4. 用户修复后重新执行 `/publish` 从步骤 2 开始
 
 ---
 
-## 步骤 2：测试（不可绕过）
+## 步骤 3：测试（不可绕过）
 
-运行测试套件：
+使用步骤 0.5 检测到的测试命令：
 
 ```bash
-npm test
+<TEST_CMD>
 ```
 
-**全部通过 → 进入步骤 3**
+**全部通过 → 进入步骤 4**
 
 **测试失败**：
 1. 输出失败的测试名称和错误详情
 2. **立即停止**，不继续后续步骤
 3. 向用户报告：失败测试数量、失败原因摘要
-4. 用户修复后重新执行 `/publish` 从步骤 1 开始
+4. 用户修复后重新执行 `/publish` 从步骤 2 开始
 
 ---
 
-## 步骤 3：版本递增
+## 步骤 4：版本递增
 
 加载 `Skill("git-workflow-and-versioning")` 执行版本管理。
 
-参数说明：
-- 用户可指定版本类型：`patch`（默认）、`minor`、`major`
-- 未指定则默认 `patch` 递增
+参数：用户可指定 `patch`（默认）、`minor`、`major`。未指定则默认 `patch`。
 
-1. 读取当前 `package.json` 中的 `version` 字段
-2. 按指定类型递增版本号：
+1. 从 `<VERSION_FILE>` 读取当前版本号 `<CUR_VER>`
+2. 按类型递增：
    - `patch`：X.Y.Z → X.Y.(Z+1)
    - `minor`：X.Y.Z → X.(Y+1).0
    - `major`：X.Y.Z → (X+1).0.0
-3. 更新 `package.json` 中的 `version` 字段为新版本号
-4. 输出：`版本递增：v<旧版本> → v<新版本>（类型：<patch|minor|major>）`
+3. 更新 `<VERSION_FILE>` 中的版本字段为新版本号 `<NEW_VER>`
+   - `package.json`：修改 `version` 字段
+   - `pyproject.toml`：修改 `[project]` 下 `version`，或 `[tool.poetry]` 下 `version`
+   - `Cargo.toml`：修改 `[package]` 下 `version`
+4. 若项目使用 Git tag 标注版本（非 npm 包），同时更新版本文件中的 git tag 引用
+
+输出：`版本递增：v<CUR_VER> → v<NEW_VER>（类型：<patch|minor|major>，文件：<VERSION_FILE>）`
 
 ---
 
-## 步骤 4：提交并推送
+## 步骤 5：提交并推送
 
 ```bash
-git add package.json
-git commit -m "chore: bump version to v<新版本>"
-git push origin dev
+git add <VERSION_FILE>
+git commit -m "chore: bump version to v<NEW_VER>"
+git push origin <WORK>
 ```
 
+> 若版本文件关联了锁文件（如 `package.json` 关联 `package-lock.json`），一并提交锁文件变更。
+
 推送失败时报告错误并停止。
 
 ---
 
-## 步骤 5：创建 PR（dev → main）
+## 步骤 6：创建 PR（工作分支 → 默认分支）
 
 ```bash
 gh pr create \
-  --base main \
-  --head dev \
-  --title "Release v<新版本>" \
+  --base <DEFAULT> \
+  --head <WORK> \
+  --title "Release v<NEW_VER>" \
   --body "## 发布内容
 
-- 版本：v<新版本>
+- 版本：v<NEW_VER>
 - 类型：<patch|minor|major>
 
 ## 检查清单
@@ -132,7 +254,7 @@ PR 创建失败时报告错误并停止。
 
 ---
 
-## 步骤 6：合并 PR
+## 步骤 7：合并 PR
 
 ```bash
 gh pr merge --merge
@@ -144,31 +266,31 @@ gh pr merge --merge
 
 ---
 
-## 步骤 7：在 main 上创建并推送 tag
+## 步骤 8：在默认分支上创建并推送 tag
 
-**仅在 PR 合并成功后**，在 `main` 分支上创建 tag：
+**仅在 PR 合并成功后**，在 `<DEFAULT>` 上创建 tag：
 
 ```bash
-# 1. 切换到 main 并拉取最新
-git checkout main && git pull origin main
+# 1. 切换到默认分支并拉取最新
+git checkout <DEFAULT> && git pull origin <DEFAULT>
 
-# 2. 在 main 上创建 tag（只在这里，不在 dev 上打 tag）
-git tag -a v<新版本> -m "Release v<新版本>"
+# 2. 在默认分支上创建 tag（只在这里，不在工作分支上打 tag）
+git tag -a v<NEW_VER> -m "Release v<NEW_VER>"
 
-# 3. 推送 tag（唯一一次触发 release workflow）
-git push origin v<新版本>
+# 3. 推送 tag
+git push origin v<NEW_VER>
 ```
 
-> **关键**：tag 只在 `main` 上创建，确保 release workflow 只触发一次。不要在 `dev` 上打 tag。
+> **关键**：tag 只在默认分支上创建，确保 release workflow 只触发一次。不要在工作分支上打 tag。
 
 推送失败时报告错误并停止。
 
 ---
 
-## 步骤 8：切回 dev 并报告结果
+## 步骤 9：切回工作分支并报告结果
 
 ```bash
-git checkout dev
+git checkout <WORK>
 ```
 
 输出发布完成报告：
@@ -176,14 +298,18 @@ git checkout dev
 ```
 ## 发布完成报告
 
-- 版本：v<旧版本> → v<新版本>
+- 版本：v<CUR_VER> → v<NEW_VER>
 - 类型：<patch|minor|major>
-- 质量门：✅ 通过
-- 测试：✅ 通过
+- 包管理器：<npm|yarn|pnpm>
+- 版本文件：<VERSION_FILE>
+- 默认分支：<DEFAULT>
+- 工作分支：<WORK>
+- 质量门：通过
+- 测试：通过
 - Commit：<commit hash>
-- Tag：v<新版本>（指向 main）
+- Tag：v<NEW_VER>（指向 <DEFAULT>）
 - PR：#<PR number>（已合并）
-- 当前分支：dev
+- 当前分支：<WORK>
 ```
 
 ---
@@ -191,31 +317,36 @@ git checkout dev
 ## 流程总览
 
 ```
-步骤 0: 前置检查（dev 分支 + 工作区干净）
+步骤 0: 环境检测（分支名 + 包管理器 + 版本文件 + 测试命令）
   ↓
-步骤 1: 质量门（Lint + Type-check + Build + Audit）
+步骤 1: 前置检查（工作区干净 + 正确分支 + 拉取最新）
+  ↓
+步骤 2: 质量门（Lint + Type-check + Build + Audit）[自适应工具]
   ↓ 全部通过
-步骤 2: 测试（npm test）
+步骤 3: 测试（自适应测试命令）
   ↓ 全部通过
-步骤 3: 版本递增（patch/minor/major）
+步骤 4: 版本递增（patch/minor/major，自适应版本文件）
   ↓
-步骤 4: 提交并推送（commit package.json + push dev）
+步骤 5: 提交并推送（commit VERSION_FILE + push 工作分支）
   ↓
-步骤 5: 创建 PR（dev → main）
+步骤 6: 创建 PR（工作分支 → 默认分支）
   ↓
-步骤 6: 合并 PR
+步骤 7: 合并 PR
   ↓
-步骤 7: 在 main 上创建并推送 tag（触发 release workflow）
+步骤 8: 在默认分支上创建并推送 tag
   ↓
-步骤 8: 切回 dev + 报告完成
+步骤 9: 切回工作分支 + 报告完成
 ```
 
+---
+
 ## 红线
 
-- 不在 `dev` 分支上发布（直接从其他分支发布会导致版本混乱）
+- 不确认分支关系就发布（可能导致版本混乱）
 - 工作区不干净时发布（未提交变更混入发布）
 - 质量门失败仍继续（带问题的代码不能发布）
 - 测试失败仍继续（回归未发现的发布是事故）
 - 手动修改版本号而不使用版本递增流程（破坏版本号一致性）
-- tag 不指向 `main` 分支（tag 应指向正式发布分支，只在 main 上打 tag）
-- 使用 `--squash` 合并 PR（丢失 dev 分支的提交历史细节）
+- tag 不指向默认分支（tag 应指向正式发布分支，确保 release workflow 正确触发）
+- 使用 `--squash` 合并 PR（丢失工作分支的提交历史细节）
+- 硬编码包管理器命令而不使用环境检测结果（导致非 npm 项目命令无效）

package/dist/src/templates/platforms/claude/commands/sync.md

@@ -1,65 +1,94 @@
 ---
-description: 同步项目文件——更新指令/技能/文档到最新版，清理过时缓存
-argument-hint: [--dry-run 预览模式]
-version: "3.46.3"
+description: 同步项目文件——从 npm 模板同步最新指令/技能/智能体到项目 .claude/ 目录
+argument-hint: [--dry-run 预览模式] [--force 强制覆盖自定义内容]
+version: "3.47.2"
 updated: "2026-05-14"
 ---
 
 # 同步项目文件
 
-立即执行以下同步流程：
+从 `jarvis-agent-factory` npm 包的模板目录同步最新配置到当前项目的 `.claude/` 目录。
 
-## 1. 同步指令
+## 步骤 0：定位模板源
 
-从模板 `src/templates/platforms/claude/commands/` 同步最新命令到 `.claude/commands/`：
+模板文件随 npm 包分发。按以下优先级定位：
 
-- 扫描模板目录下所有 `.md` 文件
-- 按文件名匹配目标目录，若模板比目标新则覆盖
-- 目标目录不存在的文件直接创建
-- 跳过 `jarvis-lite.md`、`jarvis.md` 等由引擎动态控制的命令文件（以引擎内置版本为准）
+1. **项目本地安装**（优先）：
+   ```
+   <项目根>/node_modules/jarvis-agent-factory/dist/src/templates/platforms/claude/
+   ```
 
-## 2. 同步技能
+2. **全局安装**（本地未安装时）：
+   执行 `npm root -g` 获取全局 node_modules 路径，拼接 `/jarvis-agent-factory/dist/src/templates/platforms/claude/`
 
-从模板 `src/templates/platforms/claude/skills/` 同步最新技能到 `.claude/skills/`：
+3. **未找到**：输出以下提示并**停止**：
+   ```
+   未找到 jarvis-agent-factory 模板源。
 
-- 扫描模板 `skills/` 下的子目录，每个子目录是一个技能
-- 目标 `.claude/skills/` 不存在则创建
-- 按目录比对，模板中的新增/更新技能同步到目标
+   请先安装：
+     npm install jarvis-agent-factory
+
+   或全局安装后使用 jarvis CLI 同步：
+     npm install -g jarvis-agent-factory
+     jarvis init --yes
+   ```
+
+> 模板路径在 npm 包内（`node_modules/jarvis-agent-factory/dist/src/templates/`），不要使用项目仓库内的 `src/templates/` 路径。普通用户项目中没有该目录。
+
+> 若项目已安装 `jarvis` CLI，可直接执行 `jarvis init --yes` 完成同步——该命令使用 SHA256 hash 三级对比和 Markdown section 级冲突标记，比手动比对更精确。执行后跳过以下手动步骤。
 
-## 3. 同步核心文档
+## 步骤 1：同步指令
 
-更新以下核心文档，确保与代码变更一致：
+从 `<模板源>/commands/` 同步到 `.claude/commands/`：
 
-- `CLAUDE.md` — 检查命令列表、路径引用、版本号是否与当前代码匹配
-- `AGENTS.md` — 检查约束项、流程描述、技术栈是否反映最新架构
-- `README.md` — 检查安装命令、使用方式、配置说明是否有效
-- `CHANGELOG.md` — 检查最新版本条目是否包含所有近期变更
+- 扫描模板 `commands/` 下所有 `.md` 文件
+- 对每个模板文件：
+  - 读取模板文件内容
+  - 检查目标 `.claude/commands/<文件名>` 是否存在
+  - **目标不存在** → 创建文件，写入模板内容
+  - **目标存在、内容相同** → 无需操作
+  - **目标存在、内容不同** → 默认跳过（视为用户已自定义）
+- `--force` 模式：内容不同时以模板覆盖目标
 
-比较策略：读取文件内容，对比关键字段（命令名、路径、版本号、模块列表），发现不一致则报告并修复。
+## 步骤 2：同步技能
 
-## 4. 清理过时文件
+从 `<模板源>/skills/` 同步到 `.claude/skills/`：
 
-扫描 `.claude/` 目录下不再需要的缓存和临时文件：
+- 扫描模板 `skills/` 下的子目录，每个子目录是一个技能
+- 对每个技能目录，逐文件比对：
+  - **目标不存在** → 递归创建整个技能目录
+  - **目标存在** → 逐文件比对：
+    - 模板有、目标无 → 新增文件
+    - 模板有、目标有、内容相同 → 跳过
+    - 模板有、目标有、内容不同 → 默认跳过（用户已自定义）
+    - 目标有、模板无 → 跳过（用户自行添加的文件，不删除）
+
+## 步骤 3：同步智能体
 
-- 检查 `.claude/commands/` 中存在但模板目录已删除的文件，标记为过时
-- 检查 `.claude/skills/` 中存在但模板目录已删除的技能目录，标记为过时
-- 扫描 `.claude/` 下的 `.cache`、`.tmp`、`*.log` 等临时文件并清理
+从 `<模板源>/agents/` 同步到 `.claude/agents/`（若模板中存在 `agents/` 目录）：
 
-### 跳过目录
+- 扫描模板 `agents/` 下所有 `.md` 文件
+- 比较策略与步骤 1 相同
+- 若模板中无 `agents/` 目录 → 跳过此步骤
 
-以下目录不做任何同步或清理操作：
+## 跳过保护
 
-- `dist/` — 构建产物
-- `docs/YYYY-MM-DD/` — 日期驱动文档
-- `node_modules/` — 依赖
-- `.git/` — 版本控制
+以下情况**不做任何操作**：
+
+- 目标文件已存在且内容与模板不同 → 视为用户自定义，**不覆盖**（`--force` 除外）
+- 目标目录中存在但模板中不存在的文件/目录 → 视为用户自行添加，**不删除**
+- 以下路径始终跳过：
+  - `node_modules/`、`.git/`
+  - `dist/`、`build/`、`.next/`（构建产物）
+  - `docs/` 下含日期路径的子目录（`YYYY-MM-DD/`）
+  - `*.log`、`.cache`、`.tmp`（临时文件）
 
 ## 同步策略
 
-- **默认行为**：执行全部同步步骤（指令 + 技能 + 文档 + 清理）
-- **--dry-run 模式**：仅预览变更，列出将新增/更新/删除的文件，不实际修改任何文件
-- **增量同步**：仅更新有变化的文件，时间戳或内容比对后决定是否覆盖
-- **保守删除**：清理步骤仅删除明确标记为过时的模板文件，不对未知文件做自动删除
+- **默认模式**：仅新增模板中存在但目标中不存在的文件，不覆盖任何已有文件
+- **--dry-run 模式**：预览全部变更（新增/覆盖/跳过），不实际修改任何文件
+- **--force 模式**：模板与目标内容不同时，以模板为准覆盖目标文件
+- **保守删除**：不自动删除目标目录中的任何文件或目录
 
 ## 同步报告
 
@@ -68,19 +97,35 @@ updated: "2026-05-14"
 ```
 === 同步报告 ===
 
-【指令】新增: N  更新: N  删除: N  跳过: N
-【技能】新增: N  更新: N  删除: N  跳过: N
-【文档】已检查: CLAUDE.md AGENTS.md README.md CHANGELOG.md
-        - 更新项: xxx（描述不一致处及修复内容）
-        - 一致项: xxx（确认无需修改）
-【清理】已清理: N 个文件/目录（列出路径）
-
-总计变更: N  预览模式: 是/否
+模板源: <绝对路径>
+模式: 正常 / --dry-run / --force
+
+【指令】(.claude/commands/)
+  新增: N 个
+    + <文件名1>
+    + <文件名2>
+  更新: N 个（--force 覆盖）
+    ~ <文件名>
+  跳过: N 个（用户已自定义）
+    · <文件名>（目标存在且内容不同）
+  一致: N 个（无需操作）
+
+【技能】(.claude/skills/)
+  新增: N  更新: N  跳过: N  一致: N
+  （列出各分类下的具体技能名）
+
+【智能体】(.claude/agents/)
+  新增: N  更新: N  跳过: N  一致: N
+  （若模板中无 agents 目录则显示"模板中无 agents 目录，已跳过"）
+
+总计: 新增 N / 更新 N / 跳过 N / 一致 N
+预览模式: 是 / 否
 ```
 
 ## 运行约束
 
 - 所有文件操作使用绝对路径
-- 文档对比需实际读取文件内容，禁止仅凭猜测判断
-- 模板过时但目标文件存在新内容时不强制覆盖（以目标为准）
-- `--dry-run` 模式下不执行任何写操作
+- 文件对比需实际读取内容，禁止仅凭文件名或猜测判断
+- `--dry-run` 模式下**不执行任何写操作**
+- 不修改 `.claude/settings.json`、`.mcp.json` 等配置文件（这些由 `jarvis init` 统一管理）
+- 路径分隔符使用 `/`（Unix 风格，跨平台兼容）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jarvis-agent-factory",
-  "version": "3.47.2",
+  "version": "3.47.3",
   "description": "Jarvis Agent Factory CLI — Claude Code 多智能体 AI 编程助手配置安装器 | Multi-agent AI coding assistant config installer for Claude Code",
   "keywords": [
     "jarvis",