[整備] MiyabiGate スキル: miyabi-gate と miyabi の区別を明記
- miyabi-gate gate ... が Polaris GATE CLI - miyabi は別の hub CLI（使わない） - Claude Code での正式運用フロー追記 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
林 駿甫 (Shunsuke Hayashi)
parent
0747fee394
commit
9edc191907
1 changed files with 51 additions and 30 deletions
|
|
@ -1,4 +1,4 @@
|
|||
# miyabi gate CLI — 確定的タスク実行スキル
|
||||
# MiyabiGate — 確定的タスク実行スキル
|
||||
|
||||
## バイナリ
|
||||
|
||||
|
|
@ -6,15 +6,19 @@
|
|||
|
||||
## 概要
|
||||
|
||||
Polaris (DTP) の CLI。タスクの登録・ロック・検証・完了を確定的に実行する。
|
||||
Polaris (DTP) の公式 GATE CLI。タスクの登録・ロック・検証・完了を確定的に実行する。
|
||||
ファイル編集前に必ず `miyabi-gate gate assign` でロックを取得すること。
|
||||
|
||||
Claude Code では、このスキルを `MiyabiGate` として扱う。
|
||||
`miyabi` は別の hub CLI なので、Polaris の GATE 操作には使わず、標準コマンドは `miyabi-gate gate ...` とする。
|
||||
`miyabi gate` と打つと別 CLI の help を見に行くので、誤って使わないこと。
|
||||
|
||||
## クイックスタート
|
||||
|
||||
```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 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 # 完了
|
||||
|
|
@ -22,7 +26,7 @@ miyabi-gate gate manual-complete issue-1 --reason "完了" --operator claude #
|
|||
|
||||
## トリガー
|
||||
|
||||
miyabi gate, miyabi-gate, polaris, dtp, タスク登録, ロック, assign, GATE, 確定的, deterministic, ファイルロック, 依存関係, DAG
|
||||
MiyabiGate, miyabi gate, miyabi-gate, polaris, dtp, タスク登録, ロック, assign, GATE, 確定的, deterministic, ファイルロック, 依存関係, DAG
|
||||
|
||||
## 前提
|
||||
|
||||
|
|
@ -30,81 +34,87 @@ miyabi gate, miyabi-gate, polaris, dtp, タスク登録, ロック, assign, GATE
|
|||
- ワークスペース: `/Users/shunsukehayashi/dev/platform/miyabi-cli-standalone`
|
||||
- tasks.json: `project_memory/tasks.json`（デフォルト）
|
||||
|
||||
## 公式の使い分け
|
||||
|
||||
- `MiyabiGate`: task の register、impact、assign、branch、pr、merge を進める
|
||||
- `Polaris`: Phase 実行、品質チェック、handoff を進める
|
||||
- `polaris-gate` rule: `miyabi-cli-standalone` での必須順序を強制する
|
||||
|
||||
## コマンド一覧
|
||||
|
||||
### タスク登録
|
||||
|
||||
```bash
|
||||
miyabi gate register --issue 45 --title "認証移行"
|
||||
miyabi gate register --issue 45 --title "認証移行" --format json
|
||||
miyabi gate register --issue 45 --title "認証移行" --store-path /path/to/tasks.json
|
||||
miyabi-gate gate register --issue 45 --title "認証移行"
|
||||
miyabi-gate gate register --issue 45 --title "認証移行" --format json
|
||||
miyabi-gate gate register --issue 45 --title "認証移行" --store-path /path/to/tasks.json
|
||||
```
|
||||
|
||||
### タスク状態確認
|
||||
|
||||
```bash
|
||||
miyabi gate status # 全タスク一覧
|
||||
miyabi gate status task-001 # 特定タスク
|
||||
miyabi gate status --format json # JSON出力
|
||||
miyabi-gate gate status # 全タスク一覧
|
||||
miyabi-gate gate status task-001 # 特定タスク
|
||||
miyabi-gate gate status --format json # JSON出力
|
||||
```
|
||||
|
||||
### 実行可能タスク
|
||||
|
||||
```bash
|
||||
miyabi gate dispatchable # DAG依存解決済みのタスク
|
||||
miyabi gate dispatchable --format json
|
||||
miyabi-gate gate dispatchable # DAG依存解決済みのタスク
|
||||
miyabi-gate gate dispatchable --format json
|
||||
```
|
||||
|
||||
### DAG 可視化
|
||||
|
||||
```bash
|
||||
miyabi gate dag # DAGレベル表示
|
||||
miyabi-gate gate dag # DAGレベル表示
|
||||
```
|
||||
|
||||
### impact 記録
|
||||
|
||||
```bash
|
||||
miyabi gate impact task-001 --risk LOW --symbols 3
|
||||
miyabi gate impact task-001 --risk HIGH --symbols 12 # → 人間承認が必要
|
||||
miyabi gate impact task-001 --risk HIGH --symbols 12 --approve # 承認付き
|
||||
miyabi-gate gate impact task-001 --risk LOW --symbols 3
|
||||
miyabi-gate gate impact task-001 --risk HIGH --symbols 12 # → 人間承認が必要
|
||||
miyabi-gate gate impact task-001 --risk HIGH --symbols 12 --approve # 承認付き
|
||||
```
|
||||
|
||||
### ロック獲得 + 実装開始
|
||||
|
||||
```bash
|
||||
miyabi gate assign task-001 --agent codex --node macbook --files "src/auth.rs,src/middleware.rs"
|
||||
miyabi-gate gate assign task-001 --agent claude --node macbook --files "src/auth.rs,src/middleware.rs"
|
||||
```
|
||||
|
||||
### ブランチ記録
|
||||
|
||||
```bash
|
||||
miyabi gate branch task-001 feature/issue-45-auth
|
||||
miyabi-gate gate branch task-001 feature/issue-45-auth
|
||||
```
|
||||
|
||||
### PR 記録
|
||||
|
||||
```bash
|
||||
miyabi gate pr task-001 78
|
||||
miyabi-gate gate pr task-001 78
|
||||
```
|
||||
|
||||
### merge 検証 + 完了
|
||||
|
||||
```bash
|
||||
miyabi gate merge task-001 a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2
|
||||
miyabi-gate gate merge task-001 a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2
|
||||
```
|
||||
|
||||
### ロック一覧
|
||||
|
||||
```bash
|
||||
miyabi gate locks # 現在のロック一覧
|
||||
miyabi gate locks --format json
|
||||
miyabi-gate gate locks # 現在のロック一覧
|
||||
miyabi-gate gate locks --format json
|
||||
```
|
||||
|
||||
### escape hatch
|
||||
|
||||
```bash
|
||||
miyabi gate force-unlock task-001 --reason "agent crashed" --operator hayashi
|
||||
miyabi gate manual-complete task-001 --reason "doc task, no PR" --operator hayashi
|
||||
miyabi-gate gate force-unlock task-001 --reason "agent crashed" --operator hayashi
|
||||
miyabi-gate gate manual-complete task-001 --reason "doc task, no PR" --operator hayashi
|
||||
```
|
||||
|
||||
## exit code
|
||||
|
|
@ -121,24 +131,24 @@ miyabi gate manual-complete task-001 --reason "doc task, no PR" --operator hayas
|
|||
|
||||
```bash
|
||||
# タスク登録
|
||||
miyabi gate register --issue 45 --title "認証移行" --format json
|
||||
miyabi-gate gate register --issue 45 --title "認証移行" --format json
|
||||
|
||||
# 状態確認
|
||||
miyabi gate status task-001 --format json
|
||||
miyabi-gate gate status task-001 --format json
|
||||
|
||||
# ロック獲得
|
||||
miyabi gate assign task-001 --agent claude --node macbook --files "src/auth.rs"
|
||||
miyabi-gate gate assign task-001 --agent claude --node macbook --files "src/auth.rs"
|
||||
```
|
||||
|
||||
### Codex から
|
||||
|
||||
```bash
|
||||
# Codex は --format json で結果をパースする
|
||||
result=$(miyabi gate register --issue 45 --title "test" --format json)
|
||||
result=$(miyabi-gate gate register --issue 45 --title "test" --format json)
|
||||
exit_code=$?
|
||||
if [ $exit_code -eq 0 ]; then
|
||||
task_id=$(echo "$result" | jq -r '.task_id')
|
||||
miyabi gate assign "$task_id" --agent codex --node macbook --files "src/test.rs"
|
||||
miyabi-gate gate assign "$task_id" --agent codex --node macbook --files "src/test.rs"
|
||||
fi
|
||||
```
|
||||
|
||||
|
|
@ -146,10 +156,20 @@ fi
|
|||
|
||||
```bash
|
||||
# OpenClaw main がディスパッチ
|
||||
miyabi gate dispatchable --format json | jq -r '.[0].id'
|
||||
miyabi-gate gate dispatchable --format json | jq -r '.[0].id'
|
||||
# → サブエージェントに渡す
|
||||
```
|
||||
|
||||
## Claude Code での正式運用
|
||||
|
||||
1. `miyabi-gate gate register` で task を作る
|
||||
2. `miyabi-gate gate impact` で risk を記録する
|
||||
3. `miyabi-gate gate assign` でロックを取ってから編集する
|
||||
4. 実装後に `miyabi-gate gate branch` と `miyabi-gate gate pr` を記録する
|
||||
5. merge 済みなら `miyabi-gate gate merge`、PR を伴わない文書作業なら `manual-complete` を使う
|
||||
|
||||
`miyabi-cli-standalone` では `polaris-gate` rule が前提なので、assign 前の編集は不可。
|
||||
|
||||
## GATE フロー
|
||||
|
||||
```
|
||||
|
|
@ -174,3 +194,4 @@ register (GATE 0: Issue必須)
|
|||
- `rust-llm-pitfalls` — Rust 開発時の注意点
|
||||
- `context-and-impact` — コンテキスト収集パイプライン
|
||||
- `gitnexus-impact-analysis` — GNI 影響分析
|
||||
- `polaris-gate` rule — `miyabi-cli-standalone` での必須運用ルール
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue