skills-viewer 0.5.0 → 0.7.0

package/README.md

@@ -17,10 +17,13 @@ npx skills-viewer
 ## Features
 
 - **All scopes in one view** — user (`~/.claude/skills`), every project's `.claude/skills` / `.claude/commands`, installed plugins, and Claude Code built-ins, grouped by source
+- **Purpose grouping (AI)** — one haiku call classifies everything installed by _when you use it_ into 4–8 groups generated for your environment (planning / building / review / release / … as a role-agnostic guide — a designer's or PM's skills get their own groups). Switch the list between by-source, by-purpose and flat views; a frontmatter `category:` pins an item to a manual group that takes precedence
 - **Search / sort** — incremental search over name + description + usage; sort by name, usage count, last used, updated date, or token cost
 - **Diagnostics** — an _unused_ badge (no recorded use within the transcript retention window) with an all / used / unused filter, plus static description lint: missing / too-short / too-long descriptions, missing trigger conditions ("use when …") that make auto-invocation unlikely, and name-echo descriptions
 - **Token cost** — since every name + description is injected into each session, the estimated token overhead is shown per item, per scope, and as a per-session total for the current project
-- **AI trigger diagnosis** — one click asks haiku whether the description is likely to trigger auto-invocation, lists concrete issues, and proposes an improved description you can apply with one click (cached by content hash)
+- **AI trigger diagnosis** — one click asks the model whether the description is likely to trigger auto-invocation, lists concrete issues, and proposes an improved description you can apply with one click (cached by content hash)
+- **AI flow diagram** — extract the processing flow of orchestration-style skills (steps, branches, delegations, human gates) from the definition body and render it as a step diagram; delegated skills are clickable
+- **AI model choice** — pick the model behind all AI features (haiku default / sonnet / opus) in settings; aliases are resolved by your claude CLI
 - **Edit in the browser** — inline editor for SKILL.md / commands / agents (project & user scopes) with mtime conflict detection and a one-generation backup in `~/.cache/skills-viewer/backups/`
 - **What's changed** — a banner shows items added / updated / removed since your last launch (baseline advances only when you dismiss it); the CLI prints a one-line summary at startup too
 - **Usage sparkline** — the detail pane charts the last 30 days of per-day usage

package/build/server/diagnose.js

@@ -103,7 +103,7 @@ function parseDiagnosis(text) {
         throw new Error('empty improved description');
     return { verdict, issues: issues.slice(0, 4), improved };
 }
