mcpField
O
octopus-architecture

octopus-architecture

github.com/nyldn開発4.3k63 回インストール今日更新
リポジトリ

octopus-architecture について

octopus-architecture は Codex CLI 向けのアーキテクチャレビュー用スキルです。実装、呼び出し元、テスト、変更履歴、失敗時の挙動を調べてインターフェースを提案します。設計案を比較して判断を示しますが、自動リファクタリングは行いません。

主な機能

  1. 01根拠に基づくアーキテクチャレビュー
  2. 02呼び出し元、テスト、ソース履歴の確認
  3. 032つの設計案の比較
  4. 04移行とテストへの影響を明示
  5. 05範囲を限定した独立レビューの選択

活用シーン

  1. 01提案されたモジュール境界のレビュー
  2. 02呼び出し元とテストに基づく簡素化案の評価
  3. 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を参照してください。

コメント