@shirokuma-library/shirokuma-docs 0.3.0-alpha.17 → 0.3.0-alpha.19

package/THIRD_PARTY_NOTICES.md

@@ -1,18 +1,5 @@
 # Third-Party Notices
 
 This project is licensed under the MIT License.
-The following components are licensed under different terms.
 
-## Apache License 2.0
-
-The following files are derived from [anthropics/skills](https://github.com/anthropics/skills)
-(skill-creator), licensed under Apache License 2.0:
-
-- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/init_skill.py
-- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/package_skill.py
-- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/scripts/quick_validate.py
-- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/reference-workflows.md
-- plugin/shirokuma-skills-{en,ja}/skills/managing-skills/reference-output-patterns.md
-
-These files have been modified for use in shirokuma-docs.
-See the LICENSE.txt in each managing-skills/scripts directory for the full Apache License 2.0 text.
+For third-party license notices related to bundled plugins, see `plugin/THIRD_PARTY_NOTICES.md`.

package/dist/commands/plugin-install-local.d.ts

@@ -0,0 +1,49 @@
+/**
+ * plugin-install-local command - ローカルプラグインをグローバルキャッシュにインストール
+ *
+ * @description plugin/{pluginName}/ ディレクトリをグローバルキャッシュ
+ * (~/.claude/plugins/cache/shirokuma-library/{pluginName}/local/) にコピーし、
+ * ルールを .claude/rules/shirokuma/ に展開する。
+ *
+ * 開発中のプラグイン変更を `shirokuma-docs update` を実行せずに
+ * 即座に反映させるためのコマンド。
+ *
+ * @example
+ * ```bash
+ * # 言語設定に基づき自動選択（最も一般的な使い方）
+ * shirokuma-docs plugin-install-local
+ *
+ * # 特定のプラグインを指定
+ * shirokuma-docs plugin-install-local --plugin shirokuma-skills-ja
+ *
+ * # 全プラグインをインストール
+ * shirokuma-docs plugin-install-local --all
+ *
+ * # ドライラン（変更なし）
+ * shirokuma-docs plugin-install-local --dry-run
+ * ```
+ */
+/**
+ * plugin-install-local command options
+ */
+interface PluginInstallLocalOptions {
+    /** Project path */
+    project: string;
+    /** Plugin name to install (auto-detected from language setting if not specified) */
+    plugin?: string;
+    /** Install all plugins */
+    all?: boolean;
+    /** Preview mode (no actual changes) */
+    dryRun?: boolean;
+    /** Verbose logging */
+    verbose?: boolean;
+}
+/**
+ * plugin-install-local command handler
+ *
+ * @param options - Command options
+ * @returns Exit code (0 = success, 1 = error)
+ */
+export declare function pluginInstallLocalCommand(options: PluginInstallLocalOptions): Promise<number>;
+export {};
+//# sourceMappingURL=plugin-install-local.d.ts.map

package/dist/commands/plugin-install-local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-install-local.d.ts","sourceRoot":"","sources":["../../src/commands/plugin-install-local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAoBH;;GAEG;AACH,UAAU,yBAAyB;IACjC,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sBAAsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAYD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6GnG"}

package/dist/commands/plugin-install-local.js

@@ -0,0 +1,199 @@
+/**
+ * plugin-install-local command - ローカルプラグインをグローバルキャッシュにインストール
+ *
+ * @description plugin/{pluginName}/ ディレクトリをグローバルキャッシュ
+ * (~/.claude/plugins/cache/shirokuma-library/{pluginName}/local/) にコピーし、
+ * ルールを .claude/rules/shirokuma/ に展開する。
+ *
+ * 開発中のプラグイン変更を `shirokuma-docs update` を実行せずに
+ * 即座に反映させるためのコマンド。
+ *
+ * @example
+ * ```bash
+ * # 言語設定に基づき自動選択（最も一般的な使い方）
+ * shirokuma-docs plugin-install-local
+ *
+ * # 特定のプラグインを指定
+ * shirokuma-docs plugin-install-local --plugin shirokuma-skills-ja
+ *
+ * # 全プラグインをインストール
+ * shirokuma-docs plugin-install-local --all
+ *
+ * # ドライラン（変更なし）
+ * shirokuma-docs plugin-install-local --dry-run
+ * ```
+ */
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { validateProjectPath } from "../utils/sanitize.js";
+import { createLogger } from "../utils/logger.js";
+import { t } from "../utils/i18n.js";
+import { PLUGIN_NAME, PLUGIN_NAME_JA, PLUGIN_NAME_HOOKS, getBundledPluginPathFor, deployRules, getGlobalCachePath, getLanguageSetting, installLocalPlugin, } from "../utils/skills-repo.js";
+/**
+ * plugin-install-local command handler
+ *
+ * @param options - Command options
+ * @returns Exit code (0 = success, 1 = error)
+ */
+export async function pluginInstallLocalCommand(options) {
+    const verbose = options.verbose ?? false;
+    const logger = createLogger(verbose);
+    const T = (key, params) => t(`commands.pluginInstallLocal.${key}`, params);
+    const projectPath = validateProjectPath(options.project);
+    // .claude ディレクトリの存在確認
+    if (!existsSync(join(projectPath, ".claude"))) {
+        logger.error(T("errorNoClaudeDir"));
+        return 1;
+    }
+    if (options.dryRun) {
+        logger.info(T("dryRunBanner"));
+    }
+    // 言語設定を1回だけ取得
+    const languageSetting = getLanguageSetting(projectPath);
+    // インストール対象プラグインを決定
+    const pluginsToInstall = resolveTargetPlugins(options, languageSetting);
+    if (pluginsToInstall.length === 0) {
+        logger.error(T("errorNoPluginResolved"));
+        return 1;
+    }
+    // 各プラグインをインストール
+    const installResults = [];
+    let hasError = false;
+    for (const pluginName of pluginsToInstall) {
+        const sourcePath = getBundledPluginPathFor(pluginName);
+        if (!existsSync(sourcePath)) {
+            logger.error(T("errorPluginDirNotFound", { pluginName, sourcePath }));
+            hasError = true;
+            continue;
+        }
+        logger.info(T("installingPlugin", { pluginName }));
+        const result = installLocalPlugin(pluginName, sourcePath, { dryRun: options.dryRun });
+        installResults.push(result);
+        if (result.success) {
+            logger.success(T("installedPlugin", { pluginName, cachePath: result.cachePath }));
+        }
+        else {
+            logger.error(T("errorInstallFailed", { pluginName, reason: result.message ?? "unknown error" }));
+            hasError = true;
+        }
+    }
+    if (hasError) {
+        return 1;
+    }
+    // ルール展開
+    // local/ キャッシュが存在する場合は preferLocal=true で優先解決する
+    const useJaRules = languageSetting === "japanese";
+    // 言語設定に合わせてルール展開元を選択
+    // --plugin 明示指定の場合はそのプラグインを使用、それ以外は言語設定に従う
+    let rulesPluginName;
+    if (options.plugin) {
+        rulesPluginName = options.plugin;
+    }
+    else {
+        rulesPluginName = useJaRules ? PLUGIN_NAME_JA : PLUGIN_NAME;
+    }
+    // local/ を優先して使用（インストールしたばかりのものを反映）
+    const rulesSource = getGlobalCachePath(rulesPluginName, undefined, { preferLocal: true })
+        ?? getBundledPluginPathFor(rulesPluginName);
+    logger.info(T("deployingRules", { pluginName: rulesPluginName }));
+    const deployResult = await deployRules(projectPath, {
+        dryRun: options.dryRun,
+        verbose,
+        bundledPluginPath: rulesSource,
+    });
+    const rulesDeployed = deployResult.deployed.filter(r => r.status === "deployed" || r.status === "updated").length;
+    // サマリー表示
+    printSummary(installResults, deployResult.deployed, options.dryRun ?? false, logger, T);
+    // セッション再起動案内
+    if (!options.dryRun) {
+        logger.info("");
+        logger.warn(T("restartSessionNotice"));
+        logger.info(T("restartSessionHint"));
+    }
+    if (verbose) {
+        const result = {
+            pluginName: pluginsToInstall.join(", "),
+            cachePath: installResults[0]?.cachePath ?? "",
+            rulesDeployed,
+            dryRun: options.dryRun ?? false,
+        };
+        console.log(JSON.stringify(result, null, 2));
+    }
+    return 0;
+}
+/**
+ * インストール対象プラグインの一覧を決定する
+ *
+ * @param options - コマンドオプション
+ * @param languageSetting - 言語設定（"japanese" | "english" | null）
+ * @returns インストール対象プラグイン名の配列
+ */
+function resolveTargetPlugins(options, languageSetting) {
+    // --all: 全プラグイン
+    if (options.all) {
+        return [PLUGIN_NAME, PLUGIN_NAME_JA, PLUGIN_NAME_HOOKS];
+    }
+    // --plugin: 明示指定
+    if (options.plugin) {
+        return [options.plugin];
+    }
+    // 自動選択: 言語設定に基づく
+    if (languageSetting === "japanese") {
+        return [PLUGIN_NAME_JA, PLUGIN_NAME_HOOKS];
+    }
+    // デフォルト（英語または未設定）
+    return [PLUGIN_NAME, PLUGIN_NAME_HOOKS];
+}
+/**
+ * インストール結果サマリーを表示する
+ */
+function printSummary(installResults, deployedRules, dryRun, logger, T) {
+    logger.info(`\n${T("summaryHeader")}`);
+    if (dryRun) {
+        logger.info(T("dryRunNote"));
+    }
+    for (const r of installResults) {
+        if (r.success) {
+            logger.success(`✓ ${T("summaryPluginInstalled", { pluginName: r.pluginName })}`);
+        }
+        else {
+            logger.error(`✗ ${T("summaryPluginFailed", { pluginName: r.pluginName })}`);
+        }
+    }
+    let deployed = 0, updated = 0, unchanged = 0, errors = 0;
+    for (const r of deployedRules) {
+        if (r.status === "deployed")
+            deployed++;
+        else if (r.status === "updated")
+            updated++;
+        else if (r.status === "unchanged")
+            unchanged++;
+        else if (r.status === "error")
+            errors++;
+    }
+    const parts = [];
+    if (deployed > 0)
+        parts.push(T("countDeployed", { count: deployed }));
+    if (updated > 0)
+        parts.push(T("countUpdated", { count: updated }));
+    if (unchanged > 0)
+        parts.push(T("countUnchanged", { count: unchanged }));
+    if (errors > 0)
+        parts.push(T("countError", { count: errors }));
+    if (parts.length > 0) {
+        const rulesMsg = T("deployedRulesSummary", { details: parts.join(", ") });
+        if (errors > 0) {
+            logger.error(`✗ ${rulesMsg}`);
+        }
+        else {
+            logger.success(`✓ ${rulesMsg}`);
+        }
+    }
+    if (errors > 0) {
+        logger.error(`✗ ${T("completedError", { count: errors })}`);
+    }
+    else {
+        logger.success(`✓ ${T("completedOk")}`);
+    }
+}
+//# sourceMappingURL=plugin-install-local.js.map

package/dist/commands/plugin-install-local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-install-local.js","sourceRoot":"","sources":["../../src/commands/plugin-install-local.ts"],"names":[],"mappings":"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"}

package/dist/commands/skill/benchmark.d.ts

@@ -0,0 +1,29 @@
+/**
+ * skill benchmark コマンド
+ *
+ * benchmark ディレクトリの grading.json ファイルを集計して
+ * benchmark.json と benchmark.md を生成する。
+ *
+ * Derived from: https://github.com/anthropics/skills/tree/main/skills/skill-creator
+ * Original: scripts/aggregate_benchmark.py, scripts/generate_report.py
+ * Original licensed under Apache License 2.0 (Copyright 2025 Anthropic, PBC).
+ * Modified for shirokuma-docs: ported to TypeScript with CLI integration.
+ *   - Python → TypeScript
+ *   - benchmark.md 形式のレポート生成（Handlebars は不使用、テンプレートリテラルで実装）
+ */
+import type { BenchmarkData } from "./types.js";
+export declare function generateBenchmark(benchmarkDir: string, skillName?: string, skillPath?: string): BenchmarkData;
+/**
+ * benchmark データから人間が読みやすい Markdown を生成する。
+ */
+export declare function generateMarkdown(benchmark: BenchmarkData): string;
+interface BenchmarkOptions {
+    benchmarkDir: string;
+    skillName?: string;
+    skillPath?: string;
+    output?: string;
+    verbose?: boolean;
+}
+export declare function cmdSkillBenchmark(options: BenchmarkOptions): Promise<number>;
+export {};
+//# sourceMappingURL=benchmark.d.ts.map

package/dist/commands/skill/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../../src/commands/skill/benchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,aAAa,EAA6B,MAAM,YAAY,CAAC;AAuP3E,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,SAAS,SAAK,EACd,SAAS,SAAK,GACb,aAAa,CA6Cf;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CA6CjE;AAMD,UAAU,gBAAgB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsDlF"}

package/dist/commands/skill/benchmark.js

@@ -0,0 +1,344 @@
+/**
+ * skill benchmark コマンド
+ *
+ * benchmark ディレクトリの grading.json ファイルを集計して
+ * benchmark.json と benchmark.md を生成する。
+ *
+ * Derived from: https://github.com/anthropics/skills/tree/main/skills/skill-creator
+ * Original: scripts/aggregate_benchmark.py, scripts/generate_report.py
+ * Original licensed under Apache License 2.0 (Copyright 2025 Anthropic, PBC).
+ * Modified for shirokuma-docs: ported to TypeScript with CLI integration.
+ *   - Python → TypeScript
+ *   - benchmark.md 形式のレポート生成（Handlebars は不使用、テンプレートリテラルで実装）
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+// =============================================================================
+// 統計計算
+// =============================================================================
+/**
+ * 数値配列の mean, stddev, min, max を計算する。
+ */
+function calculateStats(values) {
+    if (values.length === 0) {
+        return { mean: 0, stddev: 0, min: 0, max: 0 };
+    }
+    const n = values.length;
+    const mean = values.reduce((a, b) => a + b, 0) / n;
+    const variance = n > 1
+        ? values.reduce((sum, x) => sum + (x - mean) ** 2, 0) / (n - 1)
+        : 0;
+    const stddev = Math.sqrt(variance);
+    return {
+        mean: Math.round(mean * 10000) / 10000,
+        stddev: Math.round(stddev * 10000) / 10000,
+        min: Math.round(Math.min(...values) * 10000) / 10000,
+        max: Math.round(Math.max(...values) * 10000) / 10000,
+    };
+}
+/**
+ * benchmark ディレクトリからすべての run 結果を読み込む。
+ * 2 種類のレイアウト（workspace / legacy）をサポート。
+ */
+function loadRunResults(benchmarkDir) {
+    const results = new Map();
+    // レイアウト判定
+    const runsDir = join(benchmarkDir, "runs");
+    const searchDir = existsSync(runsDir) ? runsDir : benchmarkDir;
+    // eval-N ディレクトリを昇順でソート
+    let evalDirs = [];
+    try {
+        evalDirs = readdirSync(searchDir, { withFileTypes: true })
+            .filter(d => d.isDirectory() && d.name.startsWith("eval-"))
+            .map(d => d.name)
+            .sort();
+    }
+    catch {
+        return results;
+    }
+    for (let evalIdx = 0; evalIdx < evalDirs.length; evalIdx++) {
+        const evalDirName = evalDirs[evalIdx];
+        const evalDirPath = join(searchDir, evalDirName);
+        // eval_metadata.json から eval_id を取得
+        let evalId = evalIdx;
+        const metadataPath = join(evalDirPath, "eval_metadata.json");
+        if (existsSync(metadataPath)) {
+            try {
+                const metadata = JSON.parse(readFileSync(metadataPath, "utf-8"));
+                if (metadata["eval_id"] !== undefined) {
+                    evalId = metadata["eval_id"];
+                }
+            }
+            catch {
+                // フォールバック
+            }
+        }
+        else {
+            const parts = evalDirName.split("-");
+            const parsed = parseInt(parts[1] ?? "", 10);
+            if (!isNaN(parsed))
+                evalId = parsed;
+        }
+        // config ディレクトリを走査
+        let configDirs = [];
+        try {
+            configDirs = readdirSync(evalDirPath, { withFileTypes: true })
+                .filter(d => d.isDirectory())
+                .map(d => d.name)
+                .sort();
+        }
+        catch {
+            continue;
+        }
+        for (const configName of configDirs) {
+            const configPath = join(evalDirPath, configName);
+            // run-* ディレクトリが存在しない設定ディレクトリはスキップ
+            let runDirs = [];
+            try {
+                runDirs = readdirSync(configPath, { withFileTypes: true })
+                    .filter(d => d.isDirectory() && d.name.startsWith("run-"))
+                    .map(d => d.name)
+                    .sort();
+            }
+            catch {
+                continue;
+            }
+            if (runDirs.length === 0)
+                continue;
+            if (!results.has(configName)) {
+                results.set(configName, []);
+            }
+            for (const runDirName of runDirs) {
+                const runPath = join(configPath, runDirName);
+                const parts = runDirName.split("-");
+                const runNumber = parseInt(parts[1] ?? "1", 10);
+                const gradingFile = join(runPath, "grading.json");
+                if (!existsSync(gradingFile)) {
+                    process.stderr.write(`Warning: grading.json not found in ${runPath}\n`);
+                    continue;
+                }
+                let grading;
+                try {
+                    grading = JSON.parse(readFileSync(gradingFile, "utf-8"));
+                }
+                catch (e) {
+                    process.stderr.write(`Warning: Invalid JSON in ${gradingFile}: ${e instanceof Error ? e.message : String(e)}\n`);
+                    continue;
+                }
+                const summary = grading["summary"] ?? {};
+                const timing = grading["timing"] ?? {};
+                const metrics = grading["execution_metrics"] ?? {};
+                let timeSeconds = timing["total_duration_seconds"] ?? 0;
+                // timing.json フォールバック
+                if (timeSeconds === 0) {
+                    const timingFile = join(runPath, "timing.json");
+                    if (existsSync(timingFile)) {
+                        try {
+                            const timingData = JSON.parse(readFileSync(timingFile, "utf-8"));
+                            timeSeconds = timingData["total_duration_seconds"] ?? 0;
+                        }
+                        catch {
+                            // 無視
+                        }
+                    }
+                }
+                const tokens = metrics["output_chars"] ?? 0;
+                const rawExpectations = grading["expectations"] ?? [];
+                const notesSummary = grading["user_notes_summary"] ?? {};
+                const notes = [
+                    ...(notesSummary["uncertainties"] ?? []),
+                    ...(notesSummary["needs_review"] ?? []),
+                    ...(notesSummary["workarounds"] ?? []),
+                ];
+                results.get(configName).push({
+                    eval_id: evalId,
+                    run_number: runNumber,
+                    configuration: configName,
+                    pass_rate: summary["pass_rate"] ?? 0,
+                    passed: summary["passed"] ?? 0,
+                    failed: summary["failed"] ?? 0,
+                    total: summary["total"] ?? 0,
+                    time_seconds: timeSeconds,
+                    tokens,
+                    tool_calls: metrics["total_tool_calls"] ?? 0,
+                    errors: metrics["errors_encountered"] ?? 0,
+                    expectations: rawExpectations,
+                    notes,
+                });
+            }
+        }
+    }
+    return results;
+}
+// =============================================================================
+// 集計
+// =============================================================================
+/**
+ * run 結果を設定ごとに集計し、delta を計算する。
+ */
+function aggregateResults(results) {
+    const runSummary = {};
+    const configs = [...results.keys()];
+    for (const config of configs) {
+        const runs = results.get(config) ?? [];
+        if (runs.length === 0) {
+            runSummary[config] = {
+                pass_rate: { mean: 0, stddev: 0, min: 0, max: 0 },
+                time_seconds: { mean: 0, stddev: 0, min: 0, max: 0 },
+                tokens: { mean: 0, stddev: 0, min: 0, max: 0 },
+            };
+            continue;
+        }
+        runSummary[config] = {
+            pass_rate: calculateStats(runs.map(r => r.pass_rate)),
+            time_seconds: calculateStats(runs.map(r => r.time_seconds)),
+            tokens: calculateStats(runs.map(r => r.tokens)),
+        };
+    }
+    // delta 計算（最初の2つの設定間）
+    if (configs.length >= 2) {
+        const primary = runSummary[configs[0]];
+        const baseline = runSummary[configs[1]];
+        const deltaPr = (primary["pass_rate"]?.mean ?? 0) - (baseline["pass_rate"]?.mean ?? 0);
+        const deltaTime = (primary["time_seconds"]?.mean ?? 0) - (baseline["time_seconds"]?.mean ?? 0);
+        const deltaTokens = (primary["tokens"]?.mean ?? 0) - (baseline["tokens"]?.mean ?? 0);
+        runSummary["delta"] = {
+            pass_rate: `${deltaPr >= 0 ? "+" : ""}${deltaPr.toFixed(2)}`,
+            time_seconds: `${deltaTime >= 0 ? "+" : ""}${deltaTime.toFixed(1)}`,
+            tokens: `${deltaTokens >= 0 ? "+" : ""}${deltaTokens.toFixed(0)}`,
+        };
+    }
+    return runSummary;
+}
+// =============================================================================
+// benchmark.json 生成
+// =============================================================================
+export function generateBenchmark(benchmarkDir, skillName = "", skillPath = "") {
+    const results = loadRunResults(benchmarkDir);
+    const runSummary = aggregateResults(results);
+    const runs = [];
+    for (const [, entries] of results) {
+        for (const entry of entries) {
+            runs.push({
+                eval_id: entry.eval_id,
+                configuration: entry.configuration,
+                run_number: entry.run_number,
+                result: {
+                    eval_id: entry.eval_id,
+                    run_number: entry.run_number,
+                    pass_rate: entry.pass_rate,
+                    passed: entry.passed,
+                    failed: entry.failed,
+                    total: entry.total,
+                    time_seconds: entry.time_seconds,
+                    tokens: entry.tokens,
+                    tool_calls: entry.tool_calls,
+                    errors: entry.errors,
+                },
+                expectations: entry.expectations,
+                notes: entry.notes,
+            });
+        }
+    }
+    const evalIds = [...new Set(runs.map(r => r.eval_id))].sort();
+    return {
+        metadata: {
+            skill_name: skillName || "<skill-name>",
+            skill_path: skillPath || "<path/to/skill>",
+            executor_model: "<model-name>",
+            analyzer_model: "<model-name>",
+            timestamp: new Date().toISOString().replace(/\.\d+Z$/, "Z"),
+            evals_run: evalIds,
+            runs_per_configuration: 3,
+        },
+        runs,
+        run_summary: runSummary,
+        notes: [],
+    };
+}
+// =============================================================================
+// benchmark.md 生成
+// =============================================================================
+/**
+ * benchmark データから人間が読みやすい Markdown を生成する。
+ */
+export function generateMarkdown(benchmark) {
+    const { metadata, run_summary } = benchmark;
+    // delta を除いた設定名
+    const configs = Object.keys(run_summary).filter(k => k !== "delta");
+    const configA = configs[0] ?? "config_a";
+    const configB = configs[1] ?? "config_b";
+    const labelA = configA.replace(/_/g, " ").replace(/\b\w/g, c => c.toUpperCase());
+    const labelB = configB.replace(/_/g, " ").replace(/\b\w/g, c => c.toUpperCase());
+    const summaryA = run_summary[configA];
+    const summaryB = run_summary[configB];
+    const delta = run_summary["delta"];
+    const aPr = summaryA?.["pass_rate"] ?? { mean: 0, stddev: 0 };
+    const bPr = summaryB?.["pass_rate"] ?? { mean: 0, stddev: 0 };
+    const aTime = summaryA?.["time_seconds"] ?? { mean: 0, stddev: 0 };
+    const bTime = summaryB?.["time_seconds"] ?? { mean: 0, stddev: 0 };
+    const aTokens = summaryA?.["tokens"] ?? { mean: 0, stddev: 0 };
+    const bTokens = summaryB?.["tokens"] ?? { mean: 0, stddev: 0 };
+    const lines = [
+        `# Skill Benchmark: ${metadata.skill_name}`,
+        "",
+        `**Model**: ${metadata.executor_model}`,
+        `**Date**: ${metadata.timestamp}`,
+        `**Evals**: ${metadata.evals_run.join(", ")} (${metadata.runs_per_configuration} runs each per configuration)`,
+        "",
+        "## Summary",
+        "",
+        `| Metric | ${labelA} | ${labelB} | Delta |`,
+        "|--------|------------|---------------|-------|",
+        `| Pass Rate | ${(aPr.mean * 100).toFixed(0)}% ± ${(aPr.stddev * 100).toFixed(0)}% | ${(bPr.mean * 100).toFixed(0)}% ± ${(bPr.stddev * 100).toFixed(0)}% | ${delta?.["pass_rate"] ?? "—"} |`,
+        `| Time | ${aTime.mean.toFixed(1)}s ± ${aTime.stddev.toFixed(1)}s | ${bTime.mean.toFixed(1)}s ± ${bTime.stddev.toFixed(1)}s | ${delta?.["time_seconds"] ?? "—"}s |`,
+        `| Tokens | ${aTokens.mean.toFixed(0)} ± ${aTokens.stddev.toFixed(0)} | ${bTokens.mean.toFixed(0)} ± ${bTokens.stddev.toFixed(0)} | ${delta?.["tokens"] ?? "—"} |`,
+    ];
+    if (benchmark.notes.length > 0) {
+        lines.push("", "## Notes", "");
+        for (const note of benchmark.notes) {
+            lines.push(`- ${note}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function cmdSkillBenchmark(options) {
+    const { benchmarkDir: rawBenchmarkDir, skillName = "", skillPath = "", output, verbose, } = options;
+    const benchmarkDir = resolve(rawBenchmarkDir);
+    if (!existsSync(benchmarkDir)) {
+        process.stderr.write(`Directory not found: ${benchmarkDir}\n`);
+        return 1;
+    }
+    if (verbose) {
+        process.stderr.write(`Aggregating benchmark: ${benchmarkDir}\n`);
+    }
+    // benchmark 生成
+    const benchmark = generateBenchmark(benchmarkDir, skillName, skillPath);
+    // 出力先の決定
+    const outputJson = output ? resolve(output) : join(benchmarkDir, "benchmark.json");
+    const outputMd = outputJson.replace(/\.json$/, ".md");
+    // ディレクトリ作成
+    mkdirSync(join(outputJson, ".."), { recursive: true });
+    // benchmark.json 書き込み
+    writeFileSync(outputJson, JSON.stringify(benchmark, null, 2), "utf-8");
+    process.stdout.write(`Generated: ${outputJson}\n`);
+    // benchmark.md 書き込み
+    const markdown = generateMarkdown(benchmark);
+    writeFileSync(outputMd, markdown, "utf-8");
+    process.stdout.write(`Generated: ${outputMd}\n`);
+    // サマリー表示
+    const configs = Object.keys(benchmark.run_summary).filter(k => k !== "delta");
+    const delta = benchmark.run_summary["delta"];
+    process.stdout.write("\nSummary:\n");
+    for (const config of configs) {
+        const summary = benchmark.run_summary[config];
+        const pr = summary?.["pass_rate"]?.mean ?? 0;
+        const label = config.replace(/_/g, " ").replace(/\b\w/g, c => c.toUpperCase());
+        process.stdout.write(`  ${label}: ${(pr * 100).toFixed(1)}% pass rate\n`);
+    }
+    if (delta) {
+        process.stdout.write(`  Delta: ${delta["pass_rate"] ?? "—"}\n`);
+    }
+    return 0;
+}
+//# sourceMappingURL=benchmark.js.map