
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 AIアシスタントには「悪い記憶」はありません。彼らには があります。 悪いガバナンス あなたはそれを見たことがあります: 
 
 
 
 あなたは注意深いアーキテクチャガイドを書きました。モデルはそれを無視します。 あなたは「4層アーキテクチャ」と言いました。それは3層を出力します。 あなたは「 なし」と言いました。それは を、あなたに親切にしているかのようにドロップします。 el-input <el-input v-model="value" /> これは知性に関するものではありません。インセンティブに関するものです。 Claude Codeでは、 であり、ハード制約ではありません。Claudeがスキルを呼び出さずに回答できると「感じた」場合、そうします。そして 。 スキルは利用可能なコンテキスト あなたのプロジェクトハンドブックは装飾になります 私たちのチームでは、Claude Codeを使用してRuoYi-Plusコードベースを構築し、それを追跡しました: 
 
 介入なしでは、Claudeはプロジェクトスキルを積極的にアクティブにしたのは約25%でした。 つまり、4回に3回は、あなたの「ルール」はルールではありません。それは提案です。 私たちはもっと厳格なものを望んでいました。Claudeが賢いインターンよりも、コードを書く前にプレイブックを読むスタッフエンジニアのように振る舞うメカニズムです。 修正は、より多くのプロンプトではありませんでした。 修正は でした。 フック 約1か月のイテレーションの後、 構成スタックをリリースしました: .claude 
 
 
 
 
 （ガバナンス） 4つのライフサイクルフック （知識） 26のドメインスキル （プロセスオーケストレーション） スラッシュコマンド （並列スペシャリスト） エージェント 結果: 
 
  ルール違反のコードが少なくなり、「やり直してください」というサイクルが減り、リスクのあるツールアクションがはるかに少なくなりました。 開発タスクのスキルアクティブ化: 約25% → 90%以上 この記事では、アーキテクチャを分解して、独自のレポで再現できるようにします。 1) Claude Code がスキルを忘れる理由: スキルはデフォルトでオプトインです Claude Code のデフォルトフローは次のようになります: ユーザープロンプト → Claudeが回答（スキルを呼び出す場合も、そうでない場合もあります）
 その「場合」が問題です。 Claude の内部決定ヒューリスティックは通常次のようになります: 
 
 
 「追加のコンテキストなしで迅速に回答できますか？」 「リポジトリのルールに従わなければなりませんか？」ではありません。 そのため、システムは利便性に向かってドリフトします。 あなたが望むのは です。Claude が推論を開始する前に実行され、毎回作業を形成する軽量な「制御プレーン」です。 制度的な摩擦 2) ブレークスルー: 強制的なスキル評価フック 私たちは最も早い瞬間に発火するフックを実装しました:  。 UserPromptSubmit Claude が何かをする前に表示される短いポリシーブロックを出力します: 
 
 
 
 各スキルを評価: はい/いいえ + 理由 「はい」がある場合: スキルをすぐに呼び出す その後のみ: 実装に進む 「強制評価」フック（コアロジック） 意図的に愚かで決定論的なものに保ちます: 
 
 
 スラッシュコマンドを検出する（エスケープハッチ） そうでなければ、評価プロトコルを出力する // .claude/hooks/skill-forced-eval.js (コアアイデア、簡略化)
const prompt = process.env.CLAUDE_USER_PROMPT ?? "";
​
// エスケープハッチ: ユーザーがスラッシュコマンドを呼び出した場合、強制評価をスキップする
const isSlash = /^\/[^\s/]+/.test(prompt.trim());
if (isSlash) process.exit(0);
​
const skills = [
  "crud-development",
  "api-development",
  "database-ops",
  "ui-pc",
  "ui-mobile",
  // ... 続ける (26個あります)
];
​
const instructions = [
  "## Mandatory Skill Activation Protocol (MUST FOLLOW)",
  "",
  "### Step 1 — Evaluate",
  "EACH skill について、次のように出力してください: [skill] — Yes/No — Reason",
  "",
  "### Step 2 — Activate",
  "いずれかのスキルが Yes の場合 → すぐに Skill(<name>) を呼び出してください。",
  "すべて No の場合 → 'No skills needed' と表示して続行してください。",
  "",
  "### Step 3 — Implement",
  "Step 2 が完了した後のみ、実際の実装を開始してください。",
  "",
  "利用可能なスキル:",
  ...skills.map(s => `- ${s}`)
].join("\n");
​
console.log(instructions);
 実践で何が変わるか 前（フックなし）: 
 
 「クーポン管理を構築してください。」 Claudeはコーディングを開始します…そして、あなたの4層アーキテクチャや禁止コンポーネントを無視します。 後（強制評価フックあり）: Claudeは最初に明示的な決定テーブルを作成し、スキルをアクティブ化してから実装する必要があります。 行動の変化は劇的です。「オプションのコンプライアンス」を排除しているためです。 3) なぜ90%で100%ではないのか? 意図的に を追加したためです。 高速パス ユーザーが何をしたいかを知っていて、次のようなコマンドを入力した場合: 
 
 
 
 /dev build coupon management /crud b_coupon /check 即座に実行されるはずです。そのため、フックはスラッシュコマンドの評価をスキップし、コマンドワークフローが引き継ぐようにします。 それがトレードオフです: 
 
 
 自由形式のプロンプトのためのガバナンス 構造化されたコマンドのためのスピード 4) フック: ライフサイクル制御プレーン (4フックスタック) フックをエージェントセッションのCIパイプラインと考えてください。ただし、リアルタイムでターミナルで実行されます。 4つの主要なポイントを使用します: 4.1 SessionStart: 「話す前にリポジトリを見る」 セッションが開始されると、次を表示します: 
 
 
 
 
 現在のgitブランチ 未コミットの変更 開いているTODO / ステータス 一般的なコマンド 出力例: 🚀 Session started: RuoYi-Plus-Uniapp
