prizmkit 1.0.127 → 1.0.129

package/src/external-skills.js

@@ -1,11 +1,14 @@
 /**
  * External Skills Installer
  *
- * Delegates to `npx skills add <repo> --skill <name> --yes` to fetch the skill.
- * When run non-interactively (stdio: 'pipe'), npx skills only writes the canonical
- * .agents/skills/<name>/SKILL.md without creating any platform symlinks.
- * We read that file, copy it to the selected platform dir(s), then clean up
- * .agents/ and skills-lock.json.
+ * Delegates to `npx skills add <repo> [--skill <name>] --yes` to fetch skills.
+ * Supports two modes:
+ *   - Single skill: `--skill <name>` selects one skill from a repo
+ *   - Install all:  installs all skills from a repo (e.g. pbakaus/impeccable)
+ *
+ * When run non-interactively (stdio: 'pipe'), npx skills writes canonical
+ * .agents/skills/<name>/SKILL.md files. We copy those to the selected
+ * platform dir(s), then clean up .agents/ and skills-lock.json.
  */
 
 import { execSync } from 'node:child_process';
@@ -14,8 +17,9 @@ import fs from 'fs-extra';
 
 /**
  * @param {Object} skill        - Skill definition from external_skills.known
- *   skill.repo  {string}       - GitHub URL
- *   skill.name  {string}       - Skill name as listed in the repo
+ *   skill.repo       {string}  - GitHub short ref (e.g. "pbakaus/impeccable") or full URL
+ *   skill.name       {string}  - Skill name (used for display / single-skill mode)
+ *   skill.installAll {boolean} - If true, install all skills from the repo
  * @param {string} platform     - 'claude' | 'codebuddy' | 'both'
  * @param {string} projectRoot  - Target project root
  * @param {boolean} dryRun
@@ -25,35 +29,60 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
     throw new Error(`Skill "${skill.name}" has no repo URL defined`);
   }
 
-  const cmd = `npx skills add ${skill.repo} --skill ${skill.name} --yes`;
+  // installAll: install entire repo (all skills), otherwise install single skill by name
+  const cmd = skill.installAll
+    ? `npx skills add ${skill.repo} --yes`
+    : `npx skills add ${skill.repo} --skill ${skill.name} --yes`;
 
   if (dryRun) {
-    const targets = getTargetDirs(platform, projectRoot)
-      .map(d => path.relative(projectRoot, path.join(d, skill.name, 'SKILL.md')));
     console.log(`      [dry-run] ${cmd}`);
-    for (const t of targets) console.log(`      [dry-run] → ${t}`);
+    if (skill.installAll) {
+      console.log(`      [dry-run] → all skills from ${skill.repo}`);
+    } else {
+      const targets = getTargetDirs(platform, projectRoot)
+        .map(d => path.relative(projectRoot, path.join(d, skill.name, 'SKILL.md')));
+      for (const t of targets) console.log(`      [dry-run] → ${t}`);
+    }
     return;
   }
 
-  // stdio: 'pipe' → npx skills runs non-interactively, writes only .agents/skills/<name>/SKILL.md
-  execSync(cmd, { cwd: projectRoot, stdio: 'pipe', timeout: 60000 });
+  // stdio: 'pipe' → npx skills runs non-interactively
+  execSync(cmd, { cwd: projectRoot, stdio: 'pipe', timeout: 120000 });
 
-  const canonicalSkillMd = path.join(projectRoot, '.agents', 'skills', skill.name, 'SKILL.md');
-  if (!await fs.pathExists(canonicalSkillMd)) {
-    throw new Error(`npx skills did not produce .agents/skills/${skill.name}/SKILL.md`);
-  }
+  const agentsSkillsDir = path.join(projectRoot, '.agents', 'skills');
+
+  if (skill.installAll) {
+    // Repo-level install: copy ALL skill dirs from .agents/skills/ to platform dirs
+    if (!await fs.pathExists(agentsSkillsDir)) {
+      throw new Error(`npx skills did not produce .agents/skills/ for repo ${skill.repo}`);
+    }
+    const skillDirs = (await fs.readdir(agentsSkillsDir, { withFileTypes: true }))
+      .filter(d => d.isDirectory())
+      .map(d => d.name);
+
+    for (const targetDir of getTargetDirs(platform, projectRoot)) {
+      for (const skillName of skillDirs) {
+        const srcDir = path.join(agentsSkillsDir, skillName);
+        const destDir = path.join(targetDir, skillName);
+        await fs.remove(destDir).catch(() => {});
+        await fs.copy(srcDir, destDir);
+      }
+    }
+  } else {
+    // Single-skill install
+    const canonicalSkillMd = path.join(agentsSkillsDir, skill.name, 'SKILL.md');
+    if (!await fs.pathExists(canonicalSkillMd)) {
+      throw new Error(`npx skills did not produce .agents/skills/${skill.name}/SKILL.md`);
+    }
 
-  const content = await fs.readFile(canonicalSkillMd, 'utf8');
-
-  // Copy to selected platform dir(s)
-  // npx skills may have created symlinks (e.g. .claude/skills/<name> -> ../../.agents/skills/<name>)
-  // We must remove those symlinks first so we can write a real directory with the actual content.
-  for (const targetDir of getTargetDirs(platform, projectRoot)) {
-    const skillDir = path.join(targetDir, skill.name);
-    // Remove any existing symlink or directory at this path before creating a real dir
-    await fs.remove(skillDir).catch(() => {});
-    await fs.ensureDir(skillDir);
-    await fs.writeFile(path.join(skillDir, 'SKILL.md'), content);
+    const content = await fs.readFile(canonicalSkillMd, 'utf8');
+
+    for (const targetDir of getTargetDirs(platform, projectRoot)) {
+      const skillDir = path.join(targetDir, skill.name);
+      await fs.remove(skillDir).catch(() => {});
+      await fs.ensureDir(skillDir);
+      await fs.writeFile(path.join(skillDir, 'SKILL.md'), content);
+    }
   }
 
   // Clean up npx skills artifacts after copying

package/src/gitignore-template.js

@@ -30,6 +30,12 @@ export function generateGitignore(options = {}) {
     );
   }
 
+  lines.push(
+    '# Playwright CLI 快照和截图',
+    '.playwright-cli/',
+    '',
+  );
+
   lines.push(
     '# ===========================',
     '# Common',

package/src/index.js

@@ -67,6 +67,7 @@ export async function runScaffold(directory, options) {
       skills: options.skills || 'full',
       team: options.team !== false,
       pipeline: options.pipeline !== false,
+      playwrightCli: options.playwrightCli !== false,
       rules: options.rules || 'recommended',
       aiCli: options.aiCli || '',
       externalSkills: options.externalSkills ? options.externalSkills.split(',').map(s => s.trim()).filter(Boolean) : [],
@@ -202,6 +203,12 @@ export async function runScaffold(directory, options) {
       default: true,
     });
 
+    // 4.5. Playwright CLI (browser interaction support)
+    const playwrightCli = await confirm({
+      message: '安装浏览器交互工具 (playwright-cli)? 支持 UI 自动验证',
+      default: true,
+    });
+
     // 5. Rules 预设
     const rulesPreset = await select({
       message: '安装 AI 行为规则 (rules):',
@@ -227,6 +234,7 @@ export async function runScaffold(directory, options) {
     console.log(`    技能:       ${chalk.cyan(suiteLabel)}`);
     console.log(`    团队模式:   ${team ? chalk.green('启用') : chalk.gray('禁用')}`);
     console.log(`    流水线:     ${pipeline ? chalk.green('启用') : chalk.gray('禁用')}`);
+    console.log(`    浏览器工具: ${playwrightCli ? chalk.green('启用') : chalk.gray('禁用')}`);
     console.log(`    规则:       ${chalk.cyan(rulesPreset)}`);
     if (aiCli) console.log(`    AI CLI:     ${chalk.cyan(aiCli)}`);
     if (selectedExternalSkills.length > 0) console.log(`    外部技能:   ${chalk.cyan(selectedExternalSkills.join(', '))}`);
@@ -249,6 +257,7 @@ export async function runScaffold(directory, options) {
       skills: skillSuite,
       team,
       pipeline,
+      playwrightCli,
       rules: rulesPreset,
       aiCli: aiCli || '',
       externalSkills: selectedExternalSkills,

package/src/scaffold.js

@@ -10,9 +10,10 @@
 import chalk from 'chalk';
 import fs from 'fs-extra';
 import path from 'path';
-import { readFileSync } from 'fs';
+import { readFileSync, existsSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { execSync } from 'child_process';
 import {
   loadMetadata,
   getSkillsDir,
@@ -691,6 +692,46 @@ export async function installGitignore(projectRoot, options, dryRun) {
   }
 }
 
+// ============================================================
+// Playwright CLI 安装
+// ============================================================
+
+/**
+ * 安装 playwright-cli（全局 npm 包 + workspace 初始化）
+ * 用于浏览器交互验证（browser_interaction 功能）
+ */
+export async function installPlaywrightCli(projectRoot, dryRun) {
+  if (dryRun) {
+    console.log(chalk.gray('      [dry-run] @playwright/cli (global install + workspace init)'));
+    return;
+  }
+
+  // Check if already installed
+  try {
+    execSync('playwright-cli --version', { stdio: 'pipe' });
+    console.log(chalk.green('      ✓ playwright-cli (already installed)'));
+  } catch {
+    // Not installed, install it
+    try {
+      console.log(chalk.blue('      ⏳ Installing @playwright/cli globally...'));
+      execSync('npm install -g @playwright/cli@latest', { stdio: 'pipe', timeout: 120000 });
+      console.log(chalk.green('      ✓ @playwright/cli installed globally'));
+    } catch (e) {
+      console.log(chalk.yellow(`      ⚠ @playwright/cli install failed: ${e.message}`));
+      console.log(chalk.yellow('      ⚠ Run manually: npm install -g @playwright/cli@latest'));
+      return;
+    }
+  }
+
+  // Initialize workspace
+  try {
+    execSync('playwright-cli install', { cwd: projectRoot, stdio: 'pipe', timeout: 60000 });
+    console.log(chalk.green('      ✓ playwright-cli workspace initialized'));
+  } catch (e) {
+    console.log(chalk.yellow(`      ⚠ playwright-cli workspace init skipped: ${e.message}`));
+  }
+}
+
 // ============================================================
 // 主安装函数
 // ============================================================
