mcpField
S
skill-awareness

skill-awareness

github.com/yanko-belovエージェントワークフロー1335 回インストール40 週間前に更新
リポジトリ

skill-awareness について

skill-awarenessは、コード作成スキルの適用を記録するエージェントスキルです。Claude CodeとOpenCodeのセッションをまたぐJSONLログと、スキルの検出・利用状況確認の手順を備えています。

主な機能

  1. 01スキル適用の検出マトリクス
  2. 02永続化するJSONL利用ログ
  3. 03jqによる利用状況分析
  4. 04完了前のログ確認リスト

活用シーン

  1. 01コーディング中に適用したスキルの記録
  2. 02利用の少ない・未使用スキルの確認
  3. 03プロジェクト間のスキル利用状況の比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/yanko-belov/code-craft --skill skill-awareness

インストール後、Claude Code で/skill-awarenessを入力して読み込まれたか確認します。

詳細

スキルの適用状況

概要

スキルを適用するたびに記録し、実践履歴を作成します。

コード作成スキルを適用したら、必ず記録してください。これにより、Claude Code と OpenCode のセッションをまたいだ継続的な記録が作成され、分析や使用頻度の低いスキルの特定、スキル向上の測定に役立ちます。

絶対遵守のルール

ALWAYS log when applying a code-craft skill. No silent applications.

使用ログ

~/.claude/skills/skill-usage.jsonl に JSON を 1 行追加します。

{"ts":"2026-01-22T10:30:00Z","skill":"single-responsibility","agent":"opencode","project":"/path/to/project","ctx":"Split UserManager into UserAuth and UserProfile"}
フィールド値
tsISO 8601 形式のタイムスタンプ
skillスキル名（ケバブケース）
agentclaude-code または opencode
project作業ディレクトリのパス
ctx適用内容の簡単な説明（100 文字未満）

スキル検出マトリクス

作業内容確認するスキル
クラスの作成・変更single-responsibility、open-closed、composition-over-inheritance、encapsulation
継承階層liskov-substitution、composition-over-inheritance
依存関係の追加dependency-inversion、interface-segregation
エラーハンドリングfail-fast、exception-hierarchies、error-boundaries
API エンドポイントの作成rest-conventions、error-responses、api-versioning、idempotency、input-validation
データベースクエリn-plus-one-prevention、caching、lazy-loading
テストの作成tdd、test-isolation、aaa-pattern
シークレット／認証の取り扱いsecrets-handling、auth-patterns、input-validation
並行処理race-conditions、deadlock-prevention、idempotency
コードのコピー＆ペーストdry
「将来のため」の機能追加yagni、kiss
複雑なロジックkiss、separation-of-concerns、law-of-demeter
状態の変更immutability、encapsulation

記録プロトコル

スキルを適用した後：

echo '{"ts":"'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'","skill":"SKILL_NAME","agent":"AGENT","project":"PROJECT_PATH","ctx":"BRIEF_CONTEXT"}' >> ~/.claude/skills/skill-usage.jsonl

分析コマンド

使用回数の合計を表示：

cat ~/.claude/skills/skill-usage.jsonl | jq -s 'group_by(.skill) | map({skill: .[0].skill, count: length}) | sort_by(-.count)'

最近の適用状況：

tail -20 ~/.claude/skills/skill-usage.jsonl | jq .

使用頻度の低いスキル（適用回数が 3 回未満）：

cat ~/.claude/skills/skill-usage.jsonl | jq -s 'group_by(.skill) | map({skill: .[0].skill, count: length}) | map(select(.count < 3))'

未使用のスキル：

# Compare logged skills against all 31
comm -23 <(ls ~/.claude/skills/ | grep -v '\.' | sort) <(cat ~/.claude/skills/skill-usage.jsonl | jq -r '.skill' | sort -u)

プロジェクト別の使用状況：

cat ~/.claude/skills/skill-usage.jsonl | jq -s 'group_by(.project) | map({project: .[0].project, skills: (group_by(.skill) | map({skill: .[0].skill, count: length}))})'

利用可能なスキル一覧

SOLID（5）

single-responsibility、open-closed、liskov-substitution、interface-segregation、dependency-inversion

コア（6）

dry、yagni、kiss、composition-over-inheritance、law-of-demeter、fail-fast

テスト（3）

tdd、test-isolation、aaa-pattern

セキュリティ（3）

input-validation、secrets-handling、auth-patterns

API 設計（4）

rest-conventions、error-responses、idempotency、api-versioning

パフォーマンス（3）

n-plus-one-prevention、lazy-loading、caching

コード品質（3）

separation-of-concerns、encapsulation、immutability

エラーハンドリング（2）

exception-hierarchies、error-boundaries

並行処理（2）

race-conditions、deadlock-prevention

完了前チェックリスト

コーディングタスクを終える前に、次の点を確認してください。

  1. 検出マトリクスのどのスキルが当てはまりましたか？
  2. それらに従いましたか？
  3. 適用したスキルをすべて記録しましたか？
  4. ユーザーに伝えるべき違反事項はありますか？

要点

スキルを適用するたびに必ず記録します。例外はありません。

これにより実践履歴が蓄積され、見落としている点が明らかになり、継続的な改善が可能になります。スキルが当てはまるかどうか判断に迷った場合は、迷いがあることを記して記録してください。

コメント

Markdown 対応