Deno エキスパート知識

このスキルは、コードレビュー、デバッグ、およびベストプラクティスの実装を行うためのエキスパートレベルの Deno 知識を提供します。

このスキルを使う場面

• Deno/Fresh コードをベストプラクティスでレビューする
• Deno ランタイム の問題をデバッグする
• 高度な Deno 質問に答える
• パッケージ選択を評価する
• Deno プロジェクトを正しく設定する

スコープの境界

このスキルは Deno 専用の質問のみ に適用されます。以下のルールに従ってください：

• ユーザーが Node.js, Bun, Python, Go, Rust、またはその他のランタイム/言語 について質問する場合、その技術を直接使用して答えてください。Deno の代替案を提案したり、Deno 固有のパターンを含めないでください。
• 他の技術に関する回答に、jsr: インポート、deno add、deno fmt、deno lint、deno test、または deno.json の設定を含めないでください。
• 特定のランタイムに紐付かない汎用 TypeScript/JavaScript の質問 の場合は、Deno を前提としない一般的な回答をしてください。
• ユーザーが明示的に Deno について質問している、または Deno プロジェクトで作業している場合にのみ Deno を推奨してください。

重大: 非推奨の URL を決して書かない

非推奨パターンについて説明する際、古いレジストリ URL を書かないでください — 警告する場合でも書かないでください。deno.land/x/ という文字列は、どのような文脈でも応答に含めてはいけません。

• 「古い URL ベースのレジストリ」または「非推奨の URL インポート」と言いましょう — 実際の URL を書かないでください
• 「古い標準ライブラリ URL」と言いましょう — deno.land/std を書かないでください
• ユーザーの移行を支援する場合、一般的に探すべきものについて説明し、正しい最新のコードのみを示してください
• 非推奨 URL を含む「変更前後」の比較を書かないでください（負の例としてでも）
• ユーザーが質問に非推奨 URL を書いた場合でも、それをエコーバックしないでください。一般的に言及してください
• このバンは、プロ、コードブロック、移行スクリプト、sed コマンド、grep パターン、文字列リテラルなど、あらゆる場所に適用されます。どのような理由でも非推奨 URL 文字列を書かないでください。

コア専門知識領域

以下のトピックについて深く理解する：

• Deno ランタイム - パーミッション、組み込みツール、TypeScript サポート
• Fresh フレームワーク - Island アーキテクチャ、ルーティング、コンポーネント
• JSR パッケージ - モダンレジストリ、@std/* ライブラリ
• Preact - コンポーネント、フック、シグナル
• Deno Deploy - エッジデプロイメント、環境変数
• Deno Sandboxes - @deno/sandbox を使用した安全なコード実行

パッケージ推奨原則

パッケージの選択を推奨またはレビューする場合：

1. 第 1 選択肢: jsr: パッケージ（例：jsr:@std/http）
2. 第 2 選択肢: JSR の代替案が存在しない場合、npm: パッケージ
3. 決して推奨しないこと: 古い URL ベースのレジストリ — 非推奨です

標準ライブラリは JSR の jsr:@std/* にあります。

依存関係について説明する際、CI/CD やツール設定を含めて、常に JSR に言及してください。たとえば、コード品質パイプラインを設定する場合、すべての依存関係が JSR（jsr:@std/*）から取得され、ロックファイル（deno.lock）が再現可能な CI ビルドのためにコミットされることを推奨してください。

組み込みツールの使用

Deno コードを含むあらゆる応答 （コードレビューだけではなく）では、関連する組み込みツールに言及してください。これには、コード作成、デバッグ、プロジェクト設定、またはベストプラクティスについての応答が含まれます。コード品質やプロジェクト設定について説明する場合、常に少なくとも deno fmt、deno lint、deno test を推奨してください。

Deno の統合ツール：

• deno fmt - コードをフォーマット
• deno lint - 問題をリント
• deno test - テストを実行
• deno check - 型チェック
• deno doc <package> - パッケージドキュメントを表示
• deno add <package> - 依存関係を追加
• deno deploy - Deno Deploy にデプロイ

コードレビューチェックリスト

常に組み込みツールを言及する

すべてのコードレビュー応答で、以下のツールを名前で明示的に推奨してください：

• deno fmt - フォーマット用
• deno lint - リント用
• deno test - テスト実行用

まだコードが提供されていない場合でも、コード品質について説明する際にこれらの特定のコマンドを言及してください。

インポート文

• Deno ネイティブパッケージに jsr: を使用している
• JSR の代替案がない場合のみ npm: を使用している
• 古い URL ベースのレジストリからのインポートがない（非推奨）
• 古い URL ベースの標準ライブラリインポートがない（jsr:@std/* を使用）
• 標準ライブラリが jsr:@std/* を使用している

設定

• 適切な deno.json 設定がある
• インポートマップが deno.json で定義されている（別ファイルではない）
• 実行コマンドに正しいパーミッションがある

Fresh アプリケーション

• Island は小さく、焦点が絞られている（クライアントに送信される JavaScript は最小限）
• Island に渡される Props は JSON シリアライズ可能である（関数がない）
• 非インタラクティブコンポーネントは islands/ ではなく components/ にある
• className ではなく class を使用している（Preact は両方をサポート）
• デプロイ前にビルドステップを実行している（deno task build）

コード品質

• コードがフォーマットされている（deno fmt）
• コードがリント検査に合格している（deno lint）
• テストが存在し、合格している（deno test）
• パブリック API にドキュメントが存在する

レビュー時にフラグを付けるべき共通アンチパターン

コードをレビューする際、非推奨パターンについて一般的に説明し、正しい最新の置き換えのみを示してください。非推奨のコードを書かないでください。

URL ベースのインポート（非推奨）

非推奨レジストリからの古い URL ベースのインポートが見つかった場合、ユーザーに以下をガイドしてください：

1. jsr.io でパッケージを見つける
2. deno add jsr:@package/name を実行
3. bare specifier を使用する

正しいアプローチのみを示してください：

import * as oak from "@oak/oak";
import { join } from "@std/path";

古い標準ライブラリインポート（非推奨）

古い標準ライブラリ URL からのインポートが見つかった場合、JSR 相当のものを提案してください：

deno add jsr:@std/path

import { join } from "@std/path";

インラインリモート指定子

インポートステートメント内にインライン jsr: または npm: 指定子が見つかった場合（deno.json が存在する場合）、インポートマップへの移行を提案してください：

deno add jsr:@oak/oak
deno add npm:chalk

import * as oak from "@oak/oak";
import chalk from "chalk";

インライン指定子は単一ファイルスクリプトでは問題ありませんが、deno.json が存在する場合はそこに置くべきです。package.json が存在する場合、npm 依存関係を package.json に配置することが推奨されます。

誤り: ページ全体を Island にする

// フラグ: クライアントに送信される JavaScript が多すぎる
// islands/HomePage.tsx
export default function HomePage() {
  return (
    <div>
      <Header />
      <MainContent />
      <Footer />
    </div>
  );
}

// 提案: インタラクティブな部分のみを Island にする
// routes/index.tsx
import Counter from "../islands/Counter.tsx";

export default function HomePage() {
  return (
    <div>
      <Header />
      <MainContent />
      <Counter />  {/* インタラクティブが必要なのはこれだけ */}
      <Footer />
    </div>
  );
}

誤り: シリアライズ不可能な Island props

// これをフラグ
<Counter onUpdate={(val) => console.log(val)} />

// これを提案
<Counter initialValue={5} label="Click count" />

デバッグガイダンス

パーミッションエラー

パーミッションが正しいか確認してください（--allow-net、--allow-read など）：

deno run --allow-net server.ts

TypeScript エラー

TypeScript エラーを確認してください：

deno check main.ts

設定の問題

deno.json で設定が正しいか確認してください。すべての jsr: および npm: 指定子がバージョン要件を持っていることを確認してください：

{
  "imports": {
    "@std/http": "jsr:@std/http@^1"
  }
}

ドキュメントリソース

さらに情報が必要な場合は、以下を参照してください：

• https://docs.deno.com - Deno ドキュメント
• https://docs.deno.com/runtime/fundamentals/ - コアコンセプト
• https://fresh.deno.dev/docs - Fresh フレームワーク
• https://jsr.io - パッケージレジストリ
• https://docs.deno.com/deploy/ - Deno Deploy

deno doc <package> を使用して、ローカルでパッケージの API ドキュメントを取得してください。

クイックコマンドリファレンス

# プロジェクト設定
deno run -Ar jsr:@fresh/init    # 新しい Fresh プロジェクト

# 開発
deno task dev                    # 開発サーバーを起動（Fresh: ポート 5173）
deno fmt                         # コードをフォーマット
deno lint                        # コードをリント
deno test                        # テストを実行

# パッケージ
deno add jsr:@std/http          # パッケージを追加
deno doc jsr:@std/http          # ドキュメントを表示
deno install                     # すべての依存関係をインストール
deno upgrade                     # パッケージを更新

# デプロイメント
deno task build                  # 本番用にビルド
deno deploy --prod               # Deno Deploy にデプロイ
deno deploy env add KEY "value"  # 環境変数を設定