@@ -705,11 +746,12 @@ export async function installGitignore(projectRoot, options, dryRun) {
  * @param {string} [config.rules] - Rules preset: 'recommended' | 'minimal' | 'none'
  * @param {string} [config.aiCli] - AI CLI 可执行命令（写入 .prizmkit/config.json）
  * @param {string[]} [config.externalSkills] - 要安装的外部 skill 名称列表
+ * @param {boolean} [config.playwrightCli] - 是否安装 playwright-cli
  * @param {string} config.projectRoot - 目标项目根目录
  * @param {boolean} config.dryRun - 是否为预览模式
  */
 export async function scaffold(config) {
-  const { platform, skills, team, pipeline, rules, aiCli, externalSkills, projectRoot, dryRun } = config;
+  const { platform, skills, team, pipeline, rules, aiCli, externalSkills, playwrightCli, projectRoot, dryRun } = config;
   const platforms = platform === 'both' ? ['codebuddy', 'claude'] : [platform];
 
   if (dryRun) {
@@ -803,7 +845,14 @@ export async function scaffold(config) {
     }
   }
 
-  // 10. Clean up stray .codebuddy/ directory left by third-party tools (e.g. npx skills)
+  // 10. Playwright CLI (optional)
+  if (playwrightCli) {
+    console.log(chalk.blue('    浏览器交互工具:'));
+    await installPlaywrightCli(projectRoot, dryRun);
+    console.log('');
+  }
+
+  // 11. Clean up stray .codebuddy/ directory left by third-party tools (e.g. npx skills)
   // when installing for Claude Code only. CodeBuddy files should never appear in a
   // claude-only install.
   if (!dryRun && !platforms.includes('codebuddy')) {
@@ -890,6 +939,7 @@ export async function scaffold(config) {
     console.log(chalk.gray(`    平台: ${platforms.map(p => p === 'codebuddy' ? 'CodeBuddy' : 'Claude Code').join(' + ')}`));
     console.log(chalk.gray(`    团队: ${team ? '已启用' : '未启用'}`));
     console.log(chalk.gray(`    流水线: ${pipeline ? '已安装' : '未安装'}`));
+    console.log(chalk.gray(`    浏览器工具: ${playwrightCli ? '已安装 (playwright-cli)' : '未安装'}`));
     console.log(chalk.gray(`    规则: ${rules || 'recommended'}`));
     if (aiCli) console.log(chalk.gray(`    AI CLI: ${aiCli}`));
     console.log('');