[整備] Codex + Claude Code スキルを強化: バイナリパス明記 + 全コマンド例 + init

.codex/instructions.md: 全フロー + 全コマンド + exit code + 禁止事項
skills/miyabi-gate-cli/SKILL.md: バイナリパス + クイックスタート追加

バイナリ名: miyabi-gate (~/bin/miyabi-gate)
コマンド: miyabi-gate gate <subcommand>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
林 駿甫 (Shunsuke Hayashi) 2026-04-10 09:07:49 +09:00
parent 0c5dec9950
commit 0747fee394
2 changed files with 86 additions and 28 deletions

View file

@ -1,40 +1,82 @@
# Codex Instructions for Polaris
# Codex Instructions — Polaris (miyabi-gate)
## 最重要ルール: miyabi gate を使え
**バイナリ: `~/bin/miyabi-gate`**
タスクを始める前に必ず:
1. `miyabi gate register --issue <N> --title "タスク名"`
2. `miyabi gate impact <task-id> --risk <level> --symbols <N>`
3. `miyabi gate assign <task-id> --agent codex --node macbook --files "変更ファイル"`
このリポで作業する前に **必ず miyabi-gate gate を使うこと**
使わずにファイルを編集すると pre-commit hook が拒否する。
ファイルを編集した後:
4. `miyabi gate branch <task-id> feature/issue-<N>-<slug>`
5. `miyabi gate pr <task-id> <PR番号>`
6. `miyabi gate merge <task-id> <SHA>`
## 初回(このリポで初めて作業する場合)
```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 <task-id> --risk low --symbols 3
# HIGH/CRITICAL は承認必須:
miyabi-gate gate impact <task-id> --risk high --symbols 12 --approve
# 3. ファイルロック獲得(ここから作業開始)
miyabi-gate gate assign <task-id> --agent codex --node macbook --files "src/auth.rs"
# → 実行プランが表示される。それに従う。
# 4. ロックしたファイルだけを編集する
# 5a. コードタスクの完了:
miyabi-gate gate branch <task-id> feature/issue-45-auth
miyabi-gate gate pr <task-id> 78
miyabi-gate gate merge <task-id> <40文字SHA>
# 5b. 業務タスクの完了:
miyabi-gate gate manual-complete <task-id> --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 <task-id> # コンテキスト表示
miyabi-gate gate --format json status # JSON 出力
```
## 緊急時
```bash
miyabi-gate gate force-unlock <task-id> --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)`

View file

@ -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
## 前提