skills-cli

Skills CLI

ワークフロー

1. bunx skills list でプロジェクトのスコープを、bunx skills list -g でグローバルスコープの現在の状態を確認します。
   • このリポジトリでは、正式な分類には skill-registry.json を、コミット済みのプロジェクトの意図には sjskills plan を、正確な固定ベースラインの状態には sjskills plan --global を使用します。
2. bunx skills find <query> または bunx skills add <source> --list を使用して、選択肢を調べます。
   • コマンド、ソース、スコープ、エージェントの対象を選ぶ場合（スキルの初期化を含む）は、CLI が受け付ける入力とインストール先に関する情報を確認するため、references/cli.md を読みます。
3. スコープ、スキルの選択、エージェントの対象を明示してインストールします。
   • 公開済みスキルをインストールまたは再インストールする前、あるいは共有インストールをエージェント固有のパスに移動する前に、recipes/install-and-migrate.md を読み、該当するレシピを使用します。
   • このリポジトリでは、コミット済みのプロジェクトの意図と固定グローバルベースラインの両方に、手書きのコマンドより sjskills を優先します。非公開アダプターは、Codex と Claude Code の対象を明示して配置します。検証済みの配置、状態、隔離、復元は sjskills が管理します。
   • バイト単位で一致するだけでは、調整機能の管理対象にはなりません。管理対象の更新と削除は、現在の内容が信頼できる状態と一致する場合にのみ実行されます。
4. 通常のインストールは、該当するスコープのコマンドで検証します。このリポジトリの管理対象の状態については、プロジェクトの場合は sjskills plan、固定グローバルベースラインの場合は sjskills plan --global を使用して、配置を正確に検証します。共有ルートの検出結果には、意図しないエージェントからの可視性が報告される場合があります。
5. インストールの管理や削除には、作成時と同じスコープおよびエージェントの対象指定を使用します。
   • インストール済み項目のフィルター付き一覧表示、スキルの削除、汎用の更新、ロックファイルの復元、またはパッケージに含まれるスキルの同期を実行する前に、recipes/manage-installs.md を読みます。
   • このリポジトリの公開済みスキルについては、リモートソースから再インストールする前に、ローカルの変更を公開します。

ガードレール

• デフォルトではシンボリックリンクモードを使用します。ユーザーから要求された場合、または選択したリポジトリのスキルをグローバルスコープにインストールする場合は、--copy を使用します。
• ユーザーがソース内のすべてのスキルを明示的に希望している場合にのみ、--skill '*' を使用します。現在の skills CLI では、--all は --skill '*' --agent '*' -y に展開されるため、意図せず共有の ~/.agents/skills インストールを再作成する可能性があります。
• このリポジトリの固定グローバルベースラインに対して、Pi の対象を作り出してはなりません。Pi は、選択した共有ルートのコピーを検出します。
• 調整を行う前に、変更したリポジトリのスキルを公開します。ローカルでの編集や未マージのブランチは、main に固定されたレジストリソースには含まれていません。
• 別途レビュー済みのロールアウト計画と明示的な承認なしに、実際のホームディレクトリに対して sjskills apply --global やグローバル復元を実行してはなりません。グローバル適用には、レビュー済みの JSON 計画を --approved-plan で指定し、承認済みのダイジェストを --approved-plan-sha256 で指定する必要があります。これらのフラグは証拠を紐付けるものであり、承認を与えるものではありません。
• インストール済みのスキルは実行可能な指示として扱い、信頼できないソースを避けます。
• chezmoi でドットファイルを管理している場合、稼働中のスキルディレクトリに対して chezmoi add を実行しないでください。