skill-discovery について
skill-discovery は、スキルフレームワークを使うエージェントや開発者向けのプロセススキルです。作業前に関連スキルを確認し、複数ある場合は種類に応じて優先順位を付ける方法を示します。
主な機能
- 01タスク開始前のスキル確認を規定
- 02Claude Code でのスキル利用方法を説明
- 03プロセス系と実装系の優先順位付け
- 04厳格型と柔軟型のスキルを区別
活用シーン
- 01作業開始前に該当スキルを確認
- 02Claude Code でスキルの指示を読み込む
- 03複数のスキルが該当する際の順序決定
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ oimiragieo/ agent-studio --skill skill-discoveryインストール後、Claude Code で/skill-discoveryを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
commands/skill-discovery.mdhooks/post-execute.cjspre-execute.cjsreferences/research-requirements.mdrules/skill-discovery.mdschemas/input.schema.jsonoutput.schema.jsonscripts/main.cjstemplates/implementation-template.md詳細
タスクにスキルが適用される場合、選択の余地はありません。必ず使用してください。
これは交渉の余地も、任意の選択肢もありません。自分に都合よく解釈して回避することはできません。
スキルへのアクセス方法
Claude Code の場合: Skill ツールを使用するか、スキルファイルを直接読み取ってください。スキルを呼び出すと、その内容が読み込まれて提示されるので、内容に従ってください。
その他の環境の場合: スキルの読み込み方法について、使用しているプラットフォームのドキュメントを確認してください。
フレームワークスキルの使用
ルール
回答や操作を行う前に、関連するスキル、または要求されたスキルを呼び出してください。 スキルが適用される可能性が少しでも(1%でも)ある場合は、確認するために呼び出してください。呼び出したスキルが状況に合わないと分かった場合は、使用する必要はありません。
digraph skill_flow {
"User message received" [shape=doublecircle];
"Might any skill apply?" [shape=diamond];
"Invoke Skill tool" [shape=box];
"Announce: 'Using [skill] to [purpose]'" [shape=box];
"Has checklist?" [shape=diamond];
"Create TodoWrite todo per item" [shape=box];
"Follow skill exactly" [shape=box];
"Respond (including clarifications)" [shape=doublecircle];
"User message received" -> "Might any skill apply?";
"Might any skill apply?" -> "Invoke Skill tool" [label="yes, even 1%"];
"Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
"Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
"Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
"Has checklist?" -> "Create TodoWrite todo per item" [label="yes"];
"Has checklist?" -> "Follow skill exactly" [label="no"];
"Create TodoWrite todo per item" -> "Follow skill exactly";
}
注意すべき兆候
次のように考えたら、立ち止まってください。これは都合のよい解釈です。
| 考え | 実際のところ |
|---|---|
| 「これは単純な質問にすぎない」 | 質問もタスクです。スキルを確認してください。 |
| 「まずコンテキストを詳しく知る必要がある」 | 確認の質問をする前に、スキルを確認してください。 |
| 「先にコードベースを調べよう」 | スキルは調査方法を教えてくれます。まず確認してください。 |
| 「git/ファイルをすぐに確認できる」 | ファイルには会話のコンテキストがありません。スキルを確認してください。 |
| 「まず情報を集めよう」 | スキルは情報収集の方法を教えてくれます。 |
| 「正式なスキルは必要ない」 | スキルがあるなら、使用してください。 |
| 「このスキルは覚えている」 | スキルは更新されます。最新の内容を読んでください。 |
| 「これはタスクには当たらない」 | 操作はタスクです。スキルを確認してください。 |
| 「スキルは大げさすぎる」 | 単純なことが複雑になることもあります。スキルを使用してください。 |
| 「これだけ先にやってしまおう」 | 何をするにも、先に確認してください。 |
| 「これは効率的に感じる」 | 無計画な操作は時間を浪費します。スキルはそれを防ぎます。 |
| 「意味は分かっている」 | 概念を知っていることと、スキルを使用することは別です。スキルを呼び出してください。 |
スキルの優先順位
複数のスキルが適用される可能性がある場合は、次の順序で使用してください。
- プロセススキルを最初に(ブレインストーミング、デバッグ)— これらはタスクの進め方を決めます
- 実装スキルを次に(frontend-design、mcp-builder)— これらは実行方法を示します
「X を作ろう」→ まずブレインストーミング、その後に実装スキル。 「このバグを修正して」→ まずデバッグ、その後に対象分野のスキル。
スキルの種類
厳格なスキル(TDD、デバッグ):厳密に従ってください。規律を緩めないでください。
柔軟なスキル(パターン):原則を状況に合わせて適用してください。
どちらに当たるかは、スキル自体に記載されています。
ユーザーの指示
指示は「何を」行うかを示すものであり、「どのように」行うかを示すものではありません。「X を追加して」や「Y を修正して」と言われても、ワークフローを省略してよいわけではありません。
メモリプロトコル(必須)
開始前:
.claude/context/memory/learnings.md を読み取ってください
完了後:
- 新しいパターン →
.claude/context/memory/learnings.md - 見つかった問題 →
.claude/context/memory/issues.md - 決定事項 →
.claude/context/memory/decisions.md
中断されることを前提にしてください。メモリに記録されていないことは、行われていないのと同じです。