@kafka0102/onespec 0.1.2 → 0.2.2

package/src/cli.js

@@ -1,20 +1,24 @@
-import { execFileSync } from 'node:child_process';
 import path from 'node:path';
-import readline from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
+import { readFile } from 'node:fs/promises';
+import { checkbox, select, confirm } from '@inquirer/prompts';
 
 import { doctorProject } from './doctor.js';
-import { initProject, SUPPORTED_LANGUAGES } from './init.js';
-
-const OPEN_SPEC_CLI_PACKAGE = '@fission-ai/openspec@latest';
-const SUPERPOWERS_PACKAGE = 'obra/superpowers';
+import { SUPPORTED_LANGUAGES } from './init.js';
+import { getPlatform, PLATFORMS } from './platforms.js';
+import {
+  detectExistingOneSpecPlatforms,
+  detectPlatforms,
+  initWorkspace,
+  parsePlatformList,
+  SUPPORTED_PLATFORM_IDS,
+} from './setup.js';
 
 function parseArgs(argv) {
   const args = [...argv];
   const command = args.shift() ?? 'help';
   const options = {
     targetPath: process.cwd(),
-    platform: 'codex',
+    platforms: [],
     scope: undefined,
     language: undefined,
     yes: false,
@@ -43,7 +47,7 @@ function parseArgs(argv) {
         options.language = args.shift();
         break;
       case '--platform':
-        options.platform = args.shift() ?? 'codex';
+        options.platforms.push(args.shift() ?? '');
         break;
       default:
         if (arg?.startsWith('-')) {
@@ -57,135 +61,141 @@ function parseArgs(argv) {
   return { command, options };
 }
 
-function commandExists(command) {
-  try {
-    const checker = process.platform === 'win32' ? 'where' : 'which';
-    execFileSync(checker, [command], { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
+async function selectScope(options) {
+  if (options.scope) return options.scope;
+  if (options.yes) return 'project';
+
+  return select({
+    message: 'Install scope:',
+    choices: [
+      { name: 'Project (current directory)', value: 'project' },
+      { name: 'Global (home directory)', value: 'global' },
+    ],
+  });
 }
 
-async function askInitOptions(options) {
-  if (options.yes) {
-    return {
-      ...options,
-      scope: options.scope ?? 'project',
-      language: options.language ?? 'zh',
-      installOpenSpecCli: false,
-      initOpenSpecProject: false,
-      installSuperpowers: false,
-    };
-  }
+async function selectLanguage(options) {
+  if (options.yes) return 'zh';
 
-  const preflight = await doctorProject(options.targetPath, {
-    platform: options.platform,
-    scope: options.scope ?? 'project',
+  const langId = await select({
+    message: 'Language for OneSpec skills:',
+    choices: Object.entries(SUPPORTED_LANGUAGES).map(([id, lang]) => ({ name: lang.name, value: id })),
   });
-  const rl = readline.createInterface({ input, output });
-  try {
-    const scopeAnswer =
-      options.scope ??
-      (await rl.question('安装范围？输入 project 或 global（默认 project）：'));
-    const resolvedScope = scopeAnswer.trim() || 'project';
-    const languageAnswer =
-      options.language ??
-      (await rl.question('Skill 语言？输入 zh 或 en（默认 zh）：'));
-    const overwriteAnswer = options.overwrite
-      ? 'yes'
-      : await rl.question('如果 OneSpec skill 已存在，是否覆盖？输入 yes 或 no（默认 no）：');
-    const installOpenSpecCliAnswer =
-      preflight.openspecCli.available
-        ? 'no'
-        : await rl.question(
-            `未检测到 OpenSpec CLI。是否现在执行 npm install -g ${OPEN_SPEC_CLI_PACKAGE} ？输入 yes 或 no（默认 no）：`,
-          );
-    const initOpenSpecProjectAnswer =
-      resolvedScope === 'project' && !preflight.hasOpenSpecProject
-        ? await rl.question(
-            '当前项目未初始化 OpenSpec。是否在安装 OneSpec 后执行 openspec init？输入 yes 或 no（默认 no）：',
-          )
-        : 'no';
-    const installSuperpowersAnswer = preflight.superpowers.available
-      ? 'no'
-      : await rl.question(
-          `未检测到 Superpowers。是否现在执行 npx skills add ${SUPERPOWERS_PACKAGE} -a codex${resolvedScope === 'global' ? ' -g' : ''} -y ？输入 yes 或 no（默认 no）：`,
-        );
 
+  return langId;
+}
+
+async function selectPlatforms(detected, options) {
+  const choices = SUPPORTED_PLATFORM_IDS.map((platformId) => {
+    const platform = getPlatform(platformId);
     return {
-      ...options,
-      scope: resolvedScope,
-      language: languageAnswer.trim() || 'zh',
-      overwrite: options.overwrite || ['y', 'yes', '是', '覆盖'].includes(overwriteAnswer.trim()),
-      installOpenSpecCli: ['y', 'yes', '是'].includes(installOpenSpecCliAnswer.trim()),
-      initOpenSpecProject: ['y', 'yes', '是'].includes(initOpenSpecProjectAnswer.trim()),
-      installSuperpowers: ['y', 'yes', '是'].includes(installSuperpowersAnswer.trim()),
+      name: `${platform.name}${detected.has(platformId) ? ' (detected)' : ''}`,
+      value: platformId,
+      checked: detected.has(platformId),
     };
-  } finally {
-    rl.close();
+  });
+
+  if (options.yes) {
+    const selected = [...detected];
+    return selected.length > 0 ? selected : ['codex'];
   }
-}
 
-function runCommand(command, args, cwd = process.cwd()) {
-  execFileSync(command, args, {
-    cwd,
-    stdio: 'inherit',
-    shell: process.platform === 'win32',
-  });
+  return checkbox({ message: 'Select platforms to set up:', choices, required: true });
 }
 
-function getNpxExecutable() {
-  return process.platform === 'win32' ? 'npx.cmd' : 'npx';
+async function askOverwrite(existingPlatforms, options) {
+  if (options.overwrite || existingPlatforms.length === 0) {
+    return options.overwrite;
+  }
+
+  return confirm({
+    message: `OneSpec skills already exist for ${existingPlatforms.join(', ')}. Overwrite existing items?`,
+    default: false,
+  });
 }
 
-async function ensureRequestedDependencies(targetPath, options, preflight) {
-  if (options.installOpenSpecCli && !preflight.openspecCli.available) {
-    runCommand('npm', ['install', '-g', OPEN_SPEC_CLI_PACKAGE]);
-  }
+async function askInitOptions(options) {
+  const explicitPlatforms = parsePlatformList(options.platforms);
+  const detectedPlatforms = await detectPlatforms(options.targetPath);
+  const defaultPlatforms = explicitPlatforms.length > 0 ? explicitPlatforms : detectedPlatforms.length > 0 ? detectedPlatforms : ['codex'];
 
-  if (options.installSuperpowers && !preflight.superpowers.available) {
-    const args = ['skills', 'add', SUPERPOWERS_PACKAGE, '-a', 'codex', '-y'];
-    if (options.scope === 'global') {
-      args.push('-g');
-    }
-    runCommand(getNpxExecutable(), args, targetPath);
+  if (options.yes) {
+    return {
+      ...options,
+      scope: options.scope ?? 'project',
+      language: options.language ?? 'zh',
+      platforms: defaultPlatforms,
+    };
   }
 
-  if (options.initOpenSpecProject && !preflight.hasOpenSpecProject) {
-    runCommand('openspec', ['init', targetPath], targetPath);
-  }
+  const detectedSet = new Set(detectedPlatforms);
+  const selectedPlatforms = explicitPlatforms.length > 0 ? explicitPlatforms : await selectPlatforms(detectedSet, options);
+  const resolvedScope = await selectScope(options);
+  const language = await selectLanguage(options);
+  const existingPlatforms = await detectExistingOneSpecPlatforms(
+    options.targetPath,
+    resolvedScope,
+    selectedPlatforms,
+  );
+  const overwrite = await askOverwrite(existingPlatforms, options);
+
+  return {
+    ...options,
+    platforms: selectedPlatforms,
+    scope: resolvedScope,
+    language,
+    overwrite,
+  };
 }
 
 function printHelp() {
   console.log(`OneSpec Skill Installer
 
 用法：
-  onespec init [path] [--yes] [--overwrite] [--scope project|global] [--language zh|en]
-  onespec doctor [path] [--scope project|global]
+  onespec init [path] [--yes] [--overwrite] [--scope project|global] [--language zh|en] [--platform ${SUPPORTED_PLATFORM_IDS.join('|')}[,...]]
+  onespec doctor [path] [--scope project|global] [--platform ${SUPPORTED_PLATFORM_IDS.join('|')}]
 
 说明：
-  当前提供中英文 Skill bundle，暂仅支持 Codex 平台。
+  当前提供中英文 Skill bundle，官方支持 ${SUPPORTED_PLATFORM_IDS.join(' / ')}。
+  init 会引导选择 agent，并自动安装 OpenSpec / Superpowers / OneSpec。
 `);
 }
 
+let cachedVersion;
+
+async function getPackageVersion() {
+  if (cachedVersion) {
+    return cachedVersion;
+  }
+
+  const packageJsonPath = new URL('../package.json', import.meta.url);
+  const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+  cachedVersion = packageJson.version;
+  return cachedVersion;
+}
+
 function printSummary(result) {
   console.log('\nOneSpec 初始化完成\n');
-  console.log(`安装位置：${result.skillPath}`);
+  console.log(`目标平台：${result.platformNames.join(', ')}`);
   console.log(`安装范围：${result.scope}`);
   console.log(`Skill 语言：${result.languageName} (${result.language})`);
-  console.log(`Skill 状态：${result.installedSkill ? '已安装/已覆盖' : '已存在，已跳过'}`);
-  console.log(`已安装 Skills：${result.installedSkills.join(', ') || '无'}`);
-  console.log(`已跳过 Skills：${result.skippedSkills.join(', ') || '无'}`);
-  console.log(`工作目录：${path.join(result.projectPath, 'docs', 'superpowers')}`);
-  console.log('\n环境检查：');
-  console.log(`OpenSpec CLI：${commandExists('openspec') ? '已找到' : '未找到，请先安装或运行 openspec init'}`);
-  console.log('Superpowers：请确认 Codex 可发现 brainstorming / writing-plans / using-git-worktrees 等 skills');
-  console.log('\n开始使用：在 Codex 中输入 “使用 onespec：<你的任务描述>”。\n');
+  console.log(`OpenSpec CLI：${result.openspecCli.status === 'installed' ? '已自动安装' : '已存在'}`);
+  console.log(`OpenSpec Tools：${result.openspec.toolIds.join(', ')}`);
+  console.log(`Superpowers Agents：${result.superpowers.agents.join(', ')}`);
+  for (const platformResult of result.results) {
+    const platformLabel = `${platformResult.platformName} (${platformResult.platform})`;
+    const skillStatus = platformResult.installedSkill ? '已安装/已覆盖' : '已存在，已跳过';
+    console.log(`- ${platformLabel}：${skillStatus} -> ${platformResult.skillPath}`);
+  }
+  if (result.scope === 'project') {
+    console.log(`工作目录：${path.join(result.projectPath, 'docs', 'superpowers')}`);
+  }
+  console.log('\n开始使用：重启对应 agent 会话后，直接输入 “使用 onespec：<你的任务描述>”。\n');
 }
 
 function printDoctor(report) {
   console.log('\nOneSpec 环境检查\n');
+  console.log(`目标平台：${report.platformName} (${report.platform})`);
   console.log(`OneSpec Skill：${report.onespec.installed ? '已安装' : '未安装'}`);
   console.log(`OneSpec 子 Skills：${report.onespec.installedSkills.join(', ') || '无'}`);
   console.log(`缺少 OneSpec 子 Skills：${report.onespec.missingSkills.join(', ') || '无'}`);
@@ -205,6 +215,10 @@ function printDoctor(report) {
 export async function main(argv = process.argv.slice(2)) {
   const { command, options } = parseArgs(argv);
 
+  if (command === 'version' || command === '--version' || command === '-v') {
+    console.log(await getPackageVersion());
+    return;
+  }
   if (command === 'help' || command === '--help' || command === '-h') {
     printHelp();
     return;
@@ -214,8 +228,9 @@ export async function main(argv = process.argv.slice(2)) {
   }
 
   if (command === 'doctor') {
+    const doctorPlatforms = parsePlatformList(options.platforms);
     const report = await doctorProject(options.targetPath, {
-      platform: options.platform,
+      platform: doctorPlatforms[0],
       scope: options.scope ?? 'project',
     });
     if (options.json) {
@@ -230,12 +245,7 @@ export async function main(argv = process.argv.slice(2)) {
   if (!SUPPORTED_LANGUAGES[initOptions.language]) {
     throw new Error(`Unsupported language: ${initOptions.language}`);
   }
-  const preflight = await doctorProject(initOptions.targetPath, {
-    platform: initOptions.platform,
-    scope: initOptions.scope ?? 'project',
-  });
-  await ensureRequestedDependencies(initOptions.targetPath, initOptions, preflight);
-  const result = await initProject(initOptions.targetPath, initOptions);
+  const result = await initWorkspace(initOptions.targetPath, initOptions);
   if (initOptions.json) {
     console.log(JSON.stringify(result, null, 2));
   } else {

package/src/doctor.js

@@ -3,8 +3,8 @@ import { access, readFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 
-import { BUNDLED_ONESPEC_SKILLS } from './init.js';
-import { getSkillDir, PLATFORMS } from './platforms.js';
+import { BUNDLED_ONESPEC_REFERENCE_FILES, BUNDLED_ONESPEC_SKILLS } from './init.js';
+import { getDiscoveryRoots, getPlatform, getSkillDir } from './platforms.js';
 
 const REQUIRED_SUPERPOWERS = [
   'brainstorming',
@@ -41,8 +41,12 @@ function defaultCommandChecker(command) {
 function defaultSkillRoots(projectPath, scope, platform) {
   return [
     getSkillDir(projectPath, scope, platform),
-    path.join(os.homedir(), '.codex', 'skills'),
+    ...getDiscoveryRoots(projectPath, platform),
+    path.join(os.homedir(), '.claude', 'skills'),
     path.join(os.homedir(), '.codex', 'superpowers', 'skills'),
+    path.join(os.homedir(), '.cursor', 'skills'),
+    path.join(os.homedir(), '.gemini', 'skills'),
+    path.join(os.homedir(), '.copilot', 'skills'),
     path.join(os.homedir(), '.agents', 'skills'),
   ];
 }
@@ -60,7 +64,9 @@ async function isChineseOneSpec(projectPath, scope, platform) {
   const skillsDir = getSkillDir(projectPath, scope, platform);
   const installedSkills = [];
   const missingSkills = [];
+  const missingFiles = [];
   const skillPaths = {};
+  const referencePaths = {};
 
   for (const skillName of BUNDLED_ONESPEC_SKILLS) {
     const skillPath = path.join(skillsDir, skillName, 'SKILL.md');
@@ -72,14 +78,24 @@ async function isChineseOneSpec(projectPath, scope, platform) {
     }
   }
 
+  for (const referenceFile of BUNDLED_ONESPEC_REFERENCE_FILES) {
+    const referencePath = path.join(skillsDir, 'onespec', referenceFile);
+    referencePaths[referenceFile] = referencePath;
+    if (!(await exists(referencePath))) {
+      missingFiles.push(path.join('onespec', referenceFile));
+    }
+  }
+
   const routerPath = skillPaths.onespec;
   if (!(await exists(routerPath))) {
     return {
       installed: false,
       skillPath: routerPath,
       skillPaths,
+      referencePaths,
       installedSkills,
       missingSkills,
+      missingFiles,
       chinese: false,
     };
   }
@@ -88,11 +104,13 @@ async function isChineseOneSpec(projectPath, scope, platform) {
   const chinese = content.includes('OneSpec 工作流');
   const english = content.includes('# OneSpec Workflow');
   return {
-    installed: missingSkills.length === 0 && (chinese || english),
+    installed: missingSkills.length === 0 && missingFiles.length === 0 && (chinese || english),
     skillPath: routerPath,
     skillPaths,
+    referencePaths,
     installedSkills,
     missingSkills,
+    missingFiles,
     chinese,
     english,
     language: chinese ? 'zh' : english ? 'en' : 'unknown',
@@ -101,20 +119,16 @@ async function isChineseOneSpec(projectPath, scope, platform) {
 
 export async function doctorProject(projectPath, options = {}) {
   const resolvedProject = path.resolve(projectPath);
-  const platform = options.platform ?? 'codex';
+  const platform = getPlatform(options.platform ?? 'codex');
   const scope = options.scope ?? 'project';
   const commandChecker = options.commandChecker ?? defaultCommandChecker;
 
-  if (!PLATFORMS[platform]) {
-    throw new Error(`Unsupported platform "${platform}". Currently only "codex" is supported.`);
-  }
-
-  const onespec = await isChineseOneSpec(resolvedProject, scope, platform);
+  const onespec = await isChineseOneSpec(resolvedProject, scope, platform.id);
   const skillRoots =
     options.skillRoots ??
     [
       ...new Set([
-        ...defaultSkillRoots(resolvedProject, scope, platform),
+        ...defaultSkillRoots(resolvedProject, scope, platform.id),
         ...(options.extraSkillRoots ?? []),
       ]),
     ];
@@ -139,29 +153,41 @@ export async function doctorProject(projectPath, options = {}) {
   const nextSteps = [];
   if (onespec.missingSkills.length > 0) {
     nextSteps.push(
-      `缺少 OneSpec Skills：${onespec.missingSkills.join(', ')}。运行 \`onespec init --overwrite\` 补齐 OneSpec Skill bundle。`,
+      `缺少 OneSpec Skills：${onespec.missingSkills.join(', ')}。运行 \`onespec init --platform ${platform.id} --overwrite\` 补齐 OneSpec Skill bundle。`,
+    );
+  } else if (onespec.missingFiles.length > 0) {
+    nextSteps.push(
+      `缺少 OneSpec references：${onespec.missingFiles.join(', ')}。运行 \`onespec init --platform ${platform.id} --overwrite\` 补齐 OneSpec Skill bundle。`,
     );
   } else if (!onespec.installed) {
-    nextSteps.push('运行 `onespec init --yes` 安装 OneSpec Skill。');
+    nextSteps.push(`运行 \`onespec init --platform ${platform.id} --yes\` 安装 OneSpec Skill。`);
   } else if (!onespec.chinese && !onespec.english) {
-    nextSteps.push('当前 OneSpec Skill 无法识别语言版本，运行 `onespec init --overwrite` 覆盖安装。');
+    nextSteps.push(
+      `当前 OneSpec Skill 无法识别语言版本，运行 \`onespec init --platform ${platform.id} --overwrite\` 覆盖安装。`,
+    );
   }
   if (!openspecCli.available) {
-    nextSteps.push('未找到 OpenSpec CLI，请安装 OpenSpec CLI 并在目标项目运行 `openspec init`。');
+    nextSteps.push(
+      `未找到 OpenSpec CLI。运行 \`onespec init --platform ${platform.id} --scope ${scope}\` 让 OneSpec 自动安装并初始化 OpenSpec。`,
+    );
   } else if (scope === 'project' && !openSpecProjectInstalled) {
-    nextSteps.push('当前项目尚未初始化 OpenSpec，请先运行 `openspec init`。');
+    nextSteps.push(
+      `当前项目尚未初始化 OpenSpec。请重新运行 \`onespec init --platform ${platform.id} --scope project\` 让 OneSpec 自动补齐。`,
+    );
   }
   if (!superpowers.available) {
-    nextSteps.push(`缺少 Superpowers Skills：${missing.join(', ')}。请先安装 Superpowers。`);
+    nextSteps.push(
+      `缺少 Superpowers Skills：${missing.join(', ')}。运行 \`onespec init --platform ${platform.id} --scope ${scope}\` 让 OneSpec 自动补齐。`,
+    );
   }
   if (nextSteps.length === 0) {
-    nextSteps.push('环境检查通过。可以在 Codex 中使用 `onespec` 工作流。');
+    nextSteps.push(`环境检查通过。可以在 ${platform.name} 中使用 \`onespec\` 工作流。`);
   }
 
   return {
     projectPath: resolvedProject,
-    platform,
-    platformName: PLATFORMS[platform].name,
+    platform: platform.id,
+    platformName: platform.name,
     scope,
     onespec,
     openspecCli,

package/src/init.js

@@ -2,18 +2,29 @@ import { access, chmod, cp, mkdir, rm, stat } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { getSkillDir, PLATFORMS } from './platforms.js';
+import { getPlatform, getSkillDir } from './platforms.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 export const BUNDLED_ONESPEC_SKILLS = [
   'onespec',
+  'onespec-fast',
+];
+
+export const LEGACY_ONESPEC_CHILD_SKILLS = [
   'onespec-design',
   'onespec-execute',
   'onespec-archive',
 ];
 
+export const BUNDLED_ONESPEC_REFERENCE_FILES = [
+  'references/design.md',
+  'references/execute.md',
+  'references/archive.md',
+  'references/fast.md',
+];
+
 export const SUPPORTED_LANGUAGES = {
   zh: {
     id: 'zh',
@@ -66,14 +77,11 @@ async function createWorkingDirs(projectPath) {
 
 export async function initProject(projectPath, options = {}) {
   const resolvedProject = path.resolve(projectPath);
-  const platform = options.platform ?? 'codex';
+  const platform = getPlatform(options.platform ?? 'codex');
   const scope = options.scope ?? 'project';
   const overwrite = Boolean(options.overwrite);
   const language = options.language ?? 'zh';
 
-  if (!PLATFORMS[platform]) {
-    throw new Error(`Unsupported platform "${platform}". Currently only "codex" is supported.`);
-  }
   if (!['project', 'global'].includes(scope)) {
     throw new Error(`Unsupported scope "${scope}". Use "project" or "global".`);
   }
@@ -85,13 +93,19 @@ export async function initProject(projectPath, options = {}) {
 
   const sourceRoot = assetsSkillsDir();
   const localizedRoot = localizedSkillsDir(language);
-  const skillsDir = getSkillDir(resolvedProject, scope, platform);
+  const skillsDir = getSkillDir(resolvedProject, scope, platform.id);
   const destination = path.join(skillsDir, 'onespec');
   const installedSkills = [];
   const skippedSkills = [];
 
   await mkdir(skillsDir, { recursive: true });
 
+  if (overwrite) {
+    for (const skillName of LEGACY_ONESPEC_CHILD_SKILLS) {
+      await rm(path.join(skillsDir, skillName), { recursive: true, force: true });
+    }
+  }
+
   for (const skillName of BUNDLED_ONESPEC_SKILLS) {
     const source = path.join(sourceRoot, skillName);
     const target = path.join(skillsDir, skillName);
@@ -107,9 +121,9 @@ export async function initProject(projectPath, options = {}) {
     }
     await cp(source, target, { recursive: true });
     if (language !== 'zh') {
-      const localizedSkill = path.join(localizedRoot, skillName, 'SKILL.md');
+      const localizedSkill = path.join(localizedRoot, skillName);
       if (await exists(localizedSkill)) {
-        await cp(localizedSkill, path.join(target, 'SKILL.md'));
+        await cp(localizedSkill, target, { recursive: true, force: true });
       }
     }
     await makeBundledScriptsExecutable(target);
@@ -122,8 +136,8 @@ export async function initProject(projectPath, options = {}) {
 
   return {
     projectPath: resolvedProject,
-    platform,
-    platformName: PLATFORMS[platform].name,
+    platform: platform.id,
+    platformName: platform.name,
     scope,
     language,
     languageName: SUPPORTED_LANGUAGES[language].name,

package/src/platforms.js

@@ -1,23 +1,103 @@
 import os from 'node:os';
 import path from 'node:path';
 
+const home = os.homedir();
+const codexHome = process.env.CODEX_HOME?.trim() || path.join(home, '.codex');
+const claudeHome = process.env.CLAUDE_CONFIG_DIR?.trim() || path.join(home, '.claude');
+
 export const PLATFORMS = {
   codex: {
     id: 'codex',
     name: 'Codex',
-    skillsDir: '.codex',
+    projectSkillsDir: path.join('.agents', 'skills'),
+    globalSkillsDir: path.join(codexHome, 'skills'),
+    legacyProjectSkillDirs: [path.join('.codex', 'skills')],
+    discoveryRoots: [path.join(home, '.agents', 'skills'), '/etc/codex/skills'],
     openspecToolId: 'codex',
   },
+  'claude-code': {
+    id: 'claude-code',
+    name: 'Claude Code',
+    projectSkillsDir: path.join('.claude', 'skills'),
+    globalSkillsDir: path.join(claudeHome, 'skills'),
+    discoveryRoots: [],
+    openspecToolId: 'claude',
+  },
+  cursor: {
+    id: 'cursor',
+    name: 'Cursor',
+    projectSkillsDir: path.join('.agents', 'skills'),
+    globalSkillsDir: path.join(home, '.cursor', 'skills'),
+    discoveryRoots: [path.join(home, '.agents', 'skills')],
+    openspecToolId: 'cursor',
+  },
+  'gemini-cli': {
+    id: 'gemini-cli',
+    name: 'Gemini CLI',
+    projectSkillsDir: path.join('.agents', 'skills'),
+    globalSkillsDir: path.join(home, '.gemini', 'skills'),
+    discoveryRoots: [path.join(home, '.agents', 'skills')],
+    openspecToolId: 'gemini',
+  },
+  'github-copilot': {
+    id: 'github-copilot',
+    name: 'GitHub Copilot',
+    projectSkillsDir: path.join('.agents', 'skills'),
+    globalSkillsDir: path.join(home, '.copilot', 'skills'),
+    discoveryRoots: [path.join(home, '.agents', 'skills')],
+    openspecToolId: 'github-copilot',
+  },
 };
 
-export function getInstallBase(projectPath, scope) {
-  return scope === 'global' ? os.homedir() : projectPath;
-}
+const PLATFORM_ALIASES = {
+  codex: 'codex',
+  claude: 'claude-code',
+  'claude-code': 'claude-code',
+  claude_code: 'claude-code',
+  cursor: 'cursor',
+  gemini: 'gemini-cli',
+  'gemini-cli': 'gemini-cli',
+  gemini_cli: 'gemini-cli',
+  copilot: 'github-copilot',
+  'github-copilot': 'github-copilot',
+  github_copilot: 'github-copilot',
+  'github-copilot-cli': 'github-copilot',
+};
 
-export function getSkillDir(projectPath, scope, platformId = 'codex') {
-  const platform = PLATFORMS[platformId];
-  if (!platform) {
+export function resolvePlatformId(platformId = 'codex') {
+  const resolved = PLATFORM_ALIASES[platformId];
+  if (!resolved) {
     throw new Error(`Unsupported platform: ${platformId}`);
   }
-  return path.join(getInstallBase(projectPath, scope), platform.skillsDir, 'skills');
+  return resolved;
+}
+
+export function getPlatform(platformId = 'codex') {
+  return PLATFORMS[resolvePlatformId(platformId)];
+}
+
+export function getProjectSkillDir(projectPath, platformId = 'codex') {
+  const platform = getPlatform(platformId);
+  return path.join(projectPath, platform.projectSkillsDir);
+}
+
+export function getGlobalSkillDir(platformId = 'codex') {
+  const platform = getPlatform(platformId);
+  return platform.globalSkillsDir;
+}
+
+export function getSkillDir(projectPath, scope, platformId = 'codex') {
+  return scope === 'global'
+    ? getGlobalSkillDir(platformId)
+    : getProjectSkillDir(projectPath, platformId);
+}
+
+export function getDiscoveryRoots(projectPath, platformId = 'codex') {
+  const platform = getPlatform(platformId);
+  return [
+    getProjectSkillDir(projectPath, platformId),
+    ...(platform.legacyProjectSkillDirs ?? []).map((relativeDir) => path.join(projectPath, relativeDir)),
+    getGlobalSkillDir(platformId),
+    ...(platform.discoveryRoots ?? []),
+  ];
 }