skills-script 1.1.1 → 1.1.2

package/README.md

@@ -1,57 +1,51 @@
 # skills-script
 
-Interactive skills toolkit CLI.
+交互式技能工具 CLI。
 
-## Run
+## 运行
 
 ```bash
 npx skills-script
 ```
 
-Flow:
+## 脚本整体运作流程
 
-1. Select tool (currently: `skills-sync`).
-2. Select platforms with Space (multi-select).
-3. Press Enter to confirm.
-4. Optional: input custom platform path tokens (for example: `.aaa`).
+1. 启动入口：执行 `bin/skill-script.js`，进入 `src/cli.js`。
+2. 解析命令参数：
+   - 无参数：进入交互模式。
+   - `-h/--help/help`：输出帮助信息并退出。
+   - `-v/--version/version`：输出版本并退出。
+   - `sync ...`：进入非交互同步流程。
+3. 解析工作目录：优先使用调用上下文目录（用于避免 npx 临时目录干扰）。
+4. 执行对应流程：
+   - 交互模式：先选工具，再进入该工具的交互步骤。
+   - 非交互模式：直接按命令参数执行目标工具。
+5. 返回退出码：
+   - 成功返回 `0`。
+   - 参数错误或运行失败返回非 `0`。
 
-## Platform Selection
+## 交互模式流程
 
-Built-in options:
+1. 工具选择：
+   - `skills-sync`
+   - `claude-settings-switch`
+2. 进入对应工具流程并执行。
+3. `claude-settings-switch` 固定操作 `~/.claude`（例如 `/Users/youzi/.claude`）。
 
-- `all`
-- `claude`
-- `codex`
-- `gemini`
-
-Built-in targets are under command invocation directory:
-
-- `claude` => `<cwd>/.claude/skills`
-- `codex` => `<cwd>/.codex/skills`
-- `gemini` => `<cwd>/.gemini/skills`
-
-Custom token rules:
-
-- `.aaa` => `<cwd>/.aaa/skills`
-- absolute/relative path => used directly as target directory
-
-## Source Skills Directory
-
-The source is fixed to:
+## 非交互模式
 
 ```bash
-<command invocation directory>/.agents/skills
+npx skills-script sync claude,codex,.aaa
 ```
 
-When running through npm/npx, the tool prefers `INIT_CWD` to avoid temp-cache working directory issues.
+## 工具实现文档
 
-## Non-Interactive Mode
+每个工具的实现细节单独记录：
 
-```bash
-npx skills-script sync claude,codex,.aaa
-```
+- `docs/tools/skills-sync.md`
+- `docs/tools/claude-settings-switch.md`
 