Time: 2026-02-16 21:14
Branch: master
​
⚠️ Uncommitted changes: 5 files
📋 TODO: 3 open / 12 done
​
Shortcuts:
  /dev    build feature
  /crud   generate module
  /check  verify conventions
  Claudeは、空の部屋に入るかのように振る舞うのをやめます。 なぜ重要か: 4.2 UserPromptSubmit: 強制スキル評価（規律） これは「ハンドブックを読まなければならない」ゲートです。 4.3 PreToolUse: セーフティレイヤー（ツールガバナンス） Claude Codeは、Bashを実行したり、ファイルを書き込んだり、コードを編集したりできるため強力です。 それは事故が起こる方法でもあります。 PreToolUseは、不可逆的な何かが起こる前の最後の防御線です。 小さなブラックリストをブロックし（より広いグレイスリストで警告します）: // .claude/hooks/pre-tool-use.js (概念)
const cmd = process.env.CLAUDE_TOOL_INPUT ?? "";
​
const hardBlock = [
  /rm\s+(-rf|--recursive).*\s+\//i,
  /drop\s+(database|table)\b/i,
  />\s*\/dev\/sd[a-z]\b/i,
];
​
if (hardBlock.some(p => p.test(cmd))) {
  console.log(JSON.stringify({
    decision: "block",
    reason: "Dangerous command pattern detected"
  }));
  process.exit(0);
}
​
// オプション: 機密性の高いアクション（一括削除、chmod -Rなど）について警告/確認する
 これはパラノイアではありません。モデルが間違ったディレクトリで を使用して「一時ファイルをクリーンアップ」するのを見たことがあります。モデルが注意深さに依存しないガードレールが欲しいのです。 rm -rf 4.4 Stop: 次のステップガイダンスで「ループを閉じる」 Claude が終了すると、次を行います: 
 
 
 
 ファイル変更の概要（新規 vs 変更済み） 次のアクションの提案（テストの実行、ドキュメントの更新、コミット） オプションでエージェントをトリガーする（コードレビュー） 例: ✅ Done — 8 files changed
​
Next steps:
- @code-reviewer for backend conventions
- SQL changed: sync migration scripts
- Consider: git commit -m "feat: coupon module"
 目標: 「チャットでうまくいった」ギャップをなくすことです。 5) スキル: 実際に強制できる知識レイヤー アクティブ化が決定論的になると、スキルは本来あるべき姿になります。つまり、 です。 ドメイン固有の知識ベース 26のスキルを構築しました: 
 
 
 
 
 
 
 バックエンド（CRUD、API、DB、アノテーション、エラー処理） フロントエンド（PCコンポーネントポリシー、状態管理） モバイル（UIキット、uniappプラットフォーム制約） 統合（支払い、WeChat、OSS） 品質（パフォーマンス、セキュリティ、バグ検出） エンジニアリング管理（アーキテクチャ、gitワークフロー、技術決定） スケーリングするスキルファイル構造 すべての は同じスケルトンに従います: SKILL.md # Skill Name
