diff --git a/.codex/instructions.md b/.codex/instructions.md index 769ffc7..ae7a0b9 100644 --- a/.codex/instructions.md +++ b/.codex/instructions.md @@ -1,40 +1,82 @@ -# Codex Instructions for Polaris +# Codex Instructions — Polaris (miyabi-gate) -## 最重要ルール: miyabi gate を使え +**バイナリ: `~/bin/miyabi-gate`** -タスクを始める前に必ず: -1. `miyabi gate register --issue --title "タスク名"` -2. `miyabi gate impact --risk --symbols ` -3. `miyabi gate assign --agent codex --node macbook --files "変更ファイル"` +このリポで作業する前に **必ず miyabi-gate gate を使うこと**。 +使わずにファイルを編集すると pre-commit hook が拒否する。 -ファイルを編集した後: -4. `miyabi gate branch feature/issue--` -5. `miyabi gate pr ` -6. `miyabi gate merge ` +## 初回（このリポで初めて作業する場合） + +```bash +miyabi-gate gate init +``` + +## タスク実行フロー（必ずこの順序で実行） + +```bash +# 1. タスク登録（Issue 番号必須） +miyabi-gate gate register --issue 45 --title "認証機能修正" + +# 業務タスク（コード変更なし）の場合: +miyabi-gate gate register --issue 45 --title "ドキュメントレビュー" --completion-mode manual + +# 2. 影響分析を記録 +miyabi-gate gate impact --risk low --symbols 3 +# HIGH/CRITICAL は承認必須: +miyabi-gate gate impact --risk high --symbols 12 --approve + +# 3. ファイルロック獲得（ここから作業開始） +miyabi-gate gate assign --agent codex --node macbook --files "src/auth.rs" +# → 実行プランが表示される。それに従う。 + +# 4. ロックしたファイルだけを編集する + +# 5a. コードタスクの完了: +miyabi-gate gate branch feature/issue-45-auth +miyabi-gate gate pr 78 +miyabi-gate gate merge <40文字SHA> + +# 5b. 業務タスクの完了: +miyabi-gate gate manual-complete --reason "完了理由" --operator codex +``` + +## 確認コマンド + +```bash +miyabi-gate gate status # 全タスク一覧 +miyabi-gate gate locks # ロック中ファイル一覧 +miyabi-gate gate dag # DAG 依存関係 +miyabi-gate gate dispatchable # 実行可能タスク +miyabi-gate gate attach # コンテキスト表示 +miyabi-gate gate --format json status # JSON 出力 +``` + +## 緊急時 + +```bash +miyabi-gate gate force-unlock --reason "理由" --operator codex +``` ## 禁止 -- assign せずにファイルを編集しない（pre-commit hook が拒否する） -- 他のエージェントがロック中のファイルに触らない -- Issue なしで作業を始めない +- `miyabi-gate gate assign` なしでファイル編集 → pre-commit hook が拒否 +- 他エージェントのロック中ファイルに触る → CLI が拒否 (exit 1) +- Issue なしでタスク開始 → GATE 0 が拒否 -## 確認 +## exit code -```bash -miyabi gate status # 全タスク -miyabi gate locks # ロック中ファイル -miyabi gate dispatchable # 実行可能タスク -miyabi gate dag # 依存関係 -``` +- 0: 成功 +- 1: GATE 拒否（条件を満たしてリトライ） +- 2: 入力エラー（コマンド修正） -## 品質 +## コミット規約 + +日本語タグ形式: `[追加]`, `[修正]`, `[改善]`, `[整備]`, `[文書]`, `[検証]`, `[完了]` +Issue 番号を含める: `[修正] 認証機能 (#45)` + +## 品質チェック（コミット前） ```bash cargo test --all cargo clippy --all-targets --all-features -- -D warnings ``` - -## コミット - -日本語タグ形式: `[追加]`, `[修正]`, `[改善]`, `[整備]`, `[文書]`, `[検証]`, `[完了]` -Issue 番号を含める: `[修正] GATE 0 拒否 (#52)` diff --git a/skills/miyabi-gate-cli/SKILL.md b/skills/miyabi-gate-cli/SKILL.md index 5fbfff9..cbcbd8a 100644 --- a/skills/miyabi-gate-cli/SKILL.md +++ b/skills/miyabi-gate-cli/SKILL.md @@ -1,12 +1,28 @@ # miyabi gate CLI — 確定的タスク実行スキル +## バイナリ + +**`~/bin/miyabi-gate`** （全ノードにインストール済み） + ## 概要 -Polaris (DTP) の CLI インターフェース。エージェントがタスクの登録・ロック・検証・完了を確定的に実行する。 +Polaris (DTP) の CLI。タスクの登録・ロック・検証・完了を確定的に実行する。 +ファイル編集前に必ず `miyabi-gate gate assign` でロックを取得すること。 + +## クイックスタート + +```bash +miyabi-gate gate init # 初回のみ +miyabi-gate gate register --issue 1 --title "タスク名" # タスク登録 +miyabi-gate gate impact issue-1 --risk low --symbols 0 # 影響分析 +miyabi-gate gate assign issue-1 --agent claude --node macbook --files "src/main.rs" # ロック獲得 +# → 作業実施 +miyabi-gate gate manual-complete issue-1 --reason "完了" --operator claude # 完了 +``` ## トリガー -miyabi gate, polaris, dtp, タスク登録, ロック, GATE, 確定的, deterministic +miyabi gate, miyabi-gate, polaris, dtp, タスク登録, ロック, assign, GATE, 確定的, deterministic, ファイルロック, 依存関係, DAG ## 前提