From 85b0d045666837ed5b66749c00d985797581c045 Mon Sep 17 00:00:00 2001 From: HarakaraSite Date: Mon, 16 Feb 2026 18:11:05 +0900 Subject: [PATCH] docs: update README.md for skill-based workflow --- readme.md | 54 +++++++++++++++++++++++++++++------------------------- 1 file changed, 29 insertions(+), 25 deletions(-) diff --git a/readme.md b/readme.md index 2948b7f..af6b40c 100644 --- a/readme.md +++ b/readme.md @@ -2,46 +2,50 @@ このプロジェクトは、Strudel ライブコーディングの試行錯誤を記録するノートブックであり、Gemini CLI のカスタムスキルを活用して楽曲制作を加速させるための環境です。 -東京の電子音楽シーンの感性を持つ AI アシスタント「ボク」が、君の音楽制作を強力にサポートします。 +東京の電子音楽シーンの感性を持つ AI アシスタント「ボク」が、君の音楽制作をプロの視点から強力にサポートするよ。 ## 🚀 主な機能 ### 1. テンプレート生成 (`generate-strudel-template`) -指定したジャンル（Techno, House, Dub Techno, Hypnotic Techno など）に基づき、即座に演奏可能な Strudel コードと音楽的解説を生成します。 -生成されたファイルは `strudel/` ディレクトリに保存されます。 +Techno, House, Dub Techno, Minimal など、指定したジャンルに基づき、即座に演奏可能な Strudel コードと音楽的解説を生成します。 +- `strudel/` ディレクトリに新しいアイデアとして保存されます。 +- プロフェッショナルなリズムパターンと音色設定が含まれます。 ### 2. 構文修正 & 解説 (`fix-and-explain-strudelcode`) -君が書いた Strudel コードのエラー（`~` の誤用など）を最小限の修正で解決し、楽曲の音楽的な意図をプロの視点から解説します。 -修正版は `explained/` ディレクトリに保存され、オリジナルのファイルは保護されます。 +Strudel コードのエラーを修正し、楽曲の意図を汲み取った解説を加えます。 +- 修正版は `explained/` ディレクトリに保存されます。 +- 単なる修正に留まらず、音楽的なアドバイスも提供します。 ## 📁 ディレクトリ構成 -- `strudel/`: 楽曲のアイディアや生成されたテンプレート（Markdown） -- `explained/`: AI によって修正・解説された楽曲データ -- `.gemini/skills/`: Gemini CLI 用のカスタムスキル定義 -- `.gemini/REFERENCE.md`: Strudel の最新構文や音源のリファレンス -- `script/`: バッチ処理用のユーティリティスクリプト +- `strudel/`: ライブコーディングのノート（Markdown形式）。日付ベースの記録やジャンル別スケッチ。 + - `samples/`: プロジェクト固有のオーディオサンプル。 +- `explained/`: `fix-and-explain-strudelcode` スキルによって生成された修正・解説済みファイル。 +- `.gemini/skills/`: Gemini CLI 用のカスタムスキル実体。 +- `.gemini/REFERENCE.md`: Strudel の最新構文や推奨パターンをまとめたリファレンス。 +- `PRECAUTIONS.md`: 過去のミスから学んだ、高品質なコード生成のための注意守則。 +- `fix-and-explain-strudelcode/`, `generate-strudel-template/`: スキルのソースコード一式。 ## 🛠 使い方 -### スキルの有効化 -このプロジェクトを初めて使用する場合や、スキルを更新した後は以下のコマンドを実行してください。 -```bash -gemini skills reload -``` +このプロジェクトでは、Gemini CLI のカスタムスキルを直接呼び出すことで制作をサポートします。 -### テンプレートの生成 -Gemini CLI に対して、作りたいジャンルを伝えてください。 -> "Dub Techno のテンプレートを生成して" +### スキルの活用 +Gemini CLI に対して、以下のように話しかけてみて。 -### コードのデバッグ -作成中のコードに問題がある場合や、プロの解説が欲しい場合に依頼してください。 -> "strudel/my_beat.md のエラーを直して解説して" +- **新しいトラックを始めたいとき** + > "Minimal Techno のテンプレートを作って" +- **コードが動かない、または洗練させたいとき** + > "strudel/20260215.md のエラーを直して解説して" -## 🎵 制作のポリシー -- **Initialization**: すべてのコードは `setcps(BPM/60/4)` で開始します。 -- **Modular Control**: 各トラックは `$: ` 記法で独立して制御します。 -- **Clean Syntax**: 休符には `-` を使い、可読性の高いコードを目指します。 +## 🎵 制作のポリシー & 品質管理 + +ボクが生成するコードは、以下のルールと知見に基づいているよ。 + +- **Initialization**: `setcps(BPM/60/4)` で開始し、グリッドの整合性を保つ。 +- **Modular Control**: `$: ` 記法で各トラックを独立させ、ライブ演奏での操作性を確保。 +- **Clean Syntax**: 休符には `-` を使用。 +- **Best Practices**: `PRECAUTIONS.md` に基づき、音源バンクの整合性やフィルターの特性（TB-303スタイルなど）を最適化。 --- Happy Live Coding! 🎛️✨