cs-build-feature

CodeSpring の計画から機能を構築する

ガイド付きの対話型ビルドです。コードの作成にすぐ取りかからないでください。まずユーザーと準備状況を確認してから、管理された手順で構築します。このスキルは計画を読み取り、（構築フェーズでは）コードベースも編集するため、慎重に進めてください。

使用するもの：codespring スキルのリファレンス（task-workflow.md、prd-management.md、pitfalls.md、codespring-docs.md）と、兄弟スキルの cs-build-create-prd および cs-build-create-tasks。

0. まず接続する

codespring auth status と codespring status を実行します（LOCAL プロジェクト。出力を表示します）。

1. ヒアリング — 何を構築しますか？

ユーザーに、構築したい機能を尋ねます。次に、CodeSpring にある情報を確認し、内容を 簡潔な箇条書き3点で伝えます。「構築するものについて、次のように理解しました。確認、または修正してください。」平易な言葉で伝えます。

2. 準備状況の確認 — 十分なコンテキストがありますか？

対象の機能について、以下を確認します。

• 実質的な内容を含む 仕組みの説明メモ がある。
• フロントエンドとバックエンドの PRD がある（codespring prds / codespring prd <id>）。
• バックエンド PRD に、共有システム（ルート、データモデル、認証／RLS、ジョブ／cron、ストレージ、決済／クレジット、環境変数）と依存関係マップが実際に記載されている。

コンテキストが不足している場合：

• cs-build-create-prd を使って今すぐ PRD を作成するか、ユーザーに選んでもらいます。または、
• CodeSpring のウェブアプリで作成するよう案内し、references/codespring-docs.md を使って手順を説明します（プロジェクトを開く → 機能の PRD ブリッジを開く → フロントエンド／バックエンド PRD を追加して生成する）。その後、「完了したら戻ってきてください」と伝え、再度確認します。

3. タスクの確認 — 構築計画はありますか？

この機能の番号付きタスクが Kanban にあるか確認します（codespring tasks --feature <id>）。タスクがない場合は、先に cs-build-create-tasks を実行します。次に、CodeSpring の右上にある切り替え Map / Kanban → Kanban をクリックするとタスクを確認できることをユーザーに案内します（references/codespring-docs.md を参照）。

4. ビルドモード — 決めつけずに尋ねる

ユーザーに次の2点を尋ねます。

1. どのように構築しますか？
   • タスクを1つずつ（より細かく制御でき、タスクごとにレビュー可能）、または
   • しばらく実行する（複数のタスクをまとめて自律的に構築）。
2. 自律的に実行する場合：並列で実行するサブエージェントの数は？（1～5。上限は5）。続けて、各エージェントが担当するタスクを確認します。

5. タスクと順序を選ぶ

この機能の todo タスクを番号順に一覧表示します。テスト可能なスライスにできるだけ早く到達できるタスクの組み合わせを選び、最初に取り組むタスクを提案します（依存する UI より基盤／バックエンドを優先します）。今すぐ取り組むタスクをユーザーに尋ねます。

6. 既存機能への影響を防ぐガード（重要）

次のように尋ねます。「今回の変更で壊れるのではないかと心配している既存機能はありますか？」 ある場合は、以下を行います。

• ビルド後もそれらの機能が動作することを確認する Kanban のチェックタスクを、cs-build-create-tasks の番号付けを使って追加します。
• 各サブエージェントの依頼内容に、バックエンド PRD の依存関係マップにある共有システムのうち、それらの機能が依存するものは、変更前に影響を明示するよう記載します。

7. ビルド

• 各タスクを進行中に移動し（codespring task start <id>）、実装してから codespring task done <id> を実行します。
• 並列ビルドでは、最大 N 個のサブエージェントを起動します（上限は5）。各エージェントには、タスク番号と説明、再利用マップ、「変更してはいけないもの」の一覧、既存機能への影響を防ぐガードを含む、単独で完結する依頼内容を渡します。並列実行しても安全な独立タスクは別々のエージェントに割り当て、依存関係のあるタスクは順番に進めます。
• タスク番号に沿って進捗を報告し、ユーザーがボードの更新を確認できるようにします。

8. 仕上げ

構築した内容、完了したタスク、残っているタスクをまとめます。テスト可能なスライスを確認するため、アプリの起動やテストの実行を推奨します。機能の完成後、実際に構築した内容が CodeSpring に反映されるよう、cs-build-resync-codebase の実行を提案します。

うまく進んでいる状態

• コードを書く前に、ユーザーが箇条書き3点の理解内容を確認している。
• 不足している PRD／タスクが、ビルド前に（アプリ内または兄弟スキルを使って）補われている。
• 基盤を先に構築し、既存機能を壊さないための明確なガードを設けたうえで、ユーザーが選んだ制御レベル（1タスクずつ、または最大5エージェント）に従ってビルドが進んでいる。