Repolode
ShadowSwaps

ShadowSwaps/REA-Reconstruction-Companion

REAツールと連携し、既存ソフトウェアの理解から再構築の計画、検証までをAIエージェントに支援するオープンソースのエージェントスキル。

スター
131
フォーク
22
未解決の Issue
0
最終コミット
7 日前

これは何?

REA-Reconstruction-Companionは、Agent Skills形式のMarkdownによる指示とリファレンスガイドで構成された、モデルに依存しないエージェントスキルです。既存ソフトウェアの動作を理解し、観察内容を要件と段階的な計画にまとめ、明示的に依頼された場合に限って選択した部分を実装するようAIエージェントをガイドします。各ステップでは、観察した動作、推論、設計上の選択を分けて記録し、再構築したものが元のソフトウェアと一致すると決めつけず、相違点や未解決事項を記録します。

このスキルは、ソフトウェアの調査と証拠の収集に使うツールを提供するREAとの併用を想定しています。コンパニオンは、同じエージェントがその証拠を要件、設計、実装、検証に活用できるよう支援します。付属のNode.js 20以降対応インストーラーは、Claude Code、Codex、汎用クライアントに対応し、ドライランでの事前確認、検証、バックアップ機能を備えています。オプションのREA連携を追加すると、REAのスキルファイルに目印付きのルールが挿入され、関連する再構築依頼でコンパニオンも読み込まれるようになります。

このプロジェクトでは、コストと権限にも明確な制限を設けています。料金が発生する可能性のある操作を開始しないようエージェントに指示し、無料であることを確認できないステップはスキップします。任意機能として、デフォルトでは無効のアップデート確認があり、実行は最大7日に1回です。新しいリリースをインストールする際には、ユーザーの承認が必要です。

主な機能

  • 01観察内容、ファイル、録画を、動作の説明、要件、未解決の質問にまとめます。
  • 02証拠にひも付いた受け入れ基準を含む仕様と、段階的な再構築計画を作成します。
  • 03実装を依頼された場合に限り、選択した動作をテスト可能な単位で段階的に構築します。
  • 04差分ファジング、ミューテーションテスト、インターフェース契約などの検証ガイドを含みます。
  • 05インストーラーはClaude Code、Codex、汎用のスキルディレクトリに対応し、ドライランモードとチェックモードを備えています。
  • 06オプションのREA連携により、元に戻せるルーティングルールがREAのスキルファイルに追加されます。

ユースケース

  • 類似ツールを計画する前に、既存のデスクトップアプリやWebアプリが保存、編集、インポートをどう処理するかを把握する。
  • 入力、出力、エラーケースを文書化しながら、1つの機能やファイル形式の再構築を計画する。
  • ローカルプロジェクトで選択したワークフローを再構築し、未検証の相違点を報告する。
  • 既存の再構築を、以前の成果との互換性を保ちながら復旧し、変更する。

クイックスタート

  1. 1

    GitHubからリポジトリをダウンロードまたはクローンします

  2. 2

    REAを変更せずにClaude Code用のコンパニオンをインストールします

    node install.mjs --client claude-code --integration off
  3. 3

    インストール前に変更をプレビューします(任意)

    node install.mjs --client claude-code --integration off --dry-run
  4. 4

    インストールを確認します

    node install.mjs --client claude-code --integration off --check

使う前に知っておきたいこと

  • インストーラーの実行にはNode.js 20以降が必要です。
  • ライブ調査を行うには、使用するクライアント向けにREAを別途インストールして設定する必要があります。
  • チャット専用クライアントやホスト型アップロードクライアントにはインストールできません。

収録されている特集

トピック

よくある質問

REA-Reconstruction-Companion とは?
REAツールと連携し、既存ソフトウェアの理解から再構築の計画、検証までをAIエージェントに支援するオープンソースのエージェントスキル。 REA-Reconstruction-Companionは、Agent Skills形式のMarkdownによる指示とリファレンスガイドで構成された、モデルに依存しないエージェントスキルです。既存ソフトウェアの動作を理解し、観察内容を要件と段階的な計画にまとめ、明示的に依頼された場合に限って選択した部分を実装するようAIエージェントをガイドします。各ステップでは、観察した動作、推論、設計上の選択を分けて記録し、再構築したものが元のソフトウェアと一致すると決めつけず、相違点や未解決事項を記録します。
REA-Reconstruction-Companion は無料で使えますか?ライセンスは?
REA-Reconstruction-Companion は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
REA-Reconstruction-Companion は今もメンテナンスされていますか?
活発にメンテナンス中。REA-Reconstruction-Companion の最終コミットは 2026年10月30日 です。
REA-Reconstruction-Companion は何に使えますか?
類似ツールを計画する前に、既存のデスクトップアプリやWebアプリが保存、編集、インポートをどう処理するかを把握する。 入力、出力、エラーケースを文書化しながら、1つの機能やファイル形式の再構築を計画する。 ローカルプロジェクトで選択したワークフローを再構築し、未検証の相違点を報告する。 既存の再構築を、以前の成果との互換性を保ちながら復旧し、変更する。
REA-Reconstruction-Companion のインストール方法は?
GitHubからリポジトリをダウンロードまたはクローンします REAを変更せずにClaude Code用のコンパニオンをインストールします: node install.mjs --client claude-code --integration off インストール前に変更をプレビューします(任意): node install.mjs --client claude-code --integration off --dry-run インストールを確認します: node install.mjs --client claude-code --integration off --check
REA-Reconstruction-Companion はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ShadowSwaps/REA-Reconstruction-Companion

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト