スキルビル：AIコーディングスキルのためのマークダウンベースのガバナンスフレームワーク

Skill Billとは

Skill Billは、完全にMarkdownで構築されたAIコーディングスキルのガバナンスフレームワークです。これは、開発者が複数のAIエージェントにまたがる複数のプロンプトを管理する際に直面する一般的な問題、つまり命名のずれ、重複ロジック、プラットフォーム固有のコードが汎用スキルに侵入すること、そして単一の信頼できる情報源の欠如に対処します。

始まり

開発者は、特定のタスク向けの個別スキルから始めました：Android/KMP作業用のコードレビュープロンプト、問題を抑制するのではなく修正するための慣例を持つgradle checkスキル、feature flagスキル、そして設計ドキュメントから機能を実装するスキルです。約12のスキルがエージェント間で散在した後、彼らは一貫性のない命名や、本来は汎用であるはずのスキルにKotlin固有のロジックが現れるという「よくある腐敗」を経験しました。

オーケストレーターの突破口

重要な革新は、他のスキルを順番に呼び出すfeature-implementというスキルを作成したことです。このオーケストレーターは、設計ドキュメントを受け取り、計画を作成し、機能フラグ戦略について尋ね、コードを実装し、レビューを実行し、完全性をチェックします。単一のfeature-implement実行は、10〜12のスキル呼び出しを連鎖させます：オーケストレーター、スタック検出コードレビュールーター、並行して実行される3〜5の専門家レビュアー、品質チェック、PR説明、そしてオプションの機能フラグ設定です。

コスト考慮事項

開発者はClaude CodeのMaxサブスクリプションを使用しており、当初は使用コストを考慮していませんでした。しかし、Codex Proサブスクリプションを使用している友人から、単一のcode-reviewスキル呼び出し（完全な連鎖ではなく）だけで、5時間のProレート制限の40〜50%を消費すると報告されました。Copilotは異なる課金モデル（トークン量ではなく会話ターンごと）を使用しているため、このアプローチではよりコスト効率が良くなります。

技術アーキテクチャ

このフレームワークは、コードのように機能する構造化されたMarkdownを通じて、複数のプログラミング言語をサポートするように進化しました：

• 継承：プラットフォームオーバーライド付きの基本スキル
• ルーティングロジック：スタック検出と適切な専門家への委譲
• インターフェース契約：スキル間の定義された関係
• 検証：命名規則と構造を強制してリポジトリの腐敗を防止

基本レイヤーが適切に汎用化された後、PHPサポートの追加は簡単で、続いてGoが追加されました。このフレームワークには現在、Kotlin、Android/KMP、Kotlinバックエンド、PHP、Go向けの44のスキルが含まれています。

主な機能

• 適切なプラットフォーム専門家に自動的にルーティングする基本スキル
• 命名規則と構造を強制するバリデーター
• Claude Code、Copilot、GLM、Codexと同期する単一リポジトリ
• feature-implementのような、すべてをエンドツーエンドで連鎖させるオーケストレータースキル
• 現在はKotlinファミリーとGo/PHPバックエンドで最も強力ですが、新しいプラットフォームに拡張するように設計されています

実用的な意味合い

開発者は、プロンプトリポジトリが通常のソフトウェアと同じエンジニアリング問題を持つことを発見しました。スキルを契約、検証、構成可能性を持つコードのように扱うことで、システム全体が劇的に保守しやすくなりました。このフレームワークは、MITライセンスの下でGitHubで利用可能です：https://github.com/Sermilion/skill-bill。