speccrew 0.1.1 → 0.1.2

package/lib/commands/update.js

@@ -9,7 +9,60 @@ const {
   getWorkspaceTemplatePath,
   copyDirRecursive,
 } = require('../utils');
-const { resolveIDE, getIDEConfig } = require('../ide-adapters');
+const { resolveIDE, getIDEConfig, transformAgentForIDE, transformSkillForIDE } = require('../ide-adapters');
+
+// Get npm package root directory
+function getPackageRoot() {
+  return path.resolve(__dirname, '..', '..');
+}
+
+// Get new .speccrewrc path (inside speccrew-workspace)
+function getNewSpeccrewRCPath(projectRoot) {
+  return path.join(projectRoot, 'speccrew-workspace', '.speccrewrc');
+}
+
+// Get old .speccrewrc path (project root)
+function getOldSpeccrewRCPath(projectRoot) {
+  return path.join(projectRoot, '.speccrewrc');
+}
+
+// Read .speccrewrc with migration support
+function readSpeccrewRCWithMigration(projectRoot) {
+  const newPath = getNewSpeccrewRCPath(projectRoot);
+  const oldPath = getOldSpeccrewRCPath(projectRoot);
+  
+  // Check new location first
+  if (fs.existsSync(newPath)) {
+    try {
+      return JSON.parse(fs.readFileSync(newPath, 'utf8'));
+    } catch (e) {
+      return null;
+    }
+  }
+  
+  // If not in new location, check old location and migrate
+  if (fs.existsSync(oldPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(oldPath, 'utf8'));
+      // Migrate: move to new location
+      fs.mkdirSync(path.dirname(newPath), { recursive: true });
+      fs.writeFileSync(newPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+      fs.unlinkSync(oldPath);
+      return config;
+    } catch (e) {
+      return null;
+    }
+  }
+  
+  return null;
+}
+
+// Write .speccrewrc to new location
+function writeSpeccrewRCNew(projectRoot, config) {
+  const newPath = getNewSpeccrewRCPath(projectRoot);
+  fs.mkdirSync(path.dirname(newPath), { recursive: true });
+  fs.writeFileSync(newPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
 
 // 解析命令行参数
 function parseArgs() {
@@ -60,31 +113,52 @@ function getAllDirs(dir, baseDir = dir, result = []) {
 }
 
 // 复制文件并返回是否实际复制（目标不存在或内容不同）
-function copyFileIfChanged(src, dest) {
+// contentTransform: 可选的内容转换函数 (content: string) => string
+function copyFileIfChanged(src, dest, contentTransform = null) {
   if (!fs.existsSync(src)) return { copied: false, isNew: false };
   
   const destExists = fs.existsSync(dest);
   if (!destExists) {
     fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(src, dest);
+    if (contentTransform) {
+      const srcContent = fs.readFileSync(src, 'utf8');
+      const transformedContent = contentTransform(srcContent);
+      fs.writeFileSync(dest, transformedContent, 'utf8');
+    } else {
+      fs.copyFileSync(src, dest);
+    }
     return { copied: true, isNew: true };
   }
   
   // 比较文件内容
-  const srcContent = fs.readFileSync(src);
-  const destContent = fs.readFileSync(dest);
-  if (srcContent.equals(destContent)) {
+  const srcContent = fs.readFileSync(src, 'utf8');
+  const destContent = fs.readFileSync(dest, 'utf8');
+  
+  // 如果有转换函数，比较转换后的内容
+  const srcContentToCompare = contentTransform ? contentTransform(srcContent) : srcContent;
+  
+  if (srcContentToCompare === destContent) {
     return { copied: false, isNew: false };
   }
   
-  fs.copyFileSync(src, dest);
+  // 写入转换后的内容（如果有转换函数）
+  if (contentTransform) {
+    fs.writeFileSync(dest, srcContentToCompare, 'utf8');
+  } else {
+    fs.copyFileSync(src, dest);
+  }
   return { copied: true, isNew: false };
 }
 
 // 更新 agents 目录
-function updateAgents(srcDir, destDir, stats) {
+function updateAgents(srcDir, destDir, stats, ideConfig = null) {
   if (!fs.existsSync(srcDir)) return;
   
+  // 确定 contentTransform 函数
+  const contentTransform = (ideConfig && ideConfig.transformFrontmatter)
+    ? (content) => transformAgentForIDE(content, ideConfig)
+    : null;
+  
   const entries = fs.readdirSync(srcDir, { withFileTypes: true });
   for (const entry of entries) {
     if (!entry.isFile()) continue;
@@ -93,7 +167,7 @@ function updateAgents(srcDir, destDir, stats) {
     const srcPath = path.join(srcDir, entry.name);
     const destPath = path.join(destDir, entry.name);
     
-    const result = copyFileIfChanged(srcPath, destPath);
+    const result = copyFileIfChanged(srcPath, destPath, contentTransform);
     if (result.isNew) {
       stats.added++;
     } else if (result.copied) {
@@ -117,7 +191,7 @@ function updateAgents(srcDir, destDir, stats) {
 }
 
 // 递归更新 skills 目录
-function updateSkillsRecursive(srcDir, destDir, stats, currentRelPath = '') {
+function updateSkillsRecursive(srcDir, destDir, stats, currentRelPath = '', ideConfig = null) {
   if (!fs.existsSync(srcDir)) return;
   
   // 确保目标目录存在
@@ -136,14 +210,20 @@ function updateSkillsRecursive(srcDir, destDir, stats, currentRelPath = '') {
       if (!isSpeccrewFile(entry.name)) continue;
       
       const dirStats = { added: 0, updated: 0 };
-      updateSkillsRecursive(srcPath, destPath, stats, relPath);
+      updateSkillsRecursive(srcPath, destPath, stats, relPath, ideConfig);
     } else {
       // 在 speccrew-* 目录下的文件
       // 检查是否在 speccrew-* 父目录下
       const parentDir = path.basename(srcDir);
       if (!isSpeccrewFile(parentDir)) continue;
       
-      const result = copyFileIfChanged(srcPath, destPath);
+      // 对 SKILL.md 文件应用 frontmatter 转化（如果需要）
+      const isSkillMd = entry.name === 'SKILL.md';
+      const contentTransform = (isSkillMd && ideConfig && ideConfig.transformFrontmatter)
+        ? (content) => transformSkillForIDE(content, ideConfig)
+        : null;
+      
+      const result = copyFileIfChanged(srcPath, destPath, contentTransform);
       if (result.isNew) {
         stats.added++;
       } else if (result.copied) {
@@ -175,7 +255,7 @@ function updateSkillsRecursive(srcDir, destDir, stats, currentRelPath = '') {
 }
 
 // 更新 skills 目录（入口）
-function updateSkills(srcDir, destDir, stats) {
+function updateSkills(srcDir, destDir, stats, ideConfig = null) {
   if (!fs.existsSync(srcDir)) return;
   
   // 确保目标目录存在
@@ -197,7 +277,7 @@ function updateSkills(srcDir, destDir, stats) {
     
     // 递归复制技能目录
     const skillStats = { added: 0, updated: 0, extra: [], extraDirs: [] };
-    updateSkillsRecursive(srcSkillDir, destSkillDir, skillStats, entry.name);
+    updateSkillsRecursive(srcSkillDir, destSkillDir, skillStats, entry.name, ideConfig);
     
     if (isNewSkill) {
       // 如果是全新技能，计算文件数量作为 added
@@ -235,16 +315,61 @@ function updateWorkspaceDocs(srcDir, destDir, stats) {
     const destPath = path.join(destDir, entry.name);
     
     if (entry.isDirectory()) {
-      const subStats = { updated: 0 };
+      const subStats = { updated: 0, added: 0 };
       updateWorkspaceDocs(srcPath, destPath, subStats);
       stats.updated += subStats.updated;
+      stats.added += subStats.added;
     } else {
       const result = copyFileIfChanged(srcPath, destPath);
-      if (result.copied || result.isNew) {
+      if (result.isNew) {
+        stats.added++;
+      } else if (result.copied) {
+        stats.updated++;
+      }
+    }
+  }
+}
+
+// 更新 npm 包文档 (GETTING-STARTED*.md 和 README*.md)
+function updatePackageDocs(packageRoot, workspaceDir, stats) {
+  // Update GETTING-STARTED*.md files from docs/ directory
+  const packageDocsDir = path.join(packageRoot, 'docs');
+  const destDocsDir = path.join(workspaceDir, 'docs');
+  
+  if (fs.existsSync(packageDocsDir)) {
+    const entries = fs.readdirSync(packageDocsDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile()) continue;
+      if (!entry.name.startsWith('GETTING-STARTED') || !entry.name.endsWith('.md')) continue;
+      
+      const srcPath = path.join(packageDocsDir, entry.name);
+      const destPath = path.join(destDocsDir, entry.name);
+      
+      const result = copyFileIfChanged(srcPath, destPath);
+      if (result.isNew) {
+        stats.added++;
+      } else if (result.copied) {
         stats.updated++;
       }
     }
   }
+  
+  // Update README*.md files from package root
+  const entries = fs.readdirSync(packageRoot, { withFileTypes: true });
+  for (const entry of entries) {
+    if (!entry.isFile()) continue;
+    if (!entry.name.startsWith('README') || !entry.name.endsWith('.md')) continue;
+    
+    const srcPath = path.join(packageRoot, entry.name);
+    const destPath = path.join(workspaceDir, entry.name);
+    
+    const result = copyFileIfChanged(srcPath, destPath);
+    if (result.isNew) {
+      stats.added++;
+    } else if (result.copied) {
+      stats.updated++;
+    }
+  }
 }
 
 // 主函数
@@ -253,8 +378,8 @@ function run() {
     const args = parseArgs();
     const projectRoot = process.cwd();
     
-    // 读取 .speccrewrc
-    const rc = readSpeccrewRC(projectRoot);
+    // 读取 .speccrewrc (with migration support)
+    const rc = readSpeccrewRCWithMigration(projectRoot);
     if (!rc) {
       console.error('Error: .speccrewrc not found. Please run "speccrew init" first.');
       process.exit(1);
@@ -283,7 +408,8 @@ function run() {
     const totalStats = {
       agents: { updated: 0, added: 0 },
       skills: { updated: 0, added: 0 },
-      workspaceDocs: { updated: 0 },
+      workspaceDocs: { updated: 0, added: 0 },
+      packageDocs: { updated: 0, added: 0 },
       extra: [],
       extraDirs: [],
     };
@@ -294,7 +420,7 @@ function run() {
       const srcAgentsDir = path.join(sourceRoot, 'agents');
       const destAgentsDir = path.join(projectRoot, ide.agentsDir);
       const agentStats = { updated: 0, added: 0, extra: [] };
-      updateAgents(srcAgentsDir, destAgentsDir, agentStats);
+      updateAgents(srcAgentsDir, destAgentsDir, agentStats, ide);
       totalStats.agents.updated += agentStats.updated;
       totalStats.agents.added += agentStats.added;
       totalStats.extra.push(...agentStats.extra);
@@ -303,7 +429,7 @@ function run() {
       const srcSkillsDir = path.join(sourceRoot, 'skills');
       const destSkillsDir = path.join(projectRoot, ide.skillsDir);
       const skillStats = { updated: 0, added: 0, extra: [], extraDirs: [] };
-      updateSkills(srcSkillsDir, destSkillsDir, skillStats);
+      updateSkills(srcSkillsDir, destSkillsDir, skillStats, ide);
       totalStats.skills.updated += skillStats.updated;
       totalStats.skills.added += skillStats.added;
       totalStats.extra.push(...skillStats.extra);
@@ -313,14 +439,23 @@ function run() {
     // 更新 workspace docs
     const srcDocsDir = path.join(workspaceTemplatePath, 'docs');
     const destDocsDir = path.join(projectRoot, 'speccrew-workspace', 'docs');
-    const docsStats = { updated: 0 };
+    const docsStats = { updated: 0, added: 0 };
     updateWorkspaceDocs(srcDocsDir, destDocsDir, docsStats);
     totalStats.workspaceDocs.updated = docsStats.updated;
+    totalStats.workspaceDocs.added = docsStats.added;
+    
+    // 更新 npm 包文档 (GETTING-STARTED*.md and README*.md)
+    const packageRoot = getPackageRoot();
+    const workspaceDir = path.join(projectRoot, 'speccrew-workspace');
+    const packageDocsStats = { updated: 0, added: 0 };
+    updatePackageDocs(packageRoot, workspaceDir, packageDocsStats);
+    totalStats.packageDocs.updated = packageDocsStats.updated;
+    totalStats.packageDocs.added = packageDocsStats.added;
     
     // 更新 .speccrewrc
     rc.version = currentVersion;
     rc.updatedAt = new Date().toISOString();
-    writeSpeccrewRC(projectRoot, rc);
+    writeSpeccrewRCNew(projectRoot, rc);
     
     // 输出结果
     if (installedVersion === currentVersion) {
@@ -331,7 +466,7 @@ function run() {
     
     console.log(`Agents: ${totalStats.agents.updated} updated, ${totalStats.agents.added} added`);
     console.log(`Skills: ${totalStats.skills.updated} updated, ${totalStats.skills.added} added`);
-    console.log(`Workspace docs: ${totalStats.workspaceDocs.updated} updated`);
+    console.log(`Docs: ${totalStats.packageDocs.updated + totalStats.workspaceDocs.updated} updated, ${totalStats.packageDocs.added + totalStats.workspaceDocs.added} added`);
     
     // 输出警告
     const allExtras = [...new Set([...totalStats.extra, ...totalStats.extraDirs])];

package/lib/ide-adapters.js

@@ -13,6 +13,23 @@ const IDE_CONFIGS = {
     baseDir: '.cursor',
     skillsDir: '.cursor/skills',
     agentsDir: '.cursor/agents',
+    transformFrontmatter: true,
+    agentDefaults: {
+      model: 'inherit',
+      readonly: false,
+      is_background: false,
+    },
+    unsupportedTools: ['WebFetch', 'WebSearch', 'Task', 'Skill', 'SearchCodebase'],
+  },
+  claude: {
+    name: 'Claude',
+    baseDir: '.claude',
+    skillsDir: '.claude/skills',
+    agentsDir: '.claude/agents',
+    transformFrontmatter: true,
+    agentToolsAction: 'filter',       // 保留 tools 但过滤不支持的
+    skillToolsAction: 'rename',       // tools → allowed-tools
+    unsupportedTools: ['WebFetch', 'WebSearch', 'Task', 'Skill', 'SearchCodebase'],
   },
 };
 
@@ -45,8 +62,11 @@ function resolveIDE(projectRoot, cliIdeArg) {
     return [getIDEConfig(cliIdeArg)];
   }
   
-  // 2. 从 .speccrewrc 读取
-  const rcPath = path.join(projectRoot, '.speccrewrc');
+  // 2. 从 .speccrewrc 读取（先检查 workspace 目录，再检查旧位置）
+  const workspaceRcPath = path.join(projectRoot, 'speccrew-workspace', '.speccrewrc');
+  const oldRcPath = path.join(projectRoot, '.speccrewrc');
+  const rcPath = fs.existsSync(workspaceRcPath) ? workspaceRcPath : oldRcPath;
+  
   if (fs.existsSync(rcPath)) {
     try {
       const rc = JSON.parse(fs.readFileSync(rcPath, 'utf8'));
@@ -70,4 +90,238 @@ function resolveIDE(projectRoot, cliIdeArg) {
   return detected;
 }
 
-module.exports = { IDE_CONFIGS, detectIDE, getIDEConfig, resolveIDE };
+/**
+ * 解析 frontmatter，返回 { frontmatter: string, body: string, parsed: object }
+ * 如果没有 frontmatter，返回 { frontmatter: null, body: content, parsed: null }
+ */
+function parseFrontmatter(content) {
+  // Normalize line endings for cross-platform compatibility
+  content = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+  
+  const frontmatterRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
+  const match = content.match(frontmatterRegex);
+  
+  if (!match) {
+    return { frontmatter: null, body: content, parsed: null };
+  }
+  
+  const frontmatter = match[1];
+  const body = content.slice(match[0].length);
+  
+  // 简单解析 YAML 为对象（只处理简单的 key: value 格式）
+  const parsed = {};
+  const lines = frontmatter.split('\n');
+  let currentKey = null;
+  let currentValue = null;
+  
+  for (const line of lines) {
+    const trimmed = line.trim();
+    
+    // 跳过空行
+    if (!trimmed) continue;
+    
+    // 检测 key: value 格式（支持多行列表）
+    const keyMatch = line.match(/^(\w+):\s*(.*)$/);
+    
+    if (keyMatch) {
+      // 保存之前的 key
+      if (currentKey !== null) {
+        parsed[currentKey] = currentValue;
+      }
+      currentKey = keyMatch[1];
+      currentValue = keyMatch[2].trim();
+    } else if (currentKey !== null && line.startsWith('  - ')) {
+      // 多行列表项
+      if (!Array.isArray(currentValue)) {
+        currentValue = currentValue ? [currentValue] : [];
+      }
+      currentValue.push(trimmed.replace(/^- /, ''));
+    }
+  }
+  
+  // 保存最后一个 key
+  if (currentKey !== null) {
+    parsed[currentKey] = currentValue;
+  }
+  
+  return { frontmatter, body, parsed };
+}
+
+/**
+ * 将对象序列化为 YAML frontmatter 字符串
+ */
+function serializeFrontmatter(obj) {
+  const lines = [];
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === undefined || value === null) continue;
+    
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        lines.push(`${key}: []`);
+      } else {
+        lines.push(`${key}:`);
+        for (const item of value) {
+          lines.push(`  - ${item}`);
+        }
+      }
+    } else {
+      lines.push(`${key}: ${value}`);
+    }
+  }
+  return `---\n${lines.join('\n')}\n---\n`;
+}
+
+/**
+ * 从正文提取第一个非空非标题段落作为 description
+ */
+function extractDescriptionFromBody(body) {
+  const lines = body.split('\n');
+  let inCodeBlock = false;
+  let paragraph = '';
+  
+  for (const line of lines) {
+    const trimmed = line.trim();
+    
+    // 处理代码块
+    if (trimmed.startsWith('```')) {
+      inCodeBlock = !inCodeBlock;
+      continue;
+    }
+    
+    if (inCodeBlock) continue;
+    
+    // 跳过标题行和空行
+    if (trimmed.startsWith('#') || !trimmed) {
+      // 如果已经积累了段落内容，返回它
+      if (paragraph) {
+        return paragraph.slice(0, 200).trim();
+      }
+      continue;
+    }
+    
+    // 积累段落内容
+    paragraph += (paragraph ? ' ' : '') + trimmed;
+    
+    // 如果遇到空行且已有段落内容，结束段落
+    if (paragraph && !trimmed) {
+      return paragraph.slice(0, 200).trim();
+    }
+  }
+  
+  return paragraph ? paragraph.slice(0, 200).trim() : '';
+}
+
+/**
+ * 过滤工具列表，移除不支持的工具
+ * @param {string} toolsStr - 逗号或空格分隔的工具列表字符串
+ * @param {string[]} unsupportedTools - 不支持的工具名数组
+ * @returns {string} - 过滤后的工具列表字符串（逗号+空格分隔）
+ */
+function filterTools(toolsStr, unsupportedTools) {
+  if (!toolsStr || !unsupportedTools || unsupportedTools.length === 0) {
+    return toolsStr;
+  }
+  const tools = toolsStr.split(/[,\s]+/).map(t => t.trim()).filter(Boolean);
+  const filtered = tools.filter(t => !unsupportedTools.includes(t));
+  return filtered.join(', ');
+}
+
+/**
+ * 将 Agent .md 文件的 frontmatter 从 Qoder 格式转为 Cursor 格式
+ * @param {string} content - 原始文件内容
+ * @param {object} ideConfig - IDE 配置对象
+ * @returns {string} - 转换后的内容
+ */
+function transformAgentForIDE(content, ideConfig) {
+  const { frontmatter, body, parsed } = parseFrontmatter(content);
+  
+  if (!parsed) {
+    // 没有 frontmatter，直接返回原内容
+    return content;
+  }
+
+  // 处理 tools 字段
+  if (ideConfig.agentToolsAction === 'filter' && parsed.tools) {
+    // Claude: 保留 tools 但过滤掉不支持的工具
+    const filtered = filterTools(parsed.tools, ideConfig.unsupportedTools);
+    if (filtered) {
+      parsed.tools = filtered;
+    } else {
+      delete parsed.tools;
+    }
+  } else {
+    // 默认行为（Cursor等）：移除 tools 字段
+    delete parsed.tools;
+  }
+
+  // 如果没有 description，从正文提取
+  if (!parsed.description) {
+    const extractedDesc = extractDescriptionFromBody(body);
+    if (extractedDesc) {
+      parsed.description = extractedDesc;
+    }
+  }
+
+  // 添加 agentDefaults 中的字段（不覆盖已存在的）
+  if (ideConfig.agentDefaults) {
+    for (const [key, value] of Object.entries(ideConfig.agentDefaults)) {
+      if (!(key in parsed)) {
+        parsed[key] = value;
+      }
+    }
+  }
+
+  // 重新组装 frontmatter 和 body
+  const newFrontmatter = serializeFrontmatter(parsed);
+  return newFrontmatter + body;
+}
+
+/**
+ * 将 Skill SKILL.md 的 frontmatter 转化
+ * @param {string} content - 原始文件内容
+ * @param {object} ideConfig - IDE 配置对象
+ * @returns {string} - 转换后的内容
+ */
+function transformSkillForIDE(content, ideConfig) {
+  const { frontmatter, body, parsed } = parseFrontmatter(content);
+
+  if (!parsed) {
+    // 没有 frontmatter，直接返回原内容
+    return content;
+  }
+
+  // 处理 tools 字段
+  if (ideConfig.skillToolsAction === 'rename' && parsed.tools) {
+    // Claude: tools → allowed-tools（过滤后）
+    const filtered = filterTools(parsed.tools, ideConfig.unsupportedTools);
+    if (filtered) {
+      parsed['allowed-tools'] = filtered;
+    }
+    delete parsed.tools;
+  } else {
+    // 默认行为（Cursor等）：移除 tools 字段
+    delete parsed.tools;
+  }
+  
+  // 如果没有 description，从正文提取
+  if (!parsed.description) {
+    const extractedDesc = extractDescriptionFromBody(body);
+    if (extractedDesc) {
+      parsed.description = extractedDesc;
+    }
+  }
+  
+  // 重新组装 frontmatter 和 body
+  const newFrontmatter = serializeFrontmatter(parsed);
+  return newFrontmatter + body;
+}
+
+module.exports = {
+  IDE_CONFIGS,
+  detectIDE,
+  getIDEConfig,
+  resolveIDE,
+  transformAgentForIDE,
+  transformSkillForIDE,
+  filterTools,
+};

package/lib/utils.js

@@ -1,8 +1,8 @@
 const fs = require('fs');
 const path = require('path');
 
-// 递归复制目录，支持过滤函数
-function copyDirRecursive(src, dest, filter) {
+// 递归复制目录，支持过滤函数和内容转换
+function copyDirRecursive(src, dest, filter, contentTransform) {
   if (!fs.existsSync(src)) return { copied: 0, skipped: 0 };
   
   fs.mkdirSync(dest, { recursive: true });
@@ -19,12 +19,27 @@ function copyDirRecursive(src, dest, filter) {
     }
     
     if (entry.isDirectory()) {
-      const sub = copyDirRecursive(srcPath, destPath, filter);
+      const sub = copyDirRecursive(srcPath, destPath, filter, contentTransform);
       copied += sub.copied;
       skipped += sub.skipped;
     } else {
-      fs.copyFileSync(srcPath, destPath);
-      copied++;
+      // 如果提供了 contentTransform，尝试转换内容
+      if (contentTransform) {
+        const originalContent = fs.readFileSync(srcPath, 'utf8');
+        const transformedContent = contentTransform(originalContent, entry.name, srcPath);
+        
+        if (transformedContent != null) {
+          fs.writeFileSync(destPath, transformedContent, 'utf8');
+          copied++;
+        } else {
+          // transform 返回 null/undefined，按原方式复制
+          fs.copyFileSync(srcPath, destPath);
+          copied++;
+        }
+      } else {
+        fs.copyFileSync(srcPath, destPath);
+        copied++;
+      }
     }
   }
   return { copied, skipped };
@@ -47,8 +62,9 @@ function readSpeccrewRC(projectRoot) {
 }
 
 // 写入 .speccrewrc 配置
-function writeSpeccrewRC(projectRoot, config) {
-  const rcPath = path.join(projectRoot, '.speccrewrc');
+// targetDir: 目标目录（通常是 workspace 目录）
+function writeSpeccrewRC(targetDir, config) {
+  const rcPath = path.join(targetDir, '.speccrewrc');
   fs.writeFileSync(rcPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speccrew",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Spec-Driven Development toolkit for AI-powered IDEs",
   "author": "charlesmu99",
   "repository": {
@@ -18,8 +18,13 @@
     "bin/",
     "lib/",
     ".speccrew/",
-    "workspace-template/"
+    "workspace-template/",
+    "docs/",
+    "README*.md"
   ],
+  "scripts": {
+    "postinstall": "node bin/postinstall.js"
+  },
   "engines": {
     "node": ">=16.0.0"
   },