scribe は何をしますか？
AIコーディングエージェント向けのローカルスキルマネージャー。1つのSKILL.mdをClaude Code、Cursor、Codex、Gemini全体に展開。ロックファイルで固定、プロジェクトスコープ、MITライセンス。
機能
- 統一されたSKILL.md: 単一マークダウンファイルを複数のAIエージェントに投影。
- ロックファイル固定: スキルバージョンを固定し、時間経過による変化を防止。
- プロジェクトスコープ: プロジェクトごとにエージェントの動作を定義。
- クロスプラットフォーム対応: Claude Code、Cursor、Codex、Geminiで動作。
インストール
# npmを使用してグローバルインストール
npm install -g @naoray/scribe
# または、プロジェクトの依存関係としてインストール
npm install --save-dev @naoray/scribe
クイックスタート
- プロジェクトルートに
SKILL.mdを作成：
# プロジェクトスキル
このプロジェクトでは：
- TypeScriptを使用
- Prettierでコードフォーマット
- Vitestでテスト
- スキルを初期化：
scribe init
# これによりプロジェクトスコープの設定とロックファイルが作成されます
- スキルを同期：
scribe sync
# 設定されたすべてのエージェントにSKILL.mdを投影
使い方
スキルの作成
SKILL.mdにエージェントへの指示を記述します。これには以下を含めることができます：
- プロジェクトルールと規約
- 環境設定
- 依存関係
- テストとビルドコマンド
- コーディングスタイルガイドライン
スキルの管理
# 利用可能なコマンドを表示
scribe --help
# 現在のスキル設定を表示
scribe status
# 特定のエージェントを更新
scribe update --agent cursor
# ロックファイルを更新
scribe lock
設定
プロジェクトの.scribercファイル（またはscribe.config.json）で設定可能：
{
"agents": ["claude", "cursor", "codex", "gemini"],
"skillFile": "./SKILL.md",
"lockfile": "./scribelock.json",
"scope": "project"
}
対応エージェント
| エージェント | ステータス |
|---|---|
| Claude Code | ✅ 対応 |
| Cursor | ✅ 対応 |
| Codex | ✅ 対応 |
| Gemini | ✅ 対応 |
ライセンス
MIT
貢献
Issueの報告はお気軽にどうぞ。プルリクエストも歓迎します。