autoplan について
autoplanは、リポジトリ作業を分析して計画するスキルです。依頼に応じて深さを調整し、根拠を示したリスクと成果に結び付く確認項目を各ステップに割り当てます。
主な機能
- 01依頼の振り分けと範囲選定
- 02リポジトリの根拠収集
- 03根拠付きリスク分析
- 04ファイルと契約に基づく手順
- 05成果確認を伴うマイルストーン
活用シーン
- 01実装前のリポジトリ変更計画
- 02移行やセキュリティ関連作業の範囲決定
- 03小規模変更の直接対応可否の判断
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ prathamdby/ skills --skill autoplanインストール後、Claude Code で/autoplanを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
REFERENCE.mdreferences/compatibility.mdcost.mddata.mdoperations.mdrouter-contracts.mdsecurity.md詳細
Autoplan
分析のみです。スレッド内、または呼び出し元が指定したパスに、計画を1つ提示します。
オプションとトリアージ
デフォルト:現在のリポジトリ、標準の深さ、スレッドへの出力です。Quick/sketchでは、常時適用されるレンズとともにShapeとRisksを使用します。Thorough/risky/migrationではdeepを使用し、quickより優先されます。対象領域が指定されている場合は、根拠の範囲を絞ります。スコープが競合する場合は狭い方に解決し、両方の解釈をAssumptionsに記録します。質問はしません。
根拠を確認する前に、根拠を示せる動詞/対象/領域がない場合、リポジトリ外の意図に計画可能な対象がない場合、または計画ではなく構築が求められている場合は、BLOCKEDとします。不足している要素と、実行可能な例を1つ示します。拒否時はレンズ/マップ/マイルストーンを出力しません。このスキルによって、構築の依頼がプロダクトの編集を許可されるわけではありません。
些細な作業とは、1つのモジュールに限られ、契約/データ/シグネチャの変更がなく、動作を1文で説明できるものです。その場合は、DIRECTとその説明文、さらにshape、files、first stepの3行を返します。レンズは使用しません。それ以外の場合は、intent | scope | depth | terminalを記録します。トリアージにterminalまたは根拠のある対象が定まった時点で完了です。
1. 根拠
依頼された契約がすでに存在するか確認します。既存の一致するものがあれば、再構築ではなく強化します。兄弟関係にあるreconのインストール済みSKILL.mdを見つけ、そのアンカーと、共有/レガシーメモリーのルールを確認します。headが解決できる、リポジトリで検証済みのスナップショットを読みます。読むだけのために更新を実行してはいけません。使用可能なメモリーがなければ、最大30個のマニフェストモジュールについて、それぞれ最大3つのアンカーをコールドスキャンします。reconが見つからないことは根拠の依存条件ではありません。その場合は、上限付きのスキャンを代わりに使用します。
ADRツリー(docs/adr/、adr/、doc/adr/、docs/decisions/)は、存在しない場合も含めて、無言でスキャンします。TODO、最近のrevert、重複を記録します。未コミットの内容はAssumptionsの補足情報であり、既存の契約の証拠ではありません。以降のすべての主張には、パス/テスト/ADR、対象を限定した不一致結果、または根拠不足を明記したAssumptionを引用します。継承したパターンも引用します。重要な主張に出典がある時点で完了です。
2. レンズ
REFERENCE.mdにあるすべての常時適用プローブを適用します:contracts/API、failure/rollback、longevity/debt。leaf、playbook、matcherでは、references/router-contracts.mdも適用します。
有効化された各レンズについて、すべてのプローブを評価します。ヒットは引用付きのリスクとし、計画のステップがそのリスクを担当します。各レンズの確認を、引用、リスク→ステップ、または根拠なしのいずれかで締めくくります。deepではすべてを有効にします。それ以外では、該当するレンズだけを読み込みます:
- Schema/backfill、保存済みアーティファクト、ツールチェーン:
references/data.md。 - 外部コンシューマー/保存済みペイロード:
references/compatibility.md。 - 認証/シークレット/PII/信頼できない入力:
references/security.md。 - ホットパス/コストが発生する呼び出し:
references/cost.md。 - サービス/デプロイ/ページング:
references/operations.md。 非アクティブなレンズごとに、スキップ理由を1行記載します。アクティブなプローブがすべて評価され、各リスクの担当が定まった時点で完了です。
3. 計画
実装内容や言い換えの繰り返しではなく、判断事項、変更される契約、制約、引用したパターンからの逸脱を明記します。標準/deepには、Assumptions、Shape(太字の文+パターン)、Layer map(NEW/CHANGEDの役割)、フェーズの順序、ファイルとシンボルによる根拠付け(文章の場合はファイル+契約ステップ)、最も重大なものから並べたRisks(確率×影響、または明記した判断)、Milestones、non-goals、Handoffを含めます。Sketchに含めるのはShapeとRisksのみです。
小規模な作業は1つのPRにまとめます。それ以外は、各マイルストーンをレビュー可能な垂直PRにします。最も薄いエンドツーエンドの契約/チェック用スライスから始めます。導入されるシンボル、期待される成功結果と関連する失敗結果、それらを証明するアサーションまたは観察済みの手動実行結果を明記します。終了コードが0であることだけでは証明になりません。
Handoffは呼び出し元の次のルートに従います。デフォルトは/peer-review、続いてshipです。ドキュメントのみの計画など、何も構築しない場合は、/peer-reviewを使用するか、そこで終了します。呼び出し元が明示したルートは維持します。動作が根拠または仮定に基づいており、リスクの担当が定まり、すべてのマイルストーンに成果に結び付いたチェックがある場合、PLANNEDで完了です。
Terminal:PLANNED、DIRECT、BLOCKED。