​
## When to trigger
- Keywords:
- Scenarios:
​
## Core rules
### Rule 1
Explanation + example
​
### Rule 2
Explanation + example
​
## Forbidden
- ❌ ...
​
## Reference code
- path/to/file
​
## Checklist
- [ ] ...
 この一貫性は、モデルがスキルの を学習するため重要です。 消費方法 6) コマンド: ワークフロー、提案ではない スキルは「何が正しいか」を解決します。 コマンドは「プロセスとは何か」を解決します。 6.1  : 7段階の開発パイプライン /dev を意見のあるワークフローとして設計しました: /dev 
 
 
 
 
 
 
 
 要件の明確化 設計（API + モジュール + パーミッション） DB設計（SQL + ディクショナリ + メニュー） バックエンド（4層出力） フロントエンド（コンポーネントポリシー + ルーティング） テスト/検証 ドキュメント/進捗更新 それは基本的に、「シニアがジュニアにどのように働いてほしいか」を、実行可能なスクリプトとしてエンコードしたものです。 6.2  : テーブルから完全なモジュールを生成 /crud 入力: /crud b_coupon
 出力（例）: 
 
 
 
 
 
 エンティティ / BO / VO DAO + クエリラッパーのルール サービス + コントローラー（禁止パターンなし） マッパー フロントエンドAPI + ページスキャフォールド 手動作業:   コマンド駆動:  （レビュー込み） 2〜4時間 5〜10分 6.3  : フルスタック規約リンティング（人間が読める） /check ここでスキルを検証体に変換します: 
 
 
 
 バックエンド: レイヤリングルール、禁止されている継承、クエリラッパーポリシー フロントエンド: 禁止されているコンポーネント、ラッパーの使用 モバイル: コンポーネントキット、ユニット、インポート 7) エージェント: 並列スペシャリスト（メインスレッドを過負荷にしない） 一部のタスクは、専用のサブエージェントによって処理されるべきです: 
 
 
 : 厳格なチェックリストによる規約チェック @code-reviewer : ステータスドキュメント、TODO、進捗メトリクスを更新 @project-manager 利点は「より多くの知性」ではありません。それは と、メインセッションでのコンテキスト汚染の削減です。 関心の分離 実践的なパターン: 
 
 
 
 
 メインエージェントがコードを生成します Stopフックがレビューを提案します を呼び出します @code-reviewer レビュー担当者は構造化されたdiff + 修正リストを返します 8) フルシステム: ガバナンス+知識+プロセス+分業 これが1文でのアーキテクチャです: 
 
 フックは動作を強制し、スキルは基準を提供し、コマンドはワークフローをエンコードし、エージェントは並列専門知識を処理します。 そしてはい、これは「汎用AIアシスタント」を「リポジトリネイティブのチームメイト」に変える方法です。 9) 最小限の再現可能なセットアップ（コピー＆ペーストフレンドリー） それでも機能する最小バージョンが必要な場合は、次のように構築してください: .claude/
  settings.json
  hooks/
    skill-forced-eval.js
    pre-tool-use.js
  skills/
    crud-development/
      SKILL.md
 最小 （UserPromptSubmitフック） settings.json {
  "hooks": {
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/skill-forced-eval.js"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "node .claude/hooks/pre-tool-use.js"
          }
        ]
      }
    ]
  }
}
 その後、イテレートします: 
 
 
 
 
 
 SessionStartを追加 Stopを追加 繰り返し発生する「間違った行動」を検出したときにのみスキルを成長させる 繰り返しのワークフローをコマンドとしてエンコードする レビュー/PMタスクをエージェントにオフロードする クロージング: 「能力」はボトルネックではありません —  がボトルネックです アクティベーション あなたのモデルはすでに有能です。 欠けているのは、 です。 正しい行動を自動化するシステム ハンドブックのないスマートな新入社員はフリースタイルします。ハンドブックのあるスマートな新入社員: 
 
 
 
 
 強制チェックリスト 明確な禁止パターン 繰り返し可能なワークフロー レビューとPMの専門家 …は、すぐに一貫性のあるものになります。 Claudeも同じです。

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Branch

Read My Stories

このオーディオは、ストーリーの元の言語で制作されています。

Hooks、Skills、Agents を使用して Claude コードのガバナンスレイヤーを構築する方法

About Author

コメント

ラベル

この記事は

Related Stories

AI の力を解き放つ。最先端技術の体系的レビュー: 概要と序論

ユーザー中心の暗号通貨製品の作成: 顧客からのフィードバックの重要性

クラウド移行を成功させるための完全ガイド: 戦略とベストプラクティス

暗号通貨の成長: 効果的なユーザーペルソナの作成

AI の力を解き放つ。最先端技術の体系的レビュー: 概要と序論

ユーザー中心の暗号通貨製品の作成: 顧客からのフィードバックの重要性

クラウド移行を成功させるための完全ガイド: 戦略とベストプラクティス

暗号通貨の成長: 効果的なユーザーペルソナの作成

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps