スパイク は何をしますか?
ユーザーが本番実装を決める前にアイデアをテストしたい場合に使用します: "これをスパイクして"、"簡単なプロトタイプが欲しい"、"これは可能か?"、"A/Bを比較したい"、"作る前に確認したい"。
ドキュメントやコードを読めば質問に答えられる場合、またはユーザーが明確に本番実装を依頼している場合には使用しないでください。
ループ
- 質問:具体的な実現可能性の質問を記述します。
- 調査:十分なドキュメントやソースを読んで、信頼できるアプローチを選びます。
- 構築:アイデアを検証または反証する、最小限の実行可能な成果物を作成します。
- 試行:1つのエッジケースまたは障害モードを試します。
- 判定:
VALIDATED、PARTIAL、またはINVALIDATEDを下します。
出力形式
- デフォルトの作業ディレクトリ:
.tmp/openclaw-spikes/<スラッグ>(ユーザーが追跡可能なリポジトリ内のパスを要求した場合を除く)。 - リポジトリ内オプション:
spikes/<NNN-スラッグ>/にREADME.mdと最小限のコードを含めます。 - 実行可能なCLI、小さなHTML、1つのエンドポイント、または焦点を絞ったテストを優先します。
- パッケージの増殖、Docker、envファイル、アプリケーションフレームワーク、本番用の後片付けは避けます。
複数スパイクのアイデア
- 2〜5つの独立した質問に分割します。
- 最もリスクの高い質問から実行します。
- A/B比較の場合、入力を等しく保ち、同じ次元で測定します。
- 作業が小さなプロトタイプ以上の場合は、すべてのバリアントを作成する前に確認を取ります。
判定フォーマット
## 判定: VALIDATED | PARTIAL | INVALIDATED
質問: ...
証拠: 正確なコマンド/出力/測定値。
うまくいったこと: ...
失敗または驚いたこと: ...
推奨事項: 出荷 / 調整 / 回避。次の本番ステップを添えて。
ルール
- 却下されたスパイクは、証拠をもってあるパスを除外した場合に有用です。
- スパイクコードを、通常の書き直しなしに本番コードにマージしないでください。
- 外部依存関係を評価する場合は、健全性を確認してください:最近のリリース/コミット、ドキュメント、ライセンス、インストールの手間。