prizmkit 1.0.17 → 1.0.19

package/bundled/VERSION.json

@@ -1,5 +1,5 @@
 {
-  "frameworkVersion": "1.0.17",
-  "bundledAt": "2026-03-15T14:53:53.793Z",
-  "bundledFrom": "527811d"
+  "frameworkVersion": "1.0.19",
+  "bundledAt": "2026-03-15T15:17:35.921Z",
+  "bundledFrom": "7fb7d0a"
 }

package/bundled/skills/_metadata.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.17",
+  "version": "1.0.19",
   "skills": {
     "prizm-kit": {
       "description": "Full-lifecycle dev toolkit. Covers spec-driven development, Prizm context docs, code quality, debugging, deployment, and knowledge management.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prizmkit",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
   "type": "module",
   "bin": {

package/src/external-skills.js

@@ -1,36 +1,18 @@
 /**
  * External Skills Installer
  *
- * Delegates to `npx skills add <repo> --skill <name> --yes` for installation,
- * then removes symlinks for platforms not selected by the user.
- *
- * npx skills creates symlinks for ALL platforms (.claude/skills/, .codebuddy/skills/,
- * .trae/skills/, skills/, .agent/skills/). We keep only what the user asked for.
+ * 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.
  */
 
 import { execSync } from 'node:child_process';
 import path from 'path';
 import fs from 'fs-extra';
 
-// All platform symlink dirs that `npx skills` creates (besides .agents/ canonical store)
-const ALL_PLATFORM_DIRS = [
-  '.claude/skills',
-  '.codebuddy/skills',
-  '.trae/skills',
-  '.agent/skills',
-  'skills',
-];
-
-// Which dirs to KEEP per platform selection
-const KEEP_DIRS = {
-  claude:    ['.claude/skills'],
-  codebuddy: ['.codebuddy/skills'],
-  both:      ['.claude/skills', '.codebuddy/skills'],
-};
-
 /**
- * Install an external skill via `npx skills add`, then prune unwanted platform symlinks.
- *
  * @param {Object} skill        - Skill definition from external_skills.known
  *   skill.repo  {string}       - GitHub URL
  *   skill.name  {string}       - Skill name as listed in the repo
@@ -46,35 +28,112 @@ export async function installExternalSkill(skill, platform, projectRoot, dryRun)
   const cmd = `npx skills add ${skill.repo} --skill ${skill.name} --yes`;
 
   if (dryRun) {
-    const keepDirs = KEEP_DIRS[platform] || KEEP_DIRS.claude;
+    const targets = getTargetDirs(platform, projectRoot)
+      .map(d => path.relative(projectRoot, path.join(d, skill.name, 'SKILL.md')));
     console.log(`      [dry-run] ${cmd}`);
-    console.log(`      [dry-run] keep symlinks: ${keepDirs.map(d => path.join(d, skill.name)).join(', ')}`);
+    for (const t of targets) console.log(`      [dry-run] → ${t}`);
     return;
   }
 
-  execSync(cmd, {
-    cwd: projectRoot,
-    stdio: 'pipe',
-    timeout: 60000,
-  });
+  // stdio: 'pipe' → npx skills runs non-interactively, writes only .agents/skills/<name>/SKILL.md
+  execSync(cmd, { cwd: projectRoot, stdio: 'pipe', timeout: 60000 });
 
-  // Prune symlinks for platforms not selected
-  const keepDirs = new Set(KEEP_DIRS[platform] || KEEP_DIRS.claude);
+  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 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);
+  }
+
+  // Clean up npx skills artifacts after copying
+  await fs.remove(path.join(projectRoot, '.agents')).catch(() => {});
+  await fs.remove(path.join(projectRoot, 'skills-lock.json')).catch(() => {});
+}
+
+/**
+ * Remove all artifacts created by `npx skills` that are not needed by PrizmKit.
+ * Call this once after all external skills have been installed.
+ *
+ * @param {string} projectRoot
+ * @param {string} platform - 'claude' | 'codebuddy' | 'both'
+ */
+export async function cleanExternalSkillArtifacts(projectRoot, platform) {
+  const keepDirs = new Set(
+    getTargetDirs(platform, projectRoot).map(d => path.resolve(d))
+  );
 
-  for (const dir of ALL_PLATFORM_DIRS) {
-    const linkPath = path.join(projectRoot, dir, skill.name);
-    if (keepDirs.has(dir)) continue;
+  const dirsToCheck = [
+    '.agents',
+    '.agent',
+    '.trae',
+    'skills',
+    '.claude/skills',
+    '.codebuddy/skills',
+  ];
+
+  for (const dir of dirsToCheck) {
+    const abs = path.join(projectRoot, dir);
+    if (keepDirs.has(path.resolve(abs))) continue;
+    await fs.remove(abs).catch(() => {});
+  }
+
+  // Remove any dangling symlinks inside kept platform skill dirs
+  // (npx skills creates symlinks like .claude/skills/<name> -> ../../.agents/skills/<name>)
+  for (const keepDir of keepDirs) {
+    if (!await fs.pathExists(keepDir)) continue;
+    let entries;
+    try { entries = await fs.readdir(keepDir); } catch { continue; }
+    for (const entry of entries) {
+      const entryPath = path.join(keepDir, entry);
+      try {
+        const stat = await fs.lstat(entryPath);
+        if (stat.isSymbolicLink()) {
+          await fs.remove(entryPath);
+        }
+      } catch { /* ignore */ }
+    }
+  }
+
+  // Remove empty parent dirs left behind (e.g. .codebuddy/ after removing .codebuddy/skills)
+  const parentDirs = ['.claude', '.codebuddy', '.trae', '.agent'];
+  for (const dir of parentDirs) {
+    const abs = path.join(projectRoot, dir);
+    if (!await fs.pathExists(abs)) continue;
+    // Only remove if this platform dir is entirely unneeded
+    const isKept = getTargetDirs(platform, projectRoot)
+      .some(d => path.resolve(d).startsWith(path.resolve(abs) + path.sep));
+    if (isKept) continue;
     try {
-      const stat = await fs.lstat(linkPath);
-      if (stat.isSymbolicLink()) {
-        await fs.remove(linkPath);
-        // Remove parent dir if now empty
-        const parent = path.join(projectRoot, dir);
-        const remaining = await fs.readdir(parent).catch(() => ['_']);
-        if (remaining.length === 0) await fs.remove(parent);
+      const entries = await fs.readdir(abs);
+      if (entries.length === 0) {
+        await fs.remove(abs);
       }
-    } catch {
-      // not present, skip
-    }
+    } catch { /* ignore */ }
+  }
+
+  await fs.remove(path.join(projectRoot, 'skills-lock.json')).catch(() => {});
+}
+
+function getTargetDirs(platform, projectRoot) {
+  if (platform === 'both') {
+    return [
+      path.join(projectRoot, '.claude', 'skills'),
+      path.join(projectRoot, '.codebuddy', 'skills'),
+    ];
+  }
+  if (platform === 'codebuddy') {
+    return [path.join(projectRoot, '.codebuddy', 'skills')];
   }
+  return [path.join(projectRoot, '.claude', 'skills')];
 }

package/src/index.js

@@ -86,11 +86,46 @@ export async function runScaffold(directory, options) {
     });
 
     // 1.5. AI CLI 命令配置（独立于平台，决定实际运行的可执行命令）
-    const aiCli = await input({
-      message: '底层 AI CLI 可执行命令 (可自定义，如 claude-internal --dangerously-skip-permissions):',
-      default: detected.suggestedCli,
+    const cliChoices = [
+      {
+        name: `cbc — CodeBuddy CLI${detected.cbc ? chalk.green(' ✓ 已安装') : chalk.gray(' (未检测到)')}`,
+        value: 'cbc',
+      },
+      {
+        name: `claude — Claude Code${detected.claude ? chalk.green(' ✓ 已安装') : chalk.gray(' (未检测到)')}`,
+        value: 'claude',
+      },
+      {
+        name: '自定义 — 输入其他命令',
+        value: '__custom__',
+      },
+      {
+        name: '跳过 — 稍后手动配置',
+        value: '',
+      },
+    ];
+
+    // 如果检测到的推荐命令不在固定列表里，默认选"自定义"
+    const knownCliValues = ['cbc', 'claude'];
+    const cliDefault = knownCliValues.includes(detected.suggestedCli)
+      ? detected.suggestedCli
+      : (detected.suggestedCli ? '__custom__' : '');
+
+    const cliSelection = await select({
+      message: '选择底层 AI CLI 可执行命令:',
+      choices: cliChoices,
+      default: cliDefault,
     });
 
+    let aiCli = cliSelection;
+    if (cliSelection === '__custom__') {
+      aiCli = await input({
+        message: '输入自定义 AI CLI 命令:',
+        default: knownCliValues.includes(detected.suggestedCli) ? '' : detected.suggestedCli,
+        validate: (v) => v.trim() ? true : '请输入命令',
+      });
+    }
+
     // 2. 选择技能套件
     const skillSuiteChoice = await select({
       message: '选择技能套件:',

package/src/scaffold.js

@@ -697,7 +697,7 @@ export async function scaffold(config) {
 
   // 9. 安装外部 Skills（如果选择了）
   if (externalSkills?.length) {
-    const { installExternalSkill } = await import('./external-skills.js');
+    const { installExternalSkill, cleanExternalSkillArtifacts } = await import('./external-skills.js');
     const metadata = await loadMetadata();
     const knownSkills = metadata.external_skills?.known || [];
     console.log(chalk.blue('\n    外部技能:'));
@@ -705,7 +705,6 @@ export async function scaffold(config) {
       const skillDef = knownSkills.find(s => s.name === name);
       if (skillDef) {
         try {
-        // npx skills add handles installation; we pass platform to prune unwanted symlinks
           await installExternalSkill(skillDef, platform, projectRoot, dryRun);
           console.log(chalk.green(`      ✓ ${name} (external)`));
         } catch (e) {
@@ -713,6 +712,9 @@ export async function scaffold(config) {
         }
       }
     }
+    if (!dryRun) {
+      await cleanExternalSkillArtifacts(projectRoot, platform);
+    }
   }
 
   // 10. Git pre-commit hook