@shinaps/skills 0.44.0 → 0.46.0

package/README.md

@@ -8,7 +8,7 @@ Claude Code と Codex で使う、開発ワークフローのスキル集です
 ## 必要なもの
 
 - Claude Code または Codex CLI
-- Node.js 22.13 以上の 22 系、または 24 以上（Codex への導入と、設定の検証・Managed Agents の操作・規約の機械検査に使う[配布 CLI](docs/install.md#配布-cli)に必要。機械検査の ESLint の要件に合わせている）。配布 CLI は機械検査のために ESLint・typescript-eslint・TypeScript などを依存に持ち、導入に約 50MB を使います。
+- Node.js 22.13 以上の 22 系、または 24 以上（Codex への導入と、設定の検証・Managed Agents の操作・規約の機械検査に使う[配布 CLI](docs/install.md#配布-cli)に必要。機械検査の ESLint の要件に合わせている）。配布 CLI は機械検査のために ESLint・typescript-eslint・TypeScript などを依存に持ち、導入に約 65MB を使います。
 - 機能によって追加で必要なもの（Linear・Claude Managed Agents など）は、下の「機能別の資料」の各資料に書いています。
 
 ## インストール

package/dist/lib/lint-rules.js

@@ -38,6 +38,57 @@ const preferPromiseWithResolvers = {
         };
     },
 };
