Claude-skill-registry absolute-path-checker

実装のテスト、リファクタリング、ポータビリティ、ディレクトリ階層について議論する際に、絶対パスが実装コードに存在しないことを確認する

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/absolute-path-checker" ~/.claude/skills/majiayu000-claude-skill-registry-absolute-path-checker && rm -rf "$T"

manifest: skills/data/absolute-path-checker/SKILL.md

絶対パスチェッカー

目的

実装コード内に絶対パス（特に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()
```
を使用し、文字列連結は避ける