dstack-core

dstack コアコントラクト

このサポートスキルには、dstack のワークフローで使用される共有コントラクトが含まれています。

レビューのオーケストレーションでは、永続的なレビュアー ID、ソース境界の割り当て、再開、差し替えの証拠に references/REVIEW-STATE.md を、現在の指摘事項の処置に references/REVIEW-FINDINGS.md を使用します。また、ツールに依存しないコントラクトを 変更せずに、論理ロールを名前付きの Pi レビュアー定義に対応付ける場合は、任意のアダプターである references/PI-REVIEWER-ROSTER.md を使用します。scripts/sync-pi-reviewers.py は、 ユーザーが明示的に選択したターゲットを通じてのみ使用してください。通常のスキルのインストールで Pi エージェントの ディレクトリが変更されることはありません。build-beads-review-projection.py は、Beads のストレージを直接読み取らず、 検証済みの一時的なグラフを使って実行準備状況を提供します。また、append-review-note.py は Beads の更新を通じて、 1 行形式の状態／指摘事項 JSON を検証し、バイト単位で保持します。promote-legacy-feature.py は、既存のロードマップの ルートに正規の数式ライフサイクルと検証済みの実装計画を付加します。置き換えとなるエピックは作成しません。

ライフサイクルの開始時には、references/SKILL-VERSION.md を使用して、実行中の インストール済みスキルのバージョンを記録し、変更を加える前に、信頼できるローカルの正規の証拠と比較します。 Beads への書き込みとデリバリーの完了処理は、references/INTERACTION-BOUNDARY.md に従います。ネイティブのリンク済みワークツリーの権限は共有され、変更の実行中はリポジトリ単位のリースを使用します。 外部とのやり取りの証拠がある場合はフェイルクローズを維持し、ネイティブの Dolt 公開には raw push や force push ではなく、 scripts/guarded-beads-push.py を使用します。

このディレクトリ内のリファレンスにリンクする dstack ワークフローを実行する前に、そのリファレンスを最後まで読んでください。 呼び出し元のスキルは、引き続き、そのワークフロー固有の権限と完了ルールを担います。

フィーチャーの解決

<core-dir>/scripts/resolve-feature.py は、正規のスラッグ、完全一致または一意の人間向け名称、あるいは ID を使って、 Beads 経由でフィーチャーエピックを解決します。次に準備が整ったフィーチャーエピックを選択するには、--next を使用します。 ワークフローのコマンドでは、正規の <slug> 参照を提示し、Beads ID は変更と監査証拠にのみ使用してください。

単独で実行できるイシューには、/implement-task <task-selector> を使用します。このコマンドは、オープン状態の task、 bug、chore、spike、または単独の feature を正確に 1 件処理します。フィーチャーエピックとその子孫は、 引き続きフィーチャーのライフサイクルで管理します。verify-delivery-state.py は、実際のベースブランチのコミットと デリバリーの申告内容を照合するために、/close-feature が使用するマージ後の意味的なチェックを提供します。