メインコンテンツまでスキップ

トラブルシューティングワークフロー

問題を診断・修正するための体系的なアプローチです。

概要​

ステップ1: 診断する​

doctor コマンドを実行してください。

skillshare doctor

チェックされる内容:

  • Source ディレクトリが存在し、有効であること
  • Config ファイルが正しくフォーマットされていること
  • すべての Target にアクセス可能であること
  • シンボリックリンクが壊れていないこと
  • Git リポジトリのステータス（初期化されている場合）
  • Skill フォーマットの妥当性

ステップ2: 問題を特定する​

よくある症状と原因​

症状考えられる原因クイックフィックス
AI CLI に Skill が表示されないSync されていないskillshare sync
シンボリックリンクが壊れているSource が削除された復元または再インストール
Config エラー無効な YAMLskillshare doctor が詳細を表示する
push/pull ができないGit の問題手動で git のステータスを確認する
Permission denied所有権が間違っているファイルの権限を確認する

ステップ3: 修正する​

Sync の問題​

# すべての Target を再 Sync する
skillshare sync

# 強制的に Sync する（シンボリックリンクを再作成する）
skillshare sync --force

壊れたシンボリックリンク​

# ステータスを確認する
skillshare status

# 再作成するために Sync する
skillshare sync

Config の問題​

# 現在の Config を表示する
cat ~/.config/skillshare/config.yaml

# Config をリセットする
rm ~/.config/skillshare/config.yaml
skillshare init

Git の問題​

cd ~/.config/skillshare/skills

# ステータスを確認する
git status

# pull が失敗する（ローカルに変更がある）
git stash
git pull
git stash pop

# push が失敗する（リモートが先行している）
git pull
git push

Target の問題​

# 削除して再追加する
skillshare target remove claude
skillshare target add claude ~/.claude/skills
skillshare sync

ステップ4: 検証する​

# ステータスを確認する
skillshare status

# もう一度 doctor を実行する
skillshare doctor

# AI CLI でテストする
# （Skill を呼び出す）

復旧オプション​

軽度の復旧​

# 再 Sync するだけ
skillshare sync

中程度の復旧​

# バックアップから復元する
skillshare restore claude
skillshare sync

重度の復旧（最初からやり直す）​

# 現在の状態をバックアップする
skillshare backup

# Config を削除する（Skill は保持される）
rm ~/.config/skillshare/config.yaml

# 再初期化する
skillshare init

# Sync する
skillshare sync

ヘルプを得る​

問題が解決しない場合:

  1. 情報を集める:

    skillshare doctor > doctor-output.txt
    skillshare status >> doctor-output.txt

  2. FAQ を確認する: よくあるエラー

  3. Issue を報告する: GitHub Issues

    • doctor の出力を含める
    • エラーメッセージを含める
    • 何をしようとしていたかを記述する

関連項目​