RepoIntermediate

Sentinel: あなたのAIが書いたコードをレビューし、修正まで届ける番人

AIで構築するとき、そのスピードにはリスクが隠れている。AIは「構築モード」で書く——楽観的で、すべてうまくいくと思い込み、自分自身のバグには気づけない。git に流れ込んでしまうシークレット、別の顧客のデータが見えてしまうクエリ、キーボードユーザーが押せないボタン。Sentinelはあなたのエージェントにインストールする番人で、コードを18の観点でレビューする。そして他のすべてとの違いは圧倒的だ——問題を指摘するだけでなく、最小限の修正とそれが再発しないためのテストまで届ける。無料、GitHubに住み、ここではいつ使うべきか、なぜ重要か、そしてワンコマンドでのインストール方法を教える。

Jun 25, 202612 min

これは誰のため?

AIでソフトウェアを構築するすべての人のため——プログラミングができなくても大丈夫。AIにアプリやバックエンド、関数を作ってほしいと頼むと、AIはあなたの代わりにコードを書いてくれる…が、穴を残していないかを誰もレビューしない。この recurso は、それをちゃんとレビューしてくれる番人を無料で提供し、わかりやすい言葉で説明する。セキュリティを理解する必要はない。番人があなたの代わりに理解してくれる。

1. その瞬間: AIがあなたのレビュー速度より速く書くとき

その瞬間はいつも同じようにやってくる。AIに「アプリのログインを作って」と頼むと、30秒で動くコードが手に入る。試してみると、入れる、動く。次の機能へ。そのまた次へ。AIは、人間のあなたが1行ずつ監査できない速度で生産する。それこそが、静かなリスクが現れる正確な瞬間だ。

なぜなら、AIは疑い深い監査人のようには書かないからだ。AIが書くのは、私たちが「構築モード」と呼ぶもの: 楽観的で、たった一つのハッピーパスを想像し、「動けばいい」に集中している。そしてそのモードでは、AIは物理的に自分自身のバグを見ることができない——ちょうどあなたが自分をくすぐれないのと同じだ。コードは走る、確かに。でも「走る」と「安全である」は別物だ。

こう想像してみて

構築とは、宴会を出すために急いで料理するようなもの: 皿を出すことに集中していて、ガスを開けっぱなしにしたかどうかは気にしていない。監査は正反対の思考だ: 空っぽの冷えたキッチンに入り、何が燃えうるかを探す。この二つの脳は両立しない。Sentinelは二つ目の脳——料理中のあなたには見えなかった開けっぱなしのガスを、後から懐中電灯を持って探しに入る脳だ。

2. 痛み: AIが見えないバグこそ最も高くつく

痛みは現実で、正直なものだ——黙示録ではなく、高い代償を払う事故だ。これらは、AIが意図せず何度も何度も残す古典的な欠陥だ:

「構築モード」が見えないもの

シークレット(APIキー、パスワード)がコードに直接書かれ、gitにアップされる——後で消しても、そこには永遠に残る。

ユーザーごとのフィルタリングを忘れたデータベースクエリ → ある顧客が別の顧客のデータを見られる。複数ユーザーのあるアプリで最も高くつく欠陥。

アクセス保護のないエンドポイント: URLさえ知っていれば誰でも入れる。

マウスでは動くが、キーボードやスクリーンリーダーで操作する人には見えないボタン(アクセシビリティの欠陥、時には法律違反)。

個人データ(メール、電話番号)が意図せずログに書き込まれる。

痛むのはバグそのものではない: いつ気づくかだ。ユーザーが苦情を言ったとき、誰かがデータを漏らしたとき、罰金が届いたときに気づく。その頃にはもう本番稼働中だ。バグのコストは、発見までにかかる時間とともに増大する——そしてAIが見えないバグこそ、表に出るまで最も時間がかかるものだ。

それを説明する数字

各ステップで85%の確率で正解するエージェントは良さそうに聞こえる…8ステップを鎖でつなぐまでは: 0.85⁸ ≈ 端から端まで27%の成功率。誤りはAIを使わないことではない——最初の脳が見逃したものをレビューする二つ目の脳を持たないことだ。それがSentinelだ。

3. 習慣: レビューは一度きりではなく、AIがコードに触れるたび

ここが、知識だけでなく行動を変える鍵だ: Sentinelは一度使って終わりのものではない。習慣だ。AIが重要なコードを書いたり変更したりするたびに、良しとする前にSentinelにレビューを頼む。シートベルトを締めるように: 「思い出したとき」ではなく、いつも、自動的にやる。

必ずSentinelに通すべき瞬間:

習慣の4つの瞬間

アプリを本番にアップする前(世界に公開する前)→「これは安全か?」。

AIが機微なものに触れたとき: ログイン、決済、データベース、ユーザーデータ。

変更を承認する前にレビューするとき(PR、新しいブランチ)。

定期的に全体の見直し——昨日安全だったものが、今日の変更で壊れているかもしれないから。

Sentinelの黄金律

Sentinelは「ここに問題があるよ、幸運を」で止まらない。真剣なエンジニアリング全体に通じるルールに従う: 「テストなくして、修正は完了していない」。だから確認した本物のバグ一つひとつに対して、二つのものを届ける: 最小限の修正と回帰テスト——そのバグが二度と戻らないことを保証する小さなテストだ。バグを狩るのは半分; 永遠に封じ込めるのがもう半分だ。

4. 正確に何をレビューするか: 18の観点

Sentinelは18の次元でスキャンし、二つの大きなグループに分かれる。すべてを理解する必要はない——でも見れば、それがあなたのために何をするかの規模がわかる:

古典的セキュリティ8つ: コード内のシークレット、保護のないエンドポイント、ユーザーごとのフィルタを飛ばすクエリ、スケール時に極端に遅くなるデータベース設定、誤って設定されたセキュリティヘッダー、ログ内の個人データ、検証されていない入力、既知の脆弱性を持つ依存関係。

「構築モードの盲点」10個: AIがインターフェースやロジックを構築する際に何度も繰り返すバグ——チャットからEnterを奪うキーボードショートカット、キーボードに見えないボタン、微妙なメモリリーク、重複した識別子、静かに握り潰されるエラー。この二つ目のグループが秘密の材料だ: インターネットの汎用リストからではなく、実際の監査を何ラウンドも磨いた品質プロトコルから生まれている。

信頼できる(そしてうるさくない)理由

どんなスキャナーでも怖いのは、誤報で埋め尽くされることだ。Sentinelは違うことをする: 疑いごとに、報告する前に自分自身に反論を試みる(誤検知では? その「シークレット」はただの例では? そのクエリは本当にマルチユーザーか?)。その疑いを生き延びたものだけを報告する。うるさい20件より、本物の5件のほうがいい。

5. インストール方法: ワンコマンド

SentinelはClaude Code向けのスキルだ(ターミナルやエディタで働くAIアシスタント)。ワンコマンドでインストールでき、すべてのプロジェクトで使えるようになる。Claude Codeを使っているなら、書くのはこれだけ:

bash

/plugin marketplace add MentexDev/neuralos-sentinel
/plugin install neuralos-sentinel@neuralos-sentinel

別のアシスタント(Cursor、Codex、Gemini CLI)を使っている? Sentinelはオープンなスキル標準に従っているので、npx skills add MentexDev/neuralos-sentinelでそこでも動く。一度インストールすれば、変なコマンドで呼び出すことはない: AIに普通に話しかける。

最も簡単なのは: ただ話しかけるだけ

インストール後、何も覚える必要はない。AIにこう言えばいい: 「このプロジェクトをSentinelでスキャンして」、「アップする前にこのコードは安全?」、「この変更をセキュリティバグを探しながらレビューして」。AIは意図を認識し、自分で番人を起動する。それだけシンプルだ。

6. コピーしてすぐ使えるプロンプト

何を言うか考えなくていいように、端から端までの完全なプロンプトを用意した。エージェントに貼り付けて(Sentinelを既にインストール済みで)、[角括弧]を埋め、番人に仕事をさせよう:

Sentinelで自分のコードを監査するtext

neuralos-sentinel スキルで私のコードを read-only モードでスキャンしてほしい(私のOKなしに何も変更しないで)。

レビュー対象: [プロジェクト全体 / このフォルダ / このファイル / あなたが最後に行った変更]
スタック / 技術: [例: Next.js + PostgreSQLデータベース、または「よくわからない、コードを見て」]
コンテキスト: [例: 「複数のユーザー/顧客がいるアプリなので、データは絶対に混ざってはいけない」・「ログインと決済がある」・わかっていること]

Sentinelの手順に従って: 18の次元をスキャンし、各発見をVERIFY(誤検知を排除)し、深刻度順に並べたレポートを渡して。本物の問題ごとに: それが何かをわかりやすい言葉で、どのファイルにあるか、なぜ重要か、提案する修正、そしてそれを封じるテストを教えて。最後に、私が誤報を作っていないと信頼できるよう「レビューして却下したもの」のセクションを。

まだ変更は適用しないで: まずレポートを見せて、何を直すかは私が決める。

7. 簡単な道: 誰が何をするか

Sentinelはあなたのコードエージェントの中に住んでいるので、何がチャットで起こり、何をあなたがやるかを明確にしておくといい。見た目より簡単だ:

エージェントが自分でやること(チャットで)

あなたのコード全部を読み、18の観点でスキャンする。

誤報を渡さないよう、各発見を検証する。

本物の問題ごとに修正とテスト付きの、明確なレポートを書く。

あなたが決めること(ワンクリック / 「はい」)

どの修正を適用してほしいかを承認する(Sentinelは read-only: あなたの許可なしに何も触らない)。

露出したシークレットを本当にローテーションする(それはプロバイダーのパネルで、Webから行う)。

ある発見があなたのケースに当てはまるかどうかを判断する(あなたが自分のビジネスを知っている)。

正直に: Sentinelは何ではないか

魔法でも、すべてを捕まえるアンチウイルスでもない。最も一般的で高くつく欠陥のための高信頼のネットだ——銀行向けのプロによるセキュリティ監査の代わりにはならない。そして分析はあなたのAIエージェントが行うので、コードはそのエージェントが動く場所で処理される(あなたがエージェントに送るどんなリクエストとも同じ)。Sentinelは第三者への出力チャネルを一切追加しない: 見つけたものはあなたのセッション内に留まる。

8. リポジトリ(無料、MIT、スターをつけて)

Sentinelはオープンソースで、ずっと無料だ。ここに住んでいる——入って、見て、インストールして、バグを狩ってくれたら、もっと多くの人が見つけられるようにスターを残してほしい:

MentexDev/neuralos-sentinel

REPO

AIで書いたコードのセキュリティ番人。18の次元(セキュリティ + builder-mode)でバグを狩り、回帰テスト付きの修正を届ける。デフォルトで read-only。

MarkdownMITView on GitHub

NeuralOSでは…

Sentinelは、NeuralOSを構築するのと同じ規律から生まれた: 問題を検出し、修正を届け、テストで封じ込める。それは番人たちの家族の第一号だ——あなたのプロダクトを見張り、自分で何も触らずに修正を提案してくれる、小さなAIの味方たち。根底にある考え: AIは構築するだけでなく、構築したものを守りもする。