@playcraft/cli 0.0.44 → 0.0.47

package/dist/commands/create.js

@@ -1,4 +1,4 @@
-import { execSync } from 'child_process';
+import { execFileSync, execSync } from 'child_process';
 import inquirer from 'inquirer';
 import fs from 'fs/promises';
 import path from 'path';
@@ -45,14 +45,39 @@ async function initGitRepository(targetDir) {
         env: gitEnv,
     });
 }
-/** 递归复制目录，跳过 .DS_Store */
+const TEMPLATE_COPY_EXCLUDES = new Set([
+    '.DS_Store',
+    '.git',
+    'node_modules',
+    'dist',
+    'package-lock.json',
+    'playable.ui.profile.yaml',
+    'playground',
+    'recordings',
+    'validate',
+]);
+function shouldCopyTemplateEntry(srcPath, entryName) {
+    if (srcPath.includes(`${path.sep}skills${path.sep}playable-focus${path.sep}templates${path.sep}`)) {
+        return true;
+    }
+    if (TEMPLATE_COPY_EXCLUDES.has(entryName))
+        return false;
+    if (srcPath.includes(`${path.sep}ta-workspace${path.sep}logs${path.sep}`))
+        return entryName === '.gitkeep';
+    if (srcPath.includes(`${path.sep}ta-workspace${path.sep}tmp${path.sep}`))
+        return entryName === '.gitkeep';
+    if (srcPath.includes(`${path.sep}focus-lab${path.sep}`))
+        return entryName === '.gitkeep';
+    return true;
+}
+/** 递归复制目录，跳过模板运行时产物 */
 async function copyDir(src, dest) {
     await fs.mkdir(dest, { recursive: true });
     const entries = await fs.readdir(src, { withFileTypes: true });
     for (const entry of entries) {
-        if (entry.name === '.DS_Store')
-            continue;
         const srcPath = path.join(src, entry.name);
+        if (!shouldCopyTemplateEntry(srcPath, entry.name))
+            continue;
         const destPath = path.join(dest, entry.name);
         if (entry.isDirectory()) {
             await copyDir(srcPath, destPath);
@@ -63,20 +88,684 @@ async function copyDir(src, dest) {
     }
 }
 /**
- * 在新项目的 .claude/skills/ 下为每个 playcraft-* Platform Tool Skill 创建软连接。
+ * 复制目录（仅处理真实文件/目录，保持 symlink 不作为 dereference 复制）。
+ * 用于从 .claude/ 向 .codebuddy/ 迁移 agents/hooks 等纯文件目录。
+ */
+async function copyDirRecursive(src, dest) {
+    try {
+        await fs.cp(src, dest, { recursive: true, dereference: false });
+    }
+    catch {
+        // 回退：手动递归复制
+        await fs.mkdir(dest, { recursive: true });
+        const entries = await fs.readdir(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isSymbolicLink()) {
+                const linkTarget = await fs.readlink(srcPath);
+                await fs.symlink(linkTarget, destPath);
+            }
+            else if (entry.isDirectory()) {
+                await copyDirRecursive(srcPath, destPath);
+            }
+            else {
+                await fs.copyFile(srcPath, destPath);
+            }
+        }
+    }
+}
+/**
+ * 将 .claude/skills/ 镜像到目标 skills 目录。
+ * - 真实目录 → 递归复制
+ * - symlink → 重建指向同一目标的 symlink
+ */
+async function mirrorSkillsDir(sourceDir, destDir) {
+    await fs.mkdir(destDir, { recursive: true });
+    let entries;
+    try {
+        entries = await fs.readdir(sourceDir, { withFileTypes: true });
+    }
+    catch {
+        return; // 源目录不存在，跳过
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        const srcPath = path.join(sourceDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+        try {
+            await fs.access(destPath);
+            continue; // 已存在则跳过
+        }
+        catch {
+            // 不存在，继续创建
+        }
+        if (entry.isSymbolicLink()) {
+            const linkTarget = await fs.readlink(srcPath);
+            await fs.symlink(linkTarget, destPath, 'dir');
+        }
+        else {
+            await copyDirRecursive(srcPath, destPath);
+        }
+    }
+}
+/**
+ * 翻译 settings.json 为 CodeBuddy 格式：
+ *   1. ${CLAUDE_PROJECT_DIR} → ${CODEBUDDY_PROJECT_DIR}
+ *   2. .claude/hooks/ → .codebuddy/hooks/
+ *   3. command: "node" + args: [...] → command: "node arg1 arg2"
+ *
+ * CodeBuddy 只认 command 为完整 shell 命令（不拆 command/args）。
+ * Claude Code 独有字段原样保留，CodeBuddy 忽略不识别的配置项无害。
+ */
+function translateSettingsForCodeBuddy(settings) {
+    // Step 1: env var + path 翻译（string level）
+    const raw = JSON.stringify(settings);
+    const translated = raw
+        .replace(/\$\{CLAUDE_PROJECT_DIR\}/g, '${CODEBUDDY_PROJECT_DIR}')
+        .replace(/\.claude\/hooks\//g, '.codebuddy/hooks/');
+    const parsed = JSON.parse(translated);
+    // Step 2: command + args 合并（CodeBuddy 不支持 args 字段）
+    mergeHookCommandArgs(parsed);
+    // Step 3: 启用 frontmatter hooks（默认关闭，不加则 agent hooks 静默跳过）
+    parsed.allowUntrustedFrontmatterHooks = true;
+    return parsed;
+}
+/** 递归遍历对象，将 hook 配置中 command: "node" + args: [...] 合并为 command: "node arg1 arg2" */
+function mergeHookCommandArgs(obj) {
+    if (!obj || typeof obj !== 'object')
+        return;
+    if (Array.isArray(obj)) {
+        for (const item of obj)
+            mergeHookCommandArgs(item);
+        return;
+    }
+    for (const key of Object.keys(obj)) {
+        mergeHookCommandArgs(obj[key]);
+    }
+    // 当前对象自身如果有 command + args，合并
+    const rec = obj;
+    if (typeof rec.command === 'string' && Array.isArray(rec.args)) {
+        rec.command = [rec.command, ...rec.args].join(' ');
+        delete rec.args;
+    }
+}
+/**
+ * 将 agent YAML frontmatter 的 tools 字段从 YAML 列表格式
+ * 转换为 CodeBuddy 兼容的逗号分隔字符串格式。
+ *
+ * Claude Code 同时支持两种格式，但 CodeBuddy 期望逗号分隔字符串。
  *
- * 软连接目标优先级：
- *   1. 从 CLI 安装包的相对路径（monorepo dev 模式 / npm pack 后结构）
- *   2. 相对于项目的 node_modules（运行时解析，npm install 后生效）
+ * 输入:
+ *   tools:
+ *     - 'Read'
+ *     - 'Bash(ls:*)'
  *
- * 无论在 monorepo 开发还是全局安装场景，两种路径至少有一个能工作。
- * 相对路径软连接（node_modules 指向）在 npm install 后自动激活。
+ * 输出:
+ *   tools: Read, Bash(ls:*)
  */
-async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
-    const skillsLinkDir = path.join(targetDir, '.claude', 'skills');
+function normalizeAgentToolsForCodeBuddy(content) {
+    // 匹配 tools: 后跟 YAML 列表形式（下划线 + 横线开头的行）
+    // 匹配所有常见 tool name 字符：字母数字、空格、冒号、星号、括号、斜线、连字符、点号
+    const toolsListRegex = /^tools:\s*\n((?:\s*-\s+['"]?[^\s'"][^'"\n]*['"]?\s*\n?)+)/m;
+    const match = content.match(toolsListRegex);
+    if (!match)
+        return content; // 已经是逗号分隔或其他格式，不处理
+    const listBlock = match[1];
+    // 提取所有 tool 名称，去掉前导空格、横线、引号
+    const tools = listBlock
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith('-'))
+        .map((line) => line.slice(1).trim().replace(/^['"]|['"]$/g, ''));
+    if (tools.length === 0)
+        return content;
+    // 加 \n 保证归一化后的行与紧随的 --- 之间不粘在一起
+    const normalized = `tools: ${tools.join(', ')}\n`;
+    return content.replace(toolsListRegex, normalized);
+}
+/**
+ * 标准化 .codebuddy/agents/ 下所有 agent 文件的 YAML frontmatter：
+ *   1. tools: YAML list → 逗号分隔
+ *   2. Bash(ls:*) 等模式限制 → 转为 PreToolUse hook + whitelist 脚本
+ *
+ * CodeBuddy 不支持 Bash(ls:*) 这种模式化限制。
+ * 改为：tools 中放 Bash（允许全部 shell），通过 Hook 做命令白名单。
+ */
+async function normalizeCodeBuddyAgents(agentsDir) {
+    let entries;
+    try {
+        entries = await fs.readdir(agentsDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.md'))
+            continue;
+        const agentName = entry.name.replace(/\.md$/, '');
+        const filePath = path.join(agentsDir, entry.name);
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Step 1: 归一化 tools 字段格式
+            const toolsNormalized = normalizeAgentToolsForCodeBuddy(content);
+            const hasToolsChange = toolsNormalized !== content;
+            let finalContent = toolsNormalized;
+            // Step 2: 提取 Bash 模式限制
+            const toolsLine = finalContent.match(/^tools:\s*(.+)$/m);
+            const toolsStr = toolsLine ? toolsLine[1] : '';
+            const { cleanTools, bashPatterns } = extractBashPatterns(toolsStr);
+            if (bashPatterns.length > 0) {
+                // 有 Bash 模式限制 → 生成 whitelist hook
+                // 替换 tools 行：Bash(ls:*), Bash(npm run dev*) → Bash
+                finalContent = finalContent.replace(/^tools:\s*.+$/m, `tools: ${cleanTools.join(', ')}\n`);
+                // 生成 whitelist 脚本
+                await generateBashWhitelistScript(agentsDir, agentName, bashPatterns);
+                // 注入 hooks 到 frontmatter
+                finalContent = injectBashWhitelistHook(finalContent, agentName);
+            }
+            if (finalContent !== content) {
+                await fs.writeFile(filePath, finalContent);
+            }
+        }
+        catch (e) {
+            // 文件读取/写入失败，跳过
+        }
+    }
+}
+/**
+ * 从 tools 字符串中提取 Bash 模式限制。
+ *
+ * 输入: "Read, Write, Bash(ls:*), Bash(npm run dev*), Bash(playcraft skills:*)"
+ * 返回: {
+ *   cleanTools: ["Read", "Write", "Bash"],
+ *   bashPatterns: ["ls:*", "npm run dev*", "playcraft skills:*"]
+ * }
+ */
+function extractBashPatterns(toolsStr) {
+    const tools = toolsStr.split(',').map((t) => t.trim()).filter(Boolean);
+    const cleanTools = [];
+    const bashPatterns = [];
+    let hasBash = false;
+    for (const tool of tools) {
+        const bashMatch = tool.match(/^Bash(?:\((.*)\))?$/);
+        if (bashMatch) {
+            if (bashMatch[1]) {
+                bashPatterns.push(bashMatch[1].trim());
+            }
+            if (!hasBash) {
+                cleanTools.push('Bash');
+                hasBash = true;
+            }
+        }
+        else {
+            cleanTools.push(tool);
+        }
+    }
+    return { cleanTools, bashPatterns };
+}
+/**
+ * 生成 Bash 命令白名单校验脚本。
+ * 写入 .codebuddy/hooks/bash-whitelist-{agentName}.mjs
+ */
+async function generateBashWhitelistScript(agentsDir, agentName, patterns) {
+    const hooksDir = path.join(path.dirname(agentsDir), 'hooks');
+    await fs.mkdir(hooksDir, { recursive: true });
+    // 将 glob 模式转为正则（* → .*，同时转义 / 为 \\/ 避免语法错误）
+    const regexList = patterns.map((p) => {
+        // 先转义 JS regex 特殊字符，再转义 /（regex literal 分隔符）
+        const escaped = p
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+            .replace(/\//g, '\\/')
+            .replace(/\\\*/g, '.*');
+        return `  /^${escaped}/`;
+    }).join(',\n');
+    const script = `#!/usr/bin/env node
+/**
+ * Bash command whitelist for ${agentName} agent.
+ * Generated by playcraft create — do not edit manually.
+ *
+ * Reads PreToolUse hook input from stdin, validates Bash commands against
+ * the whitelist patterns below. Returns exit 0 (allow) or exit 2 (deny).
+ */
+const PATTERNS = [
+${regexList}
+];
+
+try {
+  const input = JSON.parse(await readStdin());
+  if (input.tool_name !== 'Bash') { process.exit(0); }
+  const cmd = input.tool_input?.command || '';
+  const allowed = PATTERNS.some((re) => re.test(cmd));
+  if (!allowed) {
+    process.stderr.write(\`[bash-whitelist-${agentName}] blocked: \${JSON.stringify(cmd)}\n\`);
+    process.exit(2);
+  }
+  process.exit(0);
+} catch (err) {
+  // Parse error — deny out of caution
+  process.stderr.write(\`[bash-whitelist-${agentName}] error: \${err.message}\n\`);
+  process.exit(2);
+}
+
+function readStdin() {
+  return new Promise((resolve) => {
+    let data = '';
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => { resolve(data); });
+  });
+}
+`;
+    await fs.writeFile(path.join(hooksDir, `bash-whitelist-${agentName}.mjs`), script);
+}
+/**
+ * 在 agent YAML frontmatter 中注入 Bash 白名单 PreToolUse hook。
+ */
+function injectBashWhitelistHook(content, agentName) {
+    const bashHookBlock = `  PreToolUse:
+    - matcher: "Bash"
+      hooks:
+        - type: command
+          command: "node $\{CODEBUDDY_PROJECT_DIR}/.codebuddy/hooks/bash-whitelist-${agentName}.mjs"
+          timeout: 5`;
+    // 无 hooks section → 新建
+    if (!/^hooks:/m.test(content)) {
+        return content.replace(/\n---\n/, `\nhooks:\n${bashHookBlock}\n---\n`);
+    }
+    // 已有 hooks → 找到 hooks section 尾部，追加 PreToolUse 条目
+    const hooksIdx = content.indexOf('\nhooks:');
+    const afterHooks = content.slice(hooksIdx + 1);
+    const lines = afterHooks.split('\n');
+    let endLine = 1;
+    while (endLine < lines.length) {
+        const l = lines[endLine];
+        if (!l) {
+            endLine++;
+            continue;
+        }
+        if (l === '---')
+            break;
+        if (l[0] !== ' ' && l[0] !== '\t')
+            break;
+        endLine++;
+    }
+    const before = lines.slice(0, endLine);
+    const after = lines.slice(endLine);
+    return content.slice(0, hooksIdx + 1) + [...before, bashHookBlock, ...after].join('\n');
+}
+/**
+ * 标准化 .codebuddy/skills/ 下所有 skill 的 SKILL.md：
+ * - 将 YAML list 格式的 allowed-tools 转为逗号分隔字符串
+ * - 为使用 ## Skill Definition 格式的平台工具 skill（symlink）
+ *   生成 CodeBuddy 兼容的 wrapper SKILL.md
+ */
+async function normalizeCodeBuddySkills(skillsDir) {
+    let entries;
+    try {
+        entries = await fs.readdir(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        const skillDir = path.join(skillsDir, entry.name);
+        const skillMdPath = path.join(skillDir, 'SKILL.md');
+        let isSymlink = entry.isSymbolicLink();
+        let content;
+        try {
+            content = await fs.readFile(skillMdPath, 'utf-8');
+        }
+        catch {
+            continue; // SKILL.md 不存在
+        }
+        if (isSymlink) {
+            // 平台工具 skill：symlink 指向 node_modules/@playcraft/skills/...
+            // 读取原始内容，创建 CodeBuddy 兼容的 wrapper
+            await createCodeBuddyPlatformSkillWrapper(skillsDir, entry.name, content);
+        }
+        else {
+            // 静态 skill：标准化 allowed-tools YAML list → 逗号分隔
+            const normalized = normalizeSkillAllowedToolsForCodeBuddy(content);
+            if (normalized !== content) {
+                try {
+                    await fs.writeFile(skillMdPath, normalized);
+                }
+                catch {
+                    // 写入失败，跳过
+                }
+            }
+        }
+    }
+}
+/**
+ * 将 SKILL.md 中 YAML list 格式的 allowed-tools 转为 CodeBuddy 逗号分隔字符串格式。
+ * 同时处理空格分隔格式 → 逗号分隔，并清除非标准字段 triggers/compatibility。
+ *
+ * 输入:
+ *   allowed-tools:
+ *     - Bash(npm run state:get:*)
+ *     - Bash(npm run ensure:project:*)
+ *
+ * 输出:
+ *   allowed-tools: Bash(npm run state:get:*), Bash(npm run ensure:project:*)
+ */
+function normalizeSkillAllowedToolsForCodeBuddy(content) {
+    let modified = content;
+    // 清除非标准字段 triggers / compatibility（CodeBuddy 不使用）
+    modified = modified.replace(/^triggers:.*\n?/gm, '').replace(/^compatibility:.*\n?/gm, '');
+    // 情况 1: YAML list 格式
+    const listRegex = /^allowed-tools:\s*\n((?:\s*-\s+['"]?[^\s'"][^'"\n]*['"]?\s*\n?)+)/m;
+    const listMatch = modified.match(listRegex);
+    if (listMatch) {
+        const listBlock = listMatch[1];
+        const tools = listBlock
+            .split('\n')
+            .map((l) => l.trim())
+            .filter((l) => l.startsWith('-'))
+            .map((l) => l.slice(1).trim().replace(/^['"]|['"]$/g, ''));
+        if (tools.length > 0) {
+            // Fix A: 加 \n 防止 --- 粘在值末尾
+            return modified.replace(listRegex, `allowed-tools: ${tools.join(', ')}\n`);
+        }
+    }
+    // 情况 2: 空格分隔字符串格式（如 playwright-cli）
+    const lineMatch = modified.match(/^allowed-tools:\s*(.+)$/m);
+    if (lineMatch) {
+        const value = lineMatch[1].trim();
+        // 已经是逗号分隔 → 保持
+        if (value.includes(','))
+            return modified;
+        // 空格分隔 → 转逗号分隔（括号内空格保留）
+        const tools = parseSpaceSeparatedTools(value);
+        if (tools.length > 1) {
+            return modified.replace(/^allowed-tools:\s*.+$/m, `allowed-tools: ${tools.join(', ')}\n`);
+        }
+    }
+    return modified;
+}
+/**
+ * 解析空格分隔的工具列表，括号内的空格不被视为分隔符。
+ * 例如 "Bash(playwright-cli:*) Bash(npx:*) Bash(playcraft image info:*)"
+ *   → ["Bash(playwright-cli:*)", "Bash(npx:*)", "Bash(playcraft image info:*)"]
+ */
+function parseSpaceSeparatedTools(value) {
+    const tools = [];
+    let depth = 0;
+    let current = '';
+    for (let i = 0; i < value.length; i++) {
+        const ch = value[i];
+        if (ch === '(')
+            depth++;
+        else if (ch === ')')
+            depth--;
+        if (ch === ' ' && depth === 0) {
+            if (current) {
+                tools.push(current);
+                current = '';
+            }
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current)
+        tools.push(current);
+    return tools;
+}
+/** 从 frontmatter 中移除 CodeBuddy 不识别的非标准字段 */
+function stripCodeBuddyFrontmatterFields(content) {
+    return content
+        .replace(/^triggers:.*\n?/gm, '')
+        .replace(/^compatibility:.*\n?/gm, '');
+}
+/**
+ * 为平台工具 skill 创建 CodeBuddy 兼容的 SKILL.md wrapper。
+ *
+ * 平台工具使用 PlayCraft 私有的 ## Skill Definition 格式：
+ *   ## Skill Definition
+ *   tools:
+ *   - bash
+ *   - read
+ *   prompt_extension: |
+ *     你负责...
+ *
+ * CodeBuddy 需要 allowed-tools 在 frontmatter 中。
+ * 此函数删除原始 symlink，创建真实目录并写入兼容的 SKILL.md。
+ */
+async function createCodeBuddyPlatformSkillWrapper(skillsDir, skillName, originalContent) {
+    const originalDir = path.join(skillsDir, skillName);
+    // 解析原始 frontmatter
+    const fm = parseYamlFrontmatter(originalContent);
+    const name = fm.name || skillName;
+    const description = fm.description || '';
+    // 解析 ## Skill Definition 中的 tools 列表
+    const skillDefMatch = originalContent.match(/## Skill Definition\s*\ntools:\s*\n((?:\s*-\s*\w+\s*\n?)+)/);
+    let allowedTools = '';
+    if (skillDefMatch) {
+        const tools = skillDefMatch[1]
+            .split('\n')
+            .map((l) => l.trim())
+            .filter((l) => l.startsWith('-'))
+            .map((l) => l.slice(1).trim())
+            .filter((t) => t.length > 0)
+            // 映射 PlayCraft 工具名 → CodeBuddy 工具名
+            .map((t) => {
+            const lower = t.toLowerCase();
+            if (lower === 'bash')
+                return 'Bash';
+            if (lower === 'read')
+                return 'Read';
+            if (lower === 'write')
+                return 'Write';
+            if (lower === 'edit')
+                return 'Edit';
+            return null;
+        })
+            .filter(Boolean);
+        if (tools.length > 0) {
+            allowedTools = `allowed-tools: ${tools.join(', ')}\n`;
+        }
+    }
+    // 写出体内容（去掉 frontmatter，保留 ## Skill Definition 以下全部）
+    const body = originalContent.replace(/^---\n[\s\S]*?\n---\n?/, '').trim();
+    const wrapper = `---\nname: ${name}\ndescription: ${description}\n${allowedTools}\n---\n\n${body}\n`;
+    try {
+        // 删除原始 symlink
+        await fs.unlink(originalDir);
+        // 创建真实目录
+        await fs.mkdir(originalDir, { recursive: true });
+        // 写入 wrapper SKILL.md
+        await fs.writeFile(path.join(originalDir, 'SKILL.md'), wrapper);
+    }
+    catch {
+        // 操作失败，保持原有 symlink 不破坏
+    }
+}
+/**
+ * 为 CodeBuddy Code 生成独立的 .codebuddy/ 配置目录。
+ * 不再使用 .codebuddy → .claude 全局软连接，而是将 Claude Code
+ * 规范源的内容翻译后复制到 .codebuddy/ 下。
+ */
+async function setupCodeBuddyEnv(targetDir, cliCommandsDir) {
+    const cbcDir = path.join(targetDir, '.codebuddy');
+    const claudeDir = path.join(targetDir, '.claude');
+    // 确保 .codebuddy/ 目录存在
+    await fs.mkdir(cbcDir, { recursive: true });
+    // 1. CODEBUDDY.md — 复用 CLAUDE.md 内容（CodeBuddy 同时从根目录和 .codebuddy/ 读取）
+    const codebuddyMdPath = path.join(cbcDir, 'CODEBUDDY.md');
+    try {
+        const claudeMd = await fs.readFile(path.join(targetDir, 'CLAUDE.md'), 'utf-8');
+        await fs.writeFile(codebuddyMdPath, claudeMd);
+    }
+    catch {
+        // CLAUDE.md 可能不存在，跳过
+    }
+    // 2. agents/ — 复制所有 subagent 定义，并标准化为 CodeBuddy 格式
+    await copyDirRecursive(path.join(claudeDir, 'agents'), path.join(cbcDir, 'agents'));
+    // 标准化 tools 字段：YAML 列表 → 逗号分隔字符串
+    await normalizeCodeBuddyAgents(path.join(cbcDir, 'agents'));
+    // 3. hooks/ — 复制所有 hook 脚本
+    await copyDirRecursive(path.join(claudeDir, 'hooks'), path.join(cbcDir, 'hooks'));
+    // hooks 脚本引用 ../snapshot.mjs，需同步复制到 .codebuddy/ 根层级
+    try {
+        await fs.copyFile(path.join(claudeDir, 'snapshot.mjs'), path.join(cbcDir, 'snapshot.mjs'));
+    }
+    catch {
+        // snapshot.mjs 不存在，跳过
+    }
+    // 4. skills/ — 镜像 skills 目录 + 平台工具 + 标准化
+    await mirrorSkillsDir(path.join(claudeDir, 'skills'), path.join(cbcDir, 'skills'));
+    // 补充 Platform Tool symlinks（使用与 .claude/skills/ 相同的逻辑）
+    await setupPlatformSkillLinksInner(targetDir, cliCommandsDir, '.codebuddy');
+    // 标准化 skills：allowed-tools YAML list → 逗号分隔，平台工具 symlink → wrapper
+    await normalizeCodeBuddySkills(path.join(cbcDir, 'skills'));
+    // 5. settings.json — 翻译 env var + hook 脚本路径
+    const claudeSettingsPath = path.join(claudeDir, 'settings.json');
+    try {
+        const claudeSettingsRaw = await fs.readFile(claudeSettingsPath, 'utf-8');
+        const claudeSettings = JSON.parse(claudeSettingsRaw);
+        const cbcSettings = translateSettingsForCodeBuddy(claudeSettings);
+        await fs.writeFile(path.join(cbcDir, 'settings.json'), JSON.stringify(cbcSettings, null, 2) + '\n');
+    }
+    catch {
+        // settings.json 不存在，跳过
+    }
+    // 6. settings.local.json — 复制并修复硬编码路径
+    const claudeLocalPath = path.join(claudeDir, 'settings.local.json');
+    try {
+        const localRaw = await fs.readFile(claudeLocalPath, 'utf-8');
+        const localSettings = JSON.parse(localRaw);
+        // 移除硬编码的开发者机器路径
+        fixSettingsLocalPermissions(localSettings, targetDir);
+        await fs.writeFile(path.join(cbcDir, 'settings.local.json'), JSON.stringify(localSettings, null, 2) + '\n');
+    }
+    catch {
+        // settings.local.json 不存在或不合法，跳过
+    }
+}
+/**
+ * 移除 settings.local.json 中硬编码的开发者机器路径。
+ * 保留 playcraft 命令相关的 Bash 权限。
+ */
+function fixSettingsLocalPermissions(settings, _targetDir) {
+    const permissions = settings?.permissions;
+    if (!permissions?.allow)
+        return;
+    permissions.allow = permissions.allow.filter((entry) => {
+        // 移除硬编码的绝对路径 Read 权限（如 Read(//Users/cammer/...)）
+        if (entry.startsWith('Read(') && (entry.includes('//Users/') || entry.includes('//home/'))) {
+            return false;
+        }
+        return true;
+    });
+}
+/**
+ * 为 Cursor 生成 .cursor/rules/*.mdc 规则文件。
+ *
+ * Cursor 没有 agent/skill 概念，通过 .cursor/rules/*.mdc 注入上下文。
+ * 翻译策略：
+ *   - CLAUDE.md → alwaysApply: true 的 orchestrator 规则（模板已有）
+ *   - agent 定义 → alwaysApply: false + globs 的 subagent 边界规则（模板已有）
+ *   - 有 paths 字段的 skill → 对应的 .mdc 规则
+ *   - hooks.json 模板已有，不需要额外处理
+ */
+async function setupCursorEnv(targetDir) {
+    const cursorRulesDir = path.join(targetDir, '.cursor', 'rules');
+    const claudeSkillsDir = path.join(targetDir, '.claude', 'skills');
+    try {
+        await fs.access(claudeSkillsDir);
+    }
+    catch {
+        return; // 无 skills 目录，跳过
+    }
+    const skillEntries = await fs.readdir(claudeSkillsDir, { withFileTypes: true });
+    for (const entry of skillEntries) {
+        if (!entry.isDirectory() && !entry.isSymbolicLink())
+            continue;
+        if (!entry.name.startsWith('playcraft-'))
+            continue;
+        const skillMdPath = path.join(claudeSkillsDir, entry.name, 'SKILL.md');
+        try {
+            const content = await fs.readFile(skillMdPath, 'utf-8');
+            const frontmatter = parseYamlFrontmatter(content);
+            const paths = frontmatter.paths;
+            if (!paths)
+                continue;
+            // 将 Skill 翻译为 Cursor .mdc 规则
+            const rulePath = path.join(cursorRulesDir, `${entry.name}.mdc`);
+            const desc = frontmatter.description || entry.name;
+            const globs = Array.isArray(paths) ? paths.join(',') : String(paths);
+            const body = extractSkillBodyForCursor(content);
+            const mdcContent = `---\ndescription: ${desc}\nalwaysApply: false\nglobs: ${globs}\n---\n\n${body}\n`;
+            await fs.writeFile(rulePath, mdcContent);
+        }
+        catch {
+            // SKILL.md 不存在或解析失败，跳过
+        }
+    }
+}
+/** 简易 YAML frontmatter 解析（不依赖外部库） */
+function parseYamlFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const result = {};
+    const lines = match[1].split('\n');
+    let currentKey = null;
+    for (const line of lines) {
+        const keyMatch = line.match(/^(\w[\w-]*):\s*(.*)/);
+        if (keyMatch) {
+            currentKey = keyMatch[1];
+            const value = keyMatch[2].trim();
+            if (value) {
+                // 处理 YAML list: [a, b, c]
+                const listMatch = value.match(/^\[(.*)\]$/);
+                if (listMatch) {
+                    result[currentKey] = listMatch[1].split(',').map((s) => s.trim());
+                }
+                else {
+                    result[currentKey] = value;
+                }
+            }
+            else {
+                // 值为空，可能是多行 list 的开始
+                result[currentKey] = '';
+            }
+        }
+        else if (currentKey && line.startsWith('- ')) {
+            // YAML list item
+            const existing = result[currentKey];
+            if (Array.isArray(existing)) {
+                existing.push(line.slice(2).trim());
+            }
+            else {
+                result[currentKey] = [line.slice(2).trim()];
+            }
+        }
+    }
+    return result;
+}
+/** 从 SKILL.md 提取正文（去掉 YAML frontmatter），截取关键内容给 Cursor */
+function extractSkillBodyForCursor(content) {
+    const body = content.replace(/^---\n[\s\S]*?\n---\n?/, '').trim();
+    // 截取前 3000 字符，避免规则文件过大
+    return body.length > 3000 ? body.slice(0, 3000) + '\n\n... (truncated)' : body;
+}
+/**
+ * 在新项目的指定配置目录下为每个 playcraft-* Platform Tool Skill 创建软连接。
+ *
+ * @param targetDir 项目根目录
+ * @param cliCommandsDir CLI 命令所在目录（用于解析 skills 包位置）
+ * @param configDir 配置目录名（如 '.claude' 或 '.codebuddy'）
+ */
+async function setupPlatformSkillLinksInner(targetDir, cliCommandsDir, configDir) {
+    const skillsLinkDir = path.join(targetDir, configDir, 'skills');
     await fs.mkdir(skillsLinkDir, { recursive: true });
     // 以下 Skill 在项目模板中以静态目录形式存在，不创建软连接覆盖它们。
-    // 这些是仅供可玩广告工作流使用的 Agent 文档类 Skill，不在 @playcraft/skills 包中发布。
     const staticSkills = new Set([
         'playcraft-workflow', // 工作流入口（静态，无包版本）
         'playcraft-research', // 研究协议（静态，无包版本）
@@ -93,8 +782,6 @@ async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
         'playcraft-audio-generation',
     ]);
     // 尝试从 CLI 安装包的位置定位 @playcraft/skills/skills 目录
-    // 打包结构：packages/cli/dist/commands/ → 向上 4 层 → packages/skills/skills（monorepo）
-    //           dist/commands/ → 向上 3 层 → 与 CLI 包同级的 skills/skills（已不适用）
     const candidateDirs = [
         path.resolve(cliCommandsDir, '..', '..', '..', '..', 'skills', 'skills'),
         path.resolve(cliCommandsDir, '..', '..', '..', 'skills', 'skills'),
@@ -131,7 +818,6 @@ async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
     }
     else {
         // 无法立即解析 → 创建指向 node_modules 的相对路径软连接，npm install 后自动激活
-        // 预置已知的 Platform Tool 名称列表，以便在未安装时也能提前创建软连接骨架
         const knownPlatformTools = [
             'playcraft-asset-management',
             'playcraft-audio-generation',
@@ -151,7 +837,6 @@ async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
             'playcraft-sprite-remix',
             'playcraft-sprite-sheet',
             'playcraft-3d-flip-sprite',
-            'playcraft-prefab',
         ];
         for (const name of knownPlatformTools) {
             if (staticSkills.has(name))
@@ -167,6 +852,27 @@ async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
         }
     }
 }
+/**
+ * 在新项目的 .claude/skills/ 下为每个 playcraft-* Platform Tool Skill 创建软连接。
+ */
+async function setupPlatformSkillLinks(targetDir, cliCommandsDir) {
+    return setupPlatformSkillLinksInner(targetDir, cliCommandsDir, '.claude');
+}
+async function runEnsureProject(targetDir) {
+    const ensureScript = path.join(targetDir, 'skills', '_shared', 'scripts', 'ensure-project.mjs');
+    await fs.access(ensureScript);
+    const output = execFileSync(process.execPath, [ensureScript, `--root=${targetDir}`, '--no-install', '--json'], {
+        cwd: targetDir,
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    try {
+        return JSON.parse(output);
+    }
+    catch {
+        return { warnings: ['ensure-project completed but returned non-JSON (JavaScript Object Notation, JavaScript 对象表示法) output'] };
+    }
+}
 export async function createCommand(projectName, options) {
     console.log(pc.cyan('\n🎮 PlayCraft 可玩广告项目创建\n'));
     const baseDir = options.dir ? path.resolve(options.dir) : process.cwd();
@@ -268,40 +974,52 @@ export async function createCommand(projectName, options) {
         // 复制模板
         await copyDir(templateDir, targetDir);
         spinner.succeed('项目模板复制完成');
-        // 动态生成 package.json
-        const pkgSpinner = ora('生成 package.json...').start();
-        const packageJson = {
-            name: toPackageName(name),
-            version: '0.1.0',
-            description: 'PlayCraft Playable Ads project',
-            private: true,
-            scripts: {
-                start: 'playcraft start',
-                build: `playcraft build . -p facebook`,
-                'build:all': `playcraft build-all .`,
-            },
-            devDependencies: {
-                '@playcraft/cli': 'latest',
-                '@playcraft/skills': 'latest',
-            },
-        };
-        await fs.writeFile(path.join(targetDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n', 'utf-8');
-        pkgSpinner.succeed('package.json 生成完成');
-        // 生成 playcraft.config.json
-        const configSpinner = ora('生成 playcraft.config.json...').start();
-        const config = {
-            agent: {
-                projectId,
-                dir: '.',
-                port,
-                ...(skillsDir && { skillsDir }),
-                ...(token && { token }),
-            },
-        };
-        await fs.writeFile(path.join(targetDir, 'playcraft.config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
-        configSpinner.succeed('playcraft.config.json 生成完成');
         // 为 Platform Tool skills 创建 .claude/skills/ 软连接
         await setupPlatformSkillLinks(targetDir, __dirname);
+        // 为 CodeBuddy Code 生成独立的 .codebuddy/ 配置目录
+        const codebuddySpinner = ora('生成 CodeBuddy Code 配置...').start();
+        try {
+            await setupCodeBuddyEnv(targetDir, __dirname);
+            codebuddySpinner.succeed('CodeBuddy Code 配置生成完成');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            codebuddySpinner.warn(`CodeBuddy Code 配置生成跳过: ${message}`);
+        }
+        // 为 Cursor 生成 .cursor/rules/ 规则文件
+        const cursorSpinner = ora('生成 Cursor 配置...').start();
+        try {
+            await setupCursorEnv(targetDir);
+            cursorSpinner.succeed('Cursor 配置生成完成');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            cursorSpinner.warn(`Cursor 配置生成跳过: ${message}`);
+        }
+        // 修复 .claude/settings.local.json 中硬编码的开发者路径
+        try {
+            const localPath = path.join(targetDir, '.claude', 'settings.local.json');
+            const localRaw = await fs.readFile(localPath, 'utf-8');
+            const localSettings = JSON.parse(localRaw);
+            fixSettingsLocalPermissions(localSettings, targetDir);
+            await fs.writeFile(localPath, JSON.stringify(localSettings, null, 2) + '\n');
+        }
+        catch {
+            // settings.local.json 不存在或解析失败，跳过
+        }
+        const ensureSpinner = ora('初始化项目工作流...').start();
+        try {
+            const ensureResult = await runEnsureProject(targetDir);
+            ensureSpinner.succeed('项目工作流初始化完成');
+            for (const warning of ensureResult.warnings ?? []) {
+                console.log(pc.dim(`  ensure-project: ${warning}`));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            ensureSpinner.fail(`项目工作流初始化失败: ${message}`);
+            process.exit(1);
+        }
         const gitSpinner = ora('初始化 Git 仓库...').start();
         try {
             await initGitRepository(targetDir);
@@ -323,7 +1041,13 @@ export async function createCommand(projectName, options) {
         console.log();
         console.log(pc.dim('下一步：'));
         console.log(`  ${pc.cyan(`cd ${name}`)}`);
-        console.log(`  ${pc.cyan('playcraft start')}`);
+        console.log(`  ${pc.cyan('npm install')}`);
+        console.log(`  ${pc.cyan('playcraft skills init-atom-tree --intent "<your game keywords>"')}`);
+        console.log(`  ${pc.cyan('playcraft remix init-template --from-atom-tree')}`);
+        console.log(`  ${pc.cyan('npm run verify:contract && npm run dev')}`);
+        console.log();
+        console.log(pc.dim('如需使用 PlayCraft CLI 打渠道包：'));
+        console.log(`  ${pc.cyan('playcraft build . -p facebook')}`);
         console.log();
         console.log(pc.dim('正式接入 PlayCraft 后，替换项目 ID：'));
         console.log(`  ${pc.cyan(`playcraft config set --key projectId --value <真实项目ID>`)}`);