@hyuga/carrylint 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hyuga611
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# carrylint
+
+**Your skill works on your machine. Does it work on your teammate's — or in a different agent?**
+`carrylint` is a zero-dependency, model-agnostic linter that fails your PR when a `SKILL.md`, `AGENTS.md`, or slash-command has your machine or your model baked in — absolute paths, undeclared external CLIs, unresolved placeholders. It runs **no LLM and needs no API key**: pure static analysis.
+
+**あなたのスキル、自分のマシンでは動く。でも "次の人の環境・別のエージェント" で動きますか？**
+`carrylint` は、`SKILL.md` / `AGENTS.md` / スラッシュコマンドに**作った本人の環境・モデル前提が焼き込まれていないか**を CI で落とす、依存ゼロ・モデル非依存のリンタ。絶対パス・未宣言の外部CLI・未解決プレースホルダを検出します。**実行時に LLM も API キーも使いません**（純静的解析）。
+
+---
+
+## Why / なぜ
+
+[Agent Skills](https://agentskills.io) became an open standard in Dec 2025 — one `SKILL.md` runs across 20+ agents (Claude Code, Codex, Gemini CLI, Cursor, Copilot …). The **format** is portable now. But the **content** still isn't: a skill that shells out to `codex` you never installed, writes to `C:\Users\you\Downloads`, or hardcodes `gpt-image-2` silently breaks the moment someone else installs it.
+
+Other skill linters check your skill is **spec-valid**. carrylint checks it **actually runs when someone else installs it**.
+
+> オープン標準化で "形式" は可搬になった。carrylint は "中身が実際に動くか" を見る側です。
+
+## What it checks / 何を見るか
+
+| kind | severity | 説明 |
+|---|---|---|
+| `abs-path` | **error** | マシン固有の絶対パス（`C:\Users\…` / `/Users/…` / `/home/…` / `$HOME` / `%USERPROFILE%`） |
+| `placeholder` | **error** | 配布物に残った未解決プレースホルダ（`<FILL_ME>` / `YOUR_API_KEY` / `path/to/your…`） |
+| `undeclared-cli` | **error** | 外部/プロバイダCLI（`codex` `gemini` `ollama` …）を叩くのに install 手順も `requires` 宣言もない |
+| `home-path` | warn | `~/…` ホーム相対パス（ユーザー前提） |
+| `provider-env` | warn | プロバイダ固有 API キー env の生参照（`OPENAI_API_KEY` …） |
+| `todo` | warn | 配布物に残った `TODO:` / `FIXME:` |
+| `model-id` | opt-in | モデルID直書き（`claude-*` / `gpt-*` / `gemini-*`）※`--model-ids` で有効化 |
+
+Low-noise by design: only the unambiguous breakers are **error** (fail the PR); the rest are **warn**; intentional model pinning is **off** unless you ask for it.
+
+> 誤検知＝狼少年化が唯一の死因なので、曖昧さゼロのものだけ error にしています。
+
+## Use as a GitHub Action / CIで使う（定着の本体）
+
+```yaml
+# .github/workflows/carrylint.yml
+name: carrylint
+on: [push, pull_request]
+jobs:
+  carrylint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: hyuga611/carrylint@v0
+        with:
+          paths: .          # optional; default = repo
+          # strict: 'true'      # warnings also fail
+          # model-ids: 'true'   # enable the opt-in model-id rule
+```
+
+Findings appear as inline PR annotations and the job fails (exit 1) on any **error**, so a non-portable skill can't be merged.
+
+## Use as a CLI / ローカルで使う
+
+```bash
+npx @hyuga/carrylint                     # scan the repo
+npx @hyuga/carrylint path/to/skills      # scan a dir/file
+npx @hyuga/carrylint --allow codex,gemini   # I depend on these on purpose
+npx @hyuga/carrylint --strict            # warnings fail too
+npx @hyuga/carrylint --model-ids         # enable the model-id rule
+npx @hyuga/carrylint --format json       # machine-readable (VS Code / tooling)
+```
+
+### Suppress a line / 行単位の無効化
+
+```md
+Save to `C:\tools\out.png` <!-- carry-ignore -->
+
+<!-- carry-ignore-next -->
+This model is pinned on purpose: `claude-opus-4-8`
+```
+
+## Config / 設定
+
+The provider-CLI / model-ID / env dictionary lives in `rules.json` (data-driven — edit it, no code change). CLI flags also read env: `CARRYLINT_STRICT=1`, `CARRYLINT_MODEL_IDS=1`, `CARRYLINT_FORMAT=json`.
+
+## Model-agnostic / モデル非依存
+
+carrylint treats `codex` / `gemini` / `claude` / `ollama` / `aider` … **equally** as provider lock-in — it never favors one vendor. The check itself is "are you locked to one machine or one model?", so it works the same whether you author with Claude, Codex, or Gemini. No LLM at runtime.
+
+## How it differs / 既存との違い
+
+- **reflint** — does the reference *exist*? (referential integrity)
+- **skills-lint** — do two skills *collide*? is the frontmatter valid?
+- **carrylint** — does the reference *resolve on someone else's machine / another agent*? (runtime portability)
+
+Part of a small family of zero-dependency, language-agnostic, CI-resident linters for AI-native artifacts.
+
+## License
+
+MIT © hyuga611

package/action.yml

@@ -0,0 +1,36 @@
+name: 'carrylint runtime-portability linter'
+description: 'Fail CI when a skill/command hardcodes machine- or model-specific assumptions: absolute paths, undeclared CLIs, unresolved placeholders. Zero-dep, model-agnostic.'
+author: 'hyuga611'
+branding:
+  icon: 'package'
+  color: 'blue'
+inputs:
+  paths:
+    description: 'Space-separated files or dirs to scan. Default: the repo (SKILL.md / AGENTS.md / CLAUDE.md / GEMINI.md / .claude/commands …).'
+    required: false
+    default: ''
+  strict:
+    description: 'Treat warnings as failures (exit 1).'
+    required: false
+    default: 'false'
+  model-ids:
+    description: 'Enable the opt-in hardcoded model-ID rule.'
+    required: false
+    default: 'false'
+runs:
+  using: 'composite'
+  steps:
+    - name: Run carrylint
+      shell: bash
+      # Caller inputs are passed via env (NOT ${{ }} inlined into the script) to avoid
+      # template/shell injection. $PATHS is intentionally unquoted so multiple space-separated
+      # paths split into separate argv; the flag array is quote-safe.
+      env:
+        PATHS: ${{ inputs.paths }}
+        STRICT: ${{ inputs.strict }}
+        MODEL_IDS: ${{ inputs.model-ids }}
+      run: |
+        args=()
+        [ "$STRICT" = "true" ] && args+=(--strict)
+        [ "$MODEL_IDS" = "true" ] && args+=(--model-ids)
+        node "$GITHUB_ACTION_PATH/src/check.mjs" "${args[@]}" $PATHS

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@hyuga/carrylint",
+  "version": "0.1.0",
+  "description": "Runtime-portability linter for agent skills & commands: fail CI when a SKILL.md / AGENTS.md / slash-command hardcodes machine- or model-specific assumptions (absolute paths, undeclared CLIs, unresolved placeholders). Zero-dependency, model-agnostic.",
+  "type": "module",
+  "bin": {
+    "carrylint": "src/check.mjs"
+  },
+  "files": [
+    "src",
+    "rules.json",
+    "action.yml"
+  ],
+  "scripts": {
+    "poc": "node src/check.mjs examples/bad",
+    "test": "node --test"
+  },
+  "keywords": [
+    "skill.md",
+    "agent-skills",
+    "claude",
+    "codex",
+    "gemini",
+    "ai",
+    "agent",
+    "linter",
+    "ci",
+    "portability",
+    "model-agnostic",
+    "cross-agent"
+  ],
+  "license": "MIT",
+  "author": "hyuga611",
+  "homepage": "https://github.com/hyuga611/carrylint",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hyuga611/carrylint.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hyuga611/carrylint/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/rules.json

@@ -0,0 +1,36 @@
+{
+  "_comment": "carrylint のデータ駆動ルール辞書。ここを編集すれば scan() の判定が変わる（コード変更不要）。src/check.mjs の DEFAULT_RULES が同梱フォールバック。",
+
+  "providerClis": [
+    "codex", "gemini", "ollama", "claude", "aider", "cursor-agent",
+    "llm", "sgpt", "mods", "copilot", "goose"
+  ],
+
+  "packageBinaries": {
+    "@openai/codex": "codex",
+    "@google/gemini-cli": "gemini",
+    "@anthropic-ai/claude-code": "claude",
+    "@githubnext/github-copilot-cli": "copilot",
+    "@block/goose": "goose",
+    "aider-chat": "aider",
+    "aider-install": "aider",
+    "llm": "llm",
+    "shell-gpt": "sgpt"
+  },
+
+  "modelIdPatterns": [
+    "claude-[a-z0-9][a-z0-9.\\-]*",
+    "gpt-[0-9][a-z0-9.\\-]*",
+    "gpt-image-[0-9]",
+    "o[0-9]-[a-z0-9\\-]+",
+    "gemini-[0-9][a-z0-9.\\-]*",
+    "dall-e-[0-9]",
+    "text-embedding-[a-z0-9\\-]+"
+  ],
+
+  "providerEnv": [
+    "OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GEMINI_API_KEY", "GOOGLE_API_KEY",
+    "AZURE_OPENAI_API_KEY", "GROQ_API_KEY", "MISTRAL_API_KEY", "COHERE_API_KEY",
+    "OLLAMA_HOST", "OPENROUTER_API_KEY", "PERPLEXITY_API_KEY"
+  ]
+}

package/src/check.mjs

@@ -0,0 +1,405 @@
+#!/usr/bin/env node
+// carrylint — 「そのスキル/コマンド、他人のマシン・別のエージェントで本当に動く?」を CI で落とす。
+//
+// SKILL.md / .claude/commands / AGENTS.md / CLAUDE.md / GEMINI.md / .cursor/rules などの本文から、
+// 作った本人の環境・モデル前提が焼き込まれた「実行時に可搬でない」記述を検出する。
+//
+//   ・abs-path       : マシン固有の絶対パス (C:\… /Users/… /home/… $HOME %USERPROFILE%)   [ERROR]
+//   ・placeholder    : 配布物に残った未解決プレースホルダ (<FILL_ME> YOUR_API_KEY path/to/…)  [ERROR]
+//   ・undeclared-cli : 本文が外部/プロバイダCLIを叩くのに宣言もインストール手順もない           [ERROR]
+//   ・home-path      : ~/… ホーム相対パス (ユーザー前提)                                        [WARN]
+//   ・provider-env   : プロバイダ固有の API キー env の生参照                                    [WARN]
+//   ・todo           : 配布物に残った TODO:/FIXME:/XXX:                                          [WARN]
+//   ・model-id       : モデルID直書き (claude-* gpt-* gemini-*)   ← 既定OFF・--model-ids で有効  [opt-in]
+//
+// Agent Skills はオープン標準として "形式" は 20+ エージェントで可搬になった。carrylint は
+// "中身が実際に動くか" を見る側。実行時に LLM も API キーも使わない純静的解析（依存ゼロ）。
+//
+//   node src/check.mjs [path ...]        # path 省略時はカレント配下の対象ファイルを自動探索
+//   --strict        WARN も exit 1 にする
+//   --model-ids     model-id ルールを有効化
+//   --allow a,b     意図的に依存する CLI を許可（undeclared-cli を抑制）
+//   --format json   機械可読 JSON 出力（VS Code 拡張向け）
+//
+// 行内無効化: 行末に <!-- carry-ignore --> でその行を無視。単独行 <!-- carry-ignore-next --> で次行を無視。
+
+import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { resolve, join, dirname } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+// ---------------- ルール辞書（既定・rules.json で上書き可能） ----------------
+
+export const DEFAULT_RULES = {
+  // コマンド位置で叩かれたら「そのエージェント/モデルに固定」とみなす外部CLI群。
+  providerClis: [
+    'codex', 'gemini', 'ollama', 'claude', 'aider', 'cursor-agent',
+    'llm', 'sgpt', 'mods', 'copilot', 'goose',
+  ],
+  // 「npm i -g <package>」等が提供するバイナリ名の別名（宣言判定を正確にする）。
+  packageBinaries: {
+    '@openai/codex': 'codex',
+    '@google/gemini-cli': 'gemini',
+    '@anthropic-ai/claude-code': 'claude',
+    '@githubnext/github-copilot-cli': 'copilot',
+    '@block/goose': 'goose',
+    'aider-chat': 'aider',
+    'aider-install': 'aider',
+    'llm': 'llm',
+    'shell-gpt': 'sgpt',
+  },
+  // プロバイダ固有のモデルID（opt-in）。
+  modelIdPatterns: [
+    'claude-[a-z0-9][a-z0-9.\\-]*',
+    'gpt-[0-9][a-z0-9.\\-]*',
+    'gpt-image-[0-9]',
+    'o[0-9]-[a-z0-9\\-]+',
+    'gemini-[0-9][a-z0-9.\\-]*',
+    'dall-e-[0-9]',
+    'text-embedding-[a-z0-9\\-]+',
+  ],
+  // プロバイダ固有の API キー等 env（生参照は環境前提＝WARN）。
+  providerEnv: [
+    'OPENAI_API_KEY', 'ANTHROPIC_API_KEY', 'GEMINI_API_KEY', 'GOOGLE_API_KEY',
+    'AZURE_OPENAI_API_KEY', 'GROQ_API_KEY', 'MISTRAL_API_KEY', 'COHERE_API_KEY',
+    'OLLAMA_HOST', 'OPENROUTER_API_KEY', 'PERPLEXITY_API_KEY',
+  ],
+};
+
+// 配布物に残っていたら「未完成」を示す、曖昧さの小さいプレースホルダ（ERROR）。
+// 汎用の <name> 等は意図的なテンプレなので拾わない（skills-lint と同じ思想）。
+const PLACEHOLDER_ERROR = [
+  /<fill[_\- ]?me>?/i,
+  /\bfill[_\-]me\b/i,
+  /\breplace[_\-]?me\b/i,
+  /\bchange[_\-]?me\b/i,
+  /\byour[_\-](?:api[_\-]?key|token|secret|password)\b/i,
+  /<your-[^>]{1,40}>/i,
+  /<insert[ _\-][^>]{1,40}>/i,
+  /\bpath\/to\/your\b/i,
+  /(?:^|[\s`"'(])\/path\/to\//,
+  /\bpath\/to\/\.{3}/,
+];
+
+// ---------------- パターン（純粋・textスキャン） ----------------
+
+const DRIVE_ABS = /(?<![\w.])[A-Za-z]:\\[^\s`"')<>|]+/g;                 // C:\Users\atlan\…
+const UNIX_HOME_ABS = /(?<![\w.\-\/])\/(?:Users|home)\/[^\s`"')<>|]+/g;   // /Users/atlan/… /home/foo/…
+const ENV_HOME = /(?:\$\{?HOME\b\}?|%USERPROFILE%)/gi;                    // $HOME ${HOME} %USERPROFILE%
+const TILDE_HOME = /(?<![\w.])~\/[^\s`"')<>|]*/g;                         // ~/foo …（WARN）
+const TODO_MARK = /(?:\b(?:TODO|FIXME|HACK|XXX)\b\s*[:：]|<!--\s*(?:TODO|FIXME)\b)/;
+
+function push(findings, ln, kind, severity, msg) {
+  findings.push({ ln, kind, severity, msg });
+}
+
+/** frontmatter と本文中の install/宣言行から「宣言済みツール名」を集める。 */
+function declaredTools(text, rules) {
+  const declared = new Set();
+  const add = (raw) => {
+    if (!raw) return;
+    let name = String(raw).trim().toLowerCase();
+    if (!name) return;
+    if (rules.packageBinaries[name]) {
+      declared.add(rules.packageBinaries[name]);
+      return;
+    }
+    name = name.replace(/^@[\w.\-]+\//, '').replace(/@[\w.\-]+$/, '').replace(/[^\w.\-]/g, '');
+    if (name) declared.add(name);
+  };
+
+  // frontmatter の allowed-tools / requires
+  const fm = text.match(/^?---\r?\n([\s\S]*?)\r?\n---/);
+  if (fm) {
+    for (const line of fm[1].split(/\r?\n/)) {
+      const m = line.match(/^\s*(?:allowed-tools|requires|tools|dependencies)\s*:\s*(.+)$/i);
+      if (m) m[1].replace(/[\[\]"']/g, '').split(/[,\s]+/).forEach(add);
+    }
+  }
+
+  // 本文の install 手順（npm i -g … / brew install … / pip install … 等）
+  const installRe = /\b(?:npm\s+(?:i|install)(?:\s+-g|\s+--global)?|pnpm\s+add(?:\s+-g)?|yarn\s+(?:global\s+)?add|brew\s+install(?:\s+--cask)?|pipx?\s+install|pip3?\s+install|cargo\s+install|go\s+install|apt(?:-get)?\s+install|choco\s+install|scoop\s+install|uv\s+tool\s+install)\s+([^\n`|&;]+)/gi;
+  for (const m of text.matchAll(installRe)) {
+    for (const tok of m[1].split(/[\s,]+/)) {
+      if (!tok || tok.startsWith('-')) continue;
+      add(tok);
+    }
+  }
+  return declared;
+}
+
+/** コマンドセグメントの先頭コマンド語を返す（sudo / 環境代入 / $ プロンプトを剥がす）。 */
+function firstCommandWord(seg) {
+  let s = seg.trim();
+  s = s.replace(/^[!$#>]\s*/, '');            // プロンプト記号 / Claude の !`…`
+  s = s.replace(/^sudo\s+/, '');
+  s = s.replace(/^(?:[A-Za-z_][\w]*=[^\s]*\s+)+/, ''); // FOO=bar cmd
+  const m = s.match(/^([A-Za-z][\w.-]*)/);
+  return m ? m[1].toLowerCase() : null;
+}
+
+/**
+ * 行から providerCLI の「呼び出し」を集める。コード文脈（fence行 or backtickスパン中身）で、
+ * かつツール名の後ろに引数/サブコマンドがあるものだけを呼び出しとみなす。
+ * 裸の言及（`codex` だけ等）は呼び出しではない＝誤検知しない。
+ */
+function cliInvocations(line, inFence, rules) {
+  const hits = new Set();
+  const providers = new Set(rules.providerClis);
+  const segments = [];
+  if (inFence) segments.push(line);
+  for (const m of line.matchAll(/`([^`]+)`/g)) segments.push(m[1]);
+  for (const seg of segments) {
+    for (const sub of seg.split(/[\n;|&]+|\$\(/)) {
+      const w = firstCommandWord(sub);
+      if (!w || !providers.has(w)) continue;
+      const rest = sub.trim()
+        .replace(/^[!$#>]\s*/, '')
+        .replace(/^sudo\s+/, '')
+        .replace(/^(?:[A-Za-z_][\w]*=[^\s]*\s+)+/, '');
+      if (new RegExp('^' + w + '\\b\\s+\\S', 'i').test(rest)) hits.add(w);
+    }
+  }
+  return hits;
+}
+
+/**
+ * 本文を走査して可搬性エラーを返す（純粋関数・テスト可能）。
+ * @param text  ファイル本文
+ * @param opts  { rules, allow:Set|string[], modelIds:boolean }
+ */
+export function scan(text, opts = {}) {
+  const rules = opts.rules || DEFAULT_RULES;
+  const allow = opts.allow instanceof Set ? opts.allow
+    : new Set((opts.allow || []).map((s) => String(s).toLowerCase()));
+  const modelIds = !!opts.modelIds;
+  const declared = declaredTools(text, rules);
+  const modelRe = new RegExp('\\b(?:' + rules.modelIdPatterns.join('|') + ')\\b', 'gi');
+  const envRe = new RegExp('\\b(?:' + rules.providerEnv.join('|') + ')\\b');
+
+  const findings = [];
+  const lines = String(text).split(/\r?\n/);
+
+  // 無効化コメントの行集合を先に作る。
+  const ignored = new Set();
+  lines.forEach((line, i) => {
+    if (/<!--\s*carry-ignore\s*-->/.test(line)) ignored.add(i + 1);
+    if (/<!--\s*carry-ignore-next\s*-->/.test(line)) ignored.add(i + 2);
+  });
+
+  let inFence = false;
+  lines.forEach((line, i) => {
+    const ln = i + 1;
+
+    // フェンス（``` / ~~~）開閉。マーカ行自体は走査しない。
+    if (/^\s*(`{3,}|~{3,})/.test(line)) {
+      inFence = !inFence;
+      return;
+    }
+    if (ignored.has(ln)) return;
+
+    // 1) マシン固有の絶対パス（ERROR）
+    for (const re of [DRIVE_ABS, UNIX_HOME_ABS, ENV_HOME]) {
+      re.lastIndex = 0;
+      for (const m of line.matchAll(re)) {
+        push(findings, ln, 'abs-path', 'error', `マシン固有の絶対パス \`${m[0].trim()}\` — 他人の環境で解決しません（相対パスや {baseDir} に）`);
+      }
+    }
+    // ~/ ホーム相対（WARN）
+    for (const m of line.matchAll(TILDE_HOME)) {
+      push(findings, ln, 'home-path', 'warn', `ホーム相対パス \`${m[0].trim()}\` — ユーザーのホーム前提です`);
+    }
+
+    // 2) 未解決プレースホルダ（ERROR）
+    for (const re of PLACEHOLDER_ERROR) {
+      const m = line.match(re);
+      if (m) {
+        push(findings, ln, 'placeholder', 'error', `未解決のプレースホルダ \`${m[0].trim()}\` が配布物に残っています`);
+        break; // 1行1件に留める
+      }
+    }
+
+    // 3) provider CLI 呼び出し（宣言なし→ERROR）
+    for (const cli of cliInvocations(line, inFence, rules)) {
+      if (allow.has(cli) || declared.has(cli)) continue;
+      push(findings, ln, 'undeclared-cli', 'error', `\`${cli}\` を呼んでいますが、インストール手順も requires 宣言もありません（他環境で黙って失敗します）`);
+    }
+
+    // 4) プロバイダ固有 env の生参照（WARN）
+    {
+      const m = line.match(envRe);
+      if (m) push(findings, ln, 'provider-env', 'warn', `\`${m[0]}\` を前提にしています — .env.example に記載し未設定時の案内を`);
+    }
+
+    // 5) TODO/FIXME 残り（WARN）
+    if (TODO_MARK.test(line)) {
+      push(findings, ln, 'todo', 'warn', '配布物に TODO/FIXME マーカーが残っています');
+    }
+
+    // 6) モデルID直書き（opt-in）
+    if (modelIds) {
+      modelRe.lastIndex = 0;
+      const seen = new Set();
+      for (const m of line.matchAll(modelRe)) {
+        if (seen.has(m[0])) continue;
+        seen.add(m[0]);
+        push(findings, ln, 'model-id', 'warn', `モデルID \`${m[0]}\` を直書きしています — 固定は意図的なら --allow / carry-ignore を`);
+      }
+    }
+  });
+
+  return findings;
+}
+
+// ---------------- ファイル探索 ----------------
+
+const DEFAULT_NAMES = new Set(['SKILL.md', 'AGENTS.md', 'CLAUDE.md', 'GEMINI.md']);
+const DEFAULT_DIRS = [['.claude', 'commands'], ['.codex', 'prompts'], ['.cursor', 'rules'], ['.github', 'prompts']];
+
+function isTargetName(name) {
+  return DEFAULT_NAMES.has(name);
+}
+
+/** paths（ファイル/ディレクトリ）から対象ファイルを集める。 */
+export function findFiles(paths) {
+  const out = [];
+  const seen = new Set();
+  const add = (p) => {
+    const r = p.replace(/\\/g, '/');
+    if (!seen.has(r)) { seen.add(r); out.push(r); }
+  };
+  const inCommandDir = (dir) => DEFAULT_DIRS.some((seg) => dir.replace(/\\/g, '/').includes(seg.join('/')));
+  const walk = (dir, depth) => {
+    if (depth > 8) return;
+    let entries;
+    try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries) {
+      if (e.isDirectory()) {
+        if (e.name === 'node_modules' || e.name.startsWith('.git')) continue;
+        walk(join(dir, e.name), depth + 1);
+      } else if (isTargetName(e.name) || (/\.(md|txt|mdc)$/i.test(e.name) && inCommandDir(dir))) {
+        add(join(dir, e.name));
+      }
+    }
+  };
+  for (const p of paths) {
+    let st;
+    try { st = statSync(p); } catch { continue; }
+    if (st.isDirectory()) walk(p, 0);
+    else add(p);
+  }
+  return out;
+}
+
+// ---------------- CLI ----------------
+
+/** argv から オプションを取り出し、残りをパスとして返す。 */
+export function parseArgs(argv) {
+  const paths = [];
+  const allow = new Set();
+  let strict = process.env.CARRYLINT_STRICT === '1';
+  let modelIds = process.env.CARRYLINT_MODEL_IDS === '1';
+  let asJson = process.env.CARRYLINT_FORMAT === 'json';
+  const addAllow = (s) => (s || '').split(',').forEach((n) => n.trim() && allow.add(n.trim().toLowerCase()));
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--') continue;
+    else if (a === '--strict') strict = true;
+    else if (a === '--model-ids') modelIds = true;
+    else if (a === '--json') asJson = true;
+    else if (a === '--format') { if (argv[i + 1] === 'json') asJson = true; i++; }
+    else if (a.startsWith('--format=')) { if (a.slice(9) === 'json') asJson = true; }
+    else if (a === '--allow') addAllow(argv[++i]);
+    else if (a.startsWith('--allow=')) addAllow(a.slice(8));
+    else paths.push(a);
+  }
+  return { paths, allow, strict, modelIds, asJson };
+}
+
+/** rules.json をモジュール同梱位置から読む（無ければ既定）。 */
+function loadRules() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const raw = JSON.parse(readFileSync(join(here, '..', 'rules.json'), 'utf8'));
+    return { ...DEFAULT_RULES, ...raw };
+  } catch {
+    return DEFAULT_RULES;
+  }
+}
+
+function defaultTargets() {
+  return ['.'];
+}
+
+/** results（[{file, findings}]）を機械可読な JSON 形へ（純粋・テスト可能）。 */
+export function toJson(results) {
+  const findings = results.flatMap(({ file, findings }) =>
+    findings.map((f) => ({ file, line: f.ln || 1, kind: f.kind, severity: f.severity, message: f.msg })),
+  );
+  const errors = findings.filter((f) => f.severity === 'error').length;
+  return { ok: errors === 0, count: findings.length, errors, warnings: findings.length - errors, findings };
+}
+
+export function main(argv) {
+  const inActions = process.env.GITHUB_ACTIONS === 'true';
+  const { paths, allow, strict, modelIds, asJson } = parseArgs(argv);
+  const rules = loadRules();
+  const files = findFiles(paths.length ? paths : defaultTargets());
+
+  if (files.length === 0) {
+    if (asJson) console.log(JSON.stringify({ ok: true, count: 0, errors: 0, warnings: 0, findings: [] }, null, 2));
+    else console.log('carrylint: 対象ファイルなし（SKILL.md / AGENTS.md / CLAUDE.md / GEMINI.md / .claude/commands 等）。スキップ。');
+    return 0;
+  }
+
+  const results = [];
+  for (const file of files) {
+    let text;
+    try { text = readFileSync(file, 'utf8'); }
+    catch {
+      if (asJson) { console.log(JSON.stringify({ ok: false, error: `cannot read ${file}` }, null, 2)); return 2; }
+      console.error(`carrylint: ${file} を読めません`);
+      return 2;
+    }
+    results.push({ file, findings: scan(text, { rules, allow, modelIds }) });
+  }
+
+  if (asJson) {
+    const out = toJson(results);
+    console.log(JSON.stringify(out, null, 2));
+    return out.errors > 0 || (strict && out.count > 0) ? 1 : 0;
+  }
+
+  let errors = 0;
+  let warnings = 0;
+  for (const { file, findings } of results) {
+    if (findings.length === 0) { console.log(`✓ ${file}`); continue; }
+    const errs = findings.filter((f) => f.severity === 'error').length;
+    console.error(`✗ ${file} — error ${errs} / warn ${findings.length - errs}`);
+    for (const f of findings) {
+      const ln = f.ln || 1;
+      const tag = f.severity === 'error' ? 'ERROR' : 'warn ';
+      console.error(`  ${f.severity === 'error' ? '✗' : '•'} ${file}:${ln}\t[${f.kind}] ${f.msg}`);
+      if (inActions) {
+        const level = f.severity === 'error' ? 'error' : 'warning';
+        console.log(`::${level} file=${file},line=${ln}::[${f.kind}] ${f.msg.replace(/\r?\n/g, ' ')}`);
+      }
+      if (f.severity === 'error') errors++; else warnings++;
+    }
+  }
+
+  if (errors > 0 || (strict && warnings > 0)) {
+    console.error(`\ncarrylint: error ${errors} / warn ${warnings}${strict ? '（--strict: warn も失敗）' : ''}`);
+    return 1;
+  }
+  if (warnings > 0) {
+    console.error(`\ncarrylint: error 0 / warn ${warnings}（warn は exit 0。--strict で失敗させられます）`);
+    return 0;
+  }
+  console.log(`carrylint: ${files.length} ファイル、すべて可搬OK`);
+  return 0;
+}
+
+// 直接実行された時だけ CLI として動く（import 時は関数だけ公開）。
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  process.exit(main(process.argv.slice(2)));
+}