grace-execute について
承認済みの GRACE spec と plan のバンドルに従ってプロジェクトを実行するワークフロースキルです。適用・アーカイブ前に、lint、タスク検証、並列作業の確認、明示的な承認を求めます。
主な機能
- 01承認済みバンドルとIDの確認
- 02ベースラインと最終lintゲート
- 03タスク単位の受け入れ検証
- 04並列安全性の事前確認
- 05永続状態の整合性確認
- 06明示的な適用確認
活用シーン
- 01承認済みGRACEプロジェクト計画の実行
- 02バンドル適用前の作業検証
- 03原因不明のプロジェクト差分で安全に停止
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/grace-executeを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
承認済みで、IDが一致する`spec.xml`と`plan.xml`を含むアクティブなバンドルが1つ必要です。承認済みの計画は変更できません。編集前に、コンテキスト、プロジェクション、アサーション、スコープ、タスクの依存関係、検証を読み取ってください。フェーズと互換性のない計画は、書き込み前に拒否してください。`MustPassCommand`はプロジェクトのリーフ証拠でなければならず、ターゲットアサーションも書き込み後のタスク検証も、`--assertions current`を呼び出したり、GRACEのライフサイクルコマンドを入れ子にしたりしてはなりません。承認済みの競合をその場で編集するのではなく、置き換えて再計画してください。
<assertion_commands>
- 観測された書き込みの前に行うアクティブなベースラインの事前チェック：
grace lint --path PROJECT --assertions current - 選択したベースライン：
grace lint --path PROJECT --change C-ID --assertions baseline（ベースラインでMustPassCommandが宣言されている場合は、--run-commandsを追加） - コマンドを実行しない選択済みターゲット：
grace lint --path PROJECT --change C-ID --assertions target - コマンド証拠を伴う選択済みターゲット：
grace lint --path PROJECT --change C-ID --assertions target --run-commands - 最終状態の検証：
grace lint --path PROJECT --change C-ID --assertions final（ターゲットでMustPassCommandが宣言されている場合は、--run-commandsを追加） - 並列実行の事前チェック：
grace lint --path PROJECT --parallel-preflight</assertion_commands>
<mode_selection>
明示的にsequentialまたはparallel-safeが選択されるまで待ってください。parallel-safeを選択するには、明示的な事前チェックに合格している必要があります。ワーカーは承認済みの計画を変更しません。永続的な.graceの変更は、観測された作業の検証後、中央で適用します。
</mode_selection>
<recovery_decision_table>
| 状態 | 必須の対応 |
|---|---|
| clean-to-start | 選択したベースラインを実行してから、タスクを実行します。 |
| partial-observed-writes | 宣言された観測スコープを調査し、再開するか元に戻すかを確認します。 |
| durable-state-changed | 即時停止します。置き換えて再計画してください。承認済みアサーションは変更できません。 |
| target-already-satisfied | 最終状態の検証、宣言されている場合はオプトインのコマンド証拠、永続状態の整合性確認を行い、明示的な適用確認を求めます。 |
| unsafe-unknown-drift | 即時停止し、説明のつかないファイルを報告します。 |
| </recovery_decision_table> |
<execution_rules>
- 実装前に選択したベースラインを実行します。アサーションで
MustPassCommandが宣言されている場合は、明示的に--run-commandsも指定してください。 - 依存関係が解決済みのタスクを1つ、または検証済みの並列実行可能なバッチを1つずつ実行します。
- 各タスクの受け入れ確認と検証を、直ちに実行します。
- 承認済みの永続コンテキスト、グラフ、検証の変更は、中央で適用します。
- 永続状態の整合性を確認し、リーフの計画ゲートを実行してから、選択した
--assertions finalを最外層のライフサイクルゲートとして実行します。MustPassCommandが宣言されている場合は、--run-commandsも指定してください。最終モードでは、プロジェクト全体のLintを実行し、選択済みターゲットを評価し、無関係な承認済みベースラインを有効なまま維持します。また、選択した計画の置き換え済みベースラインは再評価しません。 - 最新の最終状態の証拠が合格した後、明示的な適用確認を求めます。
- その後に限り、specとplanのステータスを
appliedに設定し、バンドル全体をアーカイブします。 - 承認済みのアサーション、スコープ、タスクをその場で編集したり、古くなった証拠を無視したり、説明のつかない差分がある状態で続行したりしてはなりません。 </execution_rules>
コメント
Markdown 対応