name	absolute-path-checker
description	実装のテスト、リファクタリング、ポータビリティ、ディレクトリ階層について議論する際に、絶対パスが実装コードに存在しないことを確認する
allowed-tools	Grep, Read, Edit, Bash

絶対パスチェッカー

目的

実装コード内に絶対パス（特にHOMEディレクトリを含むパス）が存在しないことを担保し、ポータビリティを確保する。

トリガー条件

以下のトピックについて議論・作業する際に自動的に実行:

テストの実装・修正
リファクタリング
ポータビリティの改善
ディレクトリ構造・階層の変更

実施手順

1. 絶対パスの検索

実装ファイル（.ts, .js）内で以下のパターンを検索:

# HOME ディレクトリベースの絶対パス
grep -r "/Users/" --include="*.ts" --include="*.js" .
grep -r "/home/" --include="*.ts" --include="*.js" .

# ルートからの絶対パス（設定ファイル以外）
grep -r '"/[a-z]' --include="*.ts" --include="*.js" .

2. 検出結果の判断

検出されたパスが以下のどれに該当するか判断:

種類	対応
実装コード内のリテラル	相対化が必要
テスト結果・ログ出力	許容（ただし、テストの期待値には含めない）
設定ファイルのデフォルト値	環境変数や相対パスに置換
ドキュメント・コメント内の例	許容

3. 相対パスへの変換

優先順位

既存の変数を使用: プロジェクトで定義済みの変数があれば使う
- 例: baseDir, projectRoot, Deno.cwd() など

import.meta を使用 (Deno/ESM の場合):

const __dirname = new URL(".", import.meta.url).pathname;
const configPath = join(__dirname, "../config.json");

相対パスリテラル:

// Before
const path = "/Users/dev/project/data/file.txt";

// After
const path = "./data/file.txt";

4. テストの実行

修正後は必ずテストを実行して動作確認:

deno task test

注意事項

$HOME や ~ を含むパスも絶対パスと同様に扱う
環境変数から取得したパス（Deno.env.get("HOME") など）は許容
パスの結合には join() や resolve() を使用し、文字列連結は避ける

absolute-path-checker

Install Skill

SKILL.md