BattlePlan は何をしますか?
トラッカーからすべての未完了タスクを読み取り、前回の計画以降に実際に発生したことと照合し、新しいエージェントセッションがそのまま開始できる開始プロンプトを持つ、短期間の並行作業スレッドのリストに変換します。
ステップ0 — すべての呼び出しはここから開始
BP="${SKILLS_HOME:-$HOME/.claude/skills}/BattlePlan/Tools"
uv run --script "$BP/setup_tracker.py" check
success: falseまたは設定なし → 最初に Workflows/Setup.md を実行してください。トラッカー、タブ名、コンテキストを勝手に作成しないでください。- 設定ファイルは
$BATTLEPLAN_CONFIGにあり、それ以外の場合は${AGENT_SKILLS_CONFIG:-~/.config/agent-skills}/BattlePlan/config.jsonにあります。所有者、トラッカーバックエンド、計画ディレクトリ、コンテキスト階層が保持されます。スキルディレクトリには個人データは保存されないため、自由に共有および更新できます。
ルーティング
| 呼び出し | ワークフロー |
|---|---|
| "set up battleplan"、設定なし、新しいトラッカー、新しいコンテキスト | Workflows/Setup.md |
/BattlePlan [context] [--mine] [--skip-audit] [--launch]、--audit | Workflows/Plan.md |
/BattlePlan --close | Workflows/Close.md |
/BattlePlan --draft(無人)、ドラフトのスケジュール設定 | Workflows/Draft.md |
--add、--done、--cancel、--restore、--sweep、batch-add、チケットや会議からのタスクインポート | Workflows/Tasks.md |
一日のループ
夕方 スケジュール済み(平日) 朝
/BattlePlan --close ──▶ /BattlePlan --draft ──▶ /BattlePlan
完了、スレッドごとの トラッカー + ハンドオフ + ドラフトを開く;例外のみ確認し、
次のステップ、再開コマンド セッションを読み取り; その後実行
ドラフトを作成
各ステップは、前のステップがスキップされた場合でも機能します:ハンドオフがない場合 → 要約は前営業日にフォールバック;ドラフトがない場合 → /BattlePlan がライブで計画を作成します。ファイルは plans_dir に保存されます:
| ファイル | 作成元 | 内容 |
|---|---|---|
YYYY-MM-DD-handoff-<host>.md | --close | 最初の行 Closed: <ISO 8601 オフセット付き> on <host>、その後、完了したもの、進行中のもの(次のステップ + 再開コマンド)、持ち越しタスク |
YYYY-MM-DD-draft-<host>.md | --draft | 計画+事前入力された監査提案;トラッカーへの書き込みはなし |
YYYY-MM-DD-plan.md | /BattlePlan | 確定された計画。--close が計画と実際の結果を比較できるようにする |
<host> はエイリアス(mac、wsl、linux または $BATTLEPLAN_HOST_ALIAS)であり、ホスト名ではありません。これらのファイルは複数のマシン間で共有される可能性があるためです。セッションIDは、それを作成したマシン上でのみ再開されます:他のホストの次のステップは表示されますが、再開コマンドは表示されません。
マルチマシン: plans_git_sync: true を設定し、plans_dir をgitリポジトリ内に配置します。コミットは、fetch + merge --ff-only の後、書き込まれたばかりのファイルのみを対象とします(git commit -- <path>)。stash、reset、cleanは絶対に行わないでください:他のセッションがそのリポジトリに未コミットの作業を保持している可能性があります。fast-forwardが失敗した場合は、ローカルでコミットし、プッシュが保留中であることを伝えてください。
ツール
| スクリプト | 機能 |
|---|---|
| `setup_tracker.py check | init` |
pull_tasks.py [context] [--mine] | 計算された緊急度、期限、所有者種別、依存関係、チケットを含むJSON形式の未完了タスク |
recap_sessions.py --tasks pull.json [--since auto] [--context X] | 前回のハンドオフ以降のエージェントセッションとgitコミット。チケットIDでタスクにリンク |
| `manage_tasks.py add | batch-add |
| `run_draft.sh --install | --check |
tracker.py | ストレージバックエンド(csv、xlsx、gsheets)と設定読み込み;他のスクリプトからインポート |
すべてのスクリプトは、インライン依存関係(PEP 723)を持つ uv run --script ファイルです:仮想環境の管理は不要。テスト:uv run --with pytest --with openpyxl pytest tests/。
譲れない条件
- 要約は提案し、人間が確認します。 証拠だけでタスクが完了とマークされることはありません。
- 書き込みには正確な行参照を使用。 プル後、
batch-done呼び出しでTab!row参照を使用してアーカイブします;行がわかっている場合は、部分文字列検索にフォールバックしないでください。 - 機密コンテキスト (`