build-manager

Hikyaku Build Manager

$ARGUMENTS[0] に指定されたパスの tasklist.md と build-{NN}/issue.md を管理する。

このスキルは hikyaku:architect および hikyaku:builder からモデル呼び出しで使用される内部スキルです。 ユーザーが直接呼び出すことは想定していません。hikyaku ワークフロー以外のコンテキストから呼び出された場合は、その旨をユーザーに伝えて終了してください。

操作

このスキルは以下の操作を行う:

• ビルドの追加: 新しいビルドを tasklist.md に追加し、issue.md を作成する
• ビルドの更新: 既存ビルドのスコープ・依存関係・BPを変更する
• ビルドの分割: 既存ビルドを2つに分け、新ビルドを作成する

1回の呼び出しで複数の操作を組み合わせてよい（例: ビルド分割 + 依存関係の更新）。

作業ステップ

Step 0: ファイルの読み込み

• <SKILL_ROOT>/references/templates.md: 各種成果物のテンプレート（必須）
• <SKILL_ROOT>/references/bp-guide.md: BP見積もりガイド（必須）
• リポジトリルートの .hikyaku.config を読み込む（存在する場合のみ）
  • bp_max の設定値を取得する（未設定の場合は 8）
• $ARGUMENTS[0]/tasklist.md を読み込む（存在しない場合は新規作成モード）

→ すべて読み込めたら Step 1 へ。必須ファイルが読み込めなかった場合はユーザーに報告して終了。

Step 1: 変更内容の整理

• 呼び出し元のコンテキスト（会話履歴）に基づき、必要な変更を整理する

ビルドの追加:

• タイトル、スコープ（やること / やらないこと / 受け入れ基準）を定義
• 依存関係を特定（どのビルドの完了後に実行可能か）
• buildID は max(既存buildID) + 1 を割り当てる

ビルドの更新:

• 対象ビルドの issue.md を読み込む
• スコープ・依存関係・BPの変更内容を整理
• PR列が埋まっている（完了済み）ビルドは更新しない

ビルドの分割:

• 対象ビルドの issue.md を読み込む
• 元ビルドに残す範囲と新ビルドに移す範囲を定義
• 新ビルドの buildID は max(既存buildID) + 1
• 依存関係: 新ビルドは元ビルドに依存するのが一般的だが、スコープに応じて判断する
• 元ビルドの依存先だったビルドの dependencies を新ビルドに付け替える必要がないか確認する

→ Step 2 へ。

Step 2: BP見積もり

• 追加・変更するビルドについて、bp-guide.md の手順に従いBP見積もりを行う
  • ビルドが関わるワークスペース（パッケージ）を特定する
  • ワークスペースごとに、主要指標（新規ファイル数、実装行数、API操作数、画面数、DBテーブル数）の最大値 + 加算要素でBPを算出する
  • 全ワークスペースのBPを合計する
  • 合計BPが (bp_max − 2) 以上の場合は分割を検討する（デフォルト: 6 以上）
• bp_max + 1 以上（デフォルト: 9 以上）の場合は分割が必須。(bp_max − 2) 以上 bp_max 以下（デフォルト: 6〜8）で以下のいずれかに該当する場合のみ許容する:
  • 分割したビルド間で同一ファイルの同一箇所を編集する必要があり、マージコンフリクトが避けられない
  • 分割の一方が BP 1 未満になり、ビルドとして成立しない

→ Step 3 へ。

Step 3: ユーザー承認

承認前にファイルへの書き込みは行わない。

• 変更内容をユーザーに提示し、承認を得る
  • tasklist.md の変更差分 — 追加・変更される行を明示
  • issue.md の内容 — 新規作成の場合は全文、更新の場合は変更箇所
  • 依存グラフの変更 — 変更後の Mermaid グラフ

→ 承認を得たら Step 4 へ。フィードバックがあれば反映し、Step 1 からやり直す。

Step 4: ファイル書き込み

• tasklist.md — テーブル行の追加・更新、依存グラフの再生成、ビルド要約の追加・更新
• issue.md — 新規作成または更新（$ARGUMENTS[0]/build-{NN}/issue.md）
  • 各ファイルのフォーマットは templates.md を参照

共通ルール

buildID

• 作成順の連番: max(既存buildID) + 1
• 既存 buildID のリナンバリングは 行わない
• ディレクトリ名はゼロ埋め2桁（例: buildID 3 → build-03）

依存グラフ

• tasklist.md の dependencies 列と Mermaid グラフは常に一致させる
• ビルドを追加・変更した後は 依存グラフ全体を再生成 する
• 循環依存の検証: 依存グラフにサイクルがないことを確認する。サイクルが検出された場合はユーザーに報告し、依存関係を修正する

ビルド要約

• ビルド要約セクションはビルドの推奨実行順（依存グラフのトポロジカル順）に並べる
• 新規ビルドは適切な位置に挿入する

完了済みビルドの扱い

• PR列が埋まっているビルドは完了済みとみなし、スコープの変更は行わない
• 完了済みビルドの依存関係の変更も行わない（依存グラフの整合性が崩れるため）