-async function diagnoseOne(realPath, name, lang) {
+async function diagnoseOne(realPath, name, lang, model = 'haiku') {
     const hash = (0, summary_1.contentHash)(realPath);
     const store = loadDiagnoses();
     const cached = store[realPath];
@@ -111,8 +111,8 @@ async function diagnoseOne(realPath, name, lang) {
         return { verdict: cached.verdict, issues: cached.issues, improved: cached.improved };
     }
     const content = fs.readFileSync(realPath, 'utf8').slice(0, 12000);
-    const result = parseDiagnosis(await (0, summary_1.runHaiku)(buildPrompt(name, content, lang)));
-    store[realPath] = { ...result, hash, lang, generatedAt: new Date().toISOString() };
+    const result = parseDiagnosis(await (0, summary_1.runClaude)(buildPrompt(name, content, lang), model));
+    store[realPath] = { ...result, hash, lang, model, generatedAt: new Date().toISOString() };
     saveDiagnoses(store);
     return result;
 }

package/build/server/flow.js

@@ -0,0 +1,178 @@
+"use strict";
+/*
+ * AI フロー図解: SKILL.md からオーケストレーションの処理フローを抽出する
+ * (docs/plans/09 参照)。diagnose.ts と同じオンデマンド + content hash + lang キャッシュ。
+ * スキーマは LLM が壊しにくい「直列 steps + 分岐注記」に制約し、任意の DAG は扱わない。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFlows = loadFlows;
+exports.parseFlow = parseFlow;
+exports.flowOne = flowOne;
+exports.attachFlows = attachFlows;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const summary_1 = require("./summary");
+const FLOW_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'flows.json');
+/*
+ * 抽出スキーマの世代。branches.to(ループ/スキップ)追加で 2。
+ * 旧世代キャッシュも表示には使い続ける(フローチャート描画は to 無しでも成立し、
+ * ループ矢印だけ出ない)が、再抽出時は stale 扱いして新スキーマで作り直す。
+ */
+const FLOW_SCHEMA_V = 2;
+function loadFlows() {
+    try {
+        return JSON.parse(fs.readFileSync(FLOW_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveFlows(store) {
+    fs.mkdirSync(path.dirname(FLOW_FILE), { recursive: true });
+    fs.writeFileSync(FLOW_FILE, JSON.stringify(store, null, 1));
+}
+function buildPrompt(name, content, lang) {
+    if (lang === 'ja') {
+        return ('以下は Claude Code の skill 定義です。この skill が実行する処理フローを図解用に抽出し、次の JSON だけを出力してください(前置き・コードフェンス不要):\n' +
+            '{"steps": [{"title": "ステップ名(10字程度)", "detail": "何をするか(25字程度)",\n' +
+            ' "calls": ["このステップで起動/委譲する他の skill・コマンド名"],\n' +
+            ' "gate": "human" | "auto" | null,\n' +
+            ' "branches": [{"when": "分岐条件(15字程度)", "then": "その場合の挙動(20字程度)", "to": 行き先ステップ番号}]}]}\n\n' +
+            '制約:\n' +
+            '- steps は実行順に 4〜8 個(単純な skill なら少なくてよい)\n' +
+            '- gate は人間の確認/承認を待つステップだけ "human"(自動で進むなら "auto"、該当なしは null)\n' +
+            '- calls は本文に実際に登場する名前のみ(幻覚禁止)\n' +
+            '- branches は中断・フォールバック等の分岐だけ(無ければ省略)。when は「テスト失敗」のような判定できる条件文にする\n' +
+            '- to は分岐が別ステップへ移るときだけ 1 始まりの番号で(リトライ/ループで前へ戻る場合が典型)。単なる中断・終了なら省略\n\n' +
+            '# skill: ' +
+            name +
+            '\n\n' +
+            content);
+    }
+    return ('Below is a Claude Code skill definition. Extract the processing flow this skill executes, for a diagram, and output ONLY this JSON (no preamble, no code fences):\n' +
+        '{"steps": [{"title": "step name (2-4 words)", "detail": "what it does (about 10 words)",\n' +
+        ' "calls": ["other skill/command names this step invokes or delegates to"],\n' +
+        ' "gate": "human" | "auto" | null,\n' +
+        ' "branches": [{"when": "branch condition (about 5 words)", "then": "behavior in that case (about 7 words)", "to": target step number}]}]}\n\n' +
+        'Constraints:\n' +
+        '- 4 to 8 steps in execution order (fewer is fine for simple skills)\n' +
+        '- gate is "human" ONLY for steps that wait for human confirmation/approval ("auto" if it proceeds automatically, null otherwise)\n' +
+        '- calls may contain only names that actually appear in the body (no hallucination)\n' +
+        '- branches only for aborts / fallbacks / real forks (omit when none); "when" must be a checkable condition like "tests fail"\n' +
+        '- to is the 1-based step number ONLY when the branch jumps to another step (typically looping back for a retry); omit for plain aborts/exits\n\n' +
+        '# skill: ' +
+        name +
+        '\n\n' +
+        content);
+}
+/* haiku/sonnet の出力を検証つきでパース(壊れた出力は throw して UI にエラー表示) */
+function parseFlow(text) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/, '')
+        .trim();
+    const j = JSON.parse(stripped);
+    const steps = [];
+    for (const s of Array.isArray(j.steps) ? j.steps : []) {
+        const title = String(s?.title || '').trim();
+        if (!title)
+            continue;
+        steps.push({
+            title: title.slice(0, 60),
+            detail: String(s?.detail || '').slice(0, 120),
+            calls: (Array.isArray(s?.calls) ? s.calls : [])
+                .filter((c) => typeof c === 'string' && c)
+                .map((c) => c.slice(0, 60))
+                .slice(0, 6),
+            gate: s?.gate === 'human' || s?.gate === 'auto' ? s.gate : null,
+            branches: (Array.isArray(s?.branches) ? s.branches : [])
+                .filter((b) => b && typeof b.when === 'string')
+                .map((b) => ({
+                when: String(b.when).slice(0, 60),
+                then: String(b.then || '').slice(0, 80),
+                ...(Number.isInteger(b.to) && b.to >= 1 ? { to: b.to } : {}),
+            }))
+                .slice(0, 4),
+        });
+        if (steps.length >= 12)
+            break;
+    }
+    if (!steps.length)
+        throw new Error('no steps in output');
+    // to の上限検証は全 step が出揃ってから(範囲外は to だけ捨てて分岐テキストは残す)
+    for (const st of steps)
+        for (const b of st.branches)
+            if (b.to !== undefined && b.to > steps.length)
+                delete b.to;
+    return { steps };
+}
+async function flowOne(realPath, name, lang, model = 'haiku') {
+    const hash = (0, summary_1.contentHash)(realPath);
+    const store = loadFlows();
+    const cached = store[realPath];
+    if (cached && cached.hash === hash && cached.lang === lang && cached.v === FLOW_SCHEMA_V) {
+        return { steps: cached.steps };
+    }
+    const content = fs.readFileSync(realPath, 'utf8').slice(0, 12000);
+    const result = parseFlow(await (0, summary_1.runClaude)(buildPrompt(name, content, lang), model));
+    store[realPath] = {
+        ...result,
+        hash,
+        lang,
+        model,
+        v: FLOW_SCHEMA_V,
+        generatedAt: new Date().toISOString(),
+    };
+    saveFlows(store);
+    return result;
+}
+/* スキャン結果にキャッシュ済みフローを付与(内容が変わっていれば付けない) */
+function attachFlows(sections, lang) {
+    const store = loadFlows();
+    for (const s of sections) {
+        for (const it of s.items) {
+            const cached = store[it.path];
+            if (cached &&
+                cached.lang === lang &&
+                it.path &&
+                fs.existsSync(it.path) &&
+                cached.hash === (0, summary_1.contentHash)(it.path)) {
+                it.aiFlow = { steps: cached.steps };
+            }
+        }
+    }
+}

package/build/server/groups.js

@@ -0,0 +1,202 @@
+"use strict";
+/*
+ * AI グルーピング: 環境内の全アイテム(name + description)を 1 回の haiku 呼び出しに渡し、
+ * 「用途グループの集合 + 各アイテムの割当」をまとめて生成する(docs/plans/08 参照)。
+ * グループ名はプロダクトに焼き込まず環境ごとに生成し、職種非依存の工程軸は
+ * 粒度ガイドとしてだけプロンプトに渡す。frontmatter に category を持つアイテムは
+ * 手動指定として AI 分類の対象外(クライアント側で category がそのままグループになる)。
+ * キャッシュは summary.ts と同思想だが、環境単位で言語ごとに 1 エントリ
+ * (全対象アイテムの name + description の hash)。アイテムの増減・description 変更で
+ * stale になるが、自動再生成はせず UI から手動で再分類する。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupTargets = groupTargets;
+exports.groupsHash = groupsHash;
+exports.parseGroups = parseGroups;
+exports.generateGroups = generateGroups;
+exports.attachGroups = attachGroups;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const crypto = __importStar(require("node:crypto"));
+const summary_1 = require("./summary");
+const GROUPS_FILE = path.join(os.homedir(), '.cache', 'skills-viewer', 'groups.json');
+function loadStore() {
+    try {
+        return JSON.parse(fs.readFileSync(GROUPS_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveStore(store) {
+    fs.mkdirSync(path.dirname(GROUPS_FILE), { recursive: true });
+    fs.writeFileSync(GROUPS_FILE, JSON.stringify(store, null, 1));
+}
+/*
+ * 分類対象 = hook 以外の全アイテム(built-in 含む)を name で重複排除したもの。
+ * 同名アイテム(user と project の code-review 等)は同じグループに落とす。
+ * category 持ちは手動指定なので対象外。description は 200 字で切る(分類には十分)。
+ */
+function groupTargets(sections) {
+    const seen = new Map();
+    for (const s of sections) {
+        for (const it of s.items) {
+            if (it.kind === 'hook' || it.category || seen.has(it.name))
+                continue;
+            seen.set(it.name, { name: it.name, description: it.description.slice(0, 200) });
+        }
+    }
+    return [...seen.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+function groupsHash(targets) {
+    const src = targets.map((t) => t.name + '\t' + t.description).join('\n');
+    return crypto.createHash('sha256').update(src).digest('hex').slice(0, 16);
+}
+/* 職種非依存の工程軸(粒度ガイド)。グループ名の直接指定ではない */
+const AXIS_JA = '企画・要件 / 制作・実装 / レビュー・検証 / リリース・共有 / 調査・分析 / 記録・運用';
+const AXIS_EN = 'planning & requirements / building & creating / review & verification / release & sharing / research & analysis / records & operations';
+function buildPrompt(targets, lang) {
+    const list = targets.map((t) => t.name + ': ' + t.description).join('\n');
+    if (lang === 'ja') {
+        return ('以下は Claude Code にインストールされた skill / command / agent の一覧です(1行 = 「name: description」)。\n' +
+            'これらを「いつ・何をするときに使うか」の観点でグループ分けし、次の JSON だけを出力してください(前置き・コードフェンス不要):\n' +
+            '{"groups": [{"id": "英小文字とハイフンのスラッグ(言語非依存)", "label": "グループ名(日本語で10字程度)", "emoji": "グループを表す絵文字1つ"}],\n' +
+            ' "assign": {"<name>": "<groupId>"}}\n\n' +
+            '制約:\n' +
+            '- グループ数は 4〜8。粒度の目安は職種を問わない工程軸「' +
+            AXIS_JA +
+            '」。ただしグループ名はこの一覧の実態に合わせること(例に無い分野があればそのグループを作ってよい)\n' +
+            '- assign には一覧の全 name を必ず 1 回ずつ含める。迷う場合も最も近いグループに割り当てる\n' +
+            '- assign の値は groups で定義した id のみ使用する\n\n' +
+            '# 一覧\n' +
+            list);
+    }
+    return ('Below is a list of skills / commands / agents installed for Claude Code (one per line, "name: description").\n' +
+        'Group them by WHEN and FOR WHAT they are used, and output ONLY this JSON (no preamble, no code fences):\n' +
+        '{"groups": [{"id": "lowercase-hyphen slug (language-neutral)", "label": "group name in English (2-4 words)", "emoji": "one emoji for the group"}],\n' +
+        ' "assign": {"<name>": "<groupId>"}}\n\n' +
+        'Constraints:\n' +
+        '- 4 to 8 groups. Use this role-agnostic workflow axis as a granularity guide: ' +
+        AXIS_EN +
+        '. Name the groups after what is actually in the list (create different groups if the list calls for them).\n' +
+        '- assign MUST contain every name from the list exactly once; when unsure, pick the closest group.\n' +
+        '- assign values must be ids defined in groups.\n\n' +
+        '# List\n' +
+        list);
+}
+/* id を言語非依存スラッグに正規化(空になったら null) */
+function slugify(v) {
+    const s = String(v ?? '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return s || null;
+}
+/*
+ * haiku の出力を検証つきでパース。
+ * - groups: id をスラッグ正規化・重複排除し、最大 12 件
+ * - assign: 一覧に無い name(幻覚)と未定義グループへの割当は捨てる(→「その他」扱い)
+ * groups が 1 件も取れない出力はエラー(UI にエラー表示)
+ */
+function parseGroups(text, names) {
+    const stripped = text
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/, '')
+        .trim();
+    const j = JSON.parse(stripped);
+    const groups = [];
+    const ids = new Set();
+    for (const g of Array.isArray(j.groups) ? j.groups : []) {
+        const id = slugify(g?.id);
+        const label = String(g?.label || '').trim();
+        if (!id || !label || ids.has(id))
+            continue;
+        ids.add(id);
+        const emoji = String(g?.emoji || '').trim();
+        groups.push({ id, label: label.slice(0, 40), ...(emoji ? { emoji: emoji.slice(0, 8) } : {}) });
+        if (groups.length >= 12)
+            break;
+    }
+    if (!groups.length)
+        throw new Error('no groups in output');
+    const nameSet = new Set(names);
+    const assign = {};
+    for (const [name, gid] of Object.entries(j.assign || {})) {
+        const id = slugify(gid);
+        if (nameSet.has(name) && id && ids.has(id))
+            assign[name] = id;
+    }
+    return { groups, assign };
+}
+/*
+ * 環境全体を 1 回の claude 呼び出しで分類してキャッシュに保存する。
+ * 入力が大きく(全アイテム一覧)haiku でも 2 分近くかかるため、タイムアウトは
+ * 単体要約(120s)より長い 10 分にする(sonnet / opus はさらに遅い)
+ */
+async function generateGroups(sections, lang, model = 'haiku') {
+    const targets = groupTargets(sections);
+    const result = parseGroups(await (0, summary_1.runClaude)(buildPrompt(targets, lang), model, 600000), targets.map((t) => t.name));
+    const store = loadStore();
+    store[lang] = {
+        ...result,
+        hash: groupsHash(targets),
+        model,
+        generatedAt: new Date().toISOString(),
+    };
+    saveStore(store);
+    return result;
+}
+/*
+ * スキャン結果にキャッシュ済みの割当を付与する。
+ * stale(生成後に構成が変わった)でも古い割当は表示価値があるので付与し、
+ * stale フラグで UI に再分類を促す。新規アイテムは割当なし(「その他」に落ちる)。
+ */
+function attachGroups(sections, lang) {
+    const entry = loadStore()[lang];
+    if (!entry)
+        return { stale: false };
+    for (const s of sections) {
+        for (const it of s.items) {
+            if (it.kind === 'hook' || it.category)
+                continue;
+            const gid = entry.assign[it.name];
+            if (gid)
+                it.aiGroup = gid;
+        }
+    }
+    return { groups: entry.groups, stale: entry.hash !== groupsHash(groupTargets(sections)) };
+}

package/build/server/index.js

@@ -50,6 +50,8 @@ const summary_1 = require("./summary");
 const manage_1 = require("./manage");
 const edit_1 = require("./edit");
 const diagnose_1 = require("./diagnose");
+const flow_1 = require("./flow");
+const groups_1 = require("./groups");
 const snapshot_1 = require("./snapshot");
 const errors_1 = require("./errors");
 const locale_1 = require("./locale");
@@ -157,6 +159,8 @@ function collect(cwd, lang) {
         }
     }
     (0, diagnose_1.attachDiagnoses)(sections, lang);
+    (0, flow_1.attachFlows)(sections, lang);
+    const grp = (0, groups_1.attachGroups)(sections, lang);
     const aiStale = (0, summary_1.staleItems)(sections, lang).length;
     const targets = [
         { label: 'user skills', sub: '~/.claude/skills/', path: scan_1.HOME },
@@ -172,6 +176,8 @@ function collect(cwd, lang) {
         aiStale,
         usageAvailable,
         changes: (0, snapshot_1.computeChanges)(sections),
+        ...(grp.groups ? { groups: grp.groups } : {}),
+        ...(grp.stale ? { groupsStale: true } : {}),
     };
 }
 /* DNS rebinding 対策: same-origin GET には Origin が付かないため Host 側も検証する */
@@ -244,6 +250,7 @@ function handleApi(req, res, cwd) {
             return send(400, { error: 'bad-json', detail: '' });
         }
         const lang = langOf(data.lang);
+        const model = (0, summary_1.modelOf)(data.model);
         try {
             if (url.pathname === '/api/save')
                 return send(200, (0, edit_1.doSave)(data));
@@ -252,11 +259,19 @@ function handleApi(req, res, cwd) {
             if (url.pathname === '/api/diagnose') {
                 const real = (0, manage_1.assertReadableMd)(data.src);
                 const name = data.name || path.basename(path.dirname(real));
-                (0, diagnose_1.diagnoseOne)(real, name, lang)
+                (0, diagnose_1.diagnoseOne)(real, name, lang, model)
                     .then((d) => send(200, { ok: true, ...d }))
                     .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));
                 return;
             }
+            if (url.pathname === '/api/flow') {
+                const real = (0, manage_1.assertReadableMd)(data.src);
+                const name = data.name || path.basename(path.dirname(real));
+                (0, flow_1.flowOne)(real, name, lang, model)
+                    .then((f) => send(200, { ok: true, ...f }))
+                    .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));
+                return;
+            }
             if (url.pathname === '/api/changes-ack') {
                 (0, snapshot_1.ackChanges)((0, scan_1.scanSections)(cwd, lang));
                 return send(200, { ok: true });
@@ -268,16 +283,23 @@ function handleApi(req, res, cwd) {
             if (url.pathname === '/api/open')
                 return send(200, (0, manage_1.openInEditor)(data));
             if (url.pathname === '/api/summarize-all')
-                return send(200, (0, summary_1.startSummarizeAll)((0, scan_1.scanSections)(cwd, lang), !!data.force, lang));
+                return send(200, (0, summary_1.startSummarizeAll)((0, scan_1.scanSections)(cwd, lang), !!data.force, lang, model));
+            if (url.pathname === '/api/group-generate') {
+                // 環境全体で 1 回の claude 呼び出し。完了時にグループ集合を返す(割当は再取得で反映)
+                (0, groups_1.generateGroups)((0, scan_1.scanSections)(cwd, lang), lang, model)
+                    .then((r) => send(200, { ok: true, groups: r.groups }))
+                    .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));
+                return;
+            }
             if (url.pathname === '/api/summarize') {
                 const real = (0, manage_1.assertReadableMd)(data.src);
                 // refs(関係候補)はスキャン結果から復元する
                 const sections = (0, scan_1.scanSections)(cwd, lang);
                 const item = sections.flatMap((s) => s.items).find((x) => x.path === real);
                 const name = data.name || item?.name || path.basename(path.dirname(real));
-                (0, summary_1.summarizeOne)({ path: real, name, refs: item?.refs || [] }, lang)
+                (0, summary_1.summarizeOne)({ path: real, name, refs: item?.refs || [] }, lang, model)
                     .then((analysis) => {
-                    (0, summary_1.saveSummary)(real, name, analysis, lang);
+                    (0, summary_1.saveSummary)(real, name, analysis, lang, model);
                     send(200, { ok: true, ...analysis });
                 })
                     .catch((e) => send(400, (0, errors_1.toErrorBody)(e)));

package/build/server/scan.js

@@ -152,6 +152,7 @@ function readSkillDir(dir, nameHint) {
         path: skillMd,
         updatedAt: fileMtime(skillMd),
         files: listFiles(dir).sort(),
+        ...(meta.category ? { category: meta.category } : {}),
         ...(lint.length ? { lint } : {}),
         _body: body, // 参照抽出用(scanSections で refs 化して破棄)
     };
@@ -197,6 +198,7 @@ function scanMdRoot(root, kind) {
             path: fp,
             updatedAt: fileMtime(fp),
             files: [entry.name],
+            ...(meta.category ? { category: meta.category } : {}),
             ...(lint.length ? { lint } : {}),
             _body: body,
         });

package/build/server/summary.js

@@ -1,8 +1,10 @@
 "use strict";
 /*
- * AI 要約 + 起動分類: claude CLI headless (haiku) で SKILL.md を分析し、
- * 内容ハッシュをキーに ~/.cache/skills-viewer/summaries.json へキャッシュ。
+ * AI 要約 + 起動分類: claude CLI headless(既定 haiku。設定でモデル変更可)で SKILL.md を
+ * 分析し、内容ハッシュをキーに ~/.cache/skills-viewer/summaries.json へキャッシュ。
  * ハッシュが一致する限り再生成しない(mtime でなくハッシュなので同期や clone に強い)。
+ * モデルはキャッシュキーに含めない: 切替だけで全件 stale になるのを避け、
+ * 置き換えたい場合は強制再生成を使う(生成時のモデルは記録する)。
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -40,7 +42,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadSummaries = loadSummaries;
 exports.contentHash = contentHash;
-exports.runHaiku = runHaiku;
+exports.modelOf = modelOf;
+exports.runClaude = runClaude;
 exports.summarizeOne = summarizeOne;
 exports.parseAnalysis = parseAnalysis;
 exports.saveSummary = saveSummary;
@@ -145,21 +148,26 @@ function buildPrompt(it, refs, content, lang) {
         '\n\n' +
         content);
 }
+/* クライアント指定のモデルを許可リストで検証(不明値は既定の haiku に落とす) */
+function modelOf(v) {
+    return v === 'sonnet' || v === 'opus' ? v : 'haiku';
+}
 /*
- * claude CLI headless (haiku) にプロンプトを渡して生テキストを得る共通実行部。
+ * claude CLI headless にプロンプトを渡して生テキストを得る共通実行部。
+ * モデルはエイリアス指定(haiku / sonnet / opus)で、実体は CLI 側の解決に従う。
  * --tools '' で全ツールを無効化: SKILL.md は clone したリポジトリ由来もあり得るため、
  * 本文に指示が仕込まれていても純粋なテキスト生成の外に出られないようにする
  */
-function runHaiku(prompt) {
+function runClaude(prompt, model = 'haiku', timeoutMs = 120000) {
     return new Promise((resolve, reject) => {
-        const child = (0, node_child_process_1.spawn)('claude', ['-p', '--model', 'haiku', '--tools', ''], {
+        const child = (0, node_child_process_1.spawn)('claude', ['-p', '--model', model, '--tools', ''], {
             stdio: ['pipe', 'pipe', 'pipe'],
         });
         let out = '', errOut = '';
         const timer = setTimeout(() => {
             child.kill('SIGKILL');
-            reject(new Error('timeout (120s)'));
-        }, 120000);
+            reject(new Error(`timeout (${Math.round(timeoutMs / 1000)}s)`));
+        }, timeoutMs);
         child.stdout.on('data', (d) => {
             out += d;
         });
@@ -181,13 +189,13 @@ function runHaiku(prompt) {
     });
 }
 /*
- * 1 skill を haiku で分析し {summary, invocation, invocationReason, relations} を返す。
+ * 1 skill を分析し {summary, invocation, invocationReason, relations} を返す。
  * relations の候補(refs)は静的解析で抽出済みの既知 skill 名のみに制限し、幻覚を防ぐ。
  */
-async function summarizeOne(it, lang) {
+async function summarizeOne(it, lang, model = 'haiku') {
     const content = fs.readFileSync(it.path, 'utf8').slice(0, 12000);
     const refs = it.refs || [];
-    const text = await runHaiku(buildPrompt(it, refs, content, lang));
+    const text = await runClaude(buildPrompt(it, refs, content, lang), model);
     return parseAnalysis(text, refs);
 }
 /* haiku の出力を検証つきでパース。壊れていたら全文を summary として扱う */
@@ -222,7 +230,7 @@ function parseAnalysis(text, refs) {
         return { summary: stripped, invocation: null, invocationReason: '', relations: [] };
     }
 }
-function saveSummary(realPath, name, analysis, lang) {
+function saveSummary(realPath, name, analysis, lang, model = 'haiku') {
     const summaries = loadSummaries();
     summaries[realPath] = {
         hash: contentHash(realPath),
@@ -233,6 +241,7 @@ function saveSummary(realPath, name, analysis, lang) {
         relations: analysis.relations,
         generatedAt: new Date().toISOString(),
         lang,
+        model,
     };
     saveSummaries(summaries);
 }
@@ -262,7 +271,7 @@ function staleItems(sections, lang) {
     });
 }
 let summaryJob = null;
-function startSummarizeAll(sections, force, lang) {
+function startSummarizeAll(sections, force, lang, model = 'haiku') {
     if (summaryJob && !summaryJob.finished)
         return summaryJob;
     const items = force ? summarizableItems(sections) : staleItems(sections, lang);
@@ -283,8 +292,8 @@ function startSummarizeAll(sections, force, lang) {
                 const it = items[idx++];
                 job.current = it.name;
                 try {
-                    const analysis = await summarizeOne(it, lang);
-                    saveSummary(it.path, it.name, analysis, lang);
+                    const analysis = await summarizeOne(it, lang, model);
+                    saveSummary(it.path, it.name, analysis, lang, model);
                 }
                 catch (e) {
                     job.errors.push(it.name + ': ' + (e instanceof Error ? e.message : String(e)));