@shinaps/skills 0.21.1 → 0.23.0

package/plugins/shinaps-codex/references/dev-comparison/workflow.md

@@ -0,0 +1,240 @@
+# 比較用 dev の工程
+
+eafbbc5 の Claude 版 `dev`（`plugins/shinaps-claude/skills/dev/SKILL.md`）の工程を役割単位で書いた比較用の工程である。比較用入口（`dev-mixed`・`dev-claude`・`dev-codex-astra`・`dev-codex-sol`）だけが使い、既存の `dev` とは独立に管理する。既存の `dev` を変更しても、この工程へは自動で反映しない。担当のモデルと起動手段は[構成表](configurations.md)と[起動手順](launch.md)に従い、記録は[実行記録](record.md)に従う。
+
+## 1. 前提
+
+### 作業記録の保存先
+
+作業記録はプロジェクトルートの `.shinaps/work/` 以下へ保存する。最初に記録を作るとき、`.shinaps/` を作成し、`.shinaps/.gitignore` がなければ内容 `*` と改行で作成する。既存ファイルは上書きせず、除外が不足する場合だけ `*` を追記する。ユーザーのグローバルignoreやルートの `.gitignore` の編集は不要。Git管理下では `git check-ignore` と `git status --short --untracked-files=all` で記録が未追跡変更に出ないことを確認する。既存の追跡済みファイルは自動で追跡解除しない。
+
+既存の `.claude/shinaps/` 等の記録は渡されたパスから読み、無断で移動・削除しない。新規記録は新しい保存先を使う。共有する仕様書などを `docs/` 等へ出す場合は、明示された成果物の保存先に従う。秘密情報は記録しない。
+
+### プロジェクト条件
+
+この節は以下の工程全体に適用する。適用される `AGENTS.md`・`CLAUDE.md` と参照先、CI、既存スクリプトから今回の条件を読み、比較条件ファイルと明示された依頼・許可を引き継ぐ。仕様に影響する不足だけ一問ずつ確認する。新しい恒久方針の保存はユーザーの了承を得てプロジェクト側へ行う。
+
+質問は現在のセッションで利用できる入力手段を使い、一問ずつ確認して回答を待つ。現在のセッションで提供されていないツールは仮定しない。
+
+### 実行の制約
+
+- 構成表の担当の起動は、比較用入口の実行に含まれる許可として行う。新しい作業環境（worktree・クローン）は作らない。作業環境は実施者が事前に用意する。
+- 構成表と[起動手順](launch.md)がその起動手段で指定する値（モデル・推論。起動手段が指定できる場合は tier・実行権限も）で担当を起動できなければ、他のモデル・設定・起動手段へ切り替えず、メインが代行もせず、その担当を未完了として記録する。
+- 構成表に無い AI への依頼手段（個人用のセカンドオピニオン、AI Terminal Bridge、他の AI を起動するスキルを含む）を使わない。AI Terminal Bridge で起動を依頼された場合の、依頼の受信と、依頼元への終了・停止の報告は、これに当たらない。実行中の質問は上の入力手段で行う。
+- 比較実行中は自動メモリへ書き込まない。
+- 規約は比較条件ファイルの規約スナップショットだけを使い、`search_rules` などの shinaps MCP を呼ばない。
+
+## 2. 役割と継続の規則
+
+| Phase | 役割 | 担当数 | 継続／新規 | 担当指示 |
+|---|---|---|---|---|
+| 2 | 探索 | 1（範囲分割の並列は担当数の設定と別に条件ファイルで固定する） | 新規 | [explorer](roles/explorer.md) |
+| 3 | 設計担当1（設計統合・プラン統合・設計適合性・指摘統合） | 1 | 全工程で継続 | [architect](roles/architect.md) |
+| 3 | 設計担当2 | 1体: なし／2体: あり | 設計の追加確認だけ継続。他の役割へ流用しない | [architect](roles/architect.md) |
+| 4 | 計画レビュー担当1 | 1 | 修正版の再確認で継続 | [plan-reviewer](roles/plan-reviewer.md) |
+| 4 | 計画レビュー担当2 | 1体: なし／2体: あり | 同上 | [plan-reviewer](roles/plan-reviewer.md) |
+| 4 | 計画簡素化担当1 | 1 | 同上 | [simplifier](roles/simplifier.md)（計画の簡素化） |
+| 4 | 計画簡素化担当2 | 1体: なし／2体: あり | 同上 | [simplifier](roles/simplifier.md)（計画の簡素化） |
+| 4, 6 | 指摘検証（verifier） | 1 | 検証ラウンドごとに新規 | [review-verifier](roles/review-verifier.md) |
+| 5, 7 | 実装 | 1（複製しない） | 修正で継続 | [implementer](roles/implementer.md) |
+| 6 | 設計適合性 | 1（設計担当1 を再開） | 継続 | [architect](roles/architect.md) |
+| 6 | 独立コードレビュー | 1 | ラウンドごとに新規 | [reviewer](roles/reviewer.md) |
+| 6 | refine | 1 | 同一ラウンドのバッチは継続 | [refine-agent](roles/refine-agent.md) |
+| 6 | 実装の簡素化 | 1 | ラウンドごとに新規 | [simplifier](roles/simplifier.md)（実装の簡素化） |
+
+- 担当を起動するときは[起動手順](launch.md)に従い、担当指示と今回の入力（役割名・担当番号・ラウンド・今回の割当と担当数）を渡す。担当番号は起動前に固定する。
+- 異なる役割は、同じモデルでも別のコンテキストで起動する。同じ役割の継続は同じ ID を再開する。再開できなければ同じ割当（モデル・推論・tier・起動手段）の新しい担当へ確認済み・未確認の範囲と最新の文脈を引き継ぎ、交代を実行記録に書く。
+- 設計担当2 を他の役割へ流用しない。設計担当1 は設計から指摘統合まで同じ ID で続ける。
+- 独立に確認する担当（設計担当、計画レビュー担当、計画簡素化担当、実装後の4役割）は、今回の他担当の結果を受け取らず、意見を交換しない。全担当の完了まで計画・対象コードを変更しない。
+- メインは担当の起動・待機・全文保存・受け渡し・ユーザーへの確認・実行記録だけを行う。指摘を先に選別・要約・重複整理せず、検証をやり直さない。担当は自分で他の担当やエージェントを起動しない。
+- 「並行して起動する」担当の数が、起動手段の同時実行の上限を超える場合は、[起動手順](launch.md)のとおり分けて起動する。分けても、担当の数・独立性・渡す情報は変えない。
+- 作業ツリー（未追跡ファイルを含む）は、実装担当の実行区間の外では変わらない。メインは、Phase 1 の開始時、実装担当の各依頼の前と完了後、Phase 9 の開始時に、作業ツリーの値（`git diff HEAD` の出力と、`git ls-files --others --exclude-standard -z | xargs -0 shasum -a 256` の出力を合わせた sha256。`.shinaps/` は除外されている）を記録する。実装担当の完了後から次の依頼の前まで（Phase 1〜実装前、実装後〜Phase 9 を含む）で値が変わっていれば、[実行記録](record.md)の判定に「制約違反あり」と、変化したパスを書く。前後の値の比較なので、区間の途中で変えて元に戻した場合は検出できない。
+
+## 3. 担当数の設定
+
+担当数の設定（1体／2体）が作用するのは、独立設計（Phase 3）・計画レビュー（Phase 4）・計画簡素化（Phase 4）の 3 か所の担当2 の有無だけである。1体の設定では担当2 を起動しない。実装担当は常に 1 体で、修正も同じ担当が行う。設計適合性・独立コードレビュー・refine・実装の簡素化・verifier を含む、それ以外の工程・役割・成果物・終了条件は担当数で変わらない。
+
+## 4. 実行フロー
+
+### Phase 1: 条件の受け取りと開始前の照合
+
+1. 比較条件ファイル（必須）を読み、課題・開始コミット・規約スナップショット・探索条件・合格条件・許可範囲・実行権限・この構成の親の起動方法を確定する。条件ファイルにこの構成が無ければ開始しない。
+2. 作業環境が開始状態であることを確認する。`HEAD` が開始コミットと一致し、`git status --porcelain` が空であること（`.shinaps/` は `.shinaps/.gitignore` で除外される）。満たさなければ開始しない。
+3. 課題から英語 slug（kebab-case、30 文字以内）を作り、作業ディレクトリ `.shinaps/work/{YYYYMMDD-HHMMSS}-{slug}/` と `raw/` を作る。
+4. `run-record.md` を作り、親の ID と指定値を記録し、[開始前の照合](record.md#開始前の照合)を行う。観測値が読めて指定値と一致しなければ開始しない。
+5. 課題に関連する既存の spec・調査レポート・Git の変更履歴を確認し、引き継ぐ決定と根拠を要約する。課題が成果物のパスを含む場合は読み、確定事項と未解決点を取り込む。
+6. 課題の文面が曖昧、または制約が不明確な場合はユーザーに確認する。
+
+### Phase 2: コードベース探索
+
+条件ファイルの規約スナップショットを規約全文として以降の担当へ渡す。`search_rules` を呼ばない。
+
+探索は条件ファイルの探索条件（探索担当数・範囲分割・既存調査の再利用可否）に従う。既存調査を再利用する条件なら、その成果物を読み、根拠のファイルが現在の内容と一致するかを確かめる。探索担当には課題、Phase 1 の既存成果物の要約、探索の狙い、規約スナップショットを渡す。
+
+記録先は `raw/explorer.md`（範囲分割時は `raw/explorer-{n}.md`）。
+
+### Phase 3: 実装ブループリント策定
+
+設計担当1 と、2体の設定なら設計担当2 を、同じ入力で並行して起動する。互いの案や今回の他担当のレポートを読ませず、読み取り専用で独立に設計させる。
+
+両者へ渡す情報:
+
+- 課題の目的・受入条件・合意済みの制約
+- Phase 2 の調査結果・必読ファイル・根拠
+- 規約スナップショットの全文
+- 既存配置を前提にせず、変更後の責務の所有者・配置・依存方向を先に決めること。必要な移動・分割・置き換えは変更量が大きくても含め、最小化するのは到達に不要な変更とする
+- 利用範囲が変わる責務の配置判断（移動／維持の理由）・外部契約・データフロー・全利用側の更新・実装順・回帰検証を、根拠付きの一つの推奨案として返すこと
+- コード編集・追加委託・shinaps MCP の直接呼び出しは禁止
+
+記録先は設計担当1 の案が `raw/architect-1.md`、設計担当2 の案が `raw/architect-2.md`。
+
+- 2体の設定: 両方の結果が揃ったら設計担当1 を「設計案統合」として再開し、両案の根拠・トレードオフを比較して一つの計画を返させ、`raw/architect.md` に保存する。多数決や単純な継ぎ合わせにせず、採否と理由を残す。設計者間の反復議論は追加しない。
+- 1体の設定: 設計担当1 の案を統合済みの計画とし、`raw/architect.md` に保存する。
+
+この計画を Phase 4 のレビュー対象にする。設計担当2 は設計上の追加確認が必要な場合だけ再開し、独立コードレビューなど他の役割へ流用しない。起動失敗や未完了を設計済みと扱わない。
+
+### Phase 4: プランレビューと計画の簡素化
+
+計画レビュー担当と計画簡素化担当（それぞれ担当1、2体の設定なら担当2 も）を、同じ計画で並行して起動する。
+
+計画レビュー担当へ渡す情報:
+
+- 課題の目的・受入条件、Phase 2 の調査結果と規約全文
+- Phase 3 の計画全文（再策定時は最新案）
+- 「設計・要件・実装可能性・リスク・テスト戦略をレビューし、判定と具体的な修正案を返す。他のプランレビュー担当の結果は読まず、意見を交換しない」
+
+計画簡素化担当へは、今回の目的・受入条件・最新計画・規約・調査結果・成果物パスを渡し、「計画の簡素化」として、仕様・状態・操作・実装方針から減らせるものだけを検討させる。
+
+全担当へ同じ計画を渡し、他担当の今回の結果は読ませない。全担当の完了まで計画を変更しない。メインは `raw/plan-review-{round}-{n}.md` / `raw/plan-simplify-{round}-{n}.md` に全文保存する（round は 1 始まり、n は担当番号）。未完了は同じ担当へ戻す。
+
+全結果が揃ったら、新しい verifier を起動して全結果を渡す（渡す内容は「指摘の検証」の節）。検証結果を `raw/plan-verification-{round}.md` に保存し、設計担当1 を「プラン統合」として再開する。設計担当1 は検証結果の全項目の採否・根拠と計画の修正案を返す。簡素化で機能・ユーザー体験・外部契約・受入条件が変わる提案は、変更点・失うもの・期待効果を示してメインからユーザーに確認する。承認前に計画へ採用しない。
+
+計画を変更する場合は設計担当1 が修正版を返し、メインが `raw/architect-revised-{round}.md` に保存する。同じ計画レビュー担当と計画簡素化担当へ同じ修正版・承認済み変更・前回の採否を渡し、再確認 → 新しい verifier → 設計担当1 を繰り返す。担当を再開できなければ同じ割当の担当へ引き継ぐ。他担当の今回の未確定結果は共有しない。
+
+計画段階には回数上限を設けない。修正不要で、採用すべき指摘と必要な判断・確認が解決したら `plan.md` を確定し、Phase 5 へ進む。回数を埋める再確認や、新しい根拠のない却下案の再提案は行わない。
+
+計画段階では refine を行わない。設計に関わる規約はプランレビューで確認し、コードの規約照合は実装後に行う。
+
+### Phase 5: 実装
+
+#### A. 引き継ぎ
+
+メインが `plan.md` を再読し、実装順を確認する。実装担当を 1 体起動し、以下を渡す。
+
+- 課題の目的・受入条件、確定した `plan.md` 全文
+- Phase 2 の調査結果と必読ファイル、Phase 4 のレビュー指摘と設計判断の理由
+- 規約スナップショットの全文
+- 作業ディレクトリ、担当するファイル・責務、既存の未コミット変更、必要な検証
+- 「同じ作業ツリーには他の作業があるため、他者の変更を戻さず、現在の内容に合わせて実装する」
+
+実装担当が作業している間は、メインも同じ範囲を編集しない。
+
+#### B. 実装と確認
+
+実装担当は確定した計画を実装し、セルフレビューの前に仕様を保つ簡素化と必要な検証を行う。メインは報告と実際の差分を確認する。
+
+目的・仕様を左右する不明点、計画と既存実装の不一致があれば、実装担当は変更を広げずメインへ返す。メインが既存の合意で解決できない点だけユーザーに一問ずつ確認し、決定を実装担当へ返す。通常の実装判断は既存規約に従って進める。
+
+実装担当の実装ミスによる検証失敗は 3 回まで自己修正する。それを超える場合はメインへ失敗の根拠と未解決点を返し、メインが「さらに修正試行 / Phase 6 のレビュー対象として差分を渡す / Phase 4 に戻って再策定する」をユーザーに確認する。
+
+#### C. 記録と検証
+
+メインが実装担当の報告を `implementation.md` に保存する。
+
+- 変更ファイルと変更内容、設計上の理由
+- 実装中の重要な判断、計画からの変更とその合意
+- 実行した検証コマンドと結果、未実施の確認
+- 残課題・規約衝突・未解決の論点
+
+必要な検証はプロジェクト規約・CI・変更の影響と条件ファイルの必須検証から決める。メインは報告だけで完了とせず、差分と検証の根拠を確認して Phase 6 へ進む。
+
+### Phase 6: 実装後の4役割を並行実行
+
+実装と必要な検証が終わった同じ差分を固定し、次の4役割を並行して起動する。review / refine / simplify スキルは呼ばない。実装後のレビューラウンドは初回を 1 として数え、最大 2 回までとする。計画段階のプランレビューはこの回数に含めない。
+
+| 役割 | 渡す情報 |
+|---|---|
+| 設計適合性（設計担当1 を再開） | 対象ファイルと差分（staged / unstaged / untracked を含む）、最終計画・受入条件・合意済み変更、実装報告と検証結果、規約全文 |
+| 独立コードレビュー（新規） | 同上 |
+| refine（1 体） | 規約全文、対象ファイル一覧、リポジトリルートの絶対パス、変更範囲の確認コマンド（`git diff HEAD -- <path>`。未追跡ファイルは全行を変更扱い）、バッチID |
+| 実装の簡素化（新規） | 目的・受入条件・最終計画・維持する契約・対象ファイルと差分・規約全文 |
+
+設計担当1 は自身の設計適合性レビューを確定するまで他担当の今回の結果を読まない。先に起動した担当の完了を待ってから次を起動するのではなく、4役割を起動してから結果を待つ。同じ担当を重複起動しない。対象が大きい場合は同じ担当を再開して続きのバッチを渡し、担当数や確認範囲を黙って減らさない。
+
+全担当は読み取り専用で、今回の他担当の結果を読まず、意見を交換しない。メインと実装担当も全結果が揃うまで対象を編集しない。途中で外部の変更が入った場合は、その影響範囲を最新の同じ差分で確認し直してから統合する。
+
+各担当の確認範囲・未完了報告を確認し、未確認部分は同じ担当へ戻す。失敗・未完了を「指摘なし」として処理しない。
+
+初回は `architecture-review.md` / `review.md` / `raw/refine.md` / `raw/simplify.md`、2回目は各ファイル名に `-2` を付けて保存する。4役割の全結果が揃ったら新しい verifier へ渡し、検証結果を `raw/implementation-verification-{round}.md` に保存する。検証完了後、設計担当1 を「指摘統合」として再開し、検証結果全文・原文への参照・差分の更新・検証結果・ラウンド番号を渡す。
+
+### 指摘の検証（Phase 4・6 共通）
+
+全担当の結果が揃ったら、新しい verifier を 1 体起動する。今回のレビューをした担当を流用しない。
+
+- 生レポート全文と原文のパス、各担当の確認範囲、目的・最新計画・受入条件・合意済み変更、対象コードと差分、検証結果、規約全文、ラウンド番号を渡す。
+- verifier が各指摘の根拠を検証して出典IDを保持し、重複・誤認・対立・未確認事項を整理する。
+- メインは出典の対応と完了状況を確認し、不足を同じ verifier へ戻す。検証不能は未確認として明示し、誤認も削除しない。失敗や未完了を検証済みとして先へ渡さない。
+
+### Phase 7: 設計担当1 が統合し、実装担当が修正
+
+設計担当1 が verifier の報告から全項目の採否を決め、対立・不確実性・設計上の重要点に必要な根拠を確認する。全件の事実確認を最初から繰り返さない。全指摘の採否と理由、採用した修正の対象・責務・具体的な変更・維持する契約・必要な検証を、一つの修正指示として返す。メインはそのまま記録し、仕様・受入条件の変更や未許可の範囲拡大が必要な点だけユーザーに確認する。通常の設計・修正判断をメインでやり直さない。
+
+修正不要なら Phase 9 へ進む。修正があれば、メインが同じ実装担当を再開し、設計担当1 の修正指示・確定した計画・現在の差分・規約・検証条件を渡す。再開できなければ実装履歴と採否を同じ割当の新しい担当へ引き継ぐ。設計担当1 は次のレビューに備えて継続し、コードを編集したり、実装担当を追加で起動したりしない。
+
+実装担当が修正と必要な検証を行い、変更・検証結果・未解決点を返す。メインは設計担当1 の採否と修正結果を `fix-log.md` に記録する。
+
+### Phase 8: 最大2ラウンドで終了する
+
+- **1回目のレビュー後に修正した場合**: 修正後の同じ差分について、Phase 6 の4役割を2回目として並行実行する。最新の計画、前回の指摘と採否、修正内容、検証結果を渡す。全結果を新しい verifier で検証してから設計担当1 に渡し、Phase 7 で必要な最終修正を実施する。
+- **2回目のレビュー後に修正した場合**: 実装担当が最終修正と必要なテストを行ったら Phase 9 へ進む。3回目の実装後レビューは起動しない。
+- **修正不要の場合**: 回数を埋めるために再実行せず Phase 9 へ進む。
+
+最大2回は実装後の全体レビューに対する上限であり、担当の再開・交代や計画の変更でリセットしない。検証失敗・重大な未解決事項・未完了の担当が残る場合も追加ラウンドで無期限に続けず、その状態を明記してユーザーへ返す。未完了の確認を完了済みのラウンドと偽らない。
+
+### Phase 9: 完了報告と実行記録の確定
+
+実施したレビュー回数、設計担当1 の判断と修正内容、検証結果、未解決事項を報告する。2回目の後に修正した場合は、その最終差分が再レビューされていないことを明記する。必須検証の失敗や重大な未解決事項があれば作業終了と品質上の完了を区別し、完了済みとは報告しない。
+
+[実行記録](record.md)の手順で観測値と使用量を読み、割当外の依頼の確認を行い、判定・2体目の発見の分類・修正回数・人の介入を `run-record.md` に確定する。
+
+比較実行ではコミット・PR・リリースを行わない。差分は未コミットのまま残し、回収は実施者が[比較手順](comparison.md)に従って行う。
+
+## 5. 成果物
+
+```text
+.shinaps/work/{YYYYMMDD-HHMMSS}-{slug}/
+├── run-record.md              ← 実行記録（record.md の様式）
+├── plan.md                    ← Phase 4 の全結果を検証・統合した最終 plan
+├── raw/
+│   ├── explorer.md            ← または explorer-1.md, explorer-2.md ...
+│   ├── architect-1.md         ← 設計担当1 の独立設計案
+│   ├── architect-2.md         ← 設計担当2 の独立設計案（2体の設定のみ）
+│   ├── architect.md           ← 統合した計画（1体の設定では設計担当1 の案）
+│   ├── plan-review-{round}-{n}.md   ← 計画レビュー担当 n の結果
+│   ├── plan-simplify-{round}-{n}.md ← 計画簡素化担当 n の結果
+│   ├── plan-verification-{round}.md ← 計画指摘の検証結果
+│   ├── implementation-verification-{round}.md ← 実装指摘の検証結果
+│   ├── refine.md              ← Phase 6 の規約照合の生レポート（2 回目は refine-2.md）
+│   ├── simplify.md            ← Phase 6 の実装の簡素化の生レポート（2 回目は simplify-2.md）
+│   ├── architect-revised-{n}.md  ← 計画の修正版（n は 1 始まり）
+│   ├── settings/              ← 観測値の抜粋
+│   ├── cli/                   ← codex exec のプロンプト・イベントログ（P1）
+│   └── agents/                ← サブエージェントへ渡した依頼の全文（P4〜P7）
+├── implementation.md          ← 実装ログ・変更ファイル一覧・動作確認結果
+├── architecture-review.md     ← 設計担当1 の設計適合性レビュー
+├── architecture-review-{n}.md ← 修正後の設計適合性レビュー
+├── review.md                  ← 独立コードレビューの生レポート
+├── review-{n}.md              ← 修正後の再レビュー（n は 2 始まり）
+└── fix-log.md                 ← 修正ループの履歴（修正があった場合のみ）
+```
+
+全担当の応答は全文を参照できる状態で保存する。担当は結果を文字列で返し、進行管理の成果物はメインが保存する。
+
+## 6. 終了条件
+
+Phase 8・9 の条件で終了する。設定の不一致・未検証の項目・未完了の担当があれば `run-record.md` の判定に書き、比較データとして扱える完了として報告しない（判定は[実行記録](record.md)の定義に従う）。
+
+## 7. テスト追加の判断
+
+テスト追加は既定の作業にしない。既存の規約・テストから何を保証したいプロジェクトかを確認し、不具合の再発防止、または合意された仕様・外部契約の明示と保証を目的にする。仕様を表す既存テストは、過去のバグに由来しなくても残す。追加・更新する場合は、防ぐ不具合または保証する仕様の根拠と期待挙動を示す。実装方法を変えても守るべき挙動を検証し、テストの現状だけから未合意の仕様を作らない。既存テストで保証できるなら重複を増やさない。新機能という理由だけの網羅、根拠のない仮想的な異常系、ライブラリ単体の挙動や実装手順をなぞるだけのテストは追加しない。既存テストの実行とプロジェクトが明示する必須保証は維持し、失敗する期待値を弱めたり既存テストを一括削除したりしない。
+設計・実装・レビューへこの判断基準を渡す。バグ修正の回帰確認は修正前後の挙動で行い、自動化が困難なら理由と確認結果を残す。テストを追加しない場合も、変更に必要な既存検証や動作確認は行う。

package/plugins/shinaps-codex/skills/dev-codex-astra/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: dev-codex-astra
+description: 比較実行用。shinaps:dev の工程を Codex（gpt-6-astra / medium）の担当だけで実行する（P4: 同じ役割1体、P5: 2体）。比較実行で明示的に指定された場合だけ使う。通常の開発には $shinaps:dev を使う。
+---
+
+# 比較用 dev（Codex gpt-6-astra）
+
+比較実行のための入口。工程は既存の `dev` ではなく、比較用の共通資料に従う。親と全担当のモデルは `gpt-6-astra`、推論は medium、tier は default。
+
+## 引数
+
+| 呼び出し | 構成 |
+|---|---|
+| `$shinaps:dev-codex-astra 1体 <比較条件ファイルの絶対パス>` | P4 |
+| `$shinaps:dev-codex-astra 2体 <比較条件ファイルの絶対パス>` | P5 |
+
+依頼に明示された引数だけを使い、条件ファイルを探したり推定したりしない。
+
+担当数（`1体` / `2体`）と比較条件ファイルはどちらも必須。どちらかが無い、または担当数が `1体` / `2体` 以外なら、「`$shinaps:dev-codex-astra <1体|2体> <比較条件ファイル>` で指定してください」と返して終了する。
+
+## 読む資料
+
+開始前に次をすべて読み、決めた構成で工程を進める。
+
+- [工程](../../references/dev-comparison/workflow.md)
+- [構成表](../../references/dev-comparison/configurations.md)
+- [起動手順](../../references/dev-comparison/launch.md)
+- [実行記録](../../references/dev-comparison/record.md)
+
+担当指示（工程の役割表から辿る `roles/` の各ファイル）は、そこから生成した比較専用の役割定義で担当に渡る。依頼の本文には入れない（[起動手順](../../references/dev-comparison/launch.md#codex-のサブエージェント)）。
+
+## 守ること
+
+- 構成表のこの構成の行にある担当だけを、[起動手順](../../references/dev-comparison/launch.md#codex-のサブエージェント)のとおり、比較専用の役割（`shinaps-comparison-*`）を指定した Codex のサブエージェントで起動する。`codex exec` を含め、構成表に無い AI への依頼（個人用のセカンドオピニオン、AI Terminal Bridge、他の AI を起動するスキルを含む）をしない。
+- 既存の `dev`・`review`・`refine`・`simplify` スキルと、比較専用の役割以外のカスタムエージェント（通常の dev の `shinaps-architect` などを含む）を使わない。
+
+## 完了報告
+
+- 工程の結果（工程の Phase 9 の報告項目）
+- `run-record.md` の判定（[実行記録](../../references/dev-comparison/record.md) の区分。当たるものをすべて）と、指定のみの項目、パス
+- 未検証の項目と、その理由

package/plugins/shinaps-codex/skills/dev-codex-astra/agents/openai.yaml

@@ -0,0 +1,2 @@
+policy:
+  allow_implicit_invocation: false

package/plugins/shinaps-codex/skills/dev-codex-sol/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: dev-codex-sol
+description: 比較実行用。shinaps:dev の工程を Codex（gpt-6.1-sol / medium）の担当だけで実行する（P6: 同じ役割1体、P7: 2体）。比較実行で明示的に指定された場合だけ使う。通常の開発には $shinaps:dev を使う。
+---
+
+# 比較用 dev（Codex gpt-6.1-sol）
+
+比較実行のための入口。工程は既存の `dev` ではなく、比較用の共通資料に従う。親と全担当のモデルは `gpt-6.1-sol`、推論は medium、tier は default。
+
+## 引数
+
+| 呼び出し | 構成 |
+|---|---|
+| `$shinaps:dev-codex-sol 1体 <比較条件ファイルの絶対パス>` | P6 |
+| `$shinaps:dev-codex-sol 2体 <比較条件ファイルの絶対パス>` | P7 |
+
+依頼に明示された引数だけを使い、条件ファイルを探したり推定したりしない。
+
+担当数（`1体` / `2体`）と比較条件ファイルはどちらも必須。どちらかが無い、または担当数が `1体` / `2体` 以外なら、「`$shinaps:dev-codex-sol <1体|2体> <比較条件ファイル>` で指定してください」と返して終了する。
+
+## 読む資料
+
+開始前に次をすべて読み、決めた構成で工程を進める。
+
+- [工程](../../references/dev-comparison/workflow.md)
+- [構成表](../../references/dev-comparison/configurations.md)
+- [起動手順](../../references/dev-comparison/launch.md)
+- [実行記録](../../references/dev-comparison/record.md)
+
+担当指示（工程の役割表から辿る `roles/` の各ファイル）は、そこから生成した比較専用の役割定義で担当に渡る。依頼の本文には入れない（[起動手順](../../references/dev-comparison/launch.md#codex-のサブエージェント)）。
+
+## 守ること
+
+- 構成表のこの構成の行にある担当だけを、[起動手順](../../references/dev-comparison/launch.md#codex-のサブエージェント)のとおり、比較専用の役割（`shinaps-comparison-*`）を指定した Codex のサブエージェントで起動する。`codex exec` を含め、構成表に無い AI への依頼（個人用のセカンドオピニオン、AI Terminal Bridge、他の AI を起動するスキルを含む）をしない。
+- 既存の `dev`・`review`・`refine`・`simplify` スキルと、比較専用の役割以外のカスタムエージェント（通常の dev の `shinaps-architect` などを含む）を使わない。
+
+## 完了報告
+
+- 工程の結果（工程の Phase 9 の報告項目）
+- `run-record.md` の判定（[実行記録](../../references/dev-comparison/record.md) の区分。当たるものをすべて）と、指定のみの項目、パス
+- 未検証の項目と、その理由

package/plugins/shinaps-codex/skills/dev-codex-sol/agents/openai.yaml

@@ -0,0 +1,2 @@
+policy:
+  allow_implicit_invocation: false

package/plugins/shinaps-codex/skills/linear/references/workflow.md

@@ -94,6 +94,7 @@ AI Terminal Bridge（以下Bridge）の本体は同梱しない。導入済み
 | 完了の報告（ClaudeからCodex） | 対象差分、自動検証の結果、起動方法、確認観点、既知の制限、未解決の事項、`shinaps:dev` 内のレビュー結果の要約と未解決の指摘。コミットした場合は、コミットSHAと `shinaps:commit` の検証・レビューの結果 |
 | 人のレビュー・コミット完了の報告（ClaudeからCodex） | 下の「人のレビュー・コミット完了の報告」の項目 |
 | 開発進行の引き渡し（ClaudeからCodex） | 利用者からの依頼の内容、対象Issue・Cycle、作業先リポジトリ、利用者が示した範囲と条件。Codexは作業先リポジトリの設定と照合して進行を始め、不足する判断はCodexから利用者へ確認する |
+| 比較実行の依頼（CodexからClaude） | [比較手順](../../../references/dev-comparison/comparison.md#5-実行)の項目だけ。下の定型文と許可範囲は含めない。Claudeは指定された比較用入口で実行し、このスキルの実装・修正の手順（`shinaps:dev`、Codexへの相談、コミット）を適用しない |
 
 コミットの依頼では、`commit_mode` がない場合の開始時の確認と、通常モードの単位ごとの承認を、Codexが人へ取り次ぐ。Codexは自分で選択・承認しない。