jarvis-agent-factory 2.0.3 → 2.1.1

package/.claude/agents/planner.md

@@ -61,6 +61,31 @@ model: deepseek-v4-pro
 - TDD 任务的 Red→Green→Refactor 必须串行
 - 不同 TDD 任务的 Red 步骤可并行
 
+### 技能分配规则
+
+根据任务类型和 test_strategy，在 Execution Packet 中指定 `required_skills`。子 Agent 收到后会在启动时加载这些技能。
+
+| 任务场景 | required_skills（基础 + 场景） |
+|---------|------|
+| 所有任务（基础） | `behavioral-guidelines` `code-standards` |
+| 代码实现 | + `source-driven-development` `incremental-implementation` `verification-before-completion` |
+| TDD 任务 | + `test-driven-development` |
+| 前端 UI/组件 | + `source-driven-development` `incremental-implementation` `verification-before-completion` |
+| 后端业务逻辑 | + `source-driven-development` `incremental-implementation` `verification-before-completion` |
+| 代码审查 | + `code-review-and-quality` |
+| 架构设计 | + `source-driven-development` `documentation-and-adrs` |
+| 安全审计 | + `security-and-hardening` |
+| 数据层/DB | + `source-driven-development` |
+| 性能测试 | + `debugging-and-error-recovery` |
+| E2E 测试 | + `debugging-and-error-recovery` `verification-before-completion` |
+| 浏览器测试 | + `agent-browser` `browser-testing` |
+| Bug 修复 | + `source-driven-development` `debugging-and-error-recovery` |
+| 重构 | + `code-simplification` `source-driven-development` `verification-before-completion` |
+| API 文档 | + `source-driven-development` `chinese-documentation` |
+| 发布/部署 | + `shipping-and-launch` `git-workflow-and-versioning` `finishing-a-development-branch` |
+
+> 若任务有项目专属 skill（如 `.claude/skills/my-custom-skill/`），编排者可在 Execution Packet 的 `required_skills` 中追加。
+
 ### 变更规模控制
 
 单轮次所有任务的预期变更总行数不应超过 ~1000 行。超过时考虑拆分为两个轮次。
@@ -212,6 +237,7 @@ Skill(skill="behavioral-guidelines")
 ### allowed_paths: <允许修改的目录/文件>
 ### forbidden_paths: <禁止修改的共享区域>
 ### dependencies: <依赖的 API / 契约 / schema>
+### required_skills: <技能列表，按上方「技能分配规则」填写。子 Agent 启动后必须逐一 Skill() 加载>
 ### parallel_group: <可与此任务并行的任务 ID 列表>
 ### wait_for: <必须等待完成的任务 ID 列表>
 ### acceptance_criteria: <可验证的验收条件>

package/.claude/commands/jarvis.md

@@ -95,6 +95,7 @@ Batch 3: [TASK-005, TASK-006]                ← 依赖 Batch 2 完成
 - objective（一句话目标）
 - allowed_paths 和 forbidden_paths
 - dependencies（依赖的 API 契约 / Schema）
+- required_skills（子 Agent 必须逐一 Skill() 加载的技能列表）
 - acceptance_criteria（可验证的验收条件）
 - test_strategy（tdd / test_after / manual_only）
 - input_documents（上游文档路径）

package/.claude/skills/using-agent-skills/SKILL.md

@@ -124,7 +124,7 @@ Jarvis 按流程调度子 Agent
 作为编排者，你不需要在每个阶段手动加载所有技能。关键规则：
 
 1. **每个阶段只加载该阶段的核心技能**（1-3 个）
-2. **子 Agent 自己会加载执行所需的技能**——你只需在 Agent prompt 中告诉它应该加载哪个技能
+2. **通过 Execution Packet 传递技能清单**——planner 在 `required_skills` 字段指定该任务需要的技能；编排者 spawn 子 Agent 时原样传递；子 Agent 启动后逐一 `Skill()` 加载
 3. **behavioral-guidelines 是所有 Agent 的基座**——每个 Agent 都会自动遵守
 4. **context-engineering 在三个关键时刻使用**：启动新会话、任务切换、子 Agent 结果偏离预期时
 

package/README.md

