jarvis-agent-factory 3.7.3 → 3.9.0

package/package.json

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

package/src/templates/mcp-claude.json

@@ -4,7 +4,7 @@
       "command": "npx",
       "args": ["@playwright/mcp@latest"]
     },
-    "jarvis": {
+    "jarvis-engine": {
       "url": "http://localhost:3456/mcp"
     }
   }

package/src/templates/platforms/claude/commands/android.md

@@ -11,7 +11,9 @@ argument-hint: [Android 需求描述]
    - `Skill("behavioral-guidelines")`
    - `Skill("using-agent-skills")`
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断需求是否适合流水线。✅ 适合：Kotlin/Compose 页面、ViewModel/StateFlow、Room 数据库、性能优化、Google Play 审核问题修复。
 

package/src/templates/platforms/claude/commands/backend.md

@@ -12,7 +12,9 @@ argument-hint: [后端需求描述]
    - `Skill("using-agent-skills")`
 
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断当前需求是否适合流水线：
    - ❌ **不适合**：纯信息提问、单 agent 可完成的简单修改、纯文档翻译

package/src/templates/platforms/claude/commands/browser-test.md

@@ -16,7 +16,7 @@ Skill("behavioral-guidelines")
 Skill("agent-browser")
 Skill("browser-testing")
 
-代码注释语言：遵从 `behavioral-guidelines` 准则 5（注释语言约定）。
+**引擎驱动**：引擎运行时，测试完成后 `mcp__jarvis-engine__gate_enforce` 验证 Gate C2，`mcp__jarvis-engine__advance_gate` 推进。
 ```
 
 ## 步骤 1：确认测试范围

package/src/templates/platforms/claude/commands/bug-fix.md

@@ -14,6 +14,8 @@ Skill("behavioral-guidelines")
 Skill("agent-browser")
 Skill("browser-testing")
 
+**引擎驱动**：引擎运行时，修复完成后 `mcp__jarvis-engine__gate_enforce` 验证当前 Gate，`mcp__jarvis-engine__advance_gate` 推进状态机。
+
 代码注释语言：遵从 `behavioral-guidelines` 准则 5（注释语言约定）。
 ```
 

package/src/templates/platforms/claude/commands/expo.md

@@ -11,7 +11,9 @@ argument-hint: [Expo 需求描述]
    - `Skill("behavioral-guidelines")`
    - `Skill("using-agent-skills")`
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断需求是否适合流水线。✅ 适合：Expo 页面/组件、Expo Router 路由、状态管理、原生模块封装、EAS 构建配置、Bug 修复。
 

package/src/templates/platforms/claude/commands/flutter.md

@@ -11,7 +11,9 @@ argument-hint: [Flutter 需求描述]
    - `Skill("behavioral-guidelines")`
    - `Skill("using-agent-skills")`
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断需求是否适合流水线。✅ 适合：Flutter Widget 页面、Provider/Riverpod/BLoC 状态管理、路由、原生插件、性能优化、Bug 修复。
 

package/src/templates/platforms/claude/commands/frontend.md

@@ -12,7 +12,9 @@ argument-hint: [前端需求描述]
    - `Skill("using-agent-skills")`
 
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断当前需求是否适合流水线：
    - ❌ **不适合**：纯信息提问、单 agent 可完成的简单样式修改、纯文档翻译

package/src/templates/platforms/claude/commands/ios.md

@@ -11,7 +11,9 @@ argument-hint: [iOS 需求描述]
    - `Skill("behavioral-guidelines")`
    - `Skill("using-agent-skills")`
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断需求是否适合流水线。✅ 适合：SwiftUI 页面、ObservableObject 状态管理、SwiftData/Core Data、性能优化、App Store 审核问题修复。
 

package/src/templates/platforms/claude/commands/jarvis.md

@@ -13,7 +13,7 @@ description: 启动贾维斯编排模式——需求→文档→任务→计划
    Gate C1 时加载：`Skill("code-quality-gate")`
    Gate E 时加载：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
-   **引擎检查**：如果项目中有 `.jarvis/engine.db`，说明引擎已就绪。每个 Gate 通过后调用 `jarvis hook gate-advance` 推进硬状态机。
+   **引擎驱动**：引擎运行后，MCP 工具自动可用。每个 Gate 工作完成后调用 `mcp__jarvis-engine__gate_enforce` 验证条件，通过后调用 `mcp__jarvis-engine__advance_gate` 推进硬状态机。
 
 2. 判断当前需求是否适合流水线：
    - ❌ **不适合**：用户提问信息量（"有多少模块？"）、明确要求单 agent 执行、纯文档格式化翻译
@@ -112,7 +112,7 @@ Batch 3: [TASK-005, TASK-006]                ← 依赖 Batch 2 完成
 
 ## 🟠 Gate C1：代码质量门（不可绕过）
 
