new-project

新規プロジェクト

型付きプリセットと機能の設定を基に、最新のソフトウェアプロジェクトを計画し、安全に初期設定します。

振り分け

$ARGUMENTS	アクション
空	ギャラリー：モード、プリセット、設定カテゴリ、例を表示します。編集は行いません
prefs、prefs list、catalog	設定：機能カテゴリとデフォルトを一覧表示します
prefs validate	設定：機能カタログとプリセットカタログを検証します
prefs add <id>	設定：安全に設定を追加する手順を説明します
preset list	プリセット：厳選されたプリセットとトレードオフを表示します
plan <name-or-path>	計画：新規または既存の対象に対する読み取り専用の設計図を作成します
init <name>、new <name>	初期化：事前チェック、設計図、承認の後に新しい対象をセットアップします
bootstrap <path>、init-existing <path>	既存プロジェクトの初期設定：不足ファイルを非破壊的にセットアップします
audit <path>	監査：スキャフォールドと規約の健全性レポートを読み取り専用で作成します
repair <path>	修復：監査結果に基づき、承認を得て追加形式で修復します
doctor <path>	診断：ファイルを変更せずにツールチェーンと設定の健全性を検証します
docs <path>	ドキュメント：docs-lite、docs-themed、docs-interactive、docs-productに分類します
docs-lite <path>、starlight <path>	軽量ドキュメント：Astro Starlightの静的ドキュメントプロファイル
docs-themed <path>	テーマ付きドキュメント：StarlightにCSS／Tailwindのブランドレイヤーを追加します
docs-interactive <path>	インタラクティブドキュメント：StarlightにReactアイランドを追加します
docs-product <path>、fumadocs <path>	プロダクト向けドキュメント：Next.jsとFumadocsによる高度なドキュメントプロファイル
ai <path>、agents <path>	AI 指示：AGENTS、ネストしたAGENTS、Claude Code、OpenCode、Codexの計画
github <path>	GitHub：CI、テンプレート、リリースワークフローの計画
python <name>、uv <name>	初期化／計画：Python向けプリセット
node <name>、web <name>、next <name>	初期化／計画：Node／Web向けプリセット
data <name>	初期化／計画：Supabase、SQLite、DuckDB、ノートブックのプリセット
aws <name>、agentcore <name>	計画：Bedrock／AgentCoreの計画。プロバイダーの変更はオプトイン方式です
monorepo <name>、nx <name>	初期化／計画：モノレポのプリセット
full <name>、max-free <name>	計画：包括的な設計図を作成します。適用はモジュールごとに行います
自然言語による新規リポジトリ／初期設定の依頼	自動で分類し、影響の大きい不足情報だけを質問します
プロダクト機能の依頼	拒否するか、実装スキルへ案内します
エージェントまたはMCP サーバーの依頼	拒否するか、agent-conventionsまたはmcp-creatorへ案内します
破壊的操作または強制実行の依頼	停止してリスクを説明し、ファイルごとの承認を求めます

運用フロー

1. リクエストを、新規プロジェクト、既存リポジトリのブートストラップ、監査、修復、設定、ドキュメント、AI 指示、GitHub、クラウド／データ、または拒否に分類します。
2. 曖昧なリクエストや自然言語によるリクエストについては、references/intake-and-routing.md を読みます。
3. 変更を伴うモードに入る前に、読み取り専用の事前確認を実行します。
4. 場当たり的な文章ではなく、data/ からプリセットと機能を解決します。
5. ファイル、コマンド、スキップした既存ファイル、リスク、承認事項、検証を含む設計図を作成します。
6. 明示的な承認を得てから、モジュールごとに適用します。
7. 検証を実行し、作成、スキップ、保留した作業を要約します。

パターンの実装

分類によるゲーティング

すべてのリクエストを実行前に、新規プロジェクト、既存環境のブートストラップ、監査、修復、設定、ドキュメント、AI 指示、GitHub、クラウド／データ、または拒否に分類します。曖昧なリクエストは、不足している選択が解決するまで読み取り専用のままにします。

段階的開示

SKILL.md はルーティングの規約として維持します。ドメインの詳細にはリファレンスを、設定にはデータファイルを、決定的なチェックにはスクリプトを、レポートの作成にはテンプレートのみを読み込みます。

スケーリング戦略

今後のスタックは、まず機能とプリセットとして追加します。新しいトップレベルモードが必要な場合にのみ、ディスパッチテーブルを変更します。

標準用語

以下の標準用語をそのまま使用してください。

用語	意味
Preset	minimal、python-api、docs-lite、monorepo など、厳選されたセットアップの一式
Capability	python.uv、docs.starlight、github.actions-ci など、単一のセットアップ機能
Blueprint	ファイル、コマンド、リスク、承認事項、チェックを含む読み取り専用のプロジェクト設定計画
Apply step	設計図に基づく、承認済みの変更単位
External side effect	クラウド、デプロイ、リリース、DNS、アカウント、プロバイダーに対する変更

参照ファイル一覧

ファイル	目的	読むタイミング
references/workflow.md	エンドツーエンドの安全なセットアップ手順	変更を伴うモード
references/capability-model.md	機能スキーマと競合のセマンティクス	設定／カタログ関連の作業
references/presets.md	プリセットとトレードオフ	プリセットの選択
references/preference-catalog.md	人が読みやすい設定一覧	prefs、計画
references/adding-preferences.md	将来の設定追加ワークフロー	prefs add、メンテナンス
references/intake-and-routing.md	分類と曖昧さへの対処	自然言語による入力
references/scaffold-profiles.md	プリセット別の成果物マトリクス	ブループリント作成
references/python-uv.md	uv、uvx、pyproject、Python パッケージ	Python プロファイル
references/node-pnpm-npm.md	pnpm、npm/npx、TypeScript、Next、Astro、Nx、Changesets	Node プロファイル
references/docs-starlight-react.md	Starlight の軽量／テーマ付き／インタラクティブなドキュメントのガイダンス	軽量なドキュメントモード
references/docs-fumadocs.md	Fumadocs によるプロダクト向けドキュメントのガイダンス	プロダクト向けドキュメントモード
references/design-system.md	DESIGN.md と画一的なデザインを避けるためのガイダンス	Web／ドキュメント／デザインのプロファイル
references/data-platforms.md	Supabase、SQLite、DuckDB、Kaggle、Colab	データ／ノートブックのプロファイル
references/ai-apps.md	Pydantic AI、LangGraph、Vercel AI SDK、Bedrock、AgentCore	AI アプリのプロファイル
references/github-ci-release.md	Actions、リリース、最小権限の CI	GitHub モード
references/cloud-deploy-dns.md	Vercel、Cloudflare DNS、AWS のデプロイゲート	クラウドモード
references/precommit-quality-gates.md	pre-commit と CI のミラーリング	品質ゲート
references/conventional-commits-release.md	Conventional Commits、Changesets、リリース	リリースプロファイル
references/ai-agent-instructions.md	AGENTS、ネストされた AGENTS、Claude Code、OpenCode、Codex	AI 指示モード
references/openspec-governance.md	OpenSpec のセットアップと生成された成果物のポリシー	OpenSpec プロファイル
references/security-supply-chain.md	シークレット、パッケージ生成ツール、Docker、CI、サプライチェーン	リスクの高いモード
references/validation-and-repair.md	監査、doctor、修復ワークフロー	監査／修復／doctor
references/artifact-templates.md	骨組みとテンプレートのガイダンス	成果物の生成

スクリプト一覧

スクリプト	目的
scripts/preferences.py	設定の一覧表示、検証、解決、マージ、説明
scripts/preflight.py	読み取り専用のプロジェクト検出とリスクフラグ
scripts/blueprint.py	リクエスト、プリセット、機能から JSON ブループリントを構築
scripts/validate_catalog.py	スキーマ、依存関係、競合、テンプレート、参照を検証
scripts/validate_plan.py	適用前にブループリントの安全性を検証
scripts/version_check.py	選択したパッケージの情報とバージョン情報を照会
scripts/doctor.py	変更を加えずに既存のスキャフォールドの健全性を確認
scripts/render_report.py	HTML テンプレート用のレポートデータをレンダリング

スクリプトは argparse、JSON の標準出力、標準エラー出力への診断情報、--help を使用します。シークレットファイルを読み取ってはなりません。

安全性ゲート

1. スキャフォールド、ブートストラップ、修復、ドキュメント、AI、GitHub、クラウド、または適用モードでは、最初に事前チェックを行います。
2. 変更またはパッケージのインストールの前に、ブループリントを作成します。
3. 既存のファイルはデフォルトでスキップします。上書きにはファイルごとの承認が必要です。
4. 移行が承認されない限り、検出されたパッケージマネージャーを維持します。
5. ユーザーにチャットへのシークレットの貼り付けを求めず、シークレットファイルも読み取りません。
6. 実際の認証情報ではなく、.env.example または .env.template を生成します。
7. クラウド、デプロイ、リリース、DNS、Docker、アカウントに関する変更には、プロバイダーを指定した明示的な承認が必要です。
8. GitHub Actions の権限は permissions: contents: read をデフォルトとし、必要最小限の権限のみを追加します。
9. Docker Compose テンプレートでは、デフォルトで特権モード、ホストネットワーク、Docker ソケットのマウント、広範なホストマウント、root サービス、パブリックな DB バインドを避けます。
10. 生成する AI 向けの指示で、承認を迂回したり、認証情報のガードを無効化したり、自動デプロイを行ったり、優先度の高い指示を無視したりしてはなりません。

重要なルール

1. スタックの選定には機能カタログを使用します。設定を文章だけにハードコードしてはなりません。
2. 単発ツールの uvx と、プロジェクトコマンドの uv run を区別します。
3. 新しい Node プロジェクトでは pnpm を優先します。ただし、移行が承認されない限り、検出された npm／yarn／bun を維持します。
4. 軽量なドキュメントには Starlight を優先します。Fumadocs は、製品／API／ドキュメントを多く必要とする要件が正当化される場合にのみ使用します。
5. Web／製品プロファイル以外では Tailwind v4 と shadcn/ui をオプトインとし、必要な shadcn コンポーネントのみを追加します。
6. 実行中に取得したレジストリまたは公式ドキュメントの根拠なしに、latest と断言してはなりません。
7. エージェントや MCP サーバーを作成してはなりません。そのようなリクエストは別の方法に誘導します。
8. 明示的に依頼されない限り、ブランチ、ワークツリー、コミット、プッシュ、リリース、PR を作成してはなりません。
9. ローカルの品質ゲートを GitHub Actions に反映するか、CI を延期した理由を文書化します。
10. Web／ドキュメント／デザインのプロファイルには、モバイルファーストのレスポンシブ UI 要件を含めます。
11. ディスパッチモード、プリセット、機能、安全性ゲートを変更した場合は、評価テストも更新します。
12. 本文は 500 行未満に保ち、詳細はリファレンスに移します。

検証要件

このスキルへの変更を完了とする前に、次を実行します。

python skills/new-project/scripts/check.py
uv run pytest tests/test_new_project.py
uv run python skills/new-project/scripts/preflight.py --path . --format json

スキル定義、公開説明、リファレンス、または評価動作を変更した後は、利用可能であれば docs-steward を呼び出します。