AI agent skill · by @mturac

Codebase Onboarding

不慣れなコードベースを分析し、アーキテクチャマップ、主要なエントリポイント、規約、スターターCODEX.mdを含む構造化オンボーディングガイドを生成します。新しいプロジェクトに参加するか、リポでOpenAI Codexを初めてセットアップする場合に使用します。

Archived 2026-10-23 · Source updated 2026-08-24 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

# コードベースオンボーディング

体系的に不慣れなコードベースを分析し、構造化オンボーディングガイドを作成。新しいプロジェクトに参加するか、既存リポでOpenAI Codexを初めてセットアップする開発者向けに設計。

## 使用時期

- OpenAI Codexでプロジェクトを初めて開く
- 新しいチームまたはリポに参加
- ユーザーが「このコードベースを理解する手助けをしてください」と求める
- ユーザーがプロジェクトのCODEX.mdを生成するよう要求
- ユーザーが「オンボード」または「このリポを説明」と言う

## 動作方法

### フェーズ1：偵察

すべてのファイルを読まずにプロジェクトについての生の信号を集めます。これらのチェックを並行して実行：

```
1. パッケージマニフェスト検出
   → package.json, go.mod, Cargo.toml, pyproject.toml, pom.xml

2. フレームワークフィンガープリント
   → next.config、nuxt.config、angular.json、vite.config

3. エントリポイント識別
   → main.*、index.*、app.*、server.*

4. ディレクトリ構造スナップショット
   → ディレクトリツリーの最上位2レベル

5. コンフィグとツール検出
   → .eslintrc、.prettierrc、tsconfig.json、Dockerfile

6. テスト構造検出
   → tests/、__tests__/、*.spec.ts、jest.config.*
```

### フェーズ2：アーキテクチャマップ

主要なモジュールとそれらの関係を特定します。

### フェーズ3：規約とスタイル

コード規約、命名パターン、プロジェクト固有のパターンを特定。

### 出力

- アーキテクチャマップ
- 主要なエントリポイントと流れ
- 規約とスタイルガイド
- スターターCODEX.md