-实现完成后的第一道质量门。**不可绕过。** 加载 `Skill("code-quality-gate")` 执行四项检查（Lint → Type-check → Build → Deps Audit），按技能中的项目类型工具链表选择命令。全部通过后输出质量检查摘要，作为 Gate C2 前置输入。通过后 `jarvis hook gate-advance`。
+实现完成后的第一道质量门。**不可绕过。** 加载 `Skill("code-quality-gate")` 执行四项检查（Lint → Type-check → Build → Deps Audit），按技能中的项目类型工具链表选择命令。全部通过后输出质量检查摘要，作为 Gate C2 前置输入。通过后 `mcp__jarvis-engine__advance_gate({ gate: "Gate C2" })`。
 
 必须**全部**满足才能进入 Gate C2：
 - [ ] **Lint 零错误**（warning 可接受但需记录）
@@ -176,7 +176,7 @@ Gate C1（+ Gate C1.5 如适用）通过后方可进入此门。
   │     └── spawn e2e-test-worker
   │
   ├── 步骤 6：测试结果汇总 → docs/testing/...
-  ├── Gate C2 通过 → `jarvis hook gate-advance` → 进入 Gate D 评审
+  ├── Gate C2 通过 → `mcp__jarvis-engine__advance_gate({ gate: "Gate D" })` → 进入 Gate D 评审
 ```
 
 ### test_after 策略规范

package/src/templates/platforms/claude/commands/taro.md

@@ -11,7 +11,9 @@ argument-hint: [Taro 需求描述]
    - `Skill("behavioral-guidelines")`
    - `Skill("using-agent-skills")`
    Gate C1 时：`Skill("code-quality-gate")`
-   Gate E 时：`Skill("shipping-and-launch")` `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。
+   Gate E 时：`Skill("shipping-and-launch")`
+   **引擎驱动**：每个 Gate 通过后调用 mcp__jarvis-engine__gate_enforce 验证条件，mcp__jarvis-engine__advance_gate 推进硬状态机。 `Skill("git-workflow-and-versioning")` `Skill("finishing-a-development-branch")`
 
 2. 判断需求是否适合流水线。✅ 适合：Taro 页面/组件、多端适配、状态管理、性能优化、小程序审核问题修复。
 

package/src/templates/platforms/codex/skills/android/SKILL.md

@@ -11,6 +11,8 @@ description: Android 原生开发生命周期——需求→任务→计划→
 
 加载 `.codex/skills/behavioral-guidelines/` `.codex/skills/using-agent-skills/`
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ## 阶段 0
 
 确认目标 SDK 版本、Kotlin/Java、Jetpack Compose/XML、Material Design 版本、minSdk/targetSdk。

package/src/templates/platforms/codex/skills/backend/SKILL.md

@@ -12,6 +12,7 @@ description: 后端开发生命周期——需求→任务→计划→实现→
 加载 `.codex/skills/behavioral-guidelines/` `.codex/skills/using-agent-skills/`
 Gate C1: `.codex/skills/code-quality-gate/`
 Gate E: `.codex/skills/shipping-and-launch/` `.codex/skills/git-workflow-and-versioning/` `.codex/skills/finishing-a-development-branch/`
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
 
 ## 入口判断
 

package/src/templates/platforms/codex/skills/browser-test/SKILL.md

@@ -8,6 +8,7 @@ description: 浏览器自动化测试闭环——先写用例，再操作浏览
 加载此技能后进入浏览器测试模式。先写用例→执行→截图→报告→失败驱动修复闭环。
 
 ## 加载技能
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
 
 `.codex/skills/behavioral-guidelines/` `.codex/skills/agent-browser/` `.codex/skills/browser-testing/`
 

package/src/templates/platforms/codex/skills/bug-fix/SKILL.md

@@ -8,6 +8,7 @@ description: Bug 修复闭环——浏览器复现→定位根因→修复→浏
 加载此技能后进入 Bug 修复模式：浏览器复现→定位根因→修复→代码质量→浏览器验证→关闭。
 
 ## 加载技能
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
 
 `.codex/skills/behavioral-guidelines/` `.codex/skills/agent-browser/` `.codex/skills/browser-testing/`
 

package/src/templates/platforms/codex/skills/expo/SKILL.md

@@ -11,6 +11,8 @@ description: Expo 跨端开发生命周期——需求→任务→计划→实
 
 加载 `.codex/skills/behavioral-guidelines/` `.codex/skills/using-agent-skills/`
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ## 阶段 0
 
 确认 Expo SDK 版本、目标平台（iOS/Android/Web）、Expo Router、状态管理方案。

package/src/templates/platforms/codex/skills/flutter/SKILL.md

@@ -11,6 +11,8 @@ description: Flutter 跨端开发生命周期——需求→任务→计划→
 
 加载 `.codex/skills/behavioral-guidelines/` `.codex/skills/using-agent-skills/`
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ## 阶段 0
 
 确认目标平台（iOS/Android/Web/Desktop）、Dart 版本、状态管理方案（Provider/Riverpod/BLoC）。

package/src/templates/platforms/codex/skills/frontend/SKILL.md

