[整備] 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:
parent
0c5dec9950
commit
0747fee394
2 changed files with 86 additions and 28 deletions
|
|
@ -1,40 +1,82 @@
|
||||||
# Codex Instructions for Polaris
|
# Codex Instructions — Polaris (miyabi-gate)
|
||||||
|
|
||||||
## 最重要ルール: miyabi gate を使え
|
**バイナリ: `~/bin/miyabi-gate`**
|
||||||
|
|
||||||
タスクを始める前に必ず:
|
このリポで作業する前に **必ず miyabi-gate gate を使うこと**。
|
||||||
1. `miyabi gate register --issue <N> --title "タスク名"`
|
使わずにファイルを編集すると pre-commit hook が拒否する。
|
||||||
2. `miyabi gate impact <task-id> --risk <level> --symbols <N>`
|
|
||||||
3. `miyabi gate assign <task-id> --agent codex --node macbook --files "変更ファイル"`
|
|
||||||
|
|
||||||
ファイルを編集した後:
|
## 初回(このリポで初めて作業する場合)
|
||||||
4. `miyabi gate branch <task-id> feature/issue-<N>-<slug>`
|
|
||||||
5. `miyabi gate pr <task-id> <PR番号>`
|
```bash
|
||||||
6. `miyabi gate merge <task-id> <SHA>`
|
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 が拒否する)
|
- `miyabi-gate gate assign` なしでファイル編集 → pre-commit hook が拒否
|
||||||
- 他のエージェントがロック中のファイルに触らない
|
- 他エージェントのロック中ファイルに触る → CLI が拒否 (exit 1)
|
||||||
- Issue なしで作業を始めない
|
- Issue なしでタスク開始 → GATE 0 が拒否
|
||||||
|
|
||||||
## 確認
|
## exit code
|
||||||
|
|
||||||
```bash
|
- 0: 成功
|
||||||
miyabi gate status # 全タスク
|
- 1: GATE 拒否(条件を満たしてリトライ)
|
||||||
miyabi gate locks # ロック中ファイル
|
- 2: 入力エラー(コマンド修正)
|
||||||
miyabi gate dispatchable # 実行可能タスク
|
|
||||||
miyabi gate dag # 依存関係
|
|
||||||
```
|
|
||||||
|
|
||||||
## 品質
|
## コミット規約
|
||||||
|
|
||||||
|
日本語タグ形式: `[追加]`, `[修正]`, `[改善]`, `[整備]`, `[文書]`, `[検証]`, `[完了]`
|
||||||
|
Issue 番号を含める: `[修正] 認証機能 (#45)`
|
||||||
|
|
||||||
|
## 品質チェック(コミット前)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cargo test --all
|
cargo test --all
|
||||||
cargo clippy --all-targets --all-features -- -D warnings
|
cargo clippy --all-targets --all-features -- -D warnings
|
||||||
```
|
```
|
||||||
|
|
||||||
## コミット
|
|
||||||
|
|
||||||
日本語タグ形式: `[追加]`, `[修正]`, `[改善]`, `[整備]`, `[文書]`, `[検証]`, `[完了]`
|
|
||||||
Issue 番号を含める: `[修正] GATE 0 拒否 (#52)`
|
|
||||||
|
|
|
||||||
|
|
@ -1,12 +1,28 @@
|
||||||
# miyabi gate CLI — 確定的タスク実行スキル
|
# 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
|
||||||
|
|
||||||
## 前提
|
## 前提
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue