Communitygithub.com

JahacksV1/day-one-agent-kit

アーキテクチャを変更せずにリポジトリを理解します。馴染みのないリポジトリでの作業開始時、クライアントのコードベースのオンボーディング時、またはスタック/プロファイルのベースライン作成時に使用します。

day-one-agent-kit とは?

このスキルは、開発者が新しいリポジトリに取り組み始める際に、コードベースの構造やアーキテクチャを変更することなく、迅速かつ詳細に理解するためのワークフローを提供します。主な目的は、観察されたコードパターンに基づいたエビデンスベースのリポジトリプロファイルを生成し、潜在的なリスクと次のステップを明確にすることです。このスキルは、フレームワーク、言語、パッケージマネージャー、デプロイターゲットの検出から、スクリプトの特定、フロントエンド/バックエンド/データベースなどの主要エリアのマッピング、環境変数の使用パターンの把握までを自動化します。特に、プロファイルの簡潔さと実用性を重視し、該当しない領域については「該当なし」と明記することで、不要な推測やコンテンツの作成を防ぎます。最終的な出力は `.ai/PROJECT_PROFILE.md` として保存され、テンプレートに従って構造化されるため、開発者はすぐにプロジェクトの全体像を把握し、実装作業に集中できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JahacksV1/day-one-agent-kit/tree/HEAD/skills/intake-repo

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

リポジトリインテーク

このワークフローを使用して、実装前にリポジトリを迅速に理解します。

目標

エビデンスに基づいた、リスクと次のステップが明確な短いリポジトリプロファイルを作成すること。

出力

  • .ai/PROJECT_PROFILE.md(templates/PROJECT_PROFILE.md を使用)

ルール

  • プロダクトコードを編集しないでください。
  • アーキテクチャを書き換えないでください。
  • 仮定よりも、観察されたコードパターンを優先してください。
  • プロファイルは簡潔で実用的なものにしてください。
  • 「該当なし」は主要エリアに対する有効かつ期待される回答です。静的/ポートフォリオサイトでバックエンドがない場合、認証、データベース、AIロジックのレーンは該当しません。コンテンツをでっち上げたり、将来のニーズを推測したり、空白や曖昧なままにしたりせず、「該当なし」とマークしてください。

手順

  1. フレームワーク、言語、パッケージマネージャー、デプロイターゲットを検出します。
  2. パッケージ/ロック/設定ファイルと主要なエントリポイントを読み取ります。
  3. 利用可能なスクリプト(dev、typecheck、lint、test、build)を特定します。
  4. フロントエンド、バックエンド、データベース、認証、AI、デプロイメントエリアをマッピングします。
  5. 環境変数の使用パターンを特定します。
  6. コードで使用されている現在のアーキテクチャパターンを把握します。
  7. 明らかに欠けているプロダクションの基本と主要なリスクをリストアップします。
  8. .ai/PROJECT_PROFILE.md を生成または更新します。

最小限のエビデンス

各発見に対して具体的なファイルを引用します。カテゴリの例:

  • スクリプトソース(package.json、pyproject.toml など)
  • デプロイメントソース(vercel.json、Docker、CI ワークフロー)
  • 環境変数使用ソース(process.env、NEXT_PUBLIC_ など)
  • 認証/データ境界(ミドルウェア、ルートハンドラー、ポリシーファイル)

完了チェック

  • プロファイルに、検出されたスタック、スクリプト、主要エリア、パターン、リスクが含まれていること。
  • 通常のコーディングタスクで役立つ程度に出力が短いこと。

関連スキル