octopus-architecture について
octopus-architecture は Codex CLI 向けのアーキテクチャレビュー用スキルです。実装、呼び出し元、テスト、変更履歴、失敗時の挙動を調べてインターフェースを提案します。設計案を比較して判断を示しますが、自動リファクタリングは行いません。
主な機能
- 01根拠に基づくアーキテクチャレビュー
- 02呼び出し元、テスト、ソース履歴の確認
- 032つの設計案の比較
- 04移行とテストへの影響を明示
- 05範囲を限定した独立レビューの選択
活用シーン
- 01提案されたモジュール境界のレビュー
- 02呼び出し元とテストに基づく簡素化案の評価
- 03実証された拡張要件に向けた設計案の比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ nyldn/ claude-octopus --skill octopus-architectureインストール後、Claude Code で/octopus-architectureを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
ホスト:Codex CLI — このスキルはClaude Code向けに設計され、Codex向けに適応されています。 相互参照コマンドでは、
/octo:*スラッシュコマンドではなく、Codexにインストールされたスキル名を使用します。 現在のCodexシェルとサブエージェントツールを使用してください。現在のセッションで利用可能であることが確認できるまでは、プロバイダー、モデル、ホストのサブエージェントが利用可能だと主張しないでください。 ホストツールの対応については、skills/blocks/codex-host-adapter.mdを参照してください。
アーキテクチャレビュー
インストール済みプラグインの skills/blocks/engineering-method-selection.md を読み込み、
このタスクに関連する手法のみを適用してください。このエントリーポイントの
実行契約と出力形式は維持してください。参照先のスキルは指示として読み、
現在のコマンドを再帰的に呼び出したり、担当者の判断でプロバイダー呼び出しを追加したりしないでください。
この手法は現在のホストで実行してください。通常のアーキテクチャレビューでは、プロバイダーへの追加ディスパッチは発生しません。
--peer-review、明示的な独立レビューの
依頼、または既存のリスクポリシーがある場合は、Octopusルーティングを通じて、範囲を限定した外部レビュアーを1名追加できます。そのレビュアーがソースを読めない、または根拠に基づく見解を返さない場合は、独立レビューが不完全であると報告してください。
手法
インストール済みプラグインのルートにある skills/blocks/architecture-simplification.md を読み、
適用してください。境界を提案する前に、ソースリビジョンを特定し、実装、呼び出し元、テスト、
最近の変更、失敗時の挙動を調査してください。
単一の簡素化では、根拠に裏付けられたインターフェースを1つ提示してください。設計上の 選択では、変更されない同一の要件に基づいて、次の2つの案を提示してください。
- Draft Aは、呼び出し元が把握する情報と設定を最小限にします。
- Draft Bは、次に実証された拡張を容易にします。
ホストが生成した2つの案は、同一モデルによる相関した代替案として明記してください。独立したレビュアーが許可されている場合は、同じソースと要件を渡しますが、最初の回答を得るまではDraft Aを共有しないでください。転送経路が異なるからといって、モデルファミリーが異なるとは限りません。ファミリーが不明な場合は、独立性も不明です。
完了
Evidence、Caller contract、Proposed interface、Migration、Test impact、Decisionを返してください。Decisionはkeep、simplify、investigateのいずれかです。
simplifyには、ソースからの正確な根拠と具体的な呼び出し元の例が必要です。設計レビューだけでは、
自動リファクタリングは許可されません。
LSP統合
ホストで言語サーバーツールが利用できる場合は、インターフェースを提案する前に、ドキュメントシンボル、ワークスペースシンボル、定義、参照を使って、モジュール境界と呼び出し元の関係を確認してください。LSPの結果はインデックスとして扱ってください。 重要な主張はソースとテストで検証し、言語サーバーが利用できない、または不完全な場合は、 リポジトリ検索に切り替えてください。
mattpocock/skillsのcodebase-designおよびDESIGN-IT-TWICEを、MITライセンスのもと、
コミット3cca18b368ae95cdbdebbff572ccafa662551015から翻案しました。THIRD_PARTY_NOTICES.mdを参照してください。