Skip to content

About

AI Fluency - Score your AI collaboration style across 5 axes

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

AI Fluency

GitHub プロフィールに貼れる「AI活用力」のスコアカード生成ツール。

AI エージェントとの協働スタイルを5軸でスコアリングし、SVGカードと能力シートを出力します。評価軸はエージェント共通の設計ですが、現時点では Claude Code のセッション分析データ(/insights で生成)に対応しています。

カード例

AI Fluency Card

前提条件

現在の対応エージェント: Claude Code

  • Claude Code がインストール済みであること
  • Claude Code でのセッション履歴があること(分析対象データとして必要)

他の AI エージェントへの対応は今後追加予定です。

試してみる

1. リポジトリをクローンしてセットアップ

git clone https://github.com/suruseas/ai-fluency.git
cd ai-fluency
npm install

2. facets データを生成する

Claude Code で /insights を実行してください。セッション履歴が分析され、~/.claude/usage-data/facets/ に facets データ(JSON)が生成されます。

claude> /insights

Note: facets データがない状態では以降のステップは実行できません。

3. スコアカードを生成する

クローンしたディレクトリで Claude Code を起動し、/ai-fluency を実行します。

cd ai-fluency
claude
claude> /ai-fluency

直近3ヶ月分のデータを対象に、スコア算出からカード・能力シートの生成まですべて自動で行われます。

手動で実行する場合

# 定量スコアのみ算出(output/scores.json に出力)
npm run score

# SVG カードを生成(output/card-dark.svg, card-light.svg)
npm run card:ja     # 日本語版
npm run card        # 英語版(デフォルト)

# 能力シートを生成(output/profile.md)
npm run profile:ja  # 日本語版
npm run profile     # 英語版(デフォルト)

生成物はすべて output/ ディレクトリに出力されます。

注意: 生成物にはプロジェクト固有の情報は仕組み上含まれませんが、output/profile.md に機密情報が出力されていないことを公開前にご確認ください。

3. README に埋め込む

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/suruseas/ai-fluency/main/output/card-dark.svg">
  <img src="https://raw.githubusercontent.com/suruseas/ai-fluency/main/output/card-light.svg" alt="AI Fluency">
</picture>

スコアについて

スコアの一部(定性評価)は AI がセッション内容を読み取って判定しています。そのため以下の点にご注意ください。

  • 再現性はありません — 同じデータでも実行ごとにスコアが多少変動します
  • 他のユーザーとの比較はあくまで参考です — 共通のルーブリック(採点基準)はありますが、完全に同じ尺度ではありません
  • スコアは絶対的な数値ではありません — 「80点だから優秀」ではなく、5軸のバランスを見ることに意味があります
  • スタイル類型は5軸のバランスから判定されます — スコアの高低ではなく、どの軸が突出しているかで決まります

5つの測定軸

軸 説明 重み
Context Design (文脈設計力) AIが最高の出力を出せる環境を設計する力 0.25
Precision (指示精度) 少ないやりとりで的確にAIを動かす力 0.20
Steering (修正力) AIの出力を正しい方向に導き、品質を判断する力 0.20
Output (遂行力) AIとの協働で実際に価値を生み出す力 0.20
Breadth (応用力) AIの能力を多面的に引き出す力 0.15

16のスタイル類型

レーダーチャートの形状からスタイルを判定。優劣ではなく個性として表示。

Balance — The Virtuoso(万能家)

スタイル 説明
The Virtuoso(万能家) 全方位型。あらゆる面で高水準

Primary Types — 1軸が突出

スタイル 突出軸 説明
The Architect(設計者) Context Design 環境設計の達人。AIが働きやすい基盤を作る
The Sniper(狙撃手) Precision 一撃必殺。最小の指示で最大の成果を引き出す
The Navigator(航海士) Steering 修正の名手。AIを巧みに正しい方向へ導く
The Executor(実行者) Output 遂行者。AIと組んで確実に成果を出す
The Explorer(開拓者) Breadth 開拓者。AIの新しい使い方を切り拓く

Hybrid Types — 2軸が突出

スタイル 突出軸 説明
The Commander(司令官) Context Design + Steering 環境を整え、AIを的確に指揮する
The Craftsman(職人) Precision + Output 精密な指示で確実に仕上げる
The Pioneer(先駆者) Precision + Breadth 新領域を的確に攻略する
The Conductor(指揮者) Steering + Breadth 多様なAIを巧みにオーケストレーションする
The Strategist(戦略家) Context Design + Output 基盤設計から成果まで一直線
The Alchemist(錬金術師) Context Design + Breadth あらゆるAIの力を引き出す環境を作る
The Mentor(指導者) Context Design + Precision 完璧な文脈と的確な指示でAIを導く
The Captain(船長) Steering + Output 舵を取りながら確実に目的地へ届ける
The Surgeon(外科医) Precision + Steering 精密な指示と繊細な修正で難題を解く
The Polymath(博学者) Output + Breadth 多方面で成果を出し続ける万能型

ライセンス

MIT

About

AI Fluency - Score your AI collaboration style across 5 axes

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages