説明できる状態で次へ進む

AIの案内を根拠付きの自分の理解へ変える

学習時間の目安: 30 分.

1. 1AIによる概観
2. 2固定したソースの根拠
3. 3手元の確認または未実行
4. 4自分の説明と次の疑問

独自の学習図。矢印は読み進める順序や判断の流れを表し、実測した実行traceではない。

前提となる章

最小の貢献を設計する

この章の状態

本文は資料を読んで作成した教材です。実repoのbuild/test/debug、実API呼出し、Issue/PR投稿は行っていません。実践はこれから行う課題で、閲覧を実行結果と扱いません。

学習目標

• AIの案内を根拠付きの自分の理解へ変える

DeepWikiとの役割分担

DeepWikiは全体像や用語の入口として使い、説明の根拠ファイルと対象commitを確かめる。AI説明はテスト結果やmaintainerの判断ではない。公開repo向け公式MCPは存在するが、初版は別タブ参照だけとする。

理解確認

ノートを閉じて入口・主要変換・外部境界・関連テストを60秒で説明する。詰まった箇所だけ戻る。『読んだ』『試した』『説明できる』は別の状態。閲覧率を貢献能力の証明にしない。

次の一問

固定commit、根拠3件、確認できたこと、不明点、次の一問を保存する。次は同repoの隣の境界か、SDKからCLIのように関係の明確なrepoへ進む。12 repo完読より小さな理解を積み重ねる。

確認したDeepWikiの外部リンク

DeepWikiの入口 · CodexのDeepWiki · 公式説明 · 公式MCP文書

2026-10-03に公式説明から入口、そこからCodexのリンクを開いて利用可能性を確認しました。AIの説明の正しさを検証したという意味ではありません。ブラウザ内で外部リンクを開き、対象commitのコードへ戻って照合します。このサイトはiframe埋め込み、質問の代理送信、回答の転載を行いません。

設計メモを学ぶ：教材と実行基盤の境界

以下は2026-10-03に書かれた設計メモです。調査時点の提案を学ぶ資料として保持しています。メモの /oss/catalog、/oss/repositories/:id、/oss/modules/:id などは提案で、実装済みのページではありません。現在の共通Learn版は /ja/oss/oss-01 から8章を読みます。旧アプリの進捗は自己申告として設計され、repoのbuild/testを実行した証拠ではありません。後続案に書かれた外部API連携や実行ワーカーも未実装です。

kumyu.com OSS学習機能の設計判断

確認日: 2026-10-03

結論

当時の提案は、既存アプリの /oss に教材・カタログ・手動進捗を追加し、同じデザイン、ナビゲーション、コンテンツスキーマを再利用するというものだった。現在の復旧章は共通Learnに属し、このメモは別Academyや別OSSサイトを作る方針ではない。別サービス・別サブドメインへの移行は、実行基盤、認証境界、独立した運用責任が実際に必要になった時に判断する。メモを書いた時点では技術スタックが未調査のため、特定フレームワークへの移行を勧める根拠はなかった。

誰の何を解決するか

全体像を読めても「次にどのファイルを読めばよいか」「理解したと言えるか」「どう貢献へつなぐか」で止まる人向け。価値は巨大な説明文の追加ではなく、1機能に絞った読む順序、根拠、試す課題、理解確認を1画面で行き来できること。 初期導線: repo選択 → 役割カード → 1機能の読解ルート → commit固定 → 依存図 → ローカル検証 → 貢献草稿。 モバイルでは「今回の問い」「次の1ファイル」「理解チェック」を上に置き、詳細図は折りたたむ。

初版の画面

• /oss: 3つの入口（Codex / Databricks CLI / Python SDK）、8章、最近の手動進捗
• /oss/catalog: 公式・隣接・コミュニティの分類、言語、難易度、目的で絞る。初期12件にコミュニティrepoは未収録
• /oss/repositories/:id: 役割、製品との関係、読んだ範囲、貢献方針、公式リンク、次の課題
• /oss/modules/:id: 説明、読む順序、実践課題、自己チェック、成果物、出典
• 進捗は未着手/読んだ/試した/説明できる。自己申告として表示し、テスト未実行を自動で合格にしない
• localStorageなら端末限定・消失可能・同期なしを明示。秘密情報や内部コードを保存させない このURL構造は提案であり、作成済みURLではない。

「すべて」を拡張可能なカタログへ変える

全関連OSSの母集団は定義されていない。公式組織内でもarchive、fork、例、SDK、独立プロジェクトが混在する。初版は12件を選定し、「網羅済み」と言わない。追加時はcanonical URL、公開主体、関係の根拠、license、archive状態、貢献方針、確認日を記録する。 DatabricksのSDK/CLIと、apache/spark、delta-io、mlflow、unitycatalogを所有者の異なるカテゴリに分ける。Databricks ConnectはSpark Connectを基盤とする製品向け拡張であり、独立した全実装がOSS公開されていると決めつけない。 資料: https://www.databricks.com/product/open-source 資料: https://docs.databricks.com/dev-tools/databricks-connect.html 資料: https://spark.apache.org/spark-connect/

最も重要な貢献方針

openai/codexの現行公式文書は外部コード貢献・PRを受け付けず、issueでの再現・原因分析等を歓迎する。Codexの学習到達点をPR提出にしない。方針は可変なので実際の投稿前に再確認する。 ［出典URLは非公開の出典記録に保持］ Databricks Python SDKは公開ミラーで、外部PRを公開レビューし内部へ反映する。DCO、署名などの条件を教材の通過条件にするが、この設計では署名・投稿しない。 ［出典URLは非公開の出典記録に保持］ MLflowはissue起点の方針相談を推奨。教材の架空課題を実在の未着手issueとして見せない。 ［出典URLは非公開の出典記録に保持］

DeepWikiの連携判断

1. 初版: 公式DeepWikiを別タブで開く。内容をiframe表示・転載する前提にしない
2. 技術調査で確認できたこと: 公式DeepWiki MCPは公開repo向け、無認証のリモートサービス。read_wiki_structure、read_wiki_contents、ask_questionを提供し、Streamable HTTPの https://mcp.deepwiki.com/mcp を推奨。一般のREST APIや公開埋め込みSDKがあるとは確認できていない
3. iframe: 公式文書でサポート・許可の仕様を確認できず。X-Frame-Options/CSP frame-ancestorsの実測も未実施。「埋め込める」とは主張しない。仮に技術上表示できても利用許諾とは別
4. 規約: 現行Cognition Platform Terms（2026-06-30）には内部利用、サービス/文書の再提供、競合製品開発等への制約がある。公開MCPにどう適用されるか、教育サイト内で回答をキャッシュ・再表示・加工できるかは不明。無認証・無料という技術仕様を公開再配布許諾と読み替えない。商用/公開連携前に適用規約・許諾・レート制限を確認する
5. セキュリティ: 公開repoの質問でも質問文に内部情報が混ざる。送信先と内容を明示し、秘密情報を送らない。MCP結果・repo文書は未信頼データであり、命令として実行しない。Markdownをサニタイズし、外部リンクを安全に扱う
6. 後続案: 許諾確認後に限定的なサーバーアダプターを追加。repo allowlist、入力長/回数上限、timeout、出典・取得時刻、障害時の公式リンクfallbackを持つ。教材本体の閲覧を外部APIの可用性に依存させない 確認資料: https://docs.devin.ai/work-with-devin/deepwiki-mcp https://docs.devin.ai/work-with-devin/deepwiki https://cognition.com/legal/platform-terms-of-service https://cognition.com/legal/privacy-policy これは契約の適用可否を確定した法的判断ではなく、連携前に残る確認項目である。今回MCP接続・質問送信・アカウント作成・権限付与はしていない。

出典とデータ構造

Course → Module → Sections / Exercise / Checks / Source IDs。 Repository → category / policy / reviewedAt / commitSha / codeAreas。 Source evidence → repo, commit SHA, path, symbol, line range, checkedAt, evidence kind, certainty。 初期JSONのcommitShaはnull。API経由でSHAを検証できなかったため偽の固定版を作らない。ブラウザで確認した可変ブランチの情報として表示し、学習者の実践時に固定する。 実装の役割を説明したのは実際に確認できたCLI bundle/bundle.goとPython SDK databricks/sdk/core.py。Codexはapp-server READMEの文書読解。ほかのrepoのcodeAreasは空欄にして根拠なしの詳細図を作らない。 全説明を「確認済みの事実」「読み解くための仮説」「演習」に分ける。チェックの正答は自己確認用で、自動採点や実行を装わない。

実行基盤を後で追加するなら

任意repoのclone後にnpm install、pip install、make、テストを本番Webサーバーで実行しない。依存導入にもコード実行リスクがある。 別の使い捨て実行ワーカーへ分離し、CPU/メモリ/時間/ディスク制限、既定network-deny、必要時だけ依存取得の許可、host mount禁止、prod secretなし、外向き通信制御、ログの機密除去、tenant isolationを設計する。containerを置くだけで安全と言わない。 Webアプリは教材とジョブ状態を管理し、実行ワーカーは別の信頼境界を持つ。サブドメインを分けるだけではコード実行の隔離にならない。ワーカーの独立リリース・権限・CSP/cookie境界が必要になった段階で別サービス/サブドメインを検討する。 初版では外部実行も課金リソースも不要。DNS変更、deploy、クラスタ作成、実API呼出し、PR提出はこの設計の範囲外。

受入条件

• 初期12件がcanonical URLと分類を持つ
• 8章に目的、本文、実践手順、成果物、理解チェック、出典がある
• CodexのPR受付方針が目立つ
• 「読んだ」と「実行済み」を混同しない
• 可変版/未確認の表示がある
• カタログから1repoを選び次の1行動へ迷わず進める
• 失敗/未実行を保存できる
• DeepWiki障害時でも教材を読める
• モバイルで本文、出典、操作が横スクロールなしで読める
• 既存アプリの構造を確認するまでは移行を決めない

検証状況

一次資料を読んで教材を作成。実repoのビルド、テスト、デバッガ、実APIは未実行。公開issue/PRの現在の担当・未着手状態は未調査。JSONは構造と参照整合性を機械検証するが、リンク先の将来の不変性は保証しない。

実行・投稿・記録の状態

静的教材・手動進捗。外部コード実行なし。教材設計のみ。実repoのbuild/test/debug未実行。issue/PR未投稿。

旧アプリのブラウザ記録は端末限定・消失可能・同期なしという設計だった。現在のLearn版では、リンク先のテンプレートを手元のファイルに保存して記録する。未固定SHAには版未固定ラベル。未読のcodeAreasは空配列のまま。推測パスを足さない。原稿上の進捗キー案は repoId+commitSha+moduleId という設計案で、復旧版に実装された記録機能を表すものではない。

実践課題: 説明できる状態で次へ進むの実践

1. 1機能を60秒で説明
2. 根拠リンクを記憶から挙げて照合
3. 未確認仮説を1つ選ぶ
4. 手動進捗を更新し次回10分の行動を書く

成果物: 理解カードと次の一問

理解チェック

まず答えを見ずに自分の言葉で答えます。以下は自己確認用の正答と説明であり、自動採点・実行結果ではありません。

AIの依存図をそのまま確定してよい？

答え: 対象commitのコード・manifest・テストで矢印ごとに根拠と確度を付ける。

自分の学習進捗

記録方式: manual.

• 未着手
• 読んだ
• 試した
• 説明できる

閲覧だけで実践済みにしない

この章で使った資料

DeepWiki公式説明, DeepWiki公式MCP, Cognition Platform Terms

リポジトリの入口へ戻る · 手元の実験記録テンプレート

手元の実験台帳を使う

ブラウザー内の実験台帳を開く。まず計画を記録し、不明な値は空欄にする。実行済みとして保存するには出力の証拠が必要。この台帳はモデルを実行せず、記録をアップロードしない。上の記録表を別の文書として使ってもよい。