-## Publish
+## 发布
 
 ```bash
 cd /Users/youzi/Desktop/__yz/skills-script

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skills-script",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Interactive skills toolkit CLI",
   "type": "module",
   "bin": {

package/src/commands/interactive.js

@@ -1,6 +1,7 @@
 import path from 'node:path';
 import { multiSelect, promptInput, selectOne } from '../lib/interactive.js';
 import { resolveTargetDirs, runSyncByTargets } from './sync.js';
+import { runClaudeSettingSwitch } from './switch-setting.js';
 
 function parseCustomInput(input) {
   if (!input) return [];
@@ -13,9 +14,16 @@ function parseCustomInput(input) {
 export async function runInteractive(cwd = process.cwd()) {
   const tool = await selectOne({
     title: 'Select a tool',
-    options: [{ label: 'skills-sync', value: 'skills-sync' }]
+    options: [
+      { label: 'skills-sync', value: 'skills-sync' },
+      { label: 'claude-settings-switch', value: 'claude-settings-switch' }
+    ]
   });
 
+  if (tool === 'claude-settings-switch') {
+    return runClaudeSettingSwitch();
+  }
+
   if (tool !== 'skills-sync') {
     console.error('[ERROR] Unsupported tool selected.');
     return 1;

package/src/commands/switch-setting.js

@@ -0,0 +1,150 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { selectOne } from '../lib/interactive.js';
+
+function findAnthropicBaseUrlValue(input) {
+  if (!input || typeof input !== 'object') return null;
+
+  if (
+    Object.prototype.hasOwnProperty.call(input, 'ANTHROPIC_BASE_URL') &&
+    typeof input.ANTHROPIC_BASE_URL === 'string'
+  ) {
+    return input.ANTHROPIC_BASE_URL;
+  }
+
+  for (const value of Object.values(input)) {
+    if (!value || typeof value !== 'object') continue;
+    const nested = findAnthropicBaseUrlValue(value);
+    if (nested) return nested;
+  }
+
+  return null;
+}
+
+function normalizeBaseUrlName(value) {
+  if (typeof value !== 'string') return null;
+  const raw = value.trim();
+  if (!raw) return null;
+
+  let host = raw;
+  try {
+    const parsed = new URL(raw.includes('://') ? raw : `https://${raw}`);
+    host = parsed.hostname || raw;
+  } catch {
+    host = raw.replace(/^[a-zA-Z]+:\/\//, '').split('/')[0] || raw;
+  }
+
+  const cleaned = host
+    .toLowerCase()
+    .replace(/[^a-z0-9.-]+/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-+|-+$/g, '');
+
+  return cleaned || null;
+}
+
+async function listSettingsFiles(claudeDir) {
+  const entries = await fs.readdir(claudeDir, { withFileTypes: true });
+  return entries
+    .filter((entry) => entry.isFile() && /^settings.*\.json$/i.test(entry.name))
+    .map((entry) => entry.name)
+    .sort((a, b) => a.localeCompare(b));
+}
+
+async function getUniqueBackupPath(claudeDir, preferredName) {
+  const preferredPath = path.join(claudeDir, preferredName);
+
+  try {
+    await fs.access(preferredPath);
+  } catch {
+    return preferredPath;
+  }
+
+  const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const fallbackName = preferredName.replace(/\.json$/i, `.${stamp}.json`);
+  return path.join(claudeDir, fallbackName);
+}
+
+export async function runClaudeSettingSwitch() {
+  const claudeDir = path.join(os.homedir(), '.claude');
+  const activeSettingsPath = path.join(claudeDir, 'settings.json');
+
+  let claudeStat;
+  try {
+    claudeStat = await fs.stat(claudeDir);
+  } catch {
+    console.error(`[ERROR] Claude directory not found: ${claudeDir}`);
+    return 1;
+  }
+
+  if (!claudeStat.isDirectory()) {
+    console.error(`[ERROR] Not a directory: ${claudeDir}`);
+    return 1;
+  }
+
+  let candidates = [];
+  try {
+    candidates = await listSettingsFiles(claudeDir);
+  } catch (error) {
+    console.error(`[ERROR] Failed to read settings files: ${error?.message || error}`);
+    return 1;
+  }
+
+  if (!candidates.length) {
+    console.error(`[ERROR] No settings*.json found in ${claudeDir}`);
+    return 1;
+  }
+
+  const selected = await selectOne({
+    title: 'Select target Claude settings file',
+    options: candidates.map((name) => ({ label: name, value: name }))
+  });
+
+  if (selected === 'settings.json') {
+    console.log('[INFO] settings.json is already selected. Nothing to switch.');
+    return 0;
+  }
+
+  let activeJson;
+  try {
+    const raw = await fs.readFile(activeSettingsPath, 'utf8');
+    activeJson = JSON.parse(raw);
+  } catch (error) {
+    console.error(`[ERROR] Failed to read ${activeSettingsPath}: ${error?.message || error}`);
+    return 1;
+  }
+
+  const baseUrlValue = findAnthropicBaseUrlValue(activeJson);
+  const baseUrlName = normalizeBaseUrlName(baseUrlValue);
+  if (!baseUrlName) {
+    console.error('[ERROR] ANTHROPIC_BASE_URL not found in current settings.json');
+    return 1;
+  }
+
+  const backupPath = await getUniqueBackupPath(claudeDir, `settings.${baseUrlName}.json`);
+  const selectedPath = path.join(claudeDir, selected);
+
+  try {
+    await fs.rename(activeSettingsPath, backupPath);
+  } catch (error) {
+    console.error(`[ERROR] Failed to backup current settings: ${error?.message || error}`);
+    return 1;
+  }
+
+  try {
+    await fs.rename(selectedPath, activeSettingsPath);
+  } catch (error) {
+    try {
+      await fs.rename(backupPath, activeSettingsPath);
+    } catch {
+      // If rollback also fails, preserve original failure message below.
+    }
+    console.error(`[ERROR] Failed to activate selected settings: ${error?.message || error}`);
+    return 1;
+  }
+
+  console.log(`[OK] backup: ${path.basename(backupPath)}`);
+  console.log(`[OK] active: settings.json <= ${selected}`);
+  return 0;
+}