0747fee394
.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>
82 lines
2.5 KiB
Markdown
82 lines
2.5 KiB
Markdown
# Codex Instructions — Polaris (miyabi-gate)
|
||
|
||
**バイナリ: `~/bin/miyabi-gate`**
|
||
|
||
このリポで作業する前に **必ず miyabi-gate gate を使うこと**。
|
||
使わずにファイルを編集すると pre-commit hook が拒否する。
|
||
|
||
## 初回（このリポで初めて作業する場合）
|
||
|
||
```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
|
||
```
|
||
|
||
## 禁止
|
||
|
||
- `miyabi-gate gate assign` なしでファイル編集 → pre-commit hook が拒否
|
||
- 他エージェントのロック中ファイルに触る → CLI が拒否 (exit 1)
|
||
- Issue なしでタスク開始 → GATE 0 が拒否
|
||
|
||
## exit code
|
||
|
||
- 0: 成功
|
||
- 1: GATE 拒否（条件を満たしてリトライ）
|
||
- 2: 入力エラー（コマンド修正）
|
||
|
||
## コミット規約
|
||
|
||
日本語タグ形式: `[追加]`, `[修正]`, `[改善]`, `[整備]`, `[文書]`, `[検証]`, `[完了]`
|
||
Issue 番号を含める: `[修正] 認証機能 (#45)`
|
||
|
||
## 品質チェック（コミット前）
|
||
|
||
```bash
|
||
cargo test --all
|
||
cargo clippy --all-targets --all-features -- -D warnings
|
||
```
|