[整備] 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`**
|
||||
|
||||
タスクを始める前に必ず:
|
||||
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)`
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
## 前提
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue