skill 編集・同期の取り扱い
このリポジトリの skill を編集・同期・比較するときは、リポジトリ側を正とし、ホームディレクトリ直下の skill は読み取り専用として扱う。
skill は kf-global / kf-global-commands / external / kf-local の4バケットに分類する。
参照ファイル
- references/overview.md: 着手時: 基本原則・適用範囲・完了判定を確認するとき
- references/repository-layout.md: 着手時: インストール前提・4バケット・必須 meta を確認するとき
- references/edit-in-repository.md: 着手時: skill 修正依頼の編集先を決めるとき
読み進め方
- references/overview.md を読み、基本原則と適用範囲を確認する
- references/repository-layout.md を読み、対象 skill のバケットと必須 meta を確認する
- skill 修正依頼の場合は references/edit-in-repository.md を読み、編集先・禁止事項を確定する
- 下記「最終チェック」で完了判定する
最終チェック
- skill 修正は
.agents/skills/配下(このリポジトリ)だけで行っている - 対象 skill のバケットを特定し、必須 meta を満たしている
~/.agent/skillsおよび~/.agents/skills配下の skill 本体を変更していない- main マージ後の同期は vercel-labs/skills 経由であることを前提に説明している
- リポジトリとホーム間の差分を異常と扱っていない