@@ -1,12 +1,12 @@
 # Jarvis Agent Factory · 贾维斯智能体工厂
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
-[![Version](https://img.shields.io/badge/version-v2.0.1-green)](https://gitee.com/wujl1124/JarvisAgentFactory/releases)
+[![Version](https://img.shields.io/badge/version-v2.1.0-green)](https://gitee.com/wujl1124/JarvisAgentFactory/releases)
 <br>**简体中文** | [English](./README_EN.md)
 
 一套跨平台的多智能体（Multi-Agent）AI 编程助手配置集，定义了一条**从想法到交付的完整软件开发流水线**。支持 Claude Code、OpenCode、Codex 三平台，共享同一套工作流规范与技能体系。
 
-> **v2.0.1** — Claude Code 47 agents + 15 commands / OpenCode 55 agents（纯智能体切换） / Codex 45 agents + 42 skills（Skill 触发）
+> **v2.1.0** — Claude Code 47 agents + 15 commands / OpenCode 55 agents（纯智能体切换） / Codex 45 agents + 42 skills（Skill 触发）
 
 ## 核心概念
 
@@ -53,23 +53,33 @@
 
 ```bash
 npm i -g jarvis-agent-factory
+```
 
-# 新项目一键安装
-jarvis init ./my-project
-jarvis init -y              # 跳过确认
-
-# 按平台安装
-jarvis install claude
-jarvis install opencode
-jarvis install codex
-
-# 查看版本 / 检查更新
-jarvis version
-jarvis update
+| 命令 | 说明 |
+|------|------|
+| `jarvis` | 引导当前目录（≡ `jarvis init .`） |
+| `jarvis init [path]` | 初始化项目，安装全部三平台 + Playwright MCP 配置 |
+| `jarvis add <p...> [path]` | 添加指定平台（`claude` `opencode` `codex` 可多选） |
+| `jarvis remove <p...> [path]` | 移除指定平台 + 对应 MCP 配置 |
+| `jarvis upgrade [path]` | 升级已安装的配置到最新版本 |
+| `jarvis doctor [path]` | 健康检查 |
+| `-g, --global` | 安装到用户全局目录 `~/.claude/` 等 |
+| `-y, --yes` | 跳过覆盖确认 |
+| `-v, --version` | 查看版本 |
+| `-h, --help` | 帮助 |
 
-# 健康检查
-jarvis doctor
-jarvis list
+```bash
+# 常用
+jarvis                                  # 引导当前目录
+jarvis init my-app -y                   # 一键初始化
+jarvis add claude                       # 追加 Claude Code
+jarvis remove codex                     # 移除 Codex
+jarvis upgrade                          # 升级配置
+jarvis doctor                           # 检查
+
+# 全局安装
+jarvis init -g -y                       # 一键全局安装
+jarvis add opencode -g                  # 全局追加 OpenCode
 ```
 
 ### 手动安装

package/package.json

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

package/src/cli.js

@@ -1,7 +1,8 @@
 import { fileURLToPath } from 'node:url';
 import { dirname, resolve } from 'node:path';
-import { readFileSync } from 'node:fs';
+import { readFileSync, existsSync, rmSync } from 'node:fs';
 import { execSync } from 'node:child_process';
+import { createInterface } from 'node:readline';
 import { homedir } from 'node:os';
 import { install } from './install.js';
 import { doctor } from './doctor.js';
@@ -13,26 +14,31 @@ const PKG_VERSION = PKG.version;
 const PKG_NAME = PKG.name;
 
 const PLATFORMS = {
-  claude:  { dir: '.claude',  desc: 'Claude Code — 47 agents + 15 commands + 27 skills' },
-  opencode:{ dir: '.opencode',desc: 'OpenCode — 55 agents (智能体切换) + 27 skills' },
-  codex:   { dir: '.codex',   desc: 'Codex — 45 agents + 42 skills (Skill触发)' },
+  claude:   { dir: '.claude',  desc: 'Claude Code — 47 agents + 15 commands + 27 skills' },
+  opencode: { dir: '.opencode', desc: 'OpenCode — 55 agents + 27 skills (agent switching)' },
+  codex:    { dir: '.codex',   desc: 'Codex — 45 agents + 42 skills (skill-triggered)' },
 };
 
-const HELP = `
-🧠 Jarvis Agent Factory v${PKG_VERSION}
+const ALL_PLATFORMS = Object.keys(PLATFORMS);
+
+const HELP = `🧠 Jarvis Agent Factory v${PKG_VERSION}
+
+  Bootstrap multi-agent AI coding assistant configs
+  for Claude Code, OpenCode, and Codex.
 
 Usage:
-  jarvis init [path] [--yes|-y] [--global|-g]   初始化项目（含 Playwright MCP 配置）
-  jarvis install <platform> [path] [--yes|-y] [--global|-g]  安装指定平台
-  jarvis update [path] [--yes|-y]                更新已安装的平台配置
-  jarvis doctor [path]                           健康检查
-  jarvis version                                 查看版本 + 检查更新
-  jarvis list                                    列出可用平台
+  jarvis [path]                  ≡ jarvis init [path]
+  jarvis init [path]             Bootstrap project with all platforms + MCP
+  jarvis add <p...> [path]       Add platform(s) to project
+  jarvis remove <p...> [path]    Remove platform(s) from project
+  jarvis upgrade [path]          Upgrade to latest config version
+  jarvis doctor [path]           Verify installation
 
 Options:
-  --yes, -y       跳过覆盖确认
-  --global, -g    安装到用户全局目录（~/.claude/ etc）
-  --help, -h      显示帮助
+  -g, --global    Target user global directory instead of project
+  -y, --yes       Skip confirmation prompts
+  -h, --help      Show this help
+  -v, --version   Show version
 
 Platforms:
   claude     ${PLATFORMS.claude.desc}
@@ -40,23 +46,28 @@ Platforms:
   codex      ${PLATFORMS.codex.desc}
 
 Examples:
-  jarvis init ./my-project         # 项目级安装（含 MCP）
-  jarvis init --global -y          # 全局安装，跳过确认
-  jarvis install claude --global   # 全局安装 Claude Code
-  jarvis version                   # 查看版本
+  jarvis                          Bootstrap current directory
+  jarvis init my-app              Bootstrap new project
+  jarvis add claude opencode      Add platforms to current directory
+  jarvis add claude -g            Add Claude Code globally
+  jarvis remove codex             Remove Codex from project
+  jarvis upgrade                  Upgrade all configs
+  jarvis doctor                   Check current directory
 `;
 
 function showHelp() { console.log(HELP); }
 
-function parseFlags(args) {
-  const flags = { yes: false, global: false };
-  const cleaned = [];
-  for (const a of args) {
-    if (a === '--yes' || a === '-y') flags.yes = true;
-    else if (a === '--global' || a === '-g') flags.global = true;
-    else cleaned.push(a);
+function parseArgs(raw) {
+  const opts = { yes: false, global: false };
+  const positional = [];
+  for (const a of raw) {
+    if (a === '-y' || a === '--yes') opts.yes = true;
+    else if (a === '-g' || a === '--global') opts.global = true;
+    else if (a === '-h' || a === '--help') { opts.help = true; return { opts, positional }; }
+    else if (a === '-v' || a === '--version') { opts.version = true; return { opts, positional }; }
+    else positional.push(a);
   }
-  return { flags, args: cleaned };
+  return { opts, positional };
 }
 
 function checkLatest() {
@@ -67,80 +78,171 @@ function checkLatest() {
   } catch { return null; }
 }
 
+function resolveTarget(path, isGlobal) {
+  return isGlobal ? resolve('.') : resolve(path || '.');
+}
+
 export async function run() {
-  const rawArgs = process.argv.slice(2);
-  const { flags, args } = parseFlags(rawArgs);
-  const cmd = args[0];
+  const { opts, positional } = parseArgs(process.argv.slice(2));
 
-  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') { showHelp(); return; }
+  if (opts.help) { showHelp(); return; }
+  if (opts.version) {
+    console.log(`${PKG_NAME} v${PKG_VERSION}`);
+    const latest = checkLatest();
+    if (latest && latest !== PKG_VERSION) {
+      console.log(`\n  Update available: v${latest} → npm i -g ${PKG_NAME}@latest`);
+    }
+    return;
+  }
+
+  const cmd = positional[0];
+
+  // jarvis (no args) ≡ jarvis init .
+  if (!cmd) {
+    const target = resolve('.');
+    const scope = opts.global ? '~ (global)' : target;
+    console.log(`\n🚀 Jarvis v${PKG_VERSION}\n`);
+    console.log(`   Target: ${scope}\n`);
+    for (const name of ALL_PLATFORMS) {
+      await install({ platform: name, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: opts.yes, global: opts.global });
+    }
+    console.log(`\n✅ Done! \`jarvis doctor\` to verify.\n`);
+    return;
+  }
 
   switch (cmd) {
-    case 'version':
-    case '--version':
-    case '-v': {
-      console.log(`${PKG_NAME} v${PKG_VERSION}`);
-      const latest = checkLatest();
-      if (latest && latest !== PKG_VERSION) {
-        console.log(`\n  ⚡ Update available: v${latest} (current: v${PKG_VERSION})`);
-        console.log(`  Run: npm i -g ${PKG_NAME}@latest`);
+    case 'init': {
+      const path = positional[1];
+      const target = resolveTarget(path, opts.global);
+      const scope = opts.global ? '~ (global)' : target;
+      console.log(`\n🚀 Jarvis v${PKG_VERSION}\n`);
+      console.log(`   Target: ${scope}\n`);
+      for (const name of ALL_PLATFORMS) {
+        await install({ platform: name, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: opts.yes, global: opts.global });
       }
+      console.log(`\n✅ Done!\n`);
       break;
     }
-    case 'update': {
-      const latest = checkLatest();
-      if (latest && latest !== PKG_VERSION) {
-        console.log(`\n⬆️  CLI update: v${PKG_VERSION} → v${latest}`);
-        console.log(`   Run: npm i -g ${PKG_NAME}@latest\n`);
+
+    case 'add': {
+      const platforms = [];
+      let path = '.';
+      for (let i = 1; i < positional.length; i++) {
+        const p = positional[i];
+        if (PLATFORMS[p]) platforms.push(p);
+        else if (!p.startsWith('-')) path = p;
       }
-      const target = resolve(args[1] || '.');
-      console.log(`🔄 Updating configs → ${target}\n`);
-      for (const name of Object.keys(PLATFORMS)) {
-        await install({ platform: name, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: flags.yes, global: flags.global });
+      if (platforms.length === 0) {
+        console.error('\n❌  No valid platform specified.\n');
+        console.log(`Valid platforms: ${ALL_PLATFORMS.join(', ')}\n`);
+        return;
+      }
+      const target = resolveTarget(path, opts.global);
+      const scope = opts.global ? '~ (global)' : target;
+      console.log(`\n📦 Adding to ${scope}\n`);
+      for (const name of platforms) {
+        await install({ platform: name, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: opts.yes, global: opts.global });
       }
       console.log(`\n✅ Done!\n`);
       break;
     }
-    case 'init': {
-      const target = resolve(args[1] || '.');
-      const scope = flags.global ? `~ (global)` : target;
-      console.log(`\n🚀 Jarvis Agent Factory v${PKG_VERSION}\n`);
-      console.log(`   Target: ${scope}\n`);
-      for (const name of Object.keys(PLATFORMS)) {
-        await install({ platform: name, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: flags.yes, global: flags.global });
+
+    case 'remove':
+    case 'rm': {
+      const platforms = [];
+      let path = '.';
+      for (let i = 1; i < positional.length; i++) {
+        const p = positional[i];
+        if (PLATFORMS[p]) platforms.push(p);
+        else if (!p.startsWith('-')) path = p;
       }
-      console.log(`\n✅ Done! Run \`jarvis doctor\` to verify.\n`);
-      break;
-    }
-    case 'install': {
-      const platform = args[1];
-      if (!platform || !PLATFORMS[platform]) {
-        console.error(`\n❌ Unknown platform: ${platform || '(none)'}\n`);
-        console.log(`Available: ${Object.keys(PLATFORMS).join(', ')}\n`);
+      if (platforms.length === 0) {
+        console.error('\n❌  No valid platform specified.\n');
+        console.log(`Valid platforms: ${ALL_PLATFORMS.join(', ')}\n`);
         return;
       }
-      const target = resolve(args[2] || '.');
-      const scope = flags.global ? `~ (global)` : target;
-      console.log(`\n📦 Installing ${platform} → ${scope}\n`);
-      await install({ platform, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: flags.yes, global: flags.global });
+      const target = resolveTarget(path, opts.global);
+      const scope = opts.global ? '~ (global)' : target;
+      for (const name of platforms) {
+        const dir = opts.global ? (GLOBAL_ROOTS[name]) : resolve(target, PLATFORMS[name].dir);
+        if (existsSync(dir)) {
+          if (!opts.yes) {
+            const ok = await confirm(`  Remove ${dir}? [y/N] `);
+            if (!ok) { console.log(`  ⏭  Skipped ${name}`); continue; }
+          }
+          rmSync(dir, { recursive: true, force: true });
+          console.log(`  - ${PLATFORMS[name].dir.padEnd(10)} removed`);
+          // Also remove MCP config
+          removeMcp(name, target, opts.global);
+        } else {
+          console.log(`  ⏭  ${PLATFORMS[name].dir.padEnd(10)} not found`);
+        }
+      }
       console.log(`\n✅ Done!\n`);
       break;
     }
-    case 'doctor': {
-      const target = resolve(args[1] || '.');
-      doctor({ target, platforms: PLATFORMS, pkgRoot: PKG_ROOT });
+
+    case 'upgrade':
+    case 'update': {
+      // Check CLI self-upgrade
+      const latest = checkLatest();
+      if (latest && latest !== PKG_VERSION) {
+        console.log(`\n⬆️  CLI: v${PKG_VERSION} → v${latest}`);
+        console.log(`   npm i -g ${PKG_NAME}@latest\n`);
+      }
+      const path = positional[1];
+      const target = resolveTarget(path, opts.global);
+      const scope = opts.global ? '~ (global)' : target;
+      console.log(`🔄 Upgrading → ${scope}\n`);
+      for (const name of ALL_PLATFORMS) {
+        const dir = opts.global ? GLOBAL_ROOTS[name] : resolve(target, PLATFORMS[name].dir);
+        if (existsSync(dir)) {
+          await install({ platform: name, target, pkgRoot: PKG_ROOT, platforms: PLATFORMS, force: opts.yes, global: opts.global });
+        } else {
+          console.log(`  ⏭  ${PLATFORMS[name].dir} not installed, skipped`);
+        }
+      }
+      console.log(`\n✅ Done!\n`);
       break;
     }
-    case 'list': {
-      console.log('\n📋 Available platforms:\n');
-      for (const [name, info] of Object.entries(PLATFORMS)) {
-        console.log(`  ${name.padEnd(10)} ${info.desc}`);
-      }
-      console.log('');
+
+    case 'doctor':
+    case 'check': {
+      const path = positional[1];
+      const target = resolveTarget(path, opts.global);
+      doctor({ target, platforms: PLATFORMS, pkgRoot: PKG_ROOT, global: opts.global });
       break;
     }
+
     default: {
-      console.error(`\n❌ Unknown command: ${cmd}\n`);
+      console.error(`\n❌  Unknown command: ${cmd}\n`);
       showHelp();
     }
   }
 }
+
+const GLOBAL_ROOTS = {
+  claude:   resolve(homedir(), '.claude'),
+  opencode: resolve(homedir(), '.config', 'opencode'),
+  codex:    resolve(homedir(), '.codex'),
+};
+
+function removeMcp(platform, target, isGlobal) {
+  const files = {
+    claude:   '.mcp.json',
+    opencode: 'opencode.json',
+    codex:    '.codex/config.toml',
+  };
+  const f = files[platform];
+  if (!f) return;
+  const dest = isGlobal ? resolve(homedir(), f) : resolve(target, f);
+  if (existsSync(dest)) {
+    rmSync(dest, { recursive: true, force: true });
+    console.log(`  - ${f.padEnd(18)} removed`);
+  }
+}
+
+async function confirm(q) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(res => { rl.question(q, a => { rl.close(); res(a.toLowerCase() === 'y' || a.toLowerCase() === 'yes'); }); });
+}