groove-admin-config について
ユーザーが確認した設定で `.groove/index.md` を作成・更新し、選択した Git 方針を適用する Groove のセットアップスキルです。デフォルト値または引数を使い、タスク保存先、メモリー、フック、Groovebook を設定できます。
主な機能
- 01設定値の確認または適用
- 02`.groove/index.md` の書き込み
- 03`.groove/.gitignore` の生成
- 04デフォルト値と引数への対応
- 05設定内容の要約表示
活用シーン
- 01対話形式での Groove 設定
- 02初期セットアップへのデフォルト適用
- 03メモリー、タスク、フックの Git 管理設定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ andreadellacorte/ groove --skill groove-admin-configインストール後、Claude Code で/groove-admin-configを入力して読み込まれたか確認します。
詳細
groove-admin-config
目的
ユーザーが確認した値を使用して、.groove/index.md を作成または更新します。Git 戦略をただちに適用します。ユーザーは /groove-admin-install を実行できる状態になります。
受け入れ条件
- すべての設定キーに値が入力された
.groove/index.mdが存在する - 各キーはユーザーが確認するか、デフォルト値を受け入れている
- 終了前に Git 戦略が適用されている(
.groove/.gitignoreが書き込まれている) - 最終設定の概要をユーザーに提示し、
/groove-admin-installを実行するよう伝える
手順
--defaults が渡された場合:すべてのプロンプトを省略し、すべてのデフォルト値を適用して、設定の書き込みに直接進みます(「すべてのキーの確認後」の手順 1)。適用するデフォルト値を報告します。
それ以外の場合は、各設定キーについて順番にユーザーに確認します。各キーについて、現在の値(新規の場合はデフォルト値)を表示し、用途を説明して、確認または変更を依頼します。
キーとデフォルト値
| キー | デフォルト値 | 選択肢 | 質問 |
|---|---|---|---|
tasks.storage | beans | beans | linear | github | none | "どのタスクバックエンドを使用しますか?beans は、リポジトリ内の Markdown ファイルとしてタスクを管理します。" |
tasks.list_limit | 15 | 正の整数 | "task-list に表示するタスクの最大数は?(デフォルト:15)" |
tasks.analyse_limit | 30 | 正の整数 | "task-analyse に表示するタスクの最大数は?(デフォルト:30)" |
memory.review_days | 5 | 正の整数 | "1日の開始時に、直近の営業日を何日分確認しますか?(デフォルト:5)" |
git.memory | ignore-all | ignore-all | hybrid | commit-all | "メモリログの Git 戦略は?ignore-all はローカルに保持し、hybrid はログをコミットしてセッションを無視し、commit-all はすべてをコミットします。" |
git.tasks | ignore-all | ignore-all | commit-all | "タスクファイル(.groove/tasks/)の Git 戦略は?ignore-all はローカルに保持し、commit-all は Git で追跡します。" |
git.hooks | commit-all | ignore-all | commit-all | "フック(.groove/hooks/)の Git 戦略は?commit-all はチームとフックを共有し、ignore-all はローカルに保持します。" |
groovebook | andreadellacorte/groovebook | <owner>/<repo> または空欄 | "学びを共有する Groovebook リポジトリは?デフォルト:andreadellacorte/groovebook。無効にする場合は空欄にしてください。" |
すべてのキーを確認した後:
- 確認済みの値と
groove-version: <installed version>を使用して.groove/index.mdを書き込みます - Git 戦略を適用し、
.groove/.gitignoreを書き込みます(制約を参照) - 書き込んだ設定の概要を表示します
- ユーザーに次のように伝えます:"バックエンドをインストールするには、
/groove-admin-installを実行してください。"
制約
.groove/index.mdがすでに存在する場合は、各質問に現在の値をあらかじめ入力します- 必ず
groovebook:を書き込みます(デフォルトはandreadellacorte/groovebook、空欄は無効を意味します)。メモリパス(.groove/memory/)と仕様パス(.groove/memory/specs/)はハードコードされているため、質問しないでください。 --defaultsが渡された場合は、プロンプトを一切表示せずにすべてのデフォルト値を適用します。これはgroove-admin-installで初回セットアップを手間なく行うために使用されます- ほかの引数(例:
tasks=linear git.memory=hybrid)が指定された場合は、プロンプトを表示せずにそれらを適用し、指定されていないキーにはデフォルト値を使用します skills/groove/SKILL.mdに記載されたインストール済みバージョンと一致するgroove-version:を必ず書き込みます
Git 戦略 → .groove/.gitignore
.groove/index.md を作成した後、git.* サブキーから .groove/.gitignore を生成します。
| コンポーネント | 戦略 | .groove/.gitignore に追加されるエントリー |
|---|---|---|
git.memory | ignore-all | memory/ |
git.memory | hybrid | memory/sessions/ |
git.memory | commit-all | (なし) |
git.tasks | ignore-all | tasks/ |
git.tasks | commit-all | (なし) |
git.hooks | ignore-all | hooks/ |
git.hooks | commit-all | (なし) |
生成されたエントリーを .groove/.gitignore に書き込み、ファイル全体を置き換えます。エントリーが生成されない場合(すべて commit-all の場合)は、コメント # groove git strategy: commit-all を含む空のファイルを書き込みます。
戦略にかかわらず、常に以下の行を .groove/.gitignore の末尾に追加します。
# cache — always local
.cache/*
!.cache/.gitkeep
.groove/がルートの.gitignoreに記載されている場合は、ユーザーに次のように警告します:「注意:.groove/がルートの .gitignore にあります。commit-all戦略を使用するには、これを削除する必要があります。」- ルートの
.gitignoreは自動的に変更せず、ユーザーが解決できるように注意を促します。