Reset Flow

reset 安全運用

git reset は 2 つの破壊を同時に起こせる: ブランチからコミットを外す（reflog / backup があれば復旧可）と、--hard による未コミット変更の完全消滅（どこにも残らず復旧不能 — reset 最大の危険）。本スキルは 収集 → 計画提示 → 承認 → arm + 実行 → 検証 をゲートとして固定する。

環境側の強制: plugin hooks の git-guard（PreToolUse） が git reset を監視しており、scripts/reset-arm.sh が置く解錠 marker（30 分有効）が無い実行は機械的に deny される。

そもそも reset を使わない選択肢（先に検討する）

| やりたいこと | reset 不要の代替 | |---|---| | ステージを外す（unstage） | git restore --staged （guard 対象外・HEAD を動かさない） | | ファイルの変更を捨てる | git restore （対象を限定できる） | | 直前コミットの修正 | git commit --amend（rebase-flow / commit-flow の範疇） | | push 済みコミットの取り消し | git revert（履歴を書き換えない） |

本スキルの対象は「HEAD / ブランチポインタを動かす reset」だけ。上記で足りるなら reset しない。

制約（厳守）

1. 承認なし実行禁止 — §2 の計画を提示し、ユーザーの明示承認を得るまで git reset を実行しない。
2. arm なし実行禁止 — 承認後に scripts/reset-arm.sh で safety branch + 解錠 marker を作ってから実行する。
3. BLOCKER で停止 — 保護ブランチ・detached HEAD・進行中操作（rebase 中の reset は --abort を使う）では計画に進まない。
4. --hard × 未コミット変更は明示承認 — 消えるファイル一覧を計画に載せ、破棄が意図だと確認できた場合のみ reset-arm.sh --allow-dirty。確認できなければ実行しない。
5. push 済みコミットを外す reset は force-push 前提を明示 — reset 後リモートと分岐する。リモート反映は rebase-flow §7 と同じ手順（明示 lease / gh-push --expect）。
6. 承認済みコマンドを一字一句そのまま実行 — mode（--hard/--mixed/--soft）を実行時に変えない。
7. safety branch の削除はユーザー承認制。ORIG_HEAD は他操作で上書きされるため復旧手段として当てにしない。

ワークフロー

1. コンテキスト収集

bash /scripts/reset-context.sh  

• COMMITS LEAVING BRANCH — ブランチから外れるコミット。push 済みが含まれる WARNING は制約 5 へ。
• WORKING TREE — --hard で消える未コミット変更。WARNING が出たら制約 4 へ。
• TARGET の relationship — 巻き戻し（ancestor）/ 前進（descendant）/ 乗り換え（divergent）。意図と一致するか確認する。

2. 計画提示（承認ゲート）

## reset 計画: 

### 現在の状態
- ブランチ: ``（HEAD: ``、safety 予定名: `backup/reset/-`）
- WARNING: 

### reset が必要な理由

### 実行するコマンド
git reset -- 

### 失われるもの / 残るもの
- ブランチから外れるコミット:  → safety branch に残る
- 未コミット変更: 
- untracked・stash: 影響なし

### 期待される reset 後の状態

### 復旧手段
- コミットの復旧: reset-flow で target=
- 

軽量ケース（--soft / --mixed で外れるコミットも push 影響も無い場合）は「現在の状態・コマンド・影響」の 3 点に簡略化してよい。承認と arm は同じく必須。

3. 実行

1. bash /scripts/reset-arm.sh（dirty 破棄の承認済み計画のみ --allow-dirty）
2. 承認済みコマンドをそのまま実行。

4. 検証と報告

1. git rev-parse HEAD が target と一致すること。
2. git status --short と git log --oneline -5 で期待状態を確認。
3. marker を除去: rm -f "$(git rev-parse --git-path reset-flow.armed)"
4. response-format 準拠で報告: 実行コマンド / HEAD の移動（before → after）/ safety branch 名 / リモートとの関係（force-push が要るなら次の手順）。

参照

• scripts/reset-context.sh — 失われるもの・push 影響・dirty 判定の read-only 収集
• scripts/reset-arm.sh — safety branch 作成 + guard 解錠
• 関連スキル: rebase-flow（rebase 失敗からの復旧で本スキルが呼ばれる。force-push 手順は rebase-flow §7）/ gh-push（非対話環境の push 委譲）

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yasunori0418
• Source: yasunori0418/skills
• License: MIT

Install and usage instructions live in the source repository linked above.