+/**
+ * Vue の `:key` が v-for の index を使う書き方を報告する。index は v-for の 2 番目以降の別名
+ * (`(item, i) in items` の i、`(value, name, i) in object` の i) とする。オブジェクトの反復の 2 番目
+ * (`(value, name) in object` の name、プロパティ名) も構文では配列の index と区別できないので報告する。
+ * `items[i].id` のようにメンバーの計算プロパティとしてだけ使う参照は、index で引いた値の id なので報告しない。
+ * テンプレートを解析できないファイル (vue-eslint-parser 以外、HTML 以外のテンプレート) では何もしない。
+ */
+const vueNoIndexKey = {
+    meta: {
+        type: 'problem',
+        docs: {
+            description: 'Disallow v-for keys derived from the iteration index',
+        },
+        messages: {
+            indexKey: "The key uses the v-for index '{{name}}'. Use a stable identifier of the item (an id or slug).",
+        },
+        schema: [],
+    },
+    create(context) {
+        // ESLint の parserServices は parser ごとに中身が違う。vue-eslint-parser で読んだときだけ
+        // defineTemplateBodyVisitor がある。
+        const services = context.sourceCode.parserServices;
+        if (!services.defineTemplateBodyVisitor)
+            return {};
+        // defineTemplateBodyVisitor の戻り値は object 型だが、実体は ESLint に渡す visitor。
+        return services.defineTemplateBodyVisitor({
+            "VAttribute[directive=true][key.name.name='bind'][key.argument.name='key']"(node) {
+                for (const reference of node.value?.references ?? []) {
+                    const variable = reference.variable;
+                    if (variable?.kind !== 'v-for')
+                        continue;
+                    const forExpression = variable.id.parent;
+                    if (forExpression?.type !== 'VForExpression')
+                        continue;
+                    if (forExpression.left.indexOf(variable.id) < 1)
+                        continue;
+                    const parent = reference.id.parent;
+                    if (parent?.type === 'MemberExpression' &&
+                        parent.computed &&
+                        parent.property === reference.id)
+                        continue;
+                    context.report({
+                        node: reference.id,
+                        messageId: 'indexKey',
+                        data: { name: reference.id.name },
+                    });
+                }
+            },
+        });
+    },
+};
 function findVariable(scope, name) {
     for (let current = scope; current; current = current.upper) {
         const variable = current.set.get(name);
@@ -48,5 +99,8 @@ function findVariable(scope, name) {
 }
 export const shinapsPlugin = {
     meta: { name: 'shinaps' },
-    rules: { 'prefer-promise-with-resolvers': preferPromiseWithResolvers },
+    rules: {
+        'prefer-promise-with-resolvers': preferPromiseWithResolvers,
+        'vue-no-index-key': vueNoIndexKey,
+    },
 };

package/dist/lib/lint.js

@@ -154,18 +154,47 @@ function isActive(config, rule) {
     const severity = Array.isArray(entry) ? entry[0] : entry;
     return severity !== undefined && severity !== 0 && severity !== 'off';
 }
+/**
+ * react-x から登録するルール。型情報を使うのに meta.docs.requiresTypeChecking を宣言しないルール
+ * (no-implicit-key、no-leaked-conditional-rendering など。ESLintUtils.getParserServices を呼ぶ) は、型なしの
+ * 実行単位に入って lintFiles を例外で止め、同じ単位の他の検査まで not-run にするので登録しない。
+ * 追加するときは、型を使わないことをソースで確かめる (docs/lint.md)。
+ */
+const REACT_X_RULES = [
+    'rules-of-hooks',
+    'exhaustive-deps',
+    'no-array-index-key',
+    'no-missing-key',
+    'no-nested-component-definitions',
+    'no-unstable-context-value',
+];
+/**
+ * react-x が判定の前提にする React の版。settings に版が無いと、react-x (@eslint-react/shared の
+ * getReactVersion) は `createRequire(process.cwd())("react")` でプロジェクトの react を読み込むため、固定して
+ * 呼ばせない。値は react-x が検出に失敗したときの既定と同じ。React 18 のプロジェクトでも 19 の前提で判定する
+ * (`<Context value>` の省略形を provider として扱うなど、報告が増える側に寄る)。
+ */
+const REACT_X_SETTINGS = { 'react-x': { version: '19.3.0' } };
 async function loadRegistry() {
-    const [{ builtinRules }, tseslint, vue, vueParser] = await Promise.all([
+    const [{ builtinRules }, tseslint, vue, vueParser, reactX, regexp] = await Promise.all([
         import('eslint/use-at-your-own-risk'),
         import('typescript-eslint'),
         import('eslint-plugin-vue'),
         import('vue-eslint-parser'),
+        import('eslint-plugin-react-x'),
+        import('eslint-plugin-regexp'),
     ]);
-    // typescript-eslint と eslint-plugin-vue が公開する型は ESLint の Plugin・Parser・RuleModule の型と
-    // 細部が一致しない (どちらも実行時は ESLint の API に従う)。flat config に渡すために ESLint の型にする。
+    // typescript-eslint・eslint-plugin-vue・eslint-plugin-react-x が公開する型は ESLint の Plugin・Parser・
+    // RuleModule の型と細部が一致しない (どれも実行時は ESLint の API に従う)。flat config に渡すために ESLint の型にする。
+    const reactXRules = reactX.default.rules;
     const plugins = {
         '@typescript-eslint': tseslint.default.plugin,
         vue: vue.default,
+        'react-x': {
+            meta: reactX.default.meta,
+            rules: Object.fromEntries(REACT_X_RULES.map((name) => [name, reactXRules[name]])),
+        },
+        regexp: regexp.default,
         shinaps: shinapsPlugin,
     };
     const rules = new Map(builtinRules);
@@ -226,6 +255,7 @@ function unitConfig(registry, root, typed, rules) {
         ...rules.map((planned) => ({
             files: [...new Set(planned.bindings.flatMap((binding) => binding.check.files))],
             plugins: registry.plugins,
+            settings: REACT_X_SETTINGS,
             // options は JSON の配列 (unknown[]) で、ESLint の RuleEntry は要素の型を持たないので型だけを合わせる。
             rules: { [planned.rule]: ['error', ...planned.options] },
         })),

package/dist/lib/managed-session.js

@@ -4,6 +4,7 @@ import { join, resolve } from 'node:path';
 import { readJson, readJsonIfExists, writeFileAtomic } from "./fs.js";
 import { withLock } from "./lock.js";
 import { filesBeta, managedBeta } from "./managed-ant.js";
+import { importSnapshot } from "./managed-snapshot.js";
 export const staffings = ['LITE', 'BASIC', 'ULTRA'];
 export const permissions = ['commit', 'push', 'draft_pr'];
 const leadKey = './agents/shinaps-dev-managed-cc.md';
@@ -64,27 +65,28 @@ export async function runSession(account, request, options) {
         };
         // 作成より前に記録する。作成後に記録できずに終わっても、次の実行は止まり、重複して作らない。
         await writeFileAtomic(recordPath, JSON.stringify(record, null, 2) + '\n');
-        const resources = [
-            {
-                type: 'github_repository',
-                url: request.repository.url,
-                mount_path: request.repository.mount_path,
-                ...(options.githubToken ? { authorization_token: options.githubToken } : {}),
-                checkout: { type: 'commit', sha: request.base_sha },
-            },
-        ];
-        if (options.claudeMdPath) {
-            // upload は記録の後に行う。記録の前だと、途中で止まった実行の再実行のたびに Files が増える。
-            let fileId;
+        const resources = request.snapshot
+            ? []
+            : [
+                {
+                    type: 'github_repository',
+                    url: request.repository.url,
+                    mount_path: request.repository.mount_path,
+                    ...(options.githubToken ? { authorization_token: options.githubToken } : {}),
+                    checkout: { type: 'commit', sha: request.base_sha },
+                },
+            ];
+        // upload は記録の後に行う。記録の前だと、途中で止まった実行の再実行のたびに Files が増える。
+        const upload = async (file, mountPath) => {
             try {
-                fileId = await readId(ant({
+                const fileId = await readId(ant({
                     // セッションの Files と同じ beta の Files API に上げる。パスは絶対パスにする (ant は `-` を
                     // stdin と解釈する)。
                     argv: [
                         'beta:files',
                         'upload',
                         '--file',
-                        resolve(options.claudeMdPath),
+                        resolve(file),
                         ...filesBeta,
                         '--transform',
                         'id',
@@ -92,14 +94,18 @@ export async function runSession(account, request, options) {
                     ],
                     apiKey: account.apiKey,
                 }), 'ant files upload');
+                resources.push({ type: 'file', file_id: fileId, mount_path: mountPath });
             }
             catch (error) {
                 // セッションはまだ作っていないので、記録を残すと同じ依頼の再実行が不要に止まる。
                 await rm(recordPath, { force: true });
                 throw error;
             }
-            resources.push({ type: 'file', file_id: fileId, mount_path: '/CLAUDE.md' });
-        }
+        };
+        if (request.snapshot)
+            await upload(request.snapshot.bundle, '/source.bundle');
+        if (options.claudeMdPath)
+            await upload(options.claudeMdPath, '/CLAUDE.md');
         const body = {
             agent,
             environment_id: environment,
@@ -140,6 +146,16 @@ function initialMessage(request) {
         `必須検証（任意）: ${request.verify ?? '指定なし。リポジトリの規約に従う'}`,
         `author（任意）: ${request.author ?? '指定なし'}`,
         ...(request.claude_md === null ? [] : ['利用者 CLAUDE.md: /mnt/session/uploads/CLAUDE.md']),
+        ...(request.snapshot
+            ? [
+                'ローカルコードの受け渡し: GitHubのcheckoutの代わりに /mnt/session/uploads/source.bundle を使用する。',
+                `作業前に git clone /mnt/session/uploads/source.bundle ${JSON.stringify(request.repository.mount_path)} を実行する。`,
+                `比較元は送信時点のスナップショット ${request.snapshot.id}。このSHAからheadブランチを作り作業する。`,
+                'このスナップショットには元のGit履歴・remote・資格情報は含まれない。pushとPRは行わない。',
+                `完了時はlaunch.mdの一時indexによる出力手順に従い、新規ファイルを含む ${request.snapshot.id} からの全差分を /mnt/session/outputs/changes.patch に書く。`,
+                '変更内容・検証結果・未完了事項を /mnt/session/outputs/report.md に書き、ローカルで再開できるようにする。',
+            ]
+            : []),
     ].join('\n');
 }
 /**
@@ -152,10 +168,17 @@ async function requireRecordedSession(account, sessionId) {
     for (const name of names.filter((entry) => entry.endsWith('.json'))) {
         const record = await readJson(join(directory, name));
         if (record.session_id === sessionId)
-            return;
+            return record;
     }
     throw new Error(`Session ${sessionId} was not created by managed run for account ${account.name}.`);
 }
+/** 回収済みのローカル snapshot のセッションを、APIキーを使わずに新しいディレクトリへ復元する。 */
+export async function importSession(account, sessionId, destination) {
+    const record = await requireRecordedSession(account, sessionId);
+    if (!record.request.snapshot)
+        throw new Error('This session did not use a local snapshot.');
+    return importSnapshot(record.request.snapshot, join(account.dir, 'sessions', sessionId, 'outputs', 'changes.patch'), destination);
+}
 /** セッションの状態と、lead の最後のメッセージ (1 行目が `状態: 完了|質問|未完了`) を返す。 */
 export async function sessionStatus(account, sessionId, ant) {
     await requireRecordedSession(account, sessionId);

package/dist/lib/managed-snapshot.js

@@ -0,0 +1,175 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { copyFile, lstat, mkdir, mkdtemp, readFile, readlink, realpath, rename, rm, symlink, chmod, } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { readJson, writeFileAtomic } from "./fs.js";
+const execute = promisify(execFile);
+// 呼び出し元の index の上書き・hooks・filter・署名を snapshot に持ち込まない。
+async function git(cwd, args, configuration = 'snapshot') {
+    const env = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('GIT_') || (configuration === 'source' && key.startsWith('GIT_CONFIG_'))));
+    const { stdout } = await execute('git', ['-c', 'core.hooksPath=/dev/null', '-c', 'core.autocrlf=false', ...args], {
+        cwd,
+        maxBuffer: 32 * 1024 * 1024,
+        env: {
+            ...env,
+            ...(configuration === 'snapshot'
+                ? { GIT_CONFIG_NOSYSTEM: '1', GIT_CONFIG_GLOBAL: '/dev/null' }
+                : {}),
+            GIT_AUTHOR_NAME: 'Managed Snapshot',
+            GIT_AUTHOR_EMAIL: 'snapshot@example.invalid',
+            GIT_COMMITTER_NAME: 'Managed Snapshot',
+            GIT_COMMITTER_EMAIL: 'snapshot@example.invalid',
+            GIT_AUTHOR_DATE: '2000-01-01T00:00:00Z',
+            GIT_COMMITTER_DATE: '2000-01-01T00:00:00Z',
+        },
+    });
+    return stdout;
+}
+/**
+ * 元の index を変えずに、現在のソースのファイルを1コミットだけの独立したリポジトリへ固定する。
+ * @param source Git の checkout のルート。未コミットの変更と、無視されていない新規ファイルを含めて送る。
+ * @param root checkout の外にある、snapshot の非公開の保存先。
+ */
+export async function prepareSnapshot(source, root) {
+    source = await realpath(source);
+    const top = (await git(source, ['rev-parse', '--show-toplevel'], 'source')).trim();
+    if ((await realpath(top)) !== source)
+        throw new Error('Snapshot source must be the Git checkout root.');
+    await mkdir(root, { recursive: true, mode: 0o700 });
+    root = await realpath(root);
+    if (root === source || root.startsWith(source + sep))
+        throw new Error('Snapshot storage must be outside the source checkout.');
+    const temporary = await mkdtemp(join(root, '.snapshot-'));
+    try {
+        const repository = join(temporary, 'repository');
+        await mkdir(repository);
+        // 方式を固定する。git の既定が変わっても、readSnapshot が受け付ける 40 桁の id にする。
+        await git(repository, ['init', '--object-format=sha1', '--initial-branch=snapshot']);
+        const candidates = [
+            ...new Set((await git(source, ['ls-files', '-z', '--cached', '--others', '--exclude-standard'], 'source'))
+                .split('\0')
+                .filter(Boolean)),
+        ].sort();
+        const files = [];
+        for (const name of candidates) {
+            // ローカルの運用状態・資格情報・Git の内部・生成された依存物は送らない。
+            const parts = name.split('/');
+            if (parts.some((part) => ['.git', '.shinaps', 'node_modules', '.local'].includes(part)))
+                continue;
+            if (parts.some((part) => /^\.env(?:\.|$)/.test(part) && !/\.(example|sample|template)$/.test(part)) ||
+                /\.(pem|p12|pfx|key)$/i.test(name)) {
+                throw new Error(`Remove credential file from the snapshot source before sending: ${name}`);
+            }
+            const input = join(source, name);
+            let info;
+            try {
+                info = await lstat(input);
+            }
+            catch (error) {
+                if (error.code === 'ENOENT')
+                    continue;
+                throw error;
+            }
+            if (!info.isFile() && !info.isSymbolicLink())
+                throw new Error(`Snapshot does not support directories or submodules as files: ${name}`);
+            // 親ディレクトリも確かめる。途中のディレクトリを差し替えると、checkout 外のファイルを読めてしまう。
+            const parent = await realpath(dirname(input));
+            if (parent !== source && !parent.startsWith(source + sep))
+                throw new Error(`Snapshot path leaves the source checkout: ${name}`);
+            const output = join(repository, name);
+            await mkdir(dirname(output), { recursive: true });
+            if (info.isSymbolicLink()) {
+                const target = await readlink(input);
+                const destination = resolve(dirname(input), target);
+                if (target.startsWith('/') ||
+                    (destination !== source && !destination.startsWith(source + sep)))
+                    throw new Error(`Snapshot symlink leaves the source checkout: ${name}`);
+                await symlink(target, output);
+            }
+            else {
+                await copyFile(input, output);
+                await chmod(output, info.mode & 0o111 ? 0o755 : 0o644);
+            }
+            files.push(name);
+        }
+        await git(repository, ['add', '--all', '--force']);
+        await git(repository, [
+            '-c',
+            'commit.gpgsign=false',
+            'commit',
+            '--allow-empty',
+            '-m',
+            'Local source snapshot',
+        ]);
+        const id = (await git(repository, ['rev-parse', 'HEAD'])).trim();
+        const directory = join(root, id);
+        await git(repository, ['bundle', 'create', join(temporary, 'source.bundle'), 'HEAD']);
+        const snapshot = {
+            id,
+            source,
+            directory,
+            bundle: join(directory, 'source.bundle'),
+            files,
+        };
+        await writeFileAtomic(join(temporary, 'snapshot.json'), JSON.stringify(snapshot, null, 2) + '\n');
+        try {
+            await rename(temporary, directory);
+        }
+        catch (error) {
+            if (!['EEXIST', 'ENOTEMPTY'].includes(error.code ?? ''))
+                throw error;
+            // 同じ内容は別の checkout からも作られうるが、比較元としては同じ tree である。
+            return readSnapshot(join(directory, 'snapshot.json'));
+        }
+        return snapshot;
+    }
+    finally {
+        await rm(temporary, { recursive: true, force: true });
+    }
+}
+/**
+ * prepare が書いた manifest だけを受け付ける。id は git の引数と lead への指示文に、bundle は upload に
+ * 使うので、別のファイルを渡された場合にそのまま使わない。
+ * @param manifest prepare が出力した `snapshot.json` のパス。
+ */
+export async function readSnapshot(manifest) {
+    const { id, source, directory, bundle, files } = (await readJson(manifest)) ?? {};
+    if (typeof id !== 'string' ||
+        !/^[0-9a-f]{40}$/.test(id) ||
+        typeof source !== 'string' ||
+        typeof directory !== 'string' ||
+        !isAbsolute(directory) ||
+        bundle !== join(directory, 'source.bundle') ||
+        !Array.isArray(files) ||
+        !files.every((file) => typeof file === 'string'))
+        throw new Error(`Not a snapshot manifest written by managed prepare: ${manifest}`);
+    return { id, source, directory, bundle, files };
+}
+/**
+ * 比較元と差分を新しいディレクトリに復元する。元の checkout は変更しない。
+ * @param snapshot リモートのセッションが使った、保存済みの比較元。
+ * @param patch 回収した lead の差分。比較元からの全体の差分。
+ * @param destination 復元先の新しいディレクトリ。既に存在してはいけない。
+ */
+export async function importSnapshot(snapshot, patch, destination) {
+    destination = resolve(destination);
+    await mkdir(destination, { mode: 0o700 });
+    try {
+        await git(destination, [
+            'clone',
+            '--no-local',
+            '--',
+            join(snapshot.directory, 'repository'),
+            '.',
+        ]);
+        await git(destination, ['checkout', '--detach', snapshot.id]);
+        const content = await readFile(patch);
+        if (content.length)
+            await git(destination, ['apply', '--index', '--', resolve(patch)]);
+        return destination;
+    }
+    catch (error) {
+        await rm(destination, { recursive: true, force: true });
+        throw error;
+    }
+}

package/dist/lib/managed.js

@@ -1,21 +1,26 @@
 import { readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
+import { join } from 'node:path';
 import { errorMessage } from "./fs.js";
 import { managedAccountDir, managedRoot, packageRoot } from "./layout.js";
 import { antCommand } from "./managed-ant.js";
 import { validateManagedConfig } from "./managed-config.js";
-import { collectOutputs, permissions, replySession, runSession, sessionStatus, staffings, } from "./managed-session.js";
+import { collectOutputs, importSession, permissions, replySession, runSession, sessionStatus, staffings, } from "./managed-session.js";
 import { setupAccount } from "./managed-setup.js";
+import { prepareSnapshot, readSnapshot } from "./managed-snapshot.js";
 const managedUsage = [
     'Usage: shinaps-skills managed setup --account <name> [--account <name> ...] [--apply]',
-    '       shinaps-skills managed run <managed.json> --account <name> --base <branch> --base-sha <sha> --head <branch> --staffing <LITE|BASIC|ULTRA> --allow <none|commit,push,draft_pr> --budget-cents <n> --task-file <file> [--verify <command>] [--author "<name> <email>"] [--title <title>] [--claude-md <file>]',
+    '       shinaps-skills managed run <managed.json> --account <name> --base <branch> (--base-sha <sha> | --snapshot <manifest>) --head <branch> --staffing <LITE|BASIC|ULTRA> --allow <none|commit,push,draft_pr> --budget-cents <n> --task-file <file> [--verify <command>] [--author "<name> <email>"] [--title <title>] [--claude-md <file>]',
     '       shinaps-skills managed status --account <name> --session <id>',
     '       shinaps-skills managed reply --account <name> --session <id> --message-file <file>',
     '       shinaps-skills managed collect --account <name> --session <id>',
+    '       shinaps-skills managed prepare --source <local-checkout-root>',
+    '       shinaps-skills managed import --account <name> --session <id> --destination <new-directory>',
     'API keys: --api-key <name>=<key>, or SHINAPS_MANAGED_API_KEY_<NAME> (prefer the environment variable; arguments are visible to other processes).',
     'GitHub token for the mounted repository: SHINAPS_MANAGED_GITHUB_TOKEN.',
+    'Local source: prepare lists the frozen files and manifest; pass --snapshot <manifest> to run instead of --base-sha. Local snapshots do not push or create PRs.',
 ].join('\n');
-const accountName = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const accountName = /^[a-z0-9][a-z0-9-]*$/;
 const githubTokenVariable = 'SHINAPS_MANAGED_GITHUB_TOKEN';
 const valueFlags = new Set([
     'account',
@@ -33,12 +38,15 @@ const valueFlags = new Set([
     'claude-md',
     'session',
     'message-file',
+    'source',
+    'snapshot',
+    'destination',
 ]);
 const repeatableFlags = new Set(['account', 'api-key']);
 /** アカウント名ごとのキーの環境変数名。名前に `_` を許さないので、名前と一対一に対応する。 */
 const apiKeyVariable = (account) => `SHINAPS_MANAGED_API_KEY_${account.toUpperCase().replaceAll('-', '_')}`;
 /**
- * `shinaps-skills managed <setup|run|status|reply|collect>` を実行する。出力とエラー文から、渡された
+ * `shinaps-skills managed <setup|run|status|reply|collect|prepare|import>` を実行する。出力とエラー文から、渡された
  * APIキーと GitHub token の値を伏字にする。
  */
 export async function managed(args, options = {}) {
@@ -74,6 +82,25 @@ async function dispatch(args, context) {
     const home = context.home ?? homedir();
     const ant = context.ant ?? antCommand(context.env);
     const accounts = flags.get('account') ?? [];
+    if (command === 'prepare') {
+        if (apply || positional.length || accounts.length)
+            throw usageError();
+        const snapshot = await prepareSnapshot(required(flags, 'source'), join(managedRoot(home), 'snapshots'));
+        context.log(JSON.stringify({ ...snapshot, manifest: join(snapshot.directory, 'snapshot.json') }, null, 2));
+        return;
+    }
+    if (command === 'import') {
+        if (apply || positional.length || accounts.length !== 1 || !accountName.test(accounts[0]))
+            throw usageError();
+        const account = { name: accounts[0], dir: managedAccountDir(managedRoot(home), accounts[0]) };
+        const sessionId = required(flags, 'session');
+        context.log(JSON.stringify({
+            account: account.name,
+            session_id: sessionId,
+            directory: await importSession(account, sessionId, required(flags, 'destination')),
+        }, null, 2));
+        return;
+    }
     if (command === 'setup') {
         if (positional.length || !accounts.length)
             throw usageError();
@@ -164,12 +191,19 @@ async function run(configPath, account, flags, context, ant) {
     }
     const optional = (flag) => flags.get(flag)?.[0] ?? null;
     const claudeMdPath = optional('claude-md');
+    const snapshotPath = optional('snapshot');
+    if (snapshotPath && flags.has('base-sha'))
+        throw new Error('Use either --base-sha or --snapshot.');
+    const snapshot = snapshotPath ? await readSnapshot(snapshotPath) : undefined;
+    if (snapshot && (allow.includes('push') || allow.includes('draft_pr'))) {
+        throw new Error('Local snapshots support local result recovery; push and draft_pr are not available.');
+    }
     const request = {
         account: account.name,
         repository: config.repository,
         vault_id: settings.vault_id,
         base: required(flags, 'base'),
-        base_sha: required(flags, 'base-sha'),
+        base_sha: snapshot?.id ?? required(flags, 'base-sha'),
         head: required(flags, 'head'),
         staffing: staffing,
         allow,
@@ -179,6 +213,7 @@ async function run(configPath, account, flags, context, ant) {
         author: optional('author'),
         title: optional('title'),
         claude_md: claudeMdPath === null ? null : await readFile(claudeMdPath, 'utf8'),
+        ...(snapshot ? { snapshot } : {}),
     };
     const sessionId = await runSession(account, request, {
         ant,
@@ -188,6 +223,7 @@ async function run(configPath, account, flags, context, ant) {
         now: context.now ?? (() => new Date()),
     });
     context.log(`Observe: shinaps-skills managed status --account ${account.name} --session ${sessionId}`);
+    context.log(JSON.stringify({ account: account.name, session_id: sessionId }));
 }
 function resolveAccounts(names, flags, env, home) {
     const keys = new Map();
@@ -200,7 +236,7 @@ function resolveAccounts(names, flags, env, home) {
     const unique = [...new Set(names)];
     const invalid = unique.filter((name) => !accountName.test(name));
     if (invalid.length) {
-        throw new Error(`Invalid account name: ${invalid.join(', ')}. Use lowercase letters, digits and single hyphens.`);
+        throw new Error(`Invalid account name: ${invalid.join(', ')}. Use lowercase letters, digits and hyphens, starting with a letter or digit.`);
     }
     const missing = unique.filter((name) => !(keys.get(name) || env[apiKeyVariable(name)]));
     if (missing.length) {

package/docs/install.md

@@ -26,7 +26,7 @@ npx @shinaps/skills@latest recover codex
 設定の検証（`validate-linear-config`・`validate-managed-config`）、Managed Agents の操作（`managed`）、規約の機械検査（`lint`、[規約の機械検査](lint.md)）には、配布 CLI `shinaps-skills` を使います。CLI は plugin に含まれないため、利用中のスキルと同じ版を導入します。
 
 ```sh
-npm install -g @shinaps/skills@0.44.0
+npm install -g @shinaps/skills@0.46.0
 shinaps-skills --version
 ```
 

package/docs/lint.md

@@ -4,7 +4,7 @@ Shinaps AIの規約が持つ機械検査（`checks`）を手元で実行し、
 
 ## 前提と保証
 
-- プロジェクトの変更は要りません。プロジェクトのlint設定（`eslint.config.*`・`.oxlintrc.json`・`bunfig.toml` など）・`package.json` のscript・`node_modules` のパッケージは読み込みません。ESLintのNode APIを `overrideConfigFile: true` で使い、パーサーとプラグインはこのパッケージの依存から渡します。読むのは対象ファイルと、型情報を使うルールのための `tsconfig.json`・型宣言だけです（実行はしません）。
+- プロジェクトの変更は要りません。プロジェクトのlint設定（`eslint.config.*`・`.oxlintrc.json`・`bunfig.toml` など）・`package.json` のscript・`node_modules` のパッケージは読み込みません。ESLintのNode APIを `overrideConfigFile: true` で使い、パーサーとプラグインはこのパッケージの依存から渡します。読むのは対象ファイルと、型情報を使うルールのための `tsconfig.json`・型宣言だけです（実行はしません）。React のルール（react-x）が判定に使う React の版は、プロジェクトの `react` から検出させず `19.3.0` に固定します（React 18 のプロジェクトでも 19 の前提で判定するので、`<Context value>` の省略形を provider として扱うなど、報告が増える側に寄ります）。
 - 対象ファイルへ書き込みません（自動修正はしません）。結果はローカルのファイルに書き、サーバーへは送りません。
 - プロジェクトの `eslint-disable` コメントでは検査を抑止しません（`allowInlineConfig: false`）。プロジェクトの都合の例外は、指摘を確認する側で扱います。
 - 組をAI照合から外してよいのは、coverage が `full` の検査が、ESLintの判定でそのファイルに適用され、検査の実行単位が完了し、そのファイルに致命的な報告もruleIdの無い報告も無いときだけです。それ以外の組は `not-run`（または `partial`）として返し、合格にしません。coverage は検査を登録したときの判断で、このCLIは値を読むだけです。
@@ -44,7 +44,9 @@ shinaps-skills lint --checks <checks.json> --root <project> --out <result.json>
 
 ## 実行の仕組み
 
-1. 各検査のルールを、ESLint core・`@typescript-eslint`・`vue`・同梱の `shinaps` から引きます。この版に無いルールの検査は `not-run` になり、他の検査は止まりません。
+1. 各検査のルールを、ESLint core・`@typescript-eslint`・`vue`・`react-x`（下の6ルールだけ）・`regexp`・同梱の `shinaps` から引きます。この版に無いルールの検査は `not-run` になり、他の検査は止まりません。
+   - `react-x`（eslint-plugin-react-x）: `rules-of-hooks`・`exhaustive-deps`・`no-array-index-key`・`no-missing-key`・`no-nested-component-definitions`・`no-unstable-context-value`。react-x には型情報を使うのに `meta.docs.requiresTypeChecking` を宣言しないルールがあり、型なしの実行単位に入ると単位の全ての検査を止めるため、型を使わないことをソースで確かめたルールだけを登録します（`lib/lint.ts` の `REACT_X_RULES`）。他の外部プラグインでも、型を使うのに宣言しないルールは登録しません。
+   - `regexp`（eslint-plugin-regexp）: 全てのルール。型情報は有無を確かめてから使います。
 2. 検査ごとに、その検査の設定だけを入れたESLintで `calculateConfigForFile` を呼び、ルールが有効なファイルを適用先にします。globの解釈はESLintだけが行います。ESLintが設定を拒否した検査（不正なoptionsなど）は、ここで `not-run` になります。
 3. 同じルール・同じoptionsの検査は1つの設定にまとめ、同じルールでoptionsが違うものだけを別の実行単位にします。型情報を使うルール（`meta.docs.requiresTypeChecking`）は `projectService` を使う単位に分けます。この単位は全てのファイルを typescript-eslint で読み、型の得られないファイル（`tsconfig.json` に含まれないTS・JS、Vue）はそのファイルだけが `not-run` になります。型なしの検査と、他のファイルの型付きの検査は影響を受けません。型情報を使うルールはVueのファイルでは実行できません。
 4. 実行単位ごとに `lintFiles` を1回呼び、組を分類します。指摘は、ESLintがそのファイルに適用すると判定した検査の規約にだけ付けます。
@@ -54,6 +56,7 @@ shinaps-skills lint --checks <checks.json> --root <project> --out <result.json>
 | ルールID | 内容 | 型情報 |
 | --- | --- | --- |
 | `shinaps/prefer-promise-with-resolvers` | Promiseのexecutorが受け取る `resolve`・`reject` を、executorの外で使うために変数・プロパティへ代入する書き方（deferred promise）を報告する。`Promise.withResolvers()` で書ける。包んだ関数の代入や、値として渡す呼び出しは報告しない | 不要 |
+| `shinaps/vue-no-index-key` | Vueの `:key` が v-for の2番目以降の別名（配列の index）を参照する書き方を報告する。オブジェクトの反復の2番目（プロパティ名）も構文では区別できないので報告する。`items[i].id` のようにメンバーの計算プロパティとしてだけ使う参照は報告しない。HTML以外のテンプレート（`lang="pug"` など）は解析しないので何も報告しない | 不要 |
 
 ### 同梱ルールの追加
 
@@ -68,4 +71,4 @@ shinaps-skills lint --checks <checks.json> --root <project> --out <result.json>
 
 ## 依存
 
-ESLint・typescript-eslint・TypeScript・vue-eslint-parser・eslint-plugin-vue を完全一致の版で依存に持ちます（パッケージの導入が約50MB増えます）。typescript-eslint は TypeScript 7 に対応していないため、TypeScript は6系です（開発用の `tsc` も同じ版を使います）。
+ESLint・typescript-eslint・TypeScript・vue-eslint-parser・eslint-plugin-vue・eslint-plugin-react-x・eslint-plugin-regexp を完全一致の版で依存に持ちます（パッケージの導入は約65MBになります）。外部プラグインの版を上げるときは、そのルールを使う公式規約の checks の coverage がルールの挙動を前提にしているので、規約の Good・Bad と見逃しの境界の例を同じ版で実行し直して確かめます。typescript-eslint は TypeScript 7 に対応していないため、TypeScript は6系です（開発用の `tsc` も同じ版を使います）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shinaps/skills",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "description": "Install Shinaps AI workflows and custom agents for Codex",
   "type": "module",
   "bin": {
@@ -41,6 +41,8 @@
   "dependencies": {
     "ajv": "^8.20.0",
     "eslint": "10.14.0",
+    "eslint-plugin-react-x": "5.28.8",
+    "eslint-plugin-regexp": "3.3.2",
     "eslint-plugin-vue": "10.12.0",
     "typescript": "6.0.3",
     "typescript-eslint": "8.72.1",

package/plugins/shinaps-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "shinaps",
   "description": "Shinaps AIの開発ワークフロー。プロジェクトの指示から条件を読み、調査・設計・実装・簡素化・レビュー・コミット・PR・リリースとLinearでの開発進行を支援する。",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "author": {
     "name": "shinaps"
   },

package/plugins/shinaps-claude/managed-agents/skills/dev-managed-cc/references/launch.md

@@ -71,3 +71,7 @@ PR: <draft PR の URL。無ければ なし>
 | hooks | 未対応 |
 | permission mode | 定義の `permission_policy` で固定 |
 | セッション予算 | セッション作成時の `max_list_cost` で付ける |
+
+## ローカルsnapshotで始める場合
+
+初回メッセージにsource.bundleが指定されている場合は、通常のHEAD確認より先に `/mnt/session/uploads/source.bundle` を指定された作業先へcloneする。比較元は初回メッセージのsnapshot SHAとし、GitHubへのアクセスや元の履歴を前提にしない。成果物は上記の一時indexで比較元からの全差分を出力する手順に従い、変更内容・検証結果・未完了事項を `/mnt/session/outputs/report.md` にも残す。

package/plugins/shinaps-claude/references/linear/configuration.md

@@ -4,7 +4,7 @@
 
 ## 検証CLIと契約版
 
-利用中のskillとCLIの版を確認し、0.44.0のskillには同じ版のnpm CLIを導入する（`npm install -g @shinaps/skills@0.44.0`）。pluginだけにはCLIは含まれない。導入・更新が必要ならその権限を確認し、検証のたびに `npx latest` を取得しない。
+利用中のskillとCLIの版を確認し、0.46.0のskillには同じ版のnpm CLIを導入する（`npm install -g @shinaps/skills@0.46.0`）。pluginだけにはCLIは含まれない。導入・更新が必要ならその権限を確認し、検証のたびに `npx latest` を取得しない。
 
 0.35.0から通常設定の `review_flow.mode` に `ask` を受理する。`config_version` は2のままで、既存のauto・manualの設定は変更不要。0.33.0〜0.34.xのCLIと `$schema` のURLは `ask` を拒否するため、`ask` を使う設定では `$schema` も0.35.0以降のURLにする。
 

package/plugins/shinaps-claude/references/lint.md

@@ -28,7 +28,7 @@ Shinaps AIの規約は、機械検査（`checks`）を持てる。検査は配
 
 [Shinaps規約の書き方](rule-writing.md)で書き込む規約に、検査を付けられるかを判断する。
 
-- **使えるルール**: ESLint core、`@typescript-eslint/*`（型情報を使うものを含む）、`vue/*`、同梱の `shinaps/*`（`docs/lint.md` の一覧）。版によって違うので、同じ版のCLIで確かめる。使えるルールが無い規約には検査を付けない（AI照合のまま）。同梱ルールの追加は `docs/lint.md` の手順で別の作業として提案する。
-- **coverageの判断**: 規約の全文（scope・labelsを含み、更新では更新後の全文）と、検査の `rule`・`options`・`files` を照らす。`files` の範囲で、規約が求めることへの違反をこのルールが全て報告すると言えるときだけ `full`、見逃しが一つでもありうれば `partial`。lintが規約より広く報告する（例外も報告する）ことは `full` の妨げにならない（指摘はメインが確認する）。例で通ることは根拠にならない。
+- **使えるルール**: ESLint core、`@typescript-eslint/*`（型情報を使うものを含む）、`vue/*`、`react-x/*` のうち `rules-of-hooks`・`exhaustive-deps`・`no-array-index-key`・`no-missing-key`・`no-nested-component-definitions`・`no-unstable-context-value`、`regexp/*`、同梱の `shinaps/*`（`docs/lint.md` の一覧）。版によって違うので、同じ版のCLIで確かめる。使えるルールが無い規約には検査を付けない（AI照合のまま）。同梱ルールの追加は `docs/lint.md` の手順で別の作業として提案する。
+- **coverageの判断**: 規約の全文（scope・labelsを含み、更新では更新後の全文）と、検査の `rule`・`options`・`files` を照らす。`files` の範囲で、規約が求めることへの違反をこのルールが全て報告すると言えるときだけ `full`、見逃しが一つでもありうれば `partial`。lintが規約より広く報告する（例外も報告する）ことは `full` の妨げにならない（指摘はメインが確認する）。例で通ることは根拠にならない。Vueのテンプレートを見るルール（`vue/*` のテンプレート用、`shinaps/vue-no-index-key`）は、HTML以外のテンプレート（`lang="pug"` など）を解析せず報告なしで終わるので、それだけでは `.vue` を対象に `full` にできない。
 - **補助の確認**: 規約のgood・badの例を一時ディレクトリにファイルとして書き、同じ入口で実行して、badで報告され、goodで報告されないことを確かめる。対象プロジェクトのコードを写さない。
-- **書き込み**: `record_rule`・`update_rule` の `checks` に渡す。一括の `record_rules` は `checks` を受け取らない（付けると呼出し全体が入力エラーになる）ので、検査は登録後に `update_rule` で付ける。`update_rule` は配列ごと置換し、`[]` で外す。検査を持つ規約の内容（出典以外）を変える更新では、更新後の全文で検査を見直し、同じ要求で `checks` を渡す。渡さないと `CHECKS_REQUIRED` で保存されない。見直した結果が同じなら同じ配列を渡す。
+- **書き込み**: `record_rule`・`update_rule` の `checks` に渡す。一括の `record_rules` は `checks` を受け取らない（付けると呼出し全体が入力エラーになる）ので、検査は登録後に `update_rule` で付ける。`update_rule` は配列ごと置換し、`[]` で外す。検査を持つ規約の内容（出典とrepoの表示名以外。適用先はscope、repo_ownerのowner、repoのrepoIdで比べる）を変える更新では、更新後の全文で検査を見直し、同じ要求で `checks` を渡す。渡さないと `CHECKS_REQUIRED` で保存されない。見直した結果が同じなら同じ配列を渡す。

package/plugins/shinaps-claude/references/managed/configuration.md

@@ -4,7 +4,7 @@ Managed Agents は配布CLI `shinaps-skills managed` で導入・依頼・観測
 
 ## アカウント
 
-アカウントは、APIキー1つが属する組織・workspace に利用者が付ける名前で、英小文字・数字と単独のハイフン（`^[a-z0-9]+(-[a-z0-9]+)*$`）にする。同じマシンでは、同じ名前は常に同じ組織・workspace を表すようにする。lock がアカウント名で引かれるので、別の組織に同じ名前を使うと別の組織の lock で適用しようとする（`ant apply` は lock と違う組織・workspace の資格情報を拒否して止まる）。
+アカウントは、APIキー1つが属する組織・workspace に利用者が付ける名前で、先頭は英小文字または数字、以降は英小文字・数字とハイフン（`^[a-z0-9][a-z0-9-]*$`）にする。同じマシンでは、同じ名前は常に同じ組織・workspace を表すようにする。lock がアカウント名で引かれるので、別の組織に同じ名前を使うと別の組織の lock で適用しようとする（`ant apply` は lock と違う組織・workspace の資格情報を拒否して止まる）。
 
 ### APIキー
 

package/plugins/shinaps-claude/references/managed/configuration.schema.json

@@ -30,7 +30,7 @@
       "type": "object",
       "minProperties": 1,
       "propertyNames": {
-        "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        "pattern": "^[a-z0-9][a-z0-9-]*$"
       },
       "additionalProperties": {
         "type": "object",

package/plugins/shinaps-claude/references/managed/execute.md

@@ -63,7 +63,7 @@ shinaps-skills managed collect --account <name> --session <ID>
 ```
 
 - セッションに紐づく Files（`changes.patch` と作業記録の tar）を、そのアカウントの `sessions/<ID>/outputs/` へ保存し、保存したパスを表示する。同じ名前のファイルは最新のものだけを保存する（lead は毎ターン `changes.patch` を比較元からの全体の差分で置き換える）。名前がファイル名だけでないものは保存せずに止まる。保存したサイズは一覧の値と比べる。
-- CLI は差分を適用しない。ローカルの CLI は git を呼ばず、自分では push しない。push と draft PR の作成は、許可した場合にセッション内の lead が行う。`changes.patch` は合意した base の SHA のチェックアウトで `git apply --check` してから、範囲と受入条件に対する差分を確かめる。適用するかは利用者と決める。
+- collect は差分を適用せず、保存だけを行い、自分では push しない。ローカルsnapshotのprepare・importはGitを使い、importは新しいディレクトリにだけ差分を適用する。既存の作業ツリーへは適用しない。push と draft PR の作成は、許可した場合にセッション内の lead が行う。`changes.patch` は合意した base の SHA のチェックアウトで `git apply --check` してから、範囲と受入条件に対する差分を確かめる。適用するかは利用者と決める。
 - `コミット:` と push 先がある場合は `git fetch origin <head>` で head ブランチを取得し、base の SHA からのコミットと差分を確かめる。
 - `PR:` がある場合は `gh pr view <PR の URL> --json isDraft,baseRefName,headRefName` または GitHub MCP の読み取りで、draft であること・base と head が合意どおりであることを確かめる。
 
@@ -74,9 +74,33 @@ shinaps-skills managed collect --account <name> --session <ID>
 ## 未検証の境界
 
 - `managed setup`・`run`・`status`・`reply`・`collect` のコマンド・フラグ・stdin の本文・出力の形は ant 2.4.0 の公式ソースで照合し、偽の `ant` を使うテストで確かめた。実際の `ant` とクラウドではまだ実行していない。
-- API の側で決まり、ant のソースでは確かめられないこと: 予算 `max_list_cost.amount` がセント単位か、`mount_path: /CLAUDE.md` が `/mnt/session/uploads/CLAUDE.md` に置かれるか、Files の upload・一覧・取得に `files-api-2025-04-14` と `managed-agents-2026-04-01` の両方の beta を付ければよいか（ant の `--beta` は既定の beta を置き換えるので、全ての呼び出しで明示している）、Files の応答の `filename`・`size_bytes`・`created_at`、events の一覧に役割のスレッドの `agent.message` が混ざるか。lock が無い状態での skill の重複は、同じ setup で作る lead の同名確認で止まる。
+- API の側で決まり、ant のソースでは確かめられないこと: `mount_path: /CLAUDE.md` が `/mnt/session/uploads/CLAUDE.md` に置かれるか、Files の upload・一覧・取得に `files-api-2025-04-14` と `managed-agents-2026-04-01` の両方の beta を付ければよいか（ant の `--beta` は既定の beta を置き換えるので、全ての呼び出しで明示している）、Files の応答の `filename`・`size_bytes`・`created_at`、events の一覧に役割のスレッドの `agent.message` が混ざるか。lock が無い状態での skill の重複は、同じ setup で作る lead の同名確認で止まる。
 - マウントしたリポジトリの remote へ `git push` できるか（`authorization_token` が push に使われるか）。最初のセッションで最優先に確かめ、できなければ GitHub MCP の push 用ツール（`create_branch`・`push_files`）を有効にするかを利用者と相談する。
 - commit をチェックアウトしてマウントした作業先から、origin の head ブランチを取得できるか（clone の深さと fetch の資格情報）。
 - GitHub MCP で draft PR を作れるか。`draft: true` は lead への指示でしか担保されない。
 - vault に資格情報を登録できたことは、上の3点の確認にならない。
 - 完了したスレッドが同時実行の枠（25本）を空けるか。ULTRAでは、ラウンドごとに新しく起動する担当を含めて、同時に保つスレッドが多い。
+
+## Routerとローカルコードの往復
+
+Claude Account Routerを使う場合は、アプリでAPIキーとクラウド用アカウントを登録し、アプリ内CLIの `cloud managed` 経由で同じmanagedコマンドを呼ぶ。setupとrunはRouterの選択アカウントを使える。status・reply・collect・importは作成結果のaccountとsession_idを明示し、途中の選択変更を引き継がない。キーを取得して会話や設定へ書き出さない。
+
+GitHubへpushしていないコードも渡す場合は、先にローカルで固定する。
+
+```sh
+shinaps-skills managed prepare --source /path/to/repository
+```
+
+戻り値のfilesとmanifestを確認する。追跡中の現在の内容と、Gitで無視されていない新規ファイルを含む。履歴・Git設定・node_modules・.local・.shinapsは含まない。資格情報ファイルやcheckout外へのシンボリックリンクは拒否する。内容の秘密検出は行わないので、送信対象の確認は必要。submoduleはこの方式では扱わない。
+
+合意済みのrunに `--snapshot <manifest>` を付ける。比較元のSHAは保存済みsnapshotから決まり、`--base-sha` は不要。体制・許可・予算・範囲は通常どおり明示する。ローカル方式はpush・draft_prを受理しない。snapshotはFiles APIで送り、GitHubリポジトリのマウントやGitHub tokenを使わない。元のGit履歴は含まれない。
+
+collectの後、保存されたセッションを新しいローカルcheckoutへ戻せる。
+
+```sh
+shinaps-skills managed import --account personal --session SESSION_ID --destination /path/to/new-checkout
+```
+
+importはAPIキー不要。保存された送信時点のコード（`~/.local/share/shinaps-ai/skills/snapshots/<SHA>/`。アカウントに属さない。prepareごとに複製とbundleが残るので、importと確認が済んだら削除してよい）を復元し、そのセッションのchanges.patchをindexへ適用する。既存のdestinationや元の作業ツリーは上書きしない。適用失敗時は作成したディレクトリを削除してエラーにする。復元先で差分とreport.mdの報告を読み、ローカルの検証を行って作業を再開する。元のブランチへの統合は別途差分を確認して行う。
+
+実クラウドへの送信・実行・回収は未検証。ローカルの代替antと実Gitでの往復テストは、クラウド環境でのgit利用や成果物生成の保証ではない。予算amountのセント単位は[公式仕様](https://platform.claude.com/docs/en/managed-agents/budgets)で確認済みで、リクエスト途中では停止しないため厳密な請求上限とは異なる。

package/plugins/shinaps-claude/references/rule-writing.md

@@ -60,7 +60,7 @@ coding の規約は、使えるlintのルールで検査できるかを判断し
 
 ## scope
 
-全リポジトリに当てはまる判断だけ `scope: user` にして、他のプロジェクトでも通じる表現で書く。同じownerの配下に共通する判断は `scope: repo_owner`、特定のリポジトリの判断は `scope: repo` にして具体的に書く。
+全リポジトリに当てはまる判断だけ `scope: user` にして、他のプロジェクトでも通じる表現で書く。同じownerの配下に共通する判断は `scope: repo_owner`、特定のリポジトリの判断は `scope: repo` にして具体的に書く。`scope: repo` で書くには、[Shinaps規約の取得](rules.md)の「リポジトリを特定する」でrepositoryの `id` を得る。
 
 ## 目安と上限
 

package/plugins/shinaps-claude/references/rules.md

@@ -25,12 +25,25 @@ Shinaps AIのMCPから規約を取得する手順。取得は呼出し元（メ
 
 対象が確定していない工程（devの入口・`spec`・`explore`・`debug`）は、論点の技術を語彙から推定してよい。`filterUserRulesByLabels` は指定しない。
 
+## リポジトリを特定する
+
+`scope: repo` の規約はGitHubのrepositoryの`id`で識別し、owner・名前は表示にだけ使う。名前は改名で変わり、旧名は別のrepositoryやforkが使えるので、名前の一致を同じrepositoryの根拠にしない。
+
+1. 対象のownerと名前を決める。既定は現在のGit workspaceの `git remote get-url origin`（`github.com/<owner>/<repo>(.git)?` の形）。登録先が別のrepositoryなら、その値にする。この形に当たらなければ（GitHub以外のremoteなど）、`repoOwner`・`repoName`・`repoId` のどれも渡さない。
+2. `gh api repos/<owner>/<repo> --jq '{id, full_name}'` を1回呼ぶ。改名前の名前でもGitHubは改名後のrepositoryを返すので、`id` を `repoId`、`full_name` の `/` の前後を `repoOwner`・`repoName` にする。
+3. 呼出しが失敗したら（`gh` が無い、認証が無い、404など。理由は区別しない）、`repoId`・`repoName` は渡さない。1で決めたownerだけを `repoOwner` にする。
+
+- **取得**: `search_rules` には `repoOwner` と `repoId` を渡し、`repoName` は渡さない（入力エラーになる）。`repoId` が無いときは `scope: repo` の規約が返らないので、「リポジトリを特定できず、このrepositoryの規約は取得していない」と1文で報告する。
+- **新規の書込み**: `scope: repo` の `record_rule`・`record_rules` には `repoOwner`・`repoName`・`repoId` をそろえて渡す。
+- **更新**: `update_rule` で `scope: "repo"` と3つをそろえて渡すのは、適用先を repo にするとき、別のrepositoryに変えるとき、表示名を現在の名前にするとき（2の `full_name` が規約の `repoOwner`・`repoName` と違うとき）だけ。内容だけの更新では適用先の項目を渡さない（`scope` なしで渡すと入力エラーになる）。
+- **`repoId` が得られないとき**: `scope: repo` では書き込まず、`scope: user`・`scope: repo_owner` に変えるか中止するかを利用者に確認する。範囲を変えるときは、[Shinaps規約の書き方](rule-writing.md)の比較をやり直す。
+
 ## 一覧を取る
 
-`search_rules` を `fields: "summary"` で呼ぶ。`repoOwner`・`repoName` は現在のGit workspaceから渡す。対象が確定した照合では `filterUserRulesByLabels: true` を渡す。
+`search_rules` を `fields: "summary"` で呼ぶ。`repoOwner`・`repoId` は「リポジトリを特定する」で決めた値を渡す。対象が確定した照合では `filterUserRulesByLabels: true` を渡す。
 
 ```json
-{ "fields": "summary", "repoOwner": "...", "repoName": "...", "languages": ["typescript", "javascript"], "platforms": ["cloudflare-workers"], "frameworks": ["hono"], "filterUserRulesByLabels": true }
+{ "fields": "summary", "repoOwner": "...", "repoId": 123456789, "languages": ["typescript", "javascript"], "platforms": ["cloudflare-workers"], "frameworks": ["hono"], "filterUserRulesByLabels": true }
 ```
 
 - サーバーは同じ軸をOR、指定した軸の間をANDで判定する。
@@ -60,7 +73,7 @@ Shinaps AIのMCPから規約を取得する手順。取得は呼出し元（メ
 
 [Shinaps規約の書き方](rule-writing.md)の比較に使う規約は、次の条件で取得する。
 
-- `search_rules` は `fields: "summary"` で全ページ取得し、`filterUserRulesByLabels` と `kind` を渡さない。`repoOwner`・`repoName` は、登録先のowner・repoがあればその値、無い分は現在のGit workspaceの値にする。
+- `search_rules` は `fields: "summary"` で全ページ取得し、`filterUserRulesByLabels` と `kind` を渡さない。`repoOwner`・`repoId` は「リポジトリを特定する」で決めた値にする。
 - 公式規約も一覧に載るよう、`list_search_facets` の語彙が8件以内の技術軸（`languages` など）を一つ選び、その全slugを渡す。技術軸はその軸のlabelが無い公式規約にも一致する。`topics` は一致必須で別のtopicの公式規約が返らなくなるので渡さない。渡せる軸が無ければ公式規約の取得は未完了とする。
 - `projectVersions` には確定した版だけを渡す。渡しても渡さなくても、条件に合わない条件付きの公式規約は返らない。
 - 一覧のtitleとlabelから同じ場面を扱う可能性を否定できない規約を選び、「全文を取る」で全文を取得する。文字列の一致で選ばない（公式規約のtitleは英語）。「全文を取る規約を選ぶ」は対象ファイルとの照合の基準で、ここには適用しない。

package/plugins/shinaps-claude/skills/explore/SKILL.md

@@ -76,7 +76,7 @@ Claude Codeの `Skill`・`Agent`・`AskUserQuestion`・`TaskCreate` を利用で
 ### Phase 1: セッション初期化
 
 1. 最初の質問を受領する。引数が空、またはファイルパスだけなら、理解したいことを `AskUserQuestion` で 1 問だけ確認する
-2. git remoteから `repoOwner` / `repoName` を解決する。今回の依頼に関連する既存の spec・調査レポート・Git の変更履歴を確認し、引き継ぐ決定と根拠を要約する。既存成果物がなければ追加取得は不要。
+2. [Shinaps規約の取得](../../references/rules.md) の「リポジトリを特定する」で `repoOwner` / `repoId` を解決する。今回の依頼に関連する既存の spec・調査レポート・Git の変更履歴を確認し、引き継ぐ決定と根拠を要約する。既存成果物がなければ追加取得は不要。
 3. [Shinaps規約の取得](../../references/rules.md) に従い、最初の質問に対応する推定 facet で一覧を取り、必要な規約全文を取得する。論点が別領域へ移ったら、その時点で facet を取り直す
 4. リポジトリの `CLAUDE.md` / `AGENTS.md` / その他の指示ファイルを読む
 5. `git status --short --branch` と HEAD を記録する。調査対象の revision は未コミット変更を含む現在の worktree をデフォルトにし、production / PR / commit が明示された場合は対象 revision を特定して別に記録する。reset / stash / checkout / clean は行わない

package/plugins/shinaps-claude/skills/extract-rules/SKILL.md

@@ -28,7 +28,7 @@ Claude Codeの `Skill`・`Agent`・`AskUserQuestion`・`TaskCreate` を利用で
 2. 失敗したら `git remote get-url origin` を parse (`github.com/<owner>/<repo>(.git)?` 形式)
 3. それでも決まらないなら **ユーザーにチャットで確認** (「対象は `<owner>/<repo>` でいいですか?」)
 
-解決した `<owner>/<repo>` をユーザーに **必ず提示** し、誤りなら別の repo を入力してもらう。
+解決した `<owner>/<repo>` をユーザーに **必ず提示** し、誤りなら別の repo を入力してもらう。確定した repo を [Shinaps規約の取得](../../references/rules.md) の「リポジトリを特定する」で特定し、`repoId` と現在の `repoOwner`・`repoName` を得る。`repoId` が得られなければ `scope: repo` では投入できないので、ここで止めて利用者に確認する。
 
 ## Step 1. since (期間) をチャットで確認
 
@@ -87,7 +87,7 @@ Good/Bad サンプルコード (examples) の付け方:
 
 投入手順:
 
-- 候補を確定してから、[Shinaps規約の書き方](../../references/rule-writing.md) の「書き込む前に既存の規約と比べる」で候補ごとに結果を決める。既存の規約への**更新**は下の差分確認へ進める。**提示** はブロックの終わりにまとめて利用者へ示し、残りの投入は止めない。**新規**候補だけを集めて `record_rules({ scope: 'repo', repoOwner, repoName, rules: [{ title, why, recommend?, avoid?, kind?, labels?, examples?, sourceUrls? }, ...] })` で **1 call bulk 投入** する。上限は MCP ツールの入力の説明に従う。`labels` は language / platform / framework / topic の slug 配列 (`list_search_facets` が返す公式カタログの slug のみ、language/platform/framework は 1 rule に各 1 つまで) (1 call 最大 100 件、超えたら分割。同一 title の重複は入力の schema 検証で拒否される)。
+- 候補を確定してから、[Shinaps規約の書き方](../../references/rule-writing.md) の「書き込む前に既存の規約と比べる」で候補ごとに結果を決める。既存の規約への**更新**は下の差分確認へ進める。**提示** はブロックの終わりにまとめて利用者へ示し、残りの投入は止めない。**新規**候補だけを集めて `record_rules({ scope: 'repo', repoOwner, repoName, repoId, rules: [{ title, why, recommend?, avoid?, kind?, labels?, examples?, sourceUrls? }, ...] })` で **1 call bulk 投入** する。上限は MCP ツールの入力の説明に従う。`labels` は language / platform / framework / topic の slug 配列 (`list_search_facets` が返す公式カタログの slug のみ、language/platform/framework は 1 rule に各 1 つまで) (1 call 最大 100 件、超えたら分割。同一 title の重複は入力の schema 検証で拒否される)。
 - extract-rules は対象 repo の PR レビューから抽出する性質上 scope=repo (当該 repo 限定) がデフォルト。横断ルールとして残したい場合だけユーザー判断で `scope: 'user'` に格上げし、書き直した全文で比べ直す。**格上げするときは why / recommend / avoid / examples を当該 repo の固有文脈 (内部 API 名・モジュール構成・ドメイン固有の識別子) から切り離し、他プロジェクトでも適用場面を想定できる汎用的な表現・汎用サンプルに解釈し直してから登録する** (scope=repo のままなら repo 固有の具体的な記述・コード片で良い)
 - `RULE_TOO_LARGE` が返ったら、その呼出し分は全体として保存されていない。details の limit・actual・title を確かめ、該当候補の本文・例・出典を短くしてから同じ呼出しをやり直す。`update_rule` の `RULE_UPDATE_CONFLICT` は全文を読み直してから再試行する。
 - `RULE_LIMIT_REACHED` が返ったら投入を止める。個人ルールの保存数には上限があり、残りの枠が足りない `record_rules` はその呼出し分が全体として失敗し、一部も保存されない (件数を減らして一部だけ登録する手順へ自動では切り替えない)。それより前の呼出しで投入した分は保存されている。details の `limit` と `actual` から残りの枠を示し、投入する件数を絞るか既存ルールを整理するかのどちらにするかを利用者に確認する。以降のブロックの抽出・投入にも進まず、利用者の選択を待つ。

package/plugins/shinaps-claude/skills/managed-execute/SKILL.md

@@ -9,10 +9,16 @@ description: Claude Managed Agents の lead へ、アカウントを選んで de
 
 # Managed Agents へ依頼する
 
-[設定とアカウント](../../references/managed/configuration.md)と[依頼と観測の手順](../../references/managed/execute.md)を読んで進める。操作は配布CLIの `managed run`・`status`・`reply`・`collect` で行う。
+[設定とアカウント](../../references/managed/configuration.md)と[依頼と観測の手順](../../references/managed/execute.md)を読んで進める。操作は配布CLIの `managed prepare`・`run`・`status`・`reply`・`collect`・`import` で行う。
 
 - 呼び出しのたびにアカウント・base ブランチと SHA・head ブランチ・範囲と受入条件・体制（LITE・BASIC・ULTRA）・許可・予算を利用者と合意し、引数で明示する。設定・lock・過去の作業から推定しない。
 - 設定（`.shinaps/managed.json`）が無いか旧版なら、手順の「設定を用意する」に従って一問ずつ確認して作る。設定から読むのは `repository` とアカウントの `vault_id` だけで、lead と環境の ID はアカウントの lock から読む。lock が無ければ止め、導入は managed-setup で行う。
 - 計画・実装・レビューの工程と追加の担当は lead に任せ、ここでは指示しない。
-- 回収した差分は適用しない。確認と適用の判断は利用者と行う。push・merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。Linear の進行とは独立した入口である。
+- 回収した差分を既存の作業ツリーへ適用しない（importは新しいディレクトリにだけ復元する）。確認と統合の判断は利用者と行う。push・merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。Linear の進行とは独立した入口である。
 - キーと token は利用者が環境変数に設定する。受け取らない・表示しない・記録しない。
+
+## Routerとローカルでの再開
+
+利用者がClaude Account Routerとの連携を選んだ場合は、アプリ内CLIの `cloud managed` を使う。APIキーを読み出して会話へ返さない。作成結果のaccountとsession_idを保存し、後続操作でその組を使う。
+
+未コミットのローカルコードを渡す依頼では、[ローカルコードの往復](../../references/managed/execute.md#routerとローカルコードの往復)に従ってprepareし、送信する一覧・内容を確認してからsnapshotを指定する。比較元はsnapshotのSHA。collect後、ローカルでの再開が許可されていればimportで新規checkoutへ復元し、差分と報告を確認してQAへ進む。元の作業ツリーには自動適用しない。

package/plugins/shinaps-claude/skills/refine/SKILL.md

@@ -177,7 +177,7 @@ lint 由来の指摘は auto-apply にしない (ルールは構文で判定す
 
 1. **修正する** — どう直すかを 1-2 文で提案 (agent が返した `detail` を活用)。承認されたら `Edit` / `Write` で実行
 2. **このまま許容する** — 妥当な理由があるとき。理由を今回のローカル成果物（implementation.md / 調査・レビューレポート）に残す (後から「なぜ違反のままにしたか」を辿れるように)
-3. **ルールの方を修正する** — 規約自体が現実と乖離している場合。[Shinaps規約の書き方](../../references/rule-writing.md) に従って書き込む全文を作る。新規のときは scope (user / repo_owner / repo) も選ばせる (横断的なら user、この repo 限定なら repo)。同じ文書の「書き込む前に既存の規約と比べる」で比べ (Step 1 の結果はファイルの技術で絞っているので使わない)、結果と全文の差分を示して同意を受けてから shinaps-ai MCP server の `record_rule` (新規) or `update_rule` (既存修正) を実行
+3. **ルールの方を修正する** — 規約自体が現実と乖離している場合。[Shinaps規約の書き方](../../references/rule-writing.md) に従って書き込む全文を作る。新規のときは scope (user / repo_owner / repo) も選ばせる (横断的なら user、この repo 限定なら repo。repo は [Shinaps規約の取得](../../references/rules.md) の「リポジトリを特定する」で得た `repoId` を添える)。同じ文書の「書き込む前に既存の規約と比べる」で比べ (Step 1 の結果はファイルの技術で絞っているので使わない)、結果と全文の差分を示して同意を受けてから shinaps-ai MCP server の `record_rule` (新規) or `update_rule` (既存修正) を実行
 4. **後回し** — 別タスクとして扱う。`TaskCreate` で TODO 化し、後の作業セッションで着手できるようにする
 
 **提示順は `changed` を先、`pre-existing` を後**。それぞれの中では Violation → Improvement → Question の順。各 finding には `pre-existing` かどうかを明示して提示する (ユーザーが「今回の commit に混ぜるか」を判断する材料になるため)。件数が少なければ 1 回の `AskUserQuestion` に複数 question をまとめてよい (各 finding には前提説明を添える)。

package/plugins/shinaps-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "shinaps",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "description": "Shinaps AIのCodex向け開発ワークフロー",
   "skills": "./skills/"
 }

package/plugins/shinaps-codex/managed-agents/skills/dev-managed-cc/references/launch.md

@@ -71,3 +71,7 @@ PR: <draft PR の URL。無ければ なし>
 | hooks | 未対応 |
 | permission mode | 定義の `permission_policy` で固定 |
 | セッション予算 | セッション作成時の `max_list_cost` で付ける |
+
+## ローカルsnapshotで始める場合
+
+初回メッセージにsource.bundleが指定されている場合は、通常のHEAD確認より先に `/mnt/session/uploads/source.bundle` を指定された作業先へcloneする。比較元は初回メッセージのsnapshot SHAとし、GitHubへのアクセスや元の履歴を前提にしない。成果物は上記の一時indexで比較元からの全差分を出力する手順に従い、変更内容・検証結果・未完了事項を `/mnt/session/outputs/report.md` にも残す。

package/plugins/shinaps-codex/references/linear/configuration.md

@@ -4,7 +4,7 @@
 
 ## 検証CLIと契約版
 
-利用中のskillとCLIの版を確認し、0.44.0のskillには同じ版のnpm CLIを導入する（`npm install -g @shinaps/skills@0.44.0`）。pluginだけにはCLIは含まれない。導入・更新が必要ならその権限を確認し、検証のたびに `npx latest` を取得しない。
+利用中のskillとCLIの版を確認し、0.46.0のskillには同じ版のnpm CLIを導入する（`npm install -g @shinaps/skills@0.46.0`）。pluginだけにはCLIは含まれない。導入・更新が必要ならその権限を確認し、検証のたびに `npx latest` を取得しない。
 
 0.35.0から通常設定の `review_flow.mode` に `ask` を受理する。`config_version` は2のままで、既存のauto・manualの設定は変更不要。0.33.0〜0.34.xのCLIと `$schema` のURLは `ask` を拒否するため、`ask` を使う設定では `$schema` も0.35.0以降のURLにする。
 

package/plugins/shinaps-codex/references/lint.md

@@ -28,7 +28,7 @@ Shinaps AIの規約は、機械検査（`checks`）を持てる。検査は配
 
 [Shinaps規約の書き方](rule-writing.md)で書き込む規約に、検査を付けられるかを判断する。
 
-- **使えるルール**: ESLint core、`@typescript-eslint/*`（型情報を使うものを含む）、`vue/*`、同梱の `shinaps/*`（`docs/lint.md` の一覧）。版によって違うので、同じ版のCLIで確かめる。使えるルールが無い規約には検査を付けない（AI照合のまま）。同梱ルールの追加は `docs/lint.md` の手順で別の作業として提案する。
-- **coverageの判断**: 規約の全文（scope・labelsを含み、更新では更新後の全文）と、検査の `rule`・`options`・`files` を照らす。`files` の範囲で、規約が求めることへの違反をこのルールが全て報告すると言えるときだけ `full`、見逃しが一つでもありうれば `partial`。lintが規約より広く報告する（例外も報告する）ことは `full` の妨げにならない（指摘はメインが確認する）。例で通ることは根拠にならない。
+- **使えるルール**: ESLint core、`@typescript-eslint/*`（型情報を使うものを含む）、`vue/*`、`react-x/*` のうち `rules-of-hooks`・`exhaustive-deps`・`no-array-index-key`・`no-missing-key`・`no-nested-component-definitions`・`no-unstable-context-value`、`regexp/*`、同梱の `shinaps/*`（`docs/lint.md` の一覧）。版によって違うので、同じ版のCLIで確かめる。使えるルールが無い規約には検査を付けない（AI照合のまま）。同梱ルールの追加は `docs/lint.md` の手順で別の作業として提案する。
+- **coverageの判断**: 規約の全文（scope・labelsを含み、更新では更新後の全文）と、検査の `rule`・`options`・`files` を照らす。`files` の範囲で、規約が求めることへの違反をこのルールが全て報告すると言えるときだけ `full`、見逃しが一つでもありうれば `partial`。lintが規約より広く報告する（例外も報告する）ことは `full` の妨げにならない（指摘はメインが確認する）。例で通ることは根拠にならない。Vueのテンプレートを見るルール（`vue/*` のテンプレート用、`shinaps/vue-no-index-key`）は、HTML以外のテンプレート（`lang="pug"` など）を解析せず報告なしで終わるので、それだけでは `.vue` を対象に `full` にできない。
 - **補助の確認**: 規約のgood・badの例を一時ディレクトリにファイルとして書き、同じ入口で実行して、badで報告され、goodで報告されないことを確かめる。対象プロジェクトのコードを写さない。
-- **書き込み**: `record_rule`・`update_rule` の `checks` に渡す。一括の `record_rules` は `checks` を受け取らない（付けると呼出し全体が入力エラーになる）ので、検査は登録後に `update_rule` で付ける。`update_rule` は配列ごと置換し、`[]` で外す。検査を持つ規約の内容（出典以外）を変える更新では、更新後の全文で検査を見直し、同じ要求で `checks` を渡す。渡さないと `CHECKS_REQUIRED` で保存されない。見直した結果が同じなら同じ配列を渡す。
+- **書き込み**: `record_rule`・`update_rule` の `checks` に渡す。一括の `record_rules` は `checks` を受け取らない（付けると呼出し全体が入力エラーになる）ので、検査は登録後に `update_rule` で付ける。`update_rule` は配列ごと置換し、`[]` で外す。検査を持つ規約の内容（出典とrepoの表示名以外。適用先はscope、repo_ownerのowner、repoのrepoIdで比べる）を変える更新では、更新後の全文で検査を見直し、同じ要求で `checks` を渡す。渡さないと `CHECKS_REQUIRED` で保存されない。見直した結果が同じなら同じ配列を渡す。

package/plugins/shinaps-codex/references/managed/configuration.md

@@ -4,7 +4,7 @@ Managed Agents は配布CLI `shinaps-skills managed` で導入・依頼・観測
 
 ## アカウント
 
-アカウントは、APIキー1つが属する組織・workspace に利用者が付ける名前で、英小文字・数字と単独のハイフン（`^[a-z0-9]+(-[a-z0-9]+)*$`）にする。同じマシンでは、同じ名前は常に同じ組織・workspace を表すようにする。lock がアカウント名で引かれるので、別の組織に同じ名前を使うと別の組織の lock で適用しようとする（`ant apply` は lock と違う組織・workspace の資格情報を拒否して止まる）。
+アカウントは、APIキー1つが属する組織・workspace に利用者が付ける名前で、先頭は英小文字または数字、以降は英小文字・数字とハイフン（`^[a-z0-9][a-z0-9-]*$`）にする。同じマシンでは、同じ名前は常に同じ組織・workspace を表すようにする。lock がアカウント名で引かれるので、別の組織に同じ名前を使うと別の組織の lock で適用しようとする（`ant apply` は lock と違う組織・workspace の資格情報を拒否して止まる）。
 
 ### APIキー
 

package/plugins/shinaps-codex/references/managed/configuration.schema.json

@@ -30,7 +30,7 @@
       "type": "object",
       "minProperties": 1,
       "propertyNames": {
-        "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        "pattern": "^[a-z0-9][a-z0-9-]*$"
       },
       "additionalProperties": {
         "type": "object",

package/plugins/shinaps-codex/references/managed/execute.md

@@ -63,7 +63,7 @@ shinaps-skills managed collect --account <name> --session <ID>
 ```
 
 - セッションに紐づく Files（`changes.patch` と作業記録の tar）を、そのアカウントの `sessions/<ID>/outputs/` へ保存し、保存したパスを表示する。同じ名前のファイルは最新のものだけを保存する（lead は毎ターン `changes.patch` を比較元からの全体の差分で置き換える）。名前がファイル名だけでないものは保存せずに止まる。保存したサイズは一覧の値と比べる。
-- CLI は差分を適用しない。ローカルの CLI は git を呼ばず、自分では push しない。push と draft PR の作成は、許可した場合にセッション内の lead が行う。`changes.patch` は合意した base の SHA のチェックアウトで `git apply --check` してから、範囲と受入条件に対する差分を確かめる。適用するかは利用者と決める。
+- collect は差分を適用せず、保存だけを行い、自分では push しない。ローカルsnapshotのprepare・importはGitを使い、importは新しいディレクトリにだけ差分を適用する。既存の作業ツリーへは適用しない。push と draft PR の作成は、許可した場合にセッション内の lead が行う。`changes.patch` は合意した base の SHA のチェックアウトで `git apply --check` してから、範囲と受入条件に対する差分を確かめる。適用するかは利用者と決める。
 - `コミット:` と push 先がある場合は `git fetch origin <head>` で head ブランチを取得し、base の SHA からのコミットと差分を確かめる。
 - `PR:` がある場合は `gh pr view <PR の URL> --json isDraft,baseRefName,headRefName` または GitHub MCP の読み取りで、draft であること・base と head が合意どおりであることを確かめる。
 
@@ -74,9 +74,33 @@ shinaps-skills managed collect --account <name> --session <ID>
 ## 未検証の境界
 
 - `managed setup`・`run`・`status`・`reply`・`collect` のコマンド・フラグ・stdin の本文・出力の形は ant 2.4.0 の公式ソースで照合し、偽の `ant` を使うテストで確かめた。実際の `ant` とクラウドではまだ実行していない。
-- API の側で決まり、ant のソースでは確かめられないこと: 予算 `max_list_cost.amount` がセント単位か、`mount_path: /CLAUDE.md` が `/mnt/session/uploads/CLAUDE.md` に置かれるか、Files の upload・一覧・取得に `files-api-2025-04-14` と `managed-agents-2026-04-01` の両方の beta を付ければよいか（ant の `--beta` は既定の beta を置き換えるので、全ての呼び出しで明示している）、Files の応答の `filename`・`size_bytes`・`created_at`、events の一覧に役割のスレッドの `agent.message` が混ざるか。lock が無い状態での skill の重複は、同じ setup で作る lead の同名確認で止まる。
+- API の側で決まり、ant のソースでは確かめられないこと: `mount_path: /CLAUDE.md` が `/mnt/session/uploads/CLAUDE.md` に置かれるか、Files の upload・一覧・取得に `files-api-2025-04-14` と `managed-agents-2026-04-01` の両方の beta を付ければよいか（ant の `--beta` は既定の beta を置き換えるので、全ての呼び出しで明示している）、Files の応答の `filename`・`size_bytes`・`created_at`、events の一覧に役割のスレッドの `agent.message` が混ざるか。lock が無い状態での skill の重複は、同じ setup で作る lead の同名確認で止まる。
 - マウントしたリポジトリの remote へ `git push` できるか（`authorization_token` が push に使われるか）。最初のセッションで最優先に確かめ、できなければ GitHub MCP の push 用ツール（`create_branch`・`push_files`）を有効にするかを利用者と相談する。
 - commit をチェックアウトしてマウントした作業先から、origin の head ブランチを取得できるか（clone の深さと fetch の資格情報）。
 - GitHub MCP で draft PR を作れるか。`draft: true` は lead への指示でしか担保されない。
 - vault に資格情報を登録できたことは、上の3点の確認にならない。
 - 完了したスレッドが同時実行の枠（25本）を空けるか。ULTRAでは、ラウンドごとに新しく起動する担当を含めて、同時に保つスレッドが多い。
+
+## Routerとローカルコードの往復
+
+Claude Account Routerを使う場合は、アプリでAPIキーとクラウド用アカウントを登録し、アプリ内CLIの `cloud managed` 経由で同じmanagedコマンドを呼ぶ。setupとrunはRouterの選択アカウントを使える。status・reply・collect・importは作成結果のaccountとsession_idを明示し、途中の選択変更を引き継がない。キーを取得して会話や設定へ書き出さない。
+
+GitHubへpushしていないコードも渡す場合は、先にローカルで固定する。
+
+```sh
+shinaps-skills managed prepare --source /path/to/repository
+```
+
+戻り値のfilesとmanifestを確認する。追跡中の現在の内容と、Gitで無視されていない新規ファイルを含む。履歴・Git設定・node_modules・.local・.shinapsは含まない。資格情報ファイルやcheckout外へのシンボリックリンクは拒否する。内容の秘密検出は行わないので、送信対象の確認は必要。submoduleはこの方式では扱わない。
+
+合意済みのrunに `--snapshot <manifest>` を付ける。比較元のSHAは保存済みsnapshotから決まり、`--base-sha` は不要。体制・許可・予算・範囲は通常どおり明示する。ローカル方式はpush・draft_prを受理しない。snapshotはFiles APIで送り、GitHubリポジトリのマウントやGitHub tokenを使わない。元のGit履歴は含まれない。
+
+collectの後、保存されたセッションを新しいローカルcheckoutへ戻せる。
+
+```sh
+shinaps-skills managed import --account personal --session SESSION_ID --destination /path/to/new-checkout
+```
+
+importはAPIキー不要。保存された送信時点のコード（`~/.local/share/shinaps-ai/skills/snapshots/<SHA>/`。アカウントに属さない。prepareごとに複製とbundleが残るので、importと確認が済んだら削除してよい）を復元し、そのセッションのchanges.patchをindexへ適用する。既存のdestinationや元の作業ツリーは上書きしない。適用失敗時は作成したディレクトリを削除してエラーにする。復元先で差分とreport.mdの報告を読み、ローカルの検証を行って作業を再開する。元のブランチへの統合は別途差分を確認して行う。
+
+実クラウドへの送信・実行・回収は未検証。ローカルの代替antと実Gitでの往復テストは、クラウド環境でのgit利用や成果物生成の保証ではない。予算amountのセント単位は[公式仕様](https://platform.claude.com/docs/en/managed-agents/budgets)で確認済みで、リクエスト途中では停止しないため厳密な請求上限とは異なる。

package/plugins/shinaps-codex/references/rule-writing.md

@@ -60,7 +60,7 @@ coding の規約は、使えるlintのルールで検査できるかを判断し
 
 ## scope
 
-全リポジトリに当てはまる判断だけ `scope: user` にして、他のプロジェクトでも通じる表現で書く。同じownerの配下に共通する判断は `scope: repo_owner`、特定のリポジトリの判断は `scope: repo` にして具体的に書く。
+全リポジトリに当てはまる判断だけ `scope: user` にして、他のプロジェクトでも通じる表現で書く。同じownerの配下に共通する判断は `scope: repo_owner`、特定のリポジトリの判断は `scope: repo` にして具体的に書く。`scope: repo` で書くには、[Shinaps規約の取得](rules.md)の「リポジトリを特定する」でrepositoryの `id` を得る。
 
 ## 目安と上限
 

package/plugins/shinaps-codex/references/rules.md

@@ -25,12 +25,25 @@ Shinaps AIのMCPから規約を取得する手順。取得は呼出し元（メ
 
 対象が確定していない工程（devの入口・`spec`・`explore`・`debug`）は、論点の技術を語彙から推定してよい。`filterUserRulesByLabels` は指定しない。
 
+## リポジトリを特定する
+
+`scope: repo` の規約はGitHubのrepositoryの`id`で識別し、owner・名前は表示にだけ使う。名前は改名で変わり、旧名は別のrepositoryやforkが使えるので、名前の一致を同じrepositoryの根拠にしない。
+
+1. 対象のownerと名前を決める。既定は現在のGit workspaceの `git remote get-url origin`（`github.com/<owner>/<repo>(.git)?` の形）。登録先が別のrepositoryなら、その値にする。この形に当たらなければ（GitHub以外のremoteなど）、`repoOwner`・`repoName`・`repoId` のどれも渡さない。
+2. `gh api repos/<owner>/<repo> --jq '{id, full_name}'` を1回呼ぶ。改名前の名前でもGitHubは改名後のrepositoryを返すので、`id` を `repoId`、`full_name` の `/` の前後を `repoOwner`・`repoName` にする。
+3. 呼出しが失敗したら（`gh` が無い、認証が無い、404など。理由は区別しない）、`repoId`・`repoName` は渡さない。1で決めたownerだけを `repoOwner` にする。
+
+- **取得**: `search_rules` には `repoOwner` と `repoId` を渡し、`repoName` は渡さない（入力エラーになる）。`repoId` が無いときは `scope: repo` の規約が返らないので、「リポジトリを特定できず、このrepositoryの規約は取得していない」と1文で報告する。
+- **新規の書込み**: `scope: repo` の `record_rule`・`record_rules` には `repoOwner`・`repoName`・`repoId` をそろえて渡す。
+- **更新**: `update_rule` で `scope: "repo"` と3つをそろえて渡すのは、適用先を repo にするとき、別のrepositoryに変えるとき、表示名を現在の名前にするとき（2の `full_name` が規約の `repoOwner`・`repoName` と違うとき）だけ。内容だけの更新では適用先の項目を渡さない（`scope` なしで渡すと入力エラーになる）。
+- **`repoId` が得られないとき**: `scope: repo` では書き込まず、`scope: user`・`scope: repo_owner` に変えるか中止するかを利用者に確認する。範囲を変えるときは、[Shinaps規約の書き方](rule-writing.md)の比較をやり直す。
+
 ## 一覧を取る
 
-`search_rules` を `fields: "summary"` で呼ぶ。`repoOwner`・`repoName` は現在のGit workspaceから渡す。対象が確定した照合では `filterUserRulesByLabels: true` を渡す。
+`search_rules` を `fields: "summary"` で呼ぶ。`repoOwner`・`repoId` は「リポジトリを特定する」で決めた値を渡す。対象が確定した照合では `filterUserRulesByLabels: true` を渡す。
 
 ```json
-{ "fields": "summary", "repoOwner": "...", "repoName": "...", "languages": ["typescript", "javascript"], "platforms": ["cloudflare-workers"], "frameworks": ["hono"], "filterUserRulesByLabels": true }
+{ "fields": "summary", "repoOwner": "...", "repoId": 123456789, "languages": ["typescript", "javascript"], "platforms": ["cloudflare-workers"], "frameworks": ["hono"], "filterUserRulesByLabels": true }
 ```
 
 - サーバーは同じ軸をOR、指定した軸の間をANDで判定する。
@@ -60,7 +73,7 @@ Shinaps AIのMCPから規約を取得する手順。取得は呼出し元（メ
 
 [Shinaps規約の書き方](rule-writing.md)の比較に使う規約は、次の条件で取得する。
 
-- `search_rules` は `fields: "summary"` で全ページ取得し、`filterUserRulesByLabels` と `kind` を渡さない。`repoOwner`・`repoName` は、登録先のowner・repoがあればその値、無い分は現在のGit workspaceの値にする。
+- `search_rules` は `fields: "summary"` で全ページ取得し、`filterUserRulesByLabels` と `kind` を渡さない。`repoOwner`・`repoId` は「リポジトリを特定する」で決めた値にする。
 - 公式規約も一覧に載るよう、`list_search_facets` の語彙が8件以内の技術軸（`languages` など）を一つ選び、その全slugを渡す。技術軸はその軸のlabelが無い公式規約にも一致する。`topics` は一致必須で別のtopicの公式規約が返らなくなるので渡さない。渡せる軸が無ければ公式規約の取得は未完了とする。
 - `projectVersions` には確定した版だけを渡す。渡しても渡さなくても、条件に合わない条件付きの公式規約は返らない。
 - 一覧のtitleとlabelから同じ場面を扱う可能性を否定できない規約を選び、「全文を取る」で全文を取得する。文字列の一致で選ばない（公式規約のtitleは英語）。「全文を取る規約を選ぶ」は対象ファイルとの照合の基準で、ここには適用しない。

package/plugins/shinaps-codex/skills/extract-rules/SKILL.md

@@ -10,7 +10,7 @@ description: GitHubの過去PRレビューから繰り返し適用できる規
 1. `gh`で期間内のマージ済みPRを取得する。ページングし、並び順と日付フィルターの関係を守る。更新日時順の一覧で古いマージ日時を一件見つけても、それ以降の取得を打ち切らない。
 2. PRのreview本文・inline comment・conversation commentを取得する。PR descriptionはレビュー指摘として扱わない。APIのBot種別は除外し、判断が必要な投稿者は確認する。認証情報やリポジトリ全体をサービスへ送信しない。
 3. 複数のレビューで繰り返され、適用条件とWHYが説明できる規約を候補にする。根拠のない例・URLを作らず、レビューコメントの出典を付ける。
-4. 候補を[Shinaps規約の書き方](../../references/rule-writing.md)に従って書き、同じ文書の「書き込む前に既存の規約と比べる」で候補ごとに結果を決める。提示の候補はまとまりの終わりに示し、残りの投入は止めない。新規の候補だけを対象repoのスコープへ、実際のMCPツールのスキーマに従って登録する。応答は入力の位置とidだけなので、重複して投入されなかった候補は入力からtitleを得て、上書きせず提示へ進める。全プロジェクト共通へ広げる場合は利用者の判断を確認し、書き直した全文で比べ直す。既存の規約への更新の候補は差分を提示して許可を得る。`RULE_TOO_LARGE`はその呼出し分が全体として保存されなかったことを示すので、details の limit・actual・titleを確かめ、該当候補を短くしてやり直す。更新の`RULE_UPDATE_CONFLICT`は全文を読み直して再試行する。`RULE_LIMIT_REACHED`は残りの枠が足りずその呼出し分が全体として保存されなかったことを示すので、一部だけを登録する手順へ切り替えずに止め、details の limit・actualを示して、件数を絞るか既存ルールを整理するかを利用者に確認する。それより前の呼出しで投入した分は保存されている。以降のまとまりの抽出・投入にも進まず、利用者の選択を待つ。
+4. 候補を[Shinaps規約の書き方](../../references/rule-writing.md)に従って書き、同じ文書の「書き込む前に既存の規約と比べる」で候補ごとに結果を決める。提示の候補はまとまりの終わりに示し、残りの投入は止めない。新規の候補だけを対象repoのスコープへ、実際のMCPツールのスキーマに従って登録する。対象repoは[Shinaps規約の取得](../../references/rules.md)の「リポジトリを特定する」でrepositoryの`id`を得て指定し、得られなければrepoのスコープでは登録せず利用者に確認する。応答は入力の位置とidだけなので、重複して投入されなかった候補は入力からtitleを得て、上書きせず提示へ進める。全プロジェクト共通へ広げる場合は利用者の判断を確認し、書き直した全文で比べ直す。既存の規約への更新の候補は差分を提示して許可を得る。`RULE_TOO_LARGE`はその呼出し分が全体として保存されなかったことを示すので、details の limit・actual・titleを確かめ、該当候補を短くしてやり直す。更新の`RULE_UPDATE_CONFLICT`は全文を読み直して再試行する。`RULE_LIMIT_REACHED`は残りの枠が足りずその呼出し分が全体として保存されなかったことを示すので、一部だけを登録する手順へ切り替えずに止め、details の limit・actualを示して、件数を絞るか既存ルールを整理するかを利用者に確認する。それより前の呼出しで投入した分は保存されている。以降のまとまりの抽出・投入にも進まず、利用者の選択を待つ。
 5. 大量処理は100 PR程度のまとまりで結果を報告し、継続範囲を確認する。結果が不明な保存失敗では再投入の前に読み戻し、重複を避ける。`RATE_LIMITED`は制限の時間枠が切り替わるまで待ってから1回だけ再試行し、続けて拒否されたら中断して報告する。
 
 終了時は処理したPR・コメント数、新規登録・更新・書かない・提示・除外・未処理の件数と根拠を示す。取得・保存が部分的ならその範囲を明記する。記録する場合は.shinaps/work/を使い、[作業記録の共通手順](../../references/work-records.md)に従って初期化・保全する。

package/plugins/shinaps-codex/skills/managed-execute/SKILL.md

@@ -9,10 +9,16 @@ description: Claude Managed Agents の lead へ、アカウントを選んで de
 
 # Managed Agents へ依頼する
 
-[設定とアカウント](../../references/managed/configuration.md)と[依頼と観測の手順](../../references/managed/execute.md)を読んで進める。操作は配布CLIの `managed run`・`status`・`reply`・`collect` で行う。
+[設定とアカウント](../../references/managed/configuration.md)と[依頼と観測の手順](../../references/managed/execute.md)を読んで進める。操作は配布CLIの `managed prepare`・`run`・`status`・`reply`・`collect`・`import` で行う。
 
 - 呼び出しのたびにアカウント・base ブランチと SHA・head ブランチ・範囲と受入条件・体制（LITE・BASIC・ULTRA）・許可・予算を利用者と合意し、引数で明示する。設定・lock・過去の作業から推定しない。
 - 設定（`.shinaps/managed.json`）が無いか旧版なら、手順の「設定を用意する」に従って一問ずつ確認して作る。設定から読むのは `repository` とアカウントの `vault_id` だけで、lead と環境の ID はアカウントの lock から読む。lock が無ければ止め、導入は managed-setup で行う。
 - 計画・実装・レビューの工程と追加の担当は lead に任せ、ここでは指示しない。
-- 回収した差分は適用しない。確認と適用の判断は利用者と行う。push・merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。Linear の進行とは独立した入口である。
+- 回収した差分を既存の作業ツリーへ適用しない（importは新しいディレクトリにだけ復元する）。確認と統合の判断は利用者と行う。push・merge・deploy・release・Issue の更新・セッションのアーカイブは行わない。Linear の進行とは独立した入口である。
 - キーと token は利用者が環境変数に設定する。受け取らない・表示しない・記録しない。
+
+## Routerとローカルでの再開
+
+利用者がClaude Account Routerとの連携を選んだ場合は、アプリ内CLIの `cloud managed` を使う。APIキーを読み出して会話へ返さない。作成結果のaccountとsession_idを保存し、後続操作でその組を使う。
+
+未コミットのローカルコードを渡す依頼では、[ローカルコードの往復](../../references/managed/execute.md#routerとローカルコードの往復)に従ってprepareし、送信する一覧・内容を確認してからsnapshotを指定する。比較元はsnapshotのSHA。collect後、ローカルでの再開が許可されていればimportで新規checkoutへ復元し、差分と報告を確認してQAへ進む。元の作業ツリーには自動適用しない。