ignore

ナビゲーション: プラグインの CLAUDE.md | ルートの CLAUDE.md

グローバル無視パターン

lint-relative-paths リンターのグローバル無視パターンを管理します。

自己進化型スキル: このスキルは使用を通じて改善されます。指示に誤りがある場合、パラメーターが変化した場合、または回避策が必要になった場合は、後回しにせず、すぐにこのファイルを修正してください。実際に再現可能な問題がある場合にのみ更新してください。

目的

リポジトリによっては、リポジトリルートからのパス（例：/docs/file.md）ではなく、意図的に Markdown で相対パス（例：../docs/file.md）を使用しています。このコマンドは、一致するワークスペースのパス検証をスキップするグローバル無視ファイルを管理します。

アクション

アクション	説明	例
add	グローバル無視ファイルにパターンを追加します	/statusline-tools:ignore add my-repo
list	現在のパターンを表示します	/statusline-tools:ignore list
remove	無視ファイルからパターンを削除します	/statusline-tools:ignore remove my-repo

パターンの照合

パターンは部分文字列照合を使用します。ワークスペースのパスにパターンが含まれている場合、一致します。

例: パターン my-project は次のパスに一致します。

• /Users/user/projects/research-repo
• /Users/user/eon/research-repo.worktree-feature-x
• /home/user/code/research-repo-v2

無視ファイルの場所

~/.claude/lint-relative-paths-ignore

# で始まる行はコメントです。

実行

スキップのロジック

• アクションとパターンが指定されている場合 -> 直接実行します
• list のみが指定されている場合 -> すぐにパターンを表示します
• 引数がない場合 -> AskUserQuestion フローを使用します

ワークフロー

1. 現在の状態を確認: list を実行して既存のパターンを表示します
2. アクションを選択: AskUserQuestion を使用してアクションを選択します：
   • 「新しいパターンを追加」 -> パターンの入力を求めます
   • 「既存のパターンを削除」 -> 選択できるように現在のパターンを表示します
   • 「現在のパターンを表示するだけ」 -> 表示して終了します
3. パターンを入力: 追加／削除する場合は、例を示して AskUserQuestion で質問します
4. 実行: 管理スクリプトを実行します
5. 確認: 変更が適用されたことを確認します

AskUserQuestion フロー（引数なし）

引数なしで呼び出された場合は、ユーザーを対話的に案内します。

Question: "What would you like to do with lint-relative-paths ignore patterns?"
Options:
  - "Add pattern" -> "Add a new repository pattern to skip path linting"
  - "List patterns" -> "Show all current ignore patterns"
  - "Remove pattern" -> "Remove an existing pattern from the ignore list"

「パターンを追加」の場合：

Question: "Enter the repository pattern to ignore"
Note: Patterns use substring matching. Example: 'research-repo' matches any path containing 'research-repo'.

直接実行（引数あり）

$ARGUMENTS を解析し、管理スクリプトを実行します。

/usr/bin/env bash << 'IGNORE_SCRIPT_EOF'
PLUGIN_DIR="$(cc-plugin-root statusline-tools)"
bash "$PLUGIN_DIR/scripts/manage-ignore.sh" $ARGUMENTS
IGNORE_SCRIPT_EOF

手動編集

無視ファイルは手動で編集することもできます。

# View current patterns
cat ~/.claude/lint-relative-paths-ignore

# Add a pattern manually
echo "my-repo-pattern" >> ~/.claude/lint-relative-paths-ignore

トラブルシューティング

問題	原因	解決策
パターンが一致しない	部分文字列照合が厳密	より広いパターンを使用します（例：research-repo ではなく forge）
無視ファイルが見つからない	~/.claude が存在しない	mkdir -p ~/.claude で作成します
アクセスが拒否される	ファイルに書き込みできない	ls -la でファイルのアクセス許可を確認します
スクリプトが見つからない	プラグインがインストールされていない	マーケットプレイスからプラグインを再インストールします

実行後の振り返り

このスキルの実行後、終了する前に次の点を確認します。

1. コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった指示またはエラーテーブルを修正します。
2. パラメーターや出力は変わりましたか？ — 基盤となるツールのインターフェースに変更があった場合は、使用例とパラメーターテーブルを最新の内容に更新します。
3. 回避策が必要でしたか？ — 独自に対応した場合（別のフラグや追加の手順など）は、次回同じ回避策が不要になるよう、この SKILL.md を更新します。

実際に再現可能な問題がある場合にのみ更新し、推測に基づいて更新しないでください。