prizmkit 1.0.0

package/bin/create-prizmkit.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+/**
+ * prizmkit CLI
+ *
+ * Usage:
+ *   npx prizmkit install .
+ *   npx prizmkit install my-project --platform claude --non-interactive
+ *   npx prizmkit uninstall . --dry-run
+ */
+
+import { program } from 'commander';
+import { runScaffold } from '../src/index.js';
+import { runClean } from '../src/clean.js';
+
+program
+  .name('prizmkit')
+  .description('PrizmKit project installer/uninstaller')
+  .version('1.0.0');
+
+program
+  .command('install [directory]')
+  .description('Install PrizmKit into a project directory')
+  .option('--platform <platform>', 'Target platform: codebuddy, claude, or both')
+  .option('--skills <suite>', 'Skill suite: full, core, or minimal', 'full')
+  .option('--team', 'Enable multi-agent team mode (default: true)')
+  .option('--no-team', 'Disable multi-agent team mode')
+  .option('--pipeline', 'Install dev-pipeline (default: true)')
+  .option('--no-pipeline', 'Disable dev-pipeline')
+  .option('--non-interactive', 'Skip interactive prompts (requires --platform)')
+  .option('--dry-run', 'Show what would be created without making changes')
+  .action(async (directory = '.', options) => {
+    try {
+      await runScaffold(directory, options);
+    } catch (err) {
+      console.error(`\n  Error: ${err.message}\n`);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('uninstall [directory]')
+  .description('Remove PrizmKit files from an existing project')
+  .option('--dry-run', 'Show what would be removed without deleting')
+  .option('--global-team', 'Also remove ~/.codebuddy/teams/prizm-dev-team')
+  .action(async (directory = '.', options) => {
+    try {
+      await runClean(directory, options);
+    } catch (err) {
+      console.error(`\n  Error: ${err.message}\n`);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "prizmkit",
+  "version": "1.0.0",
+  "description": "Create a new PrizmKit-powered project with clean initialization — no framework dev files, just what you need.",
+  "type": "module",
+  "bin": {
+    "prizmkit": "bin/create-prizmkit.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "bundled/"
+  ],
+  "scripts": {
+    "bundle": "node ../scripts/bundle.js",
+    "dev": "node bin/create-prizmkit.js install . --dry-run",
+    "test": "node bin/create-prizmkit.js uninstall . --dry-run"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "yaml": "^2.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "create",
+    "prizmkit",
+    "scaffold",
+    "ai",
+    "autonomous",
+    "development",
+    "framework",
+    "codebuddy",
+    "claude-code"
+  ],
+  "author": "PrizmKit",
+  "license": "MIT"
+}

package/src/clean.js

@@ -0,0 +1,110 @@
+import chalk from 'chalk';
+import path from 'path';
+import fs from 'fs-extra';
+
+async function removePath(targetPath, dryRun) {
+  if (!await fs.pathExists(targetPath)) {
+    return { path: targetPath, removed: false, reason: 'not_found' };
+  }
+  if (dryRun) {
+    return { path: targetPath, removed: false, reason: 'dry_run' };
+  }
+  await fs.remove(targetPath);
+  return { path: targetPath, removed: true };
+}
+
+async function cleanGitignore(projectRoot, dryRun) {
+  const gitignorePath = path.join(projectRoot, '.gitignore');
+  if (!await fs.pathExists(gitignorePath)) {
+    return { updated: false, reason: 'not_found' };
+  }
+
+  const content = await fs.readFile(gitignorePath, 'utf8');
+  const next = content
+    .replace(/\n\n# PrizmKit\n\.prizmkit\/\n?/g, '\n')
+    .replace(/\n# PrizmKit\n\.prizmkit\/\n?/g, '\n');
+
+  if (next === content) {
+    return { updated: false, reason: 'no_prizmkit_section' };
+  }
+
+  if (dryRun) {
+    return { updated: true, reason: 'dry_run' };
+  }
+
+  await fs.writeFile(gitignorePath, next.trimEnd() + '\n');
+  return { updated: true };
+}
+
+export async function runClean(directory, options = {}) {
+  const projectRoot = path.resolve(directory || '.');
+  const dryRun = Boolean(options.dryRun);
+  const cleanGlobalTeam = Boolean(options.globalTeam);
+
+  console.log('');
+  console.log(chalk.bold('  PrizmKit 清理模式'));
+  console.log(`  目标目录: ${projectRoot}`);
+  console.log(`  全局 Team: ${cleanGlobalTeam ? chalk.yellow('将清理') : chalk.gray('跳过')}`);
+  console.log(`  预览模式: ${dryRun ? chalk.yellow('是') : chalk.green('否')}`);
+  console.log('');
+
+  const targets = [
+    '.prizmkit',
+    '.dev-team',
+    'dev-pipeline',
+    'CODEBUDDY.md',
+    'CLAUDE.md',
+    path.join('.codebuddy', 'skills'),
+    path.join('.codebuddy', 'agents'),
+    path.join('.codebuddy', 'settings.json'),
+    path.join('.claude', 'commands'),
+    path.join('.claude', 'agents'),
+    path.join('.claude', 'rules'),
+    path.join('.claude', 'settings.json'),
+    path.join('.claude', 'team-info.json'),
+  ];
+
+  const results = [];
+  for (const rel of targets) {
+    const abs = path.join(projectRoot, rel);
+    results.push(await removePath(abs, dryRun));
+  }
+
+  const gitignoreResult = await cleanGitignore(projectRoot, dryRun);
+
+  if (cleanGlobalTeam) {
+    const homeDir = process.env.HOME || process.env.USERPROFILE;
+    if (homeDir) {
+      const globalTeamPath = path.join(homeDir, '.codebuddy', 'teams', 'prizm-dev-team');
+      results.push(await removePath(globalTeamPath, dryRun));
+    }
+  }
+
+  const removed = results.filter(r => r.removed).length;
+  const found = results.filter(r => r.reason !== 'not_found').length;
+
+  console.log(chalk.bold('  清理结果:'));
+  for (const item of results) {
+    if (item.removed) {
+      console.log(chalk.green(`    ✓ 已删除: ${item.path}`));
+    } else if (item.reason === 'dry_run') {
+      console.log(chalk.gray(`    [dry-run] ${item.path}`));
+    }
+  }
+
+  if (gitignoreResult.updated) {
+    if (gitignoreResult.reason === 'dry_run') {
+      console.log(chalk.gray('    [dry-run] 将更新 .gitignore（移除 PrizmKit 段）'));
+    } else {
+      console.log(chalk.green('    ✓ 已更新 .gitignore（移除 PrizmKit 段）'));
+    }
+  }
+
+  console.log('');
+  if (dryRun) {
+    console.log(chalk.yellow(`  预览完成：将影响 ${found} 项。`));
+  } else {
+    console.log(chalk.green(`  清理完成：已删除 ${removed} 项。`));
+  }
+  console.log('');
+}

package/src/detect-platform.js

@@ -0,0 +1,38 @@
+/**
+ * 平台检测工具
+ * 检测系统中已安装的 AI CLI 工具。
+ */
+
+import { execSync } from 'child_process';
+
+/**
+ * 检查命令是否存在于 PATH 中
+ */
+function commandExists(cmd) {
+  try {
+    execSync(`command -v ${cmd}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 检测已安装的 AI CLI 工具，并返回推荐的默认平台。
+ * @returns {{ cbc: boolean, claude: boolean, suggested: string }}
+ */
+export function detectPlatform() {
+  const cbc = commandExists('cbc');
+  const claude = commandExists('claude');
+
+  let suggested = 'codebuddy';
+  if (cbc && claude) {
+    suggested = 'both';
+  } else if (claude && !cbc) {
+    suggested = 'claude';
+  } else if (cbc && !claude) {
+    suggested = 'codebuddy';
+  }
+
+  return { cbc, claude, suggested };
+}

package/src/gitignore-template.js

@@ -0,0 +1,61 @@
+/**
+ * .gitignore 模板
+ * 为新创建的 PrizmKit 项目生成合适的 .gitignore 内容。
+ */
+
+/**
+ * 生成 .gitignore 内容
+ * @param {Object} options - { pipeline: boolean }
+ * @returns {string}
+ */
+export function generateGitignore(options = {}) {
+  const lines = [
+    '# ===========================',
+    '# PrizmKit Runtime Artifacts',
+    '# ===========================',
+    '',
+    '# Prizm 文档（按需决定是否提交）',
+    '# .prizm-docs/',
+    '',
+    '# PrizmKit 工作流制品',
+    '.prizmkit/',
+    '',
+  ];
+
+  if (options.pipeline) {
+    lines.push(
+      '# Dev-Pipeline 运行时状态',
+      'dev-pipeline/state/',
+      'dev-pipeline/bugfix-state/',
+      'dev-pipeline/logs/',
+      'dev-pipeline/*.pid',
+      '',
+    );
+  }
+
+  lines.push(
+    '# ===========================',
+    '# Common',
+    '# ===========================',
+    '',
+    '# Dependencies',
+    'node_modules/',
+    '',
+    '# OS files',
+    '.DS_Store',
+    'Thumbs.db',
+    '',
+    '# IDE',
+    '.idea/',
+    '.vscode/',
+    '*.swp',
+    '*.swo',
+    '',
+    '# Environment',
+    '.env',
+    '.env.local',
+    '',
+  );
+
+  return lines.join('\n');
+}

package/src/index.js

@@ -0,0 +1,162 @@
+/**
+ * create-prizmkit 交互式主流程
+ *
+ * 引导用户选择平台、技能套件、团队模式、Pipeline，
+ * 然后调用 scaffold.js 执行纯净安装。
+ */
+
+import { select, confirm } from '@inquirer/prompts';
+import chalk from 'chalk';
+import path from 'path';
+import fs from 'fs-extra';
+import { detectPlatform } from './detect-platform.js';
+import { scaffold } from './scaffold.js';
+import { loadMetadata } from './metadata.js';
+
+/**
+ * 主入口：交互式脚手架流程
+ * @param {string} directory - 目标目录
+ * @param {Object} options - CLI 选项
+ */
+export async function runScaffold(directory, options) {
+  const projectRoot = path.resolve(directory);
+
+  // 打印欢迎 banner
+  console.log('');
+  console.log(chalk.bold('╔════════════════════════════════════════════════════════╗'));
+  console.log(chalk.bold('║') + chalk.bold.cyan('  PrizmKit') + chalk.bold(' — 自演化自主开发框架                    ') + chalk.bold('║'));
+  console.log(chalk.bold('║') + '  Create a clean, focused project environment           ' + chalk.bold('║'));
+  console.log(chalk.bold('╚════════════════════════════════════════════════════════╝'));
+  console.log('');
+
+  // 检测已安装的 CLI 工具
+  const detected = detectPlatform();
+  const cliStatus = [
+    detected.cbc ? chalk.green('cbc ✓') : chalk.gray('cbc ✗'),
+    detected.claude ? chalk.green('claude ✓') : chalk.gray('claude ✗'),
+  ].join('  ');
+  console.log(`  检测到的 CLI 工具:  ${cliStatus}`);
+  console.log(`  目标目录:          ${projectRoot}`);
+  console.log('');
+
+  // 加载 Skill 元数据
+  const metadata = await loadMetadata();
+  const totalSkills = Object.keys(metadata.skills).length;
+
+  // === 非交互式模式 ===
+  if (options.nonInteractive) {
+    if (!options.platform) {
+      console.error(chalk.red('  错误: 非交互式模式需要指定 --platform'));
+      process.exit(1);
+    }
+    const config = {
+      platform: options.platform,
+      skills: options.skills || 'full',
+      team: options.team !== false,
+      pipeline: options.pipeline !== false,
+      projectRoot,
+      dryRun: options.dryRun || false,
+    };
+    return scaffold(config);
+  }
+
+  // === 交互式模式 ===
+  try {
+    // 1. 选择平台
+    const platform = await select({
+      message: '选择目标平台:',
+      choices: [
+        {
+          name: `CodeBuddy CLI (cbc)${detected.cbc ? chalk.green(' ← 已检测到') : ''}`,
+          value: 'codebuddy',
+        },
+        {
+          name: `Claude Code CLI (claude)${detected.claude ? chalk.green(' ← 已检测到') : ''}`,
+          value: 'claude',
+        },
+        {
+          name: '同时安装两个平台',
+          value: 'both',
+        },
+      ],
+      default: detected.suggested,
+    });
+
+    // 2. 选择技能套件
+    const skillSuite = await select({
+      message: '选择技能套件:',
+      choices: [
+        {
+          name: `Full — 全部 ${totalSkills} 个技能`,
+          value: 'full',
+        },
+        {
+          name: `Core — 核心工作流 (${metadata.suites.core.skills.length} 个技能)`,
+          value: 'core',
+        },
+        {
+          name: `Minimal — 最小可用 (${metadata.suites.minimal.skills.length} 个技能)`,
+          value: 'minimal',
+        },
+      ],
+      default: 'full',
+    });
+
+    // 3. 团队模式
+    const team = await confirm({
+      message: '启用多 Agent 团队模式 (prizm-dev-team)?',
+      default: true,
+    });
+
+    // 4. Pipeline
+    const pipeline = await confirm({
+      message: '安装自动化流水线 (dev-pipeline)?',
+      default: true,
+    });
+
+    // 显示安装摘要
+    const platformLabel = platform === 'both' ? 'CodeBuddy + Claude Code'
+      : platform === 'codebuddy' ? 'CodeBuddy' : 'Claude Code';
+    const suiteLabel = skillSuite === 'full' ? `Full (${totalSkills} 个)`
+      : skillSuite === 'core' ? `Core (${metadata.suites.core.skills.length} 个)`
+      : `Minimal (${metadata.suites.minimal.skills.length} 个)`;
+
+    console.log('');
+    console.log(chalk.bold('  安装摘要:'));
+    console.log(`    平台:       ${chalk.cyan(platformLabel)}`);
+    console.log(`    技能:       ${chalk.cyan(suiteLabel)}`);
+    console.log(`    团队模式:   ${team ? chalk.green('启用') : chalk.gray('禁用')}`);
+    console.log(`    流水线:     ${pipeline ? chalk.green('启用') : chalk.gray('禁用')}`);
+    console.log(`    目标目录:   ${projectRoot}`);
+    console.log('');
+
+    // 确认
+    const proceed = await confirm({
+      message: '确认安装?',
+      default: true,
+    });
+
+    if (!proceed) {
+      console.log(chalk.yellow('  安装已取消。'));
+      return;
+    }
+
+    const config = {
+      platform,
+      skills: skillSuite,
+      team,
+      pipeline,
+      projectRoot,
+      dryRun: options.dryRun || false,
+    };
+
+    await scaffold(config);
+
+  } catch (err) {
+    if (err.message?.includes('User force closed')) {
+      console.log(chalk.yellow('\n  安装已取消。'));
+      return;
+    }
+    throw err;
+  }
+}

package/src/metadata.js

@@ -0,0 +1,134 @@
+/**
+ * Skill 元数据加载器
+ *
+ * 加载策略：
+ *   1. 优先从 bundled/ 目录加载（npm 发布后的独立场景）
+ *   2. 回退到 core/skills/_metadata.json（本地开发场景）
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * 获取框架根目录路径（用于本地开发模式）
+ */
+export function getFrameworkRoot() {
+  return path.resolve(__dirname, '../..');
+}
+
+/**
+ * 获取 bundled 目录路径（用于 npm 发布模式）
+ */
+export function getBundledRoot() {
+  return path.resolve(__dirname, '../bundled');
+}
+
+/**
+ * 判断是否处于 bundled 模式（已通过 npm 发布）
+ */
+export function isBundledMode() {
+  return fs.pathExistsSync(path.join(getBundledRoot(), 'skills', '_metadata.json'));
+}
+
+/**
+ * 加载 Skill 元数据
+ * @returns {Promise<Object>} metadata 对象（包含 skills 和 suites）
+ */
+export async function loadMetadata() {
+  const bundledPath = path.join(getBundledRoot(), 'skills', '_metadata.json');
+  const corePath = path.join(getFrameworkRoot(), 'core', 'skills', '_metadata.json');
+
+  if (await fs.pathExists(bundledPath)) {
+    return fs.readJSON(bundledPath);
+  }
+
+  if (await fs.pathExists(corePath)) {
+    return fs.readJSON(corePath);
+  }
+
+  throw new Error(
+    '无法找到 Skill 元数据文件。\n' +
+    '请确保在 PrizmKit 框架目录中运行，或已执行 `npm run bundle` 打包资源。'
+  );
+}
+
+/**
+ * 获取 core skills 目录路径
+ */
+export function getSkillsDir() {
+  const bundledDir = path.join(getBundledRoot(), 'skills');
+  const coreDir = path.join(getFrameworkRoot(), 'core', 'skills');
+
+  if (fs.pathExistsSync(bundledDir)) return bundledDir;
+  if (fs.pathExistsSync(coreDir)) return coreDir;
+
+  throw new Error('无法找到 Skills 目录。');
+}
+
+/**
+ * 获取 core agents 目录路径
+ */
+export function getAgentsDir() {
+  const bundledDir = path.join(getBundledRoot(), 'agents');
+  const coreDir = path.join(getFrameworkRoot(), 'core', 'agents');
+
+  if (fs.pathExistsSync(bundledDir)) return bundledDir;
+  if (fs.pathExistsSync(coreDir)) return coreDir;
+
+  throw new Error('无法找到 Agents 目录。');
+}
+
+/**
+ * 获取 core team 目录路径
+ */
+export function getTeamDir() {
+  const bundledDir = path.join(getBundledRoot(), 'team');
+  const coreDir = path.join(getFrameworkRoot(), 'core', 'team');
+
+  if (fs.pathExistsSync(bundledDir)) return bundledDir;
+  if (fs.pathExistsSync(coreDir)) return coreDir;
+
+  throw new Error('无法找到 Team 目录。');
+}
+
+/**
+ * 获取 templates 目录路径
+ */
+export function getTemplatesDir() {
+  const bundledDir = path.join(getBundledRoot(), 'templates');
+  const coreDir = path.join(getFrameworkRoot(), 'core', 'templates');
+
+  if (fs.pathExistsSync(bundledDir)) return bundledDir;
+  if (fs.pathExistsSync(coreDir)) return coreDir;
+
+  throw new Error('无法找到 Templates 目录。');
+}
+
+/**
+ * 获取 dev-pipeline 目录路径
+ */
+export function getPipelineDir() {
+  const bundledDir = path.join(getBundledRoot(), 'dev-pipeline');
+  const coreDir = path.join(getFrameworkRoot(), 'dev-pipeline');
+
+  if (fs.pathExistsSync(bundledDir)) return bundledDir;
+  if (fs.pathExistsSync(coreDir)) return coreDir;
+
+  throw new Error('无法找到 dev-pipeline 目录。');
+}
+
+/**
+ * 获取 adapters 目录路径
+ */
+export function getAdaptersDir() {
+  const bundledDir = path.join(getBundledRoot(), 'adapters');
+  const coreDir = path.join(getFrameworkRoot(), 'adapters');
+
+  if (fs.pathExistsSync(bundledDir)) return bundledDir;
+  if (fs.pathExistsSync(coreDir)) return coreDir;
+
+  throw new Error('无法找到 Adapters 目录。');
+}

package/src/scaffold.js

@@ -0,0 +1,628 @@
+/**
+ * 纯净安装核心逻辑
+ *
+ * 与 cli/src/installer.js 的关键区别：
+ *   - 全部使用 Copy 模式（不使用 symlink），项目完全独立于框架仓库
+ *   - 通过 adapters 转换 core/ 资源为平台特定格式
+ *   - 不安装框架开发文件（docs、tests、scripts 等）
+ *   - 自动生成 .gitignore
+ */
+
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import {
+  loadMetadata,
+  getSkillsDir,
+  getAgentsDir,
+  getTeamDir,
+  getTemplatesDir,
+  getPipelineDir,
+  getAdaptersDir,
+  getFrameworkRoot,
+} from './metadata.js';
+import { generateGitignore } from './gitignore-template.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// ============================================================
+// Adapter 动态加载
+// ============================================================
+
+/**
+ * 动态加载平台适配器
+ * 支持从 framework/adapters/ 或 bundled/adapters/ 加载
+ */
+async function loadAdapter(platform, adapterName) {
+  const adaptersDir = getAdaptersDir();
+  const adapterPath = path.join(adaptersDir, platform, adapterName);
+  return import(adapterPath);
+}
+
+async function loadSharedFrontmatter() {
+  const adaptersDir = getAdaptersDir();
+  return import(path.join(adaptersDir, 'shared', 'frontmatter.js'));
+}
+
+// ============================================================
+// Skill 解析
+// ============================================================
+
+/**
+ * 根据套件名称解析 Skill 列表
+ */
+async function resolveSkillList(suite) {
+  const metadata = await loadMetadata();
+
+  const suiteDef = metadata.suites[suite] || metadata.suites.full;
+  if (suiteDef.skills === '*') {
+    return Object.keys(metadata.skills);
+  }
+  return suiteDef.skills;
+}
+
+// ============================================================
+// 安装函数
+// ============================================================
+
+/**
+ * 安装 Skills（纯 Copy 模式）
+ */
+async function installSkills(platform, skills, projectRoot, dryRun) {
+  const skillsDir = getSkillsDir();
+  const { parseFrontmatter, buildMarkdown } = await loadSharedFrontmatter();
+
+  for (const skillName of skills) {
+    const corePath = path.join(skillsDir, skillName);
+    if (!await fs.pathExists(corePath)) continue;
+
+    const stat = await fs.stat(corePath);
+    if (!stat.isDirectory()) continue;
+
+    const skillMdPath = path.join(corePath, 'SKILL.md');
+    if (!await fs.pathExists(skillMdPath)) continue;
+
+    if (platform === 'codebuddy') {
+      const targetDir = path.join(projectRoot, '.codebuddy', 'skills', skillName);
+
+      if (dryRun) {
+        console.log(chalk.gray(`      [dry-run] .codebuddy/skills/${skillName}/`));
+        continue;
+      }
+
+      await fs.ensureDir(targetDir);
+
+      // 读取并写入 SKILL.md（CodeBuddy 格式基本透传）
+      const content = await fs.readFile(skillMdPath, 'utf8');
+      const { frontmatter, body } = parseFrontmatter(content);
+      if (!frontmatter.name) frontmatter.name = skillName;
+      await fs.writeFile(path.join(targetDir, 'SKILL.md'), buildMarkdown(frontmatter, body));
+
+      // 复制 assets/ 和 scripts/
+      for (const subdir of ['assets', 'scripts']) {
+        const srcSubdir = path.join(corePath, subdir);
+        if (await fs.pathExists(srcSubdir)) {
+          await fs.copy(srcSubdir, path.join(targetDir, subdir));
+        }
+      }
+
+      console.log(chalk.green(`      ✓ .codebuddy/skills/${skillName}/`));
+
+    } else if (platform === 'claude') {
+      const content = await fs.readFile(skillMdPath, 'utf8');
+      const { frontmatter, body } = parseFrontmatter(content);
+
+      // Claude Code 格式转换
+      const claudeFm = {
+        description: String(frontmatter.description || `PrizmKit ${skillName}`)
+          .replace(/prizmkit\.(\w+)/g, (_, sub) => `/prizmkit-${sub.replace(/_/g, '-')}`),
+      };
+
+      let convertedBody = body
+        .replace(/\$\{SKILL_DIR\}/g, `.claude/commands/${skillName}`)
+        .replace(/prizmkit\.(\w+)/g, (_, sub) => `/prizmkit-${sub.replace(/_/g, '-')}`);
+
+      const hasAssets = await fs.pathExists(path.join(corePath, 'assets'));
+      const hasScripts = await fs.pathExists(path.join(corePath, 'scripts'));
+
+      if (hasAssets || hasScripts) {
+        const targetDir = path.join(projectRoot, '.claude', 'commands', skillName);
+        if (dryRun) {
+          console.log(chalk.gray(`      [dry-run] .claude/commands/${skillName}/`));
+          continue;
+        }
+        await fs.ensureDir(targetDir);
+        await fs.writeFile(
+          path.join(targetDir, `${skillName}.md`),
+          buildMarkdown(claudeFm, convertedBody)
+        );
+        for (const subdir of ['assets', 'scripts']) {
+          const srcSubdir = path.join(corePath, subdir);
+          if (await fs.pathExists(srcSubdir)) {
+            await fs.copy(srcSubdir, path.join(targetDir, subdir));
+          }
+        }
+        console.log(chalk.green(`      ✓ .claude/commands/${skillName}/`));
+      } else {
+        const targetDir = path.join(projectRoot, '.claude', 'commands');
+        if (dryRun) {
+          console.log(chalk.gray(`      [dry-run] .claude/commands/${skillName}.md`));
+          continue;
+        }
+        await fs.ensureDir(targetDir);
+        await fs.writeFile(
+          path.join(targetDir, `${skillName}.md`),
+          buildMarkdown(claudeFm, convertedBody)
+        );
+        console.log(chalk.green(`      ✓ .claude/commands/${skillName}.md`));
+      }
+    }
+  }
+}
+
+/**
+ * 安装 Agent 定义（纯 Copy 模式）
+ */
+async function installAgents(platform, projectRoot, dryRun) {
+  const agentsDir = getAgentsDir();
+  const { parseFrontmatter, buildMarkdown } = await loadSharedFrontmatter();
+  const agentFiles = (await fs.readdir(agentsDir)).filter(f => f.endsWith('.md'));
+
+  // Claude Code 工具映射
+  const TOOL_MAPPING = {
+    'TaskCreate': 'Task',
+    'TaskGet': 'Task',
+    'TaskUpdate': 'Task',
+    'TaskList': 'Task',
+    'SendMessage': 'SendMessage',
+  };
+
+  for (const file of agentFiles) {
+    const content = await fs.readFile(path.join(agentsDir, file), 'utf8');
+
+    if (platform === 'codebuddy') {
+      const targetDir = path.join(projectRoot, '.codebuddy', 'agents');
+      if (dryRun) {
+        console.log(chalk.gray(`      [dry-run] .codebuddy/agents/${file}`));
+        continue;
+      }
+      await fs.ensureDir(targetDir);
+      await fs.writeFile(path.join(targetDir, file), content);
+      console.log(chalk.green(`      ✓ .codebuddy/agents/${file}`));
+
+    } else if (platform === 'claude') {
+      const { frontmatter, body } = parseFrontmatter(content);
+
+      // 工具映射
+      let tools = [];
+      if (frontmatter.tools) {
+        const rawTools = frontmatter.tools.split(',').map(t => t.trim());
+        const mapped = rawTools.map(t => TOOL_MAPPING[t] || t).filter(Boolean);
+        tools = [...new Set(mapped)];
+      }
+
+      // 转换 body 中的命令引用
+      let convertedBody = body
+        .replace(/prizmkit\.(\w+)/g, (_, sub) => `/prizmkit-${sub.replace(/_/g, '-')}`);
+
+      const claudeFm = {
+        name: frontmatter.name,
+        description: frontmatter.description,
+        tools: tools,
+        model: 'inherit',
+      };
+
+      const targetDir = path.join(projectRoot, '.claude', 'agents');
+      if (dryRun) {
+        console.log(chalk.gray(`      [dry-run] .claude/agents/${file}`));
+        continue;
+      }
+      await fs.ensureDir(targetDir);
+      await fs.writeFile(path.join(targetDir, file), buildMarkdown(claudeFm, convertedBody));
+      console.log(chalk.green(`      ✓ .claude/agents/${file}`));
+    }
+  }
+}
+
+/**
+ * 安装 Team 配置
+ */
+async function installTeamConfig(platform, projectRoot, dryRun) {
+  const teamDir = getTeamDir();
+  const teamDefPath = path.join(teamDir, 'prizm-dev-team.json');
+
+  if (!await fs.pathExists(teamDefPath)) {
+    console.log(chalk.yellow('      ⚠ 未找到团队配置文件，跳过'));
+    return;
+  }
+
+  const teamDef = await fs.readJSON(teamDefPath);
+
+  if (platform === 'codebuddy') {
+    const homeDir = process.env.HOME || process.env.USERPROFILE;
+    const targetDir = path.join(homeDir, '.codebuddy', 'teams', 'prizm-dev-team');
+
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] ~/.codebuddy/teams/prizm-dev-team/`));
+      return;
+    }
+
+    await fs.ensureDir(path.join(targetDir, 'inboxes'));
+
+    const config = {
+      name: teamDef.name,
+      description: teamDef.description,
+      createdAt: Date.now(),
+      leadAgentId: `${teamDef.lead}@${teamDef.name}`,
+      leadSessionId: '',
+      members: teamDef.members.map((m, i) => ({
+        agentId: `${m.name}@${teamDef.name}`,
+        name: m.name,
+        agentType: m.agentDefinition || m.name,
+        ...(m.prompt ? { prompt: m.prompt } : {}),
+        joinedAt: Date.now() + i,
+        tmuxPaneId: '',
+        cwd: '',
+        subscriptions: m.subscriptions || [],
+      })),
+    };
+
+    await fs.writeFile(path.join(targetDir, 'config.json'), JSON.stringify(config, null, 2));
+
+    for (const member of teamDef.members) {
+      const inboxPath = path.join(targetDir, 'inboxes', `${member.name}.json`);
+      if (!await fs.pathExists(inboxPath)) {
+        await fs.writeFile(inboxPath, JSON.stringify([], null, 2));
+      }
+    }
+
+    console.log(chalk.green(`      ✓ ~/.codebuddy/teams/prizm-dev-team/`));
+
+  } else if (platform === 'claude') {
+    const claudeDir = path.join(projectRoot, '.claude');
+
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] .claude/team-info.json`));
+      return;
+    }
+
+    await fs.ensureDir(claudeDir);
+
+    const teamConfig = {
+      name: teamDef.name,
+      description: teamDef.description,
+      platform: 'claude',
+      orchestrationMode: 'subagent',
+      agents: teamDef.members
+        .filter(m => m.role !== 'lead')
+        .map(m => ({
+          name: m.name,
+          role: m.role,
+          agentFile: `.claude/agents/${m.agentDefinition}.md`,
+          prompt: m.prompt,
+        })),
+      upgrade: {
+        envVar: 'CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS',
+        command: '设置 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 可启用原生 Agent Teams 模式',
+      },
+    };
+
+    await fs.writeFile(
+      path.join(claudeDir, 'team-info.json'),
+      JSON.stringify(teamConfig, null, 2)
+    );
+
+    console.log(chalk.green(`      ✓ .claude/team-info.json`));
+  }
+}
+
+/**
+ * 安装平台配置文件（settings/hooks/rules）
+ */
+async function installSettings(platform, projectRoot, options, dryRun) {
+  if (platform === 'codebuddy') {
+    const settingsPath = path.join(projectRoot, '.codebuddy', 'settings.json');
+
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] .codebuddy/settings.json`));
+      return;
+    }
+
+    await fs.ensureDir(path.dirname(settingsPath));
+
+    const settings = {
+      hooks: {
+        UserPromptSubmit: [
+          {
+            matcher: '',
+            hooks: [
+              {
+                type: 'prompt',
+                prompt: 'If this message mentions committing, pushing, or finishing a task, remind about updating .prizm-docs/ first. Suggest using the prizmkit-committer skill.',
+              },
+            ],
+          },
+        ],
+      },
+    };
+
+    await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+    console.log(chalk.green(`      ✓ .codebuddy/settings.json`));
+
+  } else if (platform === 'claude') {
+    const claudeDir = path.join(projectRoot, '.claude');
+
+    if (dryRun) {
+      console.log(chalk.gray(`      [dry-run] .claude/settings.json`));
+      console.log(chalk.gray(`      [dry-run] .claude/rules/`));
+      return;
+    }
+
+    await fs.ensureDir(claudeDir);
+
+    // Settings
+    const permissions = [
+      'Bash(python3 *)',
+      'Bash(git *)',
+      'Bash(jq *)',
+    ];
+    if (options.pipeline) {
+      permissions.push('Bash(./dev-pipeline/*)', 'Bash(python3 dev-pipeline/*)');
+    }
+
+    const settings = {
+      permissions: { allow: permissions },
+      hooks: {
+        SessionStart: [
+          {
+            matcher: 'startup',
+            hooks: [
+              {
+                type: 'command',
+                command: 'test -f .prizm-docs/root.prizm && echo "PrizmKit: .prizm-docs found. Read root.prizm for project context." || echo "PrizmKit: No .prizm-docs found. Run /prizmkit-init to bootstrap."',
+              },
+            ],
+          },
+        ],
+      },
+    };
+
+    await fs.writeFile(
+      path.join(claudeDir, 'settings.json'),
+      JSON.stringify(settings, null, 2)
+    );
+    console.log(chalk.green(`      ✓ .claude/settings.json`));
+
+    // Rules
+    const rulesDir = path.join(claudeDir, 'rules');
+    await fs.ensureDir(rulesDir);
+
+    const rules = [
+      {
+        filename: 'prizm-documentation.md',
+        content: `---\ndescription: "PrizmKit documentation rules"\nglobs:\n  - "**/*.ts"\n  - "**/*.tsx"\n  - "**/*.js"\n  - "**/*.jsx"\n  - "**/*.py"\n  - "**/*.go"\n  - "**/*.rs"\n  - "**/*.java"\n---\n\nWhen modifying source files in this project:\n1. Check if \`.prizm-docs/root.prizm\` exists\n2. If it does, read it before making changes to understand project structure\n3. After making changes, update affected \`.prizm-docs/\` files\n4. Follow the Prizm doc format (KEY: value, not prose)\n5. Size limits: L0 = 4KB, L1 = 3KB, L2 = 5KB\n`,
+      },
+      {
+        filename: 'prizm-commit-workflow.md',
+        content: `---\ndescription: "PrizmKit commit workflow rules"\n---\n\nBefore any git commit in this project:\n1. Update \`.prizm-docs/\` for affected modules\n2. Use Conventional Commits format: type(scope): description\n3. Bug fixes use \`fix()\` prefix, not \`feat()\`\n4. Do NOT create REGISTRY.md entries for bug fixes\n5. Use \`/prizmkit-committer\` command for the complete commit workflow\n`,
+      },
+      {
+        filename: 'prizm-progressive-loading.md',
+        content: `---\ndescription: "PrizmKit progressive context loading protocol"\n---\n\nThis project uses PrizmKit's progressive loading protocol:\n- ON SESSION START: Read \`.prizm-docs/root.prizm\` (L0 — project map)\n- ON TASK: Read L1 (\`.prizm-docs/<module>.prizm\`) for relevant modules\n- ON FILE EDIT: Read L2 (\`.prizm-docs/<module>/<submodule>.prizm\`) before modifying\n- NEVER load all .prizm docs at once\n- Arrow notation (->) in .prizm files indicates load pointers\n- DECISIONS and CHANGELOG in .prizm files are append-only\n`,
+      },
+    ];
+
+    for (const rule of rules) {
+      await fs.writeFile(path.join(rulesDir, rule.filename), rule.content);
+    }
+    console.log(chalk.green(`      ✓ .claude/rules/ (${rules.length} 条规则)`));
+  }
+}
+
+/**
+ * 安装项目记忆文件（CODEBUDDY.md / CLAUDE.md）
+ */
+async function installProjectMemory(platform, projectRoot, dryRun) {
+  const templatesDir = getTemplatesDir();
+  const templateName = platform === 'claude' ? 'claude-md-template.md' : 'codebuddy-md-template.md';
+  const targetName = platform === 'claude' ? 'CLAUDE.md' : 'CODEBUDDY.md';
+  const templatePath = path.join(templatesDir, templateName);
+  const targetPath = path.join(projectRoot, targetName);
+
+  if (await fs.pathExists(targetPath)) {
+    console.log(chalk.yellow(`      ⚠ ${targetName} 已存在，跳过`));
+    return;
+  }
+
+  if (dryRun) {
+    console.log(chalk.gray(`      [dry-run] ${targetName}`));
+    return;
+  }
+
+  if (await fs.pathExists(templatePath)) {
+    await fs.copy(templatePath, targetPath);
+    console.log(chalk.green(`      ✓ ${targetName}`));
+  } else {
+    console.log(chalk.yellow(`      ⚠ 模板文件不存在: ${templateName}，跳过`));
+  }
+}
+
+/**
+ * 安装 dev-pipeline（纯 Copy 模式）
+ */
+async function installPipeline(projectRoot, dryRun) {
+  const pipelineSource = getPipelineDir();
+  const pipelineTarget = path.join(projectRoot, 'dev-pipeline');
+
+  if (dryRun) {
+    console.log(chalk.gray(`      [dry-run] dev-pipeline/`));
+    return;
+  }
+
+  await fs.ensureDir(path.join(pipelineTarget, 'state'));
+  await fs.ensureDir(path.join(pipelineTarget, 'bugfix-state'));
+
+  // 需要安装的 Pipeline 文件和目录
+  const items = [
+    'run.sh', 'retry-feature.sh', 'reset-feature.sh', 'launch-daemon.sh',
+    'run-bugfix.sh', 'retry-bug.sh', 'launch-bugfix-daemon.sh',
+    'scripts', 'templates', 'assets', 'README.md', '.gitignore',
+  ];
+
+  let installedCount = 0;
+  for (const item of items) {
+    const src = path.join(pipelineSource, item);
+    const tgt = path.join(pipelineTarget, item);
+
+    if (!await fs.pathExists(src)) continue;
+    if (await fs.pathExists(tgt)) {
+      console.log(chalk.yellow(`      ⚠ dev-pipeline/${item} 已存在，跳过`));
+      continue;
+    }
+
+    await fs.copy(src, tgt);
+    installedCount++;
+  }
+
+  console.log(chalk.green(`      ✓ dev-pipeline/ (${installedCount} 项)`));
+}
+
+/**
+ * 生成 .gitignore
+ */
+async function installGitignore(projectRoot, options, dryRun) {
+  const targetPath = path.join(projectRoot, '.gitignore');
+
+  if (dryRun) {
+    console.log(chalk.gray(`      [dry-run] .gitignore`));
+    return;
+  }
+
+  if (await fs.pathExists(targetPath)) {
+    // 追加 PrizmKit 相关条目
+    const existing = await fs.readFile(targetPath, 'utf8');
+    if (existing.includes('.prizmkit/')) {
+      console.log(chalk.yellow(`      ⚠ .gitignore 已包含 PrizmKit 条目，跳过`));
+      return;
+    }
+    const prizmkitSection = '\n\n# PrizmKit\n.prizmkit/\n';
+    await fs.appendFile(targetPath, prizmkitSection);
+    console.log(chalk.green(`      ✓ .gitignore (追加 PrizmKit 条目)`));
+  } else {
+    const content = generateGitignore({ pipeline: options.pipeline });
+    await fs.writeFile(targetPath, content);
+    console.log(chalk.green(`      ✓ .gitignore`));
+  }
+}
+
+// ============================================================
+// 主安装函数
+// ============================================================
+
+/**
+ * 执行纯净安装
+ * @param {Object} config
+ * @param {string} config.platform - 'codebuddy' | 'claude' | 'both'
+ * @param {string} config.skills - 'full' | 'core' | 'minimal'
+ * @param {boolean} config.team - 是否启用团队模式
+ * @param {boolean} config.pipeline - 是否安装 dev-pipeline
+ * @param {string} config.projectRoot - 目标项目根目录
+ * @param {boolean} config.dryRun - 是否为预览模式
+ */
+export async function scaffold(config) {
+  const { platform, skills, team, pipeline, projectRoot, dryRun } = config;
+  const platforms = platform === 'both' ? ['codebuddy', 'claude'] : [platform];
+
+  if (dryRun) {
+    console.log(chalk.yellow('\n  [DRY RUN] 预览将要安装的内容:\n'));
+  }
+
+  // 解析 Skill 列表
+  const skillList = await resolveSkillList(skills);
+
+  console.log('');
+
+  for (const p of platforms) {
+    const platformLabel = p === 'codebuddy' ? 'CodeBuddy' : 'Claude Code';
+    console.log(chalk.bold(`  正在安装 ${platformLabel} 环境...\n`));
+
+    // 1. Skills
+    console.log(chalk.blue('    技能文件:'));
+    await installSkills(p, skillList, projectRoot, dryRun);
+
+    // 2. Agents
+    console.log(chalk.blue('\n    Agent 定义:'));
+    await installAgents(p, projectRoot, dryRun);
+
+    // 3. Team
+    if (team) {
+      console.log(chalk.blue('\n    团队配置:'));
+      await installTeamConfig(p, projectRoot, dryRun);
+    }
+
+    // 4. Settings/Hooks/Rules
+    console.log(chalk.blue('\n    平台配置:'));
+    await installSettings(p, projectRoot, { pipeline }, dryRun);
+
+    // 5. Project Memory
+    console.log(chalk.blue('\n    项目记忆文件:'));
+    await installProjectMemory(p, projectRoot, dryRun);
+
+    console.log('');
+  }
+
+  // 6. Pipeline
+  if (pipeline) {
+    console.log(chalk.blue('    自动化流水线:'));
+    await installPipeline(projectRoot, dryRun);
+    console.log('');
+  }
+
+  // 7. .gitignore
+  console.log(chalk.blue('    项目配置:'));
+  await installGitignore(projectRoot, { pipeline }, dryRun);
+
+  // === 完成 ===
+  console.log('');
+  console.log(chalk.bold('  ════════════════════════════════════════════════'));
+
+  if (dryRun) {
+    console.log(chalk.yellow('  预览完成。未修改任何文件。'));
+  } else {
+    console.log(chalk.green.bold('  ✅ 初始化完成！'));
+  }
+  console.log(chalk.bold('  ════════════════════════════════════════════════'));
+
+  if (!dryRun) {
+    // 打印下一步提示
+    const mainPlatform = platforms.includes('claude') ? 'claude' : 'codebuddy';
+    const cli = mainPlatform === 'claude' ? 'claude' : 'cbc';
+
+    console.log('');
+    console.log('  下一步:');
+    console.log(`    1. ${chalk.cyan('cd ' + projectRoot)}`);
+    console.log(`    2. ${chalk.cyan(cli)}                          ${chalk.gray('# 启动 AI 对话')}`);
+    console.log(`    3. ${chalk.cyan('说 "prizmkit.init"')}           ${chalk.gray('# 初始化项目上下文')}`);
+
+    if (pipeline) {
+      console.log(`    4. ${chalk.cyan('说 "规划一个应用"')}             ${chalk.gray('# 生成 feature-list.json')}`);
+      console.log(`    5. ${chalk.cyan('说 "启动流水线"')}               ${chalk.gray('# 开始自动开发')}`);
+    }
+
+    console.log('');
+
+    // 安装统计
+    const metadata = await loadMetadata();
+    const suiteLabel = skills === 'full' ? `全部 ${skillList.length} 个`
+      : skills === 'core' ? `核心 ${skillList.length} 个`
+      : `最小 ${skillList.length} 个`;
+
+    console.log(chalk.gray(`  安装统计:`));
+    console.log(chalk.gray(`    技能: ${suiteLabel}`));
+    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('');
+  }
+}