bdg

README内のバッジブロックを安全に検査・管理する場合にbdgを使用します。関連のないコンテンツには触れません。

使用場面

• crates.io、npm、MoonBit、ライセンス、GitHub Actions のバッジを追加する必要がある。
• 変更前に現在管理されているバッジブロックを検査する必要がある。
• ID、種類、または全体でバッジを削除しながら、編集範囲を制限したままにしておく必要がある。

コマンドガイド

bdg add

検出された README の管理ブロックにバッジを追加します。

• bdg add
• bdg add --yes
• bdg add --only ci,version,license
• bdg add --dry-run
• bdg add --json --dry-run

動作:

• Cargo.toml、package.json、または moon.mod.json からプロジェクトメタデータを検出します。
• .github/workflows から GitHub Actions ワークフローを検出します。
• <!-- bdg:begin --> / <!-- bdg:end --> ブロック内のみに書き込みます。
• マーカーブロックがまだ存在しない場合は挿入します。

bdg list

現在の README バッジの状態と検出されたプロジェクトコンテキストを表示します。

• bdg list
• bdg list --json
• bdg list --quiet

動作:

• README パス、マーカーステータス、バッジ数、CI ワークフロー状態をレポートします。
• --json は構造化されたリポジトリ、マニフェスト、レジストリ、CI、管理ブロックデータを出力します。

bdg remove

管理ブロックからバッジを削除します。

• bdg remove
• bdg remove --id ci:rust.yaml
• bdg remove --kind github_actions
• bdg remove --all
• bdg remove --dry-run
• bdg remove --json --dry-run

動作:

• インタラクティブモードでは削除するバッジを選択できます。
• --id と --kind は削除を正確に対象にします。
• --all は管理ブロック全体のコンテンツを削除します。
• --dry-run は書き込みなしで差分を表示します。

bdg skills

このエージェントスキルドキュメントを標準出力に出力します。

別のエージェントまたはツールが標準に準拠した形式で現在のbdg使用コンテキストを必要とする場合に使用します。

制約事項

• bdg はマーカーブロック内のコンテンツのみを管理します。
• bdg は関連のない README セクションを改写しません。
• bdg add と bdg remove はファイルを変更する可能性があります。変更をレビューする必要がある場合は、先に --dry-run を使用してください。
• bdg list と bdg skills は読み取り専用です。

プロジェクト検出

• Rust: Cargo.toml
• Node: package.json
• MoonBit: moon.mod.json

bdg はリポジトリ内の現在のディレクトリから最も一致するマニフェストを選択し、現在のディレクトリから git ルートまで設定を検索します。