mcpField
U
using-skills

using-skills

github.com/joellewisエージェントワークフロー740 回インストール30 週間前に更新
リポジトリ

using-skills について

using-skills は、応答前に関連スキルを確認し、選択したスキルの手順に従うエージェントスキルです。一貫した確認プロセスを設けたい場合に使えます。

主な機能

  1. 01スキル分類の確認
  2. 02適用可能性 1% ルール
  3. 03利用前のスキル提案
  4. 04状態機械に沿った実行

活用シーン

  1. 01新しい依頼を受けた際のスキル確認
  2. 02プロジェクトの段階変更時の再評価
  3. 03進め方に迷った際の手順整理

インストール

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

$npx skills add https://github.com/joellewis/skill-library --skill using-skills

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

詳細

概要

このスキルは、スキル呼び出しの規律を徹底し、エージェントがワークフローを省略したり、利用可能なフレームワークを使わない理由をこじつけたりすることを防ぎます。これは、AI の過信や逸脱に対する中核的な防御メカニズムです。

鉄の掟

IF THERE IS EVEN A 1% CHANCE A SKILL APPLIES, INVOKE IT AI モデルは、参照資料を確認するよりも、すぐに生成する傾向があります。このルールは「一旦立ち止まって確認する」行動を促し、質の低い、根拠のない出力を防ぎます。

ステートマシン

digraph using_skills_flow {
    "Task Received" [shape=doublecircle];
    "Step 1: Check Skill Database" [shape=box];
    "Decision: Is it ≥ 1%?" [shape=diamond];
    "Step 2: Propose Skill to User" [shape=box];
    "Step 3: Apply Skill Logic" [shape=box];
    "Done" [shape=doublecircle];

    "Task Received" -> "Step 1: Check Skill Database";
    "Step 1: Check Skill Database" -> "Decision: Is it ≥ 1%?";
    "Decision: Is it ≥ 1%?" -> "Step 2: Propose Skill to User" [label="yes"];
    "Decision: Is it ≥ 1%?" -> "Done" [label="no"];
    "Step 2: Propose Skill to User" -> "Step 3: Apply Skill Logic";
    "Step 3: Apply Skill Logic" -> "Done";
}

このスキルを使用する場面

  • 新しいリクエストを受け取ったときはいつでも。
  • 進行中のプロジェクトが新しいフェーズに移行するとき（例：分析から成果物作成へ）。
  • 適切なアプローチを「推測」していることに気づいたとき。

このスキルを使用しない場面

  • 戦略的または創造的な要素を伴わない、単純で事実に基づく確認。
  • 基本的な日常会話。

基本プロセス

ステップ 1：適用可能なスキルを確認する

6 つのファミリーにまたがる 41 個のスキルの分類を確認します。記憶に頼らず、分類を使って該当する可能性のあるスキルを特定してください。（出典：システム設計）

ステップ 2：1％ルールを適用する

「[スキル名] がこのタスクの成果を向上させる可能性が、たとえ 1％でもありますか？」と自問します。該当する場合は、そのスキルに必ず言及してください。（出典：システム設計）

ステップ 3：ユーザーに選択肢を提示する

どのスキルが適用されるか、またそれがどのような価値をもたらすかを明確に伝えます。ユーザーに代わって決定せず、専門家としての推奨として提示してください。（出典：システム設計）

ステップ 4：徹底して実行する

スキルが選択されたら、例外なくそのステートマシンと鉄の掟に従わなければなりません。（出典：システム設計）

スキル間の呼び出し

必須のサブスキル：getting-started — 初回セッションのコンテキスト設定に使用します。 推奨されるサブスキル：prompt-optimizer — 他のスキルの呼び出しを改善するために使用します。

正当化の一覧

考え実態
「ユーザーはスキルを求めていないので、使わない。」ユーザーは利用可能なスキルを知らない可能性があります。スキルを推奨するのはあなたの役目です。
「このタスクはスキルの説明と少し異なる。」1％ルールを適用してください。一部でも一致すれば、何も使わないよりも優れた構成が得られます。
「すでに 3 つのスキルを使ったので、これ以上加えると複雑になりすぎる。」複雑な問題には、複雑さが必要な場合がよくあります。
「スキルを正式に呼び出さなくても、その 原則 だけ適用できる。」ステートマシンと鉄の掟が確実に守られるのは、正式に呼び出した場合のみです。

危険信号

次のように考えたら、作業を止めてください。近道をしようとしています。

  • 「今回は手作業で対応しよう」→ 1％ルールを避けようとしています。
  • 「この小さなリクエストにこのスキルは大げさすぎる」→ 小さなリクエストこそ、フレームワークによって隠れた誤りを最も発見しやすい場面です。
  • 「そのスキルの参照資料が手元にない」→ 抽出手法を使って見つける必要があります。

診断チェックリスト

  • このタスクについて、41 個のスキルの全リストを確認しましたか？
  • 1％ルールを正しく適用しましたか？
  • 推奨するスキルの「理由」を説明しましたか？
  • 呼び出したスキルのステートマシンに従っていますか？
  • 「即興で済ませる」衝動を抑えましたか？

出典

  • システム設計 — 1％ルール。
  • システム設計 — 正当化への防御。
  • システム設計 — 鉄の掟の登録簿。

コメント

Markdown 対応