jsharness 1.0.0

package/lib/index.mjs

@@ -0,0 +1,778 @@
+/**
+ * Harness Engineering - Core Library
+ * 
+ * 多适配器架构：检测 AI 工具 → 转换规则格式 → 注入到对应位置
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// ============================================================
+// 支持的 AI 工具清单
+// ============================================================
+
+export const SUPPORTED_TOOLS = [
+  {
+    id: 'codebuddy',
+    name: 'CodeBuddy (腾讯云代码助手)',
+    description: '.codebuddy/rules/ + .codebuddy/skills/',
+    detector: hasDir('.codebuddy') || hasFile('CODEBUDDY.md'),
+    priority: 100,
+    ruleFormat: 'markdown',
+    skillFormat: 'markdown',
+  },
+  {
+    id: 'cursor',
+    name: 'Cursor',
+    description: '.cursorrules 文件',
+    detector: hasFile('.cursorrules'),
+    priority: 90,
+    ruleFormat: 'cursor-md',
+    skillFormat: null, // Cursor 不支持独立 skills
+  },
+  {
+    id: 'copilot',
+    name: 'GitHub Copilot',
+    description: '.github/copilot-instructions.md',
+    detector: hasDir('.github'),
+    priority: 80,
+    ruleFormat: 'copilot-md',
+    skillFormat: null,
+  },
+  {
+    id: 'windsurf',
+    name: 'Windsurf (Codeium)',
+    description: '.windsurfrules 目录',
+    detector: hasFile('.windsurfrules') || hasDir('.windsurf'),
+    priority: 70,
+    ruleFormat: 'windsurf-md',
+    skillFormat: null,
+  },
+  {
+    id: 'continue',
+    name: 'Continue (VS Code)',
+    description: 'continue.config.json',
+    detector: hasFile('continue.config.json'),
+    priority: 60,
+    ruleFormat: 'continue-json',
+    skillFormat: null,
+  },
+  {
+    id: 'cline',
+    name: 'Cline (VS Code)',
+    description: '.clinerules 文件',
+    detector: hasFile('.clinerules'),
+    priority: 50,
+    ruleFormat: 'cline-md',
+    skillFormat: null,
+  },
+  {
+    id: 'qoder',
+    name: 'Qoder (阿里云)',
+    description: '.qoder/rules/ 目录',
+    detector: hasDir('.qoder'),
+    priority: 95,
+    ruleFormat: 'markdown',
+    skillFormat: 'markdown',
+  },
+  {
+    id: 'codex',
+    name: 'Codex CLI (OpenAI)',
+    description: 'AGENTS.md 文件（项目根目录）',
+    detector: hasFile('AGENTS.md') || hasDir('.codex'),
+    priority: 85,
+    ruleFormat: 'agents-md',
+    skillFormat: null,
+  },
+  {
+    id: 'claude-code',
+    name: 'Claude Code (Anthropic)',
+    description: '.claude/rules/ + CLAUDE.md',
+    detector: hasFile('CLAUDE.md') || hasDir('.claude'),
+    priority: 93,
+    ruleFormat: 'claude-rules-md',
+    skillFormat: 'claude-skills-md',
+  },
+  {
+    id: 'trae',
+    name: 'Trae (字节跳动)',
+    description: '.trae/rules/project_rules.md',
+    detector: hasDir('.trae') || hasFile('.trae/rules/project_rules.md'),
+    priority: 75,
+    ruleFormat: 'trae-rules-md',
+    skillFormat: null,
+  },
+];
+
+// ============================================================
+// 检测工具函数
+// ============================================================
+
+function hasDir(name) {
+  return () => fs.existsSync(name) && fs.lstatSync(name).isDirectory();
+}
+
+function hasFile(name) {
+  return () => fs.existsSync(name) && fs.lstatSync(name).isFile();
+}
+
+/**
+ * 自动检测当前项目使用的 AI 工具
+ */
+export function detectTool(projectDir) {
+  const results = [];
+  
+  for (const tool of SUPPORTED_TOOLS) {
+    try {
+      const detectFn = tool.detector;
+      const isDetected = typeof detectFn === 'function' 
+        ? detectFn() 
+        : fs.existsSync(path.join(projectDir, typeof detectFn === 'string' ? detectFn : ''));
+      
+      if (isDetected) {
+        results.push({ ...tool, detected: true });
+      }
+    } catch {
+      // 检测失败，跳过
+    }
+  }
+
+  // 按优先级排序，返回最匹配的
+  results.sort((a, b) => b.priority - a.priority);
+  return results;
+}
+
+// ============================================================
+// 规则转换引擎
+// ============================================================
+
+/**
+ * 将 .harness/rules/*.md 转换为目标工具的格式
+ */
+export function transformRules(ruleFiles, targetToolId, options = {}) {
+  const transformer = RULE_TRANSFORMERS[targetToolId] || RULE_TRANSFORMERS['generic'];
+  return transformer(ruleFiles, options);
+}
+
+/**
+ * 将 .harness/skills/*.md 转换为目标工具的格式
+ */
+export function transformSkills(skillFiles, targetToolId, options = {}) {
+  const transformer = SKILL_TRANSFORMERS[targetToolId] || SKILL_TRANSFORMERS['generic'];
+  return transformer(skillFiles, options);
+}
+
+// ============================================================
+// 各工具格式的转换器
+// ============================================================
+
+const RULE_TRANSFORMERS = {
+
+  /** CodeBuddy: 原样复制 .md 到 .codebuddy/rules/ */
+  codebuddy(ruleFiles, opts) {
+    const outputs = [];
+    for (const file of ruleFiles) {
+      const content = fs.readFileSync(file.path, 'utf-8');
+      outputs.push({
+        relativePath: `.codebuddy/rules/${file.name}`,
+        content,
+        source: file.path,
+      });
+    }
+    return { format: 'directory', files: outputs };
+  },
+
+  /** Cursor: 合并所有规则为 .cursorrules */
+  cursor(ruleFiles, opts) {
+    let content = `# Harness Engineering Rules\n`;
+    content += `> Generated by hariness on ${new Date().toISOString().split('T')[0]}\n\n`;
+    
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      content += extractBody(raw);
+      content += '\n---\n\n';
+    }
+    
+    return { format: 'single-file', files: [{ relativePath: '.cursorrules', content }] };
+  },
+
+  /** GitHub Copilot: 合并为 .github/copilot-instructions.md */
+  copilot(ruleFiles, opts) {
+    let content = `# Project Rules & Guidelines\n\n`;
+    content += `## Harness Engineering System\n\n`;
+    
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      content += `### ${extractTitle(raw)}\n\n`;
+      content += extractBody(raw);
+      content += '\n\n';
+    }
+    
+    return { format: 'single-file', files: [{ relativePath: '.github/copilot-instructions.md', content }] };
+  },
+
+  /** Windsurf: .windsurfrules 格式 */
+  windsurf(ruleFiles, opts) {
+    let content = '';
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      content += `<rules>\n`;
+      content += `<rule name="${file.name.replace('.md', '')}">\n`;
+      content += extractBody(raw).trim();
+      content += `\n</rule>\n</rules>\n\n`;
+    }
+    return { format: 'single-file', files: [{ relativePath: '.windsurfrules', content }] };
+  },
+
+  /** Continue: continue.config.json 格式 */
+  continue(ruleFiles, opts) {
+    const rules = [];
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      rules.push({
+        name: file.name.replace('.md', ''),
+        type: 'rule',
+        description: extractDescription(raw),
+        content: extractBody(raw),
+      });
+    }
+    const config = { rules };
+    const content = JSON.stringify(config, null, 2);
+    return { format: 'json-config', files: [{ relativePath: 'continue.config.json', content }] };
+  },
+
+  /** Cline: .clinerules 格式（类似 Cursor） */
+  cline(ruleFiles, opts) {
+    let content = `# Harness Engineering Rules for Cline\n\n`;
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      content += `## ${extractTitle(raw)}\n\n`;
+      content += extractBody(raw);
+      content += '\n---\n\n';
+    }
+    return { format: 'single-file', files: [{ relativePath: '.clinerules', content }] };
+  },
+
+  /**
+   * ================================================================
+   * 新增工具适配器 (v1.1+)
+   * ================================================================
+   */
+
+  /** Qoder: 原样复制 .md 到 .qoder/rules/ (与 CodeBuddy 相同模式) */
+  qoder(ruleFiles, opts) {
+    const outputs = [];
+    for (const file of ruleFiles) {
+      const content = fs.readFileSync(file.path, 'utf-8');
+      outputs.push({
+        relativePath: `.qoder/rules/${file.name}`,
+        content,
+        source: file.path,
+      });
+    }
+    return { format: 'directory', files: outputs };
+  },
+
+  /** Codex CLI: 合并所有规则为 AGENTS.md（项目根目录） */
+  codex(ruleFiles, opts) {
+    let content = `# Harness Engineering - Project Instructions for Codex CLI\n`;
+    content += `> Generated by hariness on ${new Date().toISOString().split('T')[0]}\n`;
+    content += `> Source: .harness/ rules & skills system\n\n`;
+
+    // Codex AGENTS.md 推荐结构：Commands / Architecture / Conventions / Important
+    content += `## Overview\n\n`;
+    content += `This project uses **Harness Engineering** system with the following tech stack:\n\n`;
+    content += `- Frontend: Vue3 + Vite + TypeScript + Pinia + Element Plus\n`;
+    content += `- Backend: Spring Boot 3.2 + JDK21 + MyBatis-Plus + Nacos\n\n`;
+
+    content += `---\n\n## Conventions & Rules\n\n`;
+
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      content += `### ${extractTitle(raw)}\n\n`;
+      content += extractBody(raw);
+      content += '\n\n';
+    }
+
+    // 追加 Skills 摘要
+    content += `---\n\n## Available Build/Test Skills\n\n`;
+    content += 'See .harness/skills/ directory for detailed build, lint, test, and review procedures.\n';
+    content += `- \`npm run build\` — Vue3 frontend production build\n`;
+    content += `- \`mvn compile test\` — Java backend build with tests\n`;
+    content += `- \`node .harness/gate/index.js\` — Run gate compliance checks\n\n`;
+
+    return { format: 'single-file', files: [{ relativePath: 'AGENTS.md', content }] };
+  },
+
+  /** Claude Code: 输出为 .claude/rules/*.md（支持 paths: frontmatter 路径限定） */
+  'claude-code'(ruleFiles, opts) {
+    const outputs = [];
+
+    // 生成 CLAUDE.md 主文件（精简版，<200行）
+    let claudeMd = `# Harness Engineering System\n\n`;
+    claudeMd += `> Auto-generated by hariness. Full rules in \`.claude/rules/\`\n\n`;
+    claudeMd += `## Tech Stack\n`;
+    claudeMd += `- **Frontend**: Vue3 + Vite + TypeScript + Pinia + Element Plus\n`;
+    claudeMd += `- **Backend**: Spring Boot 3.2 (JDK21 Virtual Threads) + MyBatis-Plus\n\n`;
+    claudeMd += `## Commands\n`;
+    claudeMd += `\`\`\`bash\n`;
+    claudeMd += `npm run build          # Frontend build\n`;
+    claudeMd += `npm run lint           # ESLint check\n`;
+    claudeMd += `mvn compile test       # Backend build + test\n`;
+    claudeMd += `node .harness/gate/index.js   # Gate checks\n`;
+    claudeMd += `\`\`\`\n\n`;
+    claudeMd += `> Detailed rules are loaded from \`.claude/rules/\` files below.\n`;
+
+    outputs.push({ relativePath: 'CLAUDE.md', content: claudeMd });
+
+    // 为每个规则文件生成独立的 .claude/rules/*.md，带路径限定 frontmatter
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      const body = extractBody(raw);
+
+      // 根据规则类别决定 paths 范围
+      let scopePaths = null;
+      if (file.category === 'project') {
+        if (file.relativePath.includes('vue3') || file.relativePath.includes('frontend') || file.relativePath.includes('web')) {
+          scopePaths = ['src/**/*.{ts,vue,js}', '**/*.{ts,vue,js}'];
+        } else if (file.relativePath.includes('java') || file.relativePath.includes('backend')) {
+          scopePaths = ['src/main/**/*.java', '**/*.java'];
+        }
+      }
+
+      let content = '';
+      if (scopePaths) {
+        content += `---\npaths:\n`;
+        for (const p of scopePaths) {
+          content += `  - "${p}"\n`;
+        }
+        content += `---\n\n`;
+      }
+
+      content += body;
+
+      outputs.push({
+        relativePath: `.claude/rules/${file.name}`,
+        content,
+        source: file.path,
+      });
+    }
+
+    return { format: 'multi-file', files: outputs };
+  },
+
+  /** Trae: 合并为 .trae/rules/project_rules.md */
+  trae(ruleFiles, opts) {
+    let content = `# Harness Engineering Rules for Trae\n\n`;
+    content += `> Generated by hariness on ${new Date().toISOString().split('T')[0]}\n\n`;
+    content += `## 技术栈\n\n`;
+    content += `- 前端: Vue3 + Vite + TypeScript + Pinia + Element Plus\n`;
+    content += `- 后端: Spring Boot 3.2 + JDK21 + MyBatis-Plus\n\n`;
+    content += `---\n\n`;
+
+    for (const file of ruleFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      content += `### ${extractTitle(raw)}\n\n`;
+      content += extractBody(raw);
+      content += '\n\n---\n\n';
+    }
+
+    return { format: 'single-file', files: [{ relativePath: '.trae/rules/project_rules.md', content }] };
+  },
+
+  /** Generic fallback */
+  generic(ruleFiles, opts) {
+    return RULE_TRANSFORMERS.codebuddy(ruleFiles, opts);
+  },
+};
+
+const SKILL_TRANSFORMERS = {
+
+  /** CodeBuddy: 复制到 .codebuddy/skills/ */
+  codebuddy(skillFiles, opts) {
+    const outputs = [];
+    for (const file of skillFiles) {
+      const content = fs.readFileSync(file.path, 'utf-8');
+      outputs.push({
+        relativePath: `.codebuddy/skills/${file.name}`,
+        content,
+        source: file.path,
+      });
+    }
+    return { format: 'directory', files: outputs };
+  },
+
+  /** 不支持 skills 的工具 → 合并到规则文件中 */
+  generic(skillFiles, opts) {
+    const outputs = [];
+    for (const file of skillFiles) {
+      const content = fs.readFileSync(file.path, 'utf-8');
+      outputs.push({
+        relativePath: `.harness/skills/${file.name}`, // 保持原始位置作为参考
+        content,
+        source: file.path,
+      });
+    }
+    return { format: 'reference', files: outputs };
+  },
+
+  /** Qoder: 复制到 .qoder/skills/ */
+  qoder(skillFiles, opts) {
+    const outputs = [];
+    for (const file of skillFiles) {
+      const content = fs.readFileSync(file.path, 'utf-8');
+      outputs.push({
+        relativePath: `.qoder/skills/${file.name}`,
+        content,
+        source: file.path,
+      });
+    }
+    return { format: 'directory', files: outputs };
+  },
+
+  /** Claude Code: 复制到 .claude/skills/ (Claude 支持自动触发的 skills) */
+  'claude-code'(skillFiles, opts) {
+    const outputs = [];
+    for (const file of skillFiles) {
+      const raw = fs.readFileSync(file.path, 'utf-8');
+      const body = extractBody(raw);
+
+      // Claude Code skills 格式：YAML frontmatter + Markdown body
+      let content = `---\n`;
+      content += `name: ${file.name.replace('.md', '')}\n`;
+      content += `description: Harness Engineering Skill - ${extractDescription(raw) || file.name}\n`;
+      // 自动触发条件
+      const lowerName = file.name.toLowerCase();
+      if (lowerName.includes('build')) content += `trigger_type: manual\n`;
+      else if (lowerName.includes('test')) content += `trigger_type: on_save\n`;
+      else if (lowerName.includes('lint') || lowerName.includes('review')) content += `trigger_type: on_pr\n`;
+      else content += `trigger_type: manual\n`;
+      content += `---\n\n`;
+
+      content += body;
+
+      outputs.push({
+        relativePath: `.claude/skills/${file.name}`,
+        content,
+        source: file.path,
+      });
+    }
+    return { format: 'directory', files: outputs };
+  },
+};
+
+// ============================================================
+// Markdown 解析辅助函数
+// ============================================================
+
+function extractTitle(markdown) {
+  const match = markdown.match(/^#\s+(.+)/m);
+  return match ? match[1].trim() : 'Untitled Rule';
+}
+
+function extractDescription(markdown) {
+  // 尝试提取第一段描述性文字
+  const body = markdown.replace(/^#.+/gm, '').trim();
+  const firstPara = body.match(/^(.+)/m);
+  return firstPara ? firstPara[1].slice(0, 120) : '';
+}
+
+function extractBody(markdown) {
+  // 移除 frontmatter (--- ... ---)
+  let body = markdown;
+  if (body.startsWith('---')) {
+    const endIdx = body.indexOf('---', 3);
+    if (endIdx > 0) {
+      body = body.slice(endIdx + 3).trim();
+    }
+  }
+  return body;
+}
+
+// ============================================================
+// 扫描 Harness 源文件
+// ============================================================
+
+export function scanHarnessRules(harnessDir, stackFilter) {
+  const rulesDir = path.join(harnessDir, 'rules');
+  const results = [];
+
+  function scanDir(dir, category) {
+    if (!fs.existsSync(dir)) return;
+    const entries = fs.readdirSync(dir).filter(f => f.endsWith('.md'));
+    for (const entry of entries) {
+      const filePath = path.join(dir, entry);
+      const relPath = path.relative(harnessDir, filePath);
+
+      // 技术栈过滤
+      if (stackFilter && stackFilter !== 'all') {
+        const lowerRel = relPath.toLowerCase();
+        if (stackFilter === 'vue3' && !lowerRel.includes('vue') && !lowerRel.includes('frontend') && !lowerRel.includes('global')) {
+          // 对于 vue3 过滤，保留 global 和 frontend/vue 相关
+          if (!lowerRel.includes('global') && !lowerRel.includes('frontend') && !lowerRel.includes('web')) {
+            continue;
+          }
+        }
+        if (stackFilter === 'java' && !lowerRel.includes('java') && !lowerRel.includes('backend') && !lowerRel.includes('global')) {
+          if (!lowerRel.includes('global') && !lowerRel.includes('backend')) {
+            continue;
+          }
+        }
+      }
+
+      results.push({
+        name: entry,
+        path: filePath,
+        category,
+        relativePath: relPath,
+      });
+    }
+  }
+
+  scanDir(path.join(rulesDir, 'global'), 'global');
+  scanDir(path.join(rulesDir, 'project'), 'project');
+
+  return results;
+}
+
+export function scanHarnessSkills(harnessDir, stackFilter) {
+  const skillsDir = path.join(harnessDir, 'skills');
+  const results = [];
+
+  if (!fs.existsSync(skillsDir)) return results;
+
+  const entries = fs.readdirSync(skillsDir).filter(f => f.endsWith('.md'));
+  for (const entry of entries) {
+    const filePath = path.join(skillsDir, entry);
+    results.push({
+      name: entry,
+      path: filePath,
+      category: 'skill',
+      relativePath: path.relative(harnessDir, filePath),
+    });
+  }
+
+  return results;
+}
+
+// ============================================================
+// 写入目标位置
+// ============================================================
+
+export function injectOutputs(projectDir, outputs, options = {}) {
+  const { force = false, verbose = false } = options;
+  const written = [];
+  const skipped = [];
+
+  for (const output of outputs) {
+    const targetPath = path.join(projectDir, output.relativePath);
+    const targetDir = path.dirname(targetPath);
+
+    // 创建目录
+    if (!fs.existsSync(targetDir)) {
+      fs.mkdirSync(targetDir, { recursive: true });
+    }
+
+    // 检查是否已存在
+    if (fs.existsSync(targetPath) && !force) {
+      skipped.push(output.relativePath);
+      if (verbose) console.log(`  ⏭  跳过 (已存在): ${output.relativePath}`);
+      continue;
+    }
+
+    fs.writeFileSync(targetPath, output.content, 'utf-8');
+    written.push(output.relativePath);
+    if (verbose) console.log(`  ✅ 已写入: ${output.relativePath}`);
+  }
+
+  return { written, skipped };
+}
+
+// ============================================================
+// CLI 命令实现
+// ============================================================
+
+export async function runInit(projectDir, options = {}) {
+  const {
+    tool: requestedTool,
+    stack = 'all',
+    rulesOnly = false,
+    skillsOnly = false,
+    force = false,
+    verbose = false,
+  } = options;
+
+  console.log('\n🔧 Harness Engineering 初始化');
+  console.log(`   目标目录: ${projectDir}\n`);
+
+  // 1. 确定 Harness 源路径
+  const harnessDir = findHarnessSource(projectDir);
+  if (!harnessDir) {
+    console.error('❌ 未找到 .harness/ 目录。请确保在包含 .harness/ 的项目或包中运行。');
+    process.exit(1);
+  }
+  if (verbose) console.log(`   📂 Harness 源: ${harnessDir}`);
+
+  // 2. 检测或指定 AI 工具
+  let targetTools = [];
+  if (requestedTool) {
+    const found = SUPPORTED_TOOLS.find(t => t.id === requestedTool || t.name.includes(requestedTool));
+    if (found) {
+      targetTools = [{ ...found, detected: true }];
+    } else {
+      console.error(`❌ 不支持的工具: ${requestedTool}`);
+      console.log(`   可用工具: ${SUPPORTED_TOOLS.map(t => t.id).join(', ')}`);
+      process.exit(1);
+    }
+  } else {
+    targetTools = detectTool(projectDir);
+    if (targetTools.length === 0) {
+      console.log('⚠️  未自动检测到 AI 工具。将使用默认模式（CodeBuddy 格式）。\n');
+      console.log('   提示: 使用 --tool <name> 指定工具，或运行 npx hariness list-tools 查看');
+      targetTools = [{ ...SUPPORTED_TOOLS[0], detected: true }]; // 默认 CodeBuddy
+    } else {
+      console.log(`🔍 检测到的 AI 工具:`);
+      for (const t of targetTools) {
+        console.log(`   • ${t.name} (${t.description})`);
+      }
+      console.log('');
+    }
+  }
+
+  // 3. 扫描源文件
+  const allRuleFiles = scanHarnessRules(harnessDir, stack);
+  const allSkillFiles = scanHarnessSkills(harnessDir, stack);
+
+  if (verbose) {
+    console.log(`📋 扫描结果: ${allRuleFiles.length} 个规则, ${allSkillFiles.length} 个技能\n`);
+  }
+
+  // 4. 对每个目标工具执行注入
+  const summary = [];
+
+  for (const tool of targetTools) {
+    console.log(`\n━━━ 注入到 ${tool.name} ━━━`);
+
+    const outputs = [];
+
+    // 注入 Rules
+    if (!skillsOnly && allRuleFiles.length > 0) {
+      console.log(`\n📜 注入规则 (${allRuleFiles.length} 个)...`);
+      const result = transformRules(allRuleFiles, tool.id, { stack });
+      outputs.push(...result.files);
+    }
+
+    // 注入 Skills
+    if (!rulesOnly && allSkillFiles.length > 0) {
+      console.log(`⚡ 注入技能 (${allSkillFiles.length} 个)...`);
+      const result = transformSkills(allSkillFiles, tool.id, { stack });
+      outputs.push(...result.files);
+    }
+
+    // 写入文件
+    const { written, skipped } = injectOutputs(projectDir, outputs, { force, verbose });
+
+    summary.push({ tool: tool.name, written, skipped });
+  }
+
+  // 5. 输出总结
+  console.log('\n═════════════════════════════');
+  console.log('✅ 初始化完成！');
+  
+  for (const s of summary) {
+    if (s.written.length > 0) {
+      console.log(`\n  [${s.tool}]`);
+      console.log(`  ✅ 写入 ${s.written.length} 个文件:`);
+      s.written.forEach(f => console.log(`     - ${f}`));
+    }
+    if (s.skipped.length > 0) {
+      console.log(`  ⏭  跳过 ${s.skipped.length} 个文件 (已存在):`);
+      s.skipped.forEach(f => console.log(`     - ${f}`));
+    }
+  }
+
+  if (!force && summary.some(s => s.skipped.length > 0)) {
+    console.log('\n💡 提示: 使用 --force 可覆盖已有配置');
+  }
+
+  console.log('\n🎉 Harness 规则已注入到你的 AI 工具中！开始对话即可生效。\n');
+}
+
+export function listTools() {
+  console.log('\n支持的 AI 编程工具:\n');
+
+  for (const tool of SUPPORTED_TOOLS) {
+    const status = tool.detector ? '✅' : '○ ';
+    console.log(`${status}  ${tool.id.padEnd(14)} ${tool.name}`);
+    console.log(`   格式: ${tool.ruleFormat}${tool.skillFormat ? ' + ' + tool.skillFormat : ''}`);
+    console.log(`   说明: ${tool.description}`);
+    console.log('');
+  }
+
+  console.log('使用方法:');
+  console.log('  npx hariness init --tool <id>');
+  console.log('');
+}
+
+export function showStatus(projectDir) {
+  console.log('\n📊 Harness 项目状态\n');
+
+  // 检查 .harness 是否存在
+  const harnessDir = path.join(projectDir, '.harness');
+  const hasHarness = fs.existsSync(harnessDir);
+  console.log(`  Harness 源: ${hasHarness ? '✅ 存在' : '❌ 缺失'} (.harness/)`);
+
+  if (hasHarness) {
+    const rulesCount = scanHarnessRules(harnessDir, 'all').length;
+    const skillsCount = scanHarnessSkills(harnessDir, 'all').length;
+    console.log(`  规则数量:   ${rulesCount}`);
+    console.log(`  技能数量:   ${skillsCount}`);
+  }
+
+  // 检查各工具状态
+  const detected = detectTool(projectDir);
+  console.log(`  AI 工具:    ${detected.length > 0 ? detected.map(t => t.name).join(', ') : '(未检测到)'}`);
+
+  // 检查已注入的目标文件
+  const targets = [
+    { name: 'CodeBuddy', path: '.codebuddy/rules/' },
+    { name: 'Qoder', path: '.qoder/rules/' },
+    { name: 'Cursor', path: '.cursorrules' },
+    { name: 'Copilot', path: '.github/copilot-instructions.md' },
+    { name: 'Windsurf', path: '.windsurfrules' },
+    { name: 'Continue', path: 'continue.config.json' },
+    { name: 'Cline', path: '.clinerules' },
+    { name: 'Codex CLI', path: 'AGENTS.md' },
+    { name: 'Claude Code', path: '.claude/rules/' },
+    { name: 'Trae', path: '.trae/rules/project_rules.md' },
+  ];
+
+  console.log('\n  注入状态:');
+  for (const t of targets) {
+    const fullPath = path.join(projectDir, t.path);
+    const exists = fs.existsSync(fullPath);
+    console.log(`    ${exists ? '✅' : '○ '} ${t.name.padEnd(12)} ${t.path}`);
+  }
+
+  console.log('');
+}
+
+// ============================================================
+// 内部：查找 Harness 源
+// ============================================================
+
+function findHarnessSource(projectDir) {
+  // 1. 项目自身的 .harness/
+  const localHarness = path.join(projectDir, '.harness');
+  if (fs.existsSync(localHarness)) return localHarness;
+
+  // 2. npm 包内的 harness（当本包被安装后）
+  // __dirname 指向 lib/，向上两级到包根，再到 .harness/
+  const packageHarness = path.join(__dirname, '..', '..', '.harness');
+  if (fs.existsSync(packageHarness)) return packageHarness;
+
+  return null;
+}