unit-planner

スキル：unit-planner

トリガーとルーティング

• トリガー：unit planner、generate UNITS.csv、execution contract、units template、生成工作单元。
• 使用する場合：実行契約を初期化／更新するとき：pipeline を選択して UNITS.csv を生成する場合、またはスコープ拡大に伴い units／依存関係を追加する場合。
• 使用しない場合：UNITS.csv が現在のスコープを正しく反映している場合（書き換え不要）。
• ネットワーク：なし。
• ガードレール：CSV の妥当性を維持します。スコープが拡大した場合は units を追加し、受け入れ条件を満たした後にのみ DONE とマークします。

目標

• pipeline（pipelines/*.pipeline.md）を、特定のワークスペース向けの具体的な UNITS.csv 契約に変換します。

入力

• PIPELINE.lock.md（推奨）または選択した pipelines/*.pipeline.md
• pipeline のフロントマターで参照されている templates/UNITS.*.csv
• 既存のワークスペース成果物（必要に応じてスコープを調整するため）

出力

• UNITS.csv（ワークスペースのルート）
• 任意：次に実行可能な units を記載した STATUS.md

手順（必ず従うこと）

使用するもの：templates/UNITS.*.csv。

1. PIPELINE.lock.md を読みます（または pipeline-router を使って作成するよう依頼します）。
2. UNITS.csv が存在しない場合、pipeline の units_template をワークスペースにコピーし、UNITS.csv とします。
3. UNITS.csv が存在する場合は、次の内容を反映するためにのみ編集します。
   • 新しいスコープ（行を追加）
   • 依存関係の修正
   • 受け入れ条件の明確化
4. 各 unit に unit_id、skill、outputs、acceptance、checkpoint、status、owner があることを確認します。
5. チェックポイントが CHECKPOINTS.md と一致するようにします。pipeline がカスタムチェックポイントを使用している場合は、不足しているチェックポイントを追加します。

受け入れ条件（必ず確認）

• UNITS.csv が CSV として解析でき、必須の列がすべて含まれています。
• すべての depends_on が既存の U### を参照しています。

副作用

• 許可：UNITS.csv、STATUS.md、CHECKPOINTS.md（カスタムチェックポイントの追加）の編集。
• 許可されないこと：依頼がない限り、pipelines/ 内の pipeline ファイルを変更すること。

トラブルシューティング

問題：PIPELINE.lock.md が見つからない

対処方法：

• units を生成する前に、pipeline-router（Mode A）または uv run python scripts/pipeline.py kickoff|init を実行して PIPELINE.lock.md を作成します。

問題：編集後に UNITS.csv が不正な CSV になった

対処方法：

• inputs/outputs はセミコロン区切りにし、フィールド内のエスケープされていないカンマを避けます。uv run python scripts/validate_repo.py で検証します。