@@ -13,6 +13,8 @@ description: 前端开发生命周期——需求→任务→计划→实现→
 Gate C1: `.codex/skills/code-quality-gate/`
 Gate E: `.codex/skills/shipping-and-launch/` `.codex/skills/git-workflow-and-versioning/` `.codex/skills/finishing-a-development-branch/`
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ## 入口判断
 
 - 不适合：纯信息提问、单 agent 可完成的简单样式修改、纯文档翻译

package/src/templates/platforms/codex/skills/ios/SKILL.md

@@ -11,6 +11,8 @@ description: iOS 原生开发生命周期——需求→任务→计划→实现
 
 加载 `.codex/skills/behavioral-guidelines/` `.codex/skills/using-agent-skills/`
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ## 阶段 0
 
 确认 Swift/SwiftUI、iOS 版本目标、HIG 要求、设备适配（iPhone/iPad）。

package/src/templates/platforms/codex/skills/jarvis/SKILL.md

@@ -42,6 +42,8 @@ description: 贾维斯编排模式——需求→文档→任务→计划→实
 
 ## 闸门门禁（A→B→C→C1→C1.5→C2→D→E，不可绕过）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 - **Gate A**：需求文档落盘、状态 confirmed、至少 1 轮提问已完成
 - **Gate B**：每个 TASK-XXX 映射至少 1 个 REQ-XXX、DDD/TDD 分类完整
 - **Gate C**：计划文档包含 parallel_batches、共享区域唯一责任方、Execution Packet

package/src/templates/platforms/codex/skills/taro/SKILL.md

@@ -11,6 +11,8 @@ description: Taro 小程序/H5 开发生命周期——需求→任务→计划
 
 加载 `.codex/skills/behavioral-guidelines/` `.codex/skills/using-agent-skills/`
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ## 阶段 0
 
 确认目标端（微信/支付宝/百度/字节小程序 + H5）、Taro 版本、React/Vue 框架、分包策略。

package/src/templates/platforms/opencode/agents/android.md

@@ -58,6 +58,8 @@ permission:
 
 ## 🚪 闸门门禁（A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A → Gate B → Gate C（标准）
 需求文档落盘、REQ-XXX 映射、parallel_batches + Execution Packet。
 

package/src/templates/platforms/opencode/agents/backend.md

@@ -99,6 +99,8 @@ permission:
 
 ## 🚪 闸门门禁（硬性阻断，顺序 A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A：需求 → 任务分解
 - [ ] 需求文档落盘 `docs/requirements/`，状态 `confirmed`
 - [ ] 需求有 `REQ-XXX` 编号、优先级、可验证验收标准

package/src/templates/platforms/opencode/agents/expo.md

@@ -59,6 +59,8 @@ permission:
 
 ## 🚪 闸门门禁（A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A → Gate B → Gate C（标准）
 需求文档落盘、REQ-XXX 映射、parallel_batches + Execution Packet。
 

package/src/templates/platforms/opencode/agents/flutter.md

@@ -59,6 +59,8 @@ permission:
 
 ## 🚪 闸门门禁（A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A → Gate B → Gate C（标准）
 需求文档落盘、REQ-XXX 映射、parallel_batches + Execution Packet。
 

package/src/templates/platforms/opencode/agents/frontend.md

@@ -97,6 +97,8 @@ permission:
 
 ## 🚪 闸门门禁（硬性阻断，顺序 A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A：需求 → 任务分解
 - [ ] 需求文档落盘 `docs/requirements/`，状态 `confirmed`
 - [ ] 需求有 `REQ-XXX` 编号、优先级、可验证验收标准

package/src/templates/platforms/opencode/agents/ios.md

@@ -58,6 +58,8 @@ permission:
 
 ## 🚪 闸门门禁（A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A → Gate B → Gate C（标准）
 需求文档落盘、REQ-XXX 映射、parallel_batches + Execution Packet。
 

package/src/templates/platforms/opencode/agents/jarvis.md

@@ -21,6 +21,8 @@ permission:
 
 > 这两个技能是所有后续决策和执行的基础，缺一不可。
 
+**引擎驱动**：引擎运行时 MCP 工具自动可用。每个 Gate 通过后：`mcp__jarvis-engine__gate_enforce` 验证条件 → `mcp__jarvis-engine__advance_gate` 推进硬状态机。
+
 ## 主线流程（唯一入口）
 
 编排只有一条主线：**（想法细化）→ 澄清需求 → 生成并确认需求文档 → 任务分解 → 执行规划 → 分配实现 → 评审交付 → 发布上线**。

package/src/templates/platforms/opencode/agents/taro.md

@@ -58,6 +58,8 @@ permission:
 
 ## 🚪 闸门门禁（A→B→C→C1→C2→D→E）
 
+**引擎驱动**：每个 Gate 通过后调用引擎 MCP：gate_enforce 验证条件，gate_advance 推进硬状态机。
+
 ### Gate A → Gate B → Gate C（标准）
 需求文档落盘、REQ-XXX 映射、parallel_batches + Execution Packet。注意小程序分包策略和体积限制。