tauri-agent-kit

agent-skills

コーディングエージェント向けの、独自の開発手法です。すべての変更は承認済みの Linear イシューから始まり、テストファーストで実装され、独立したレビューを通過し、あなたが指示した場合にのみプルリクエストに進みます。

この手法は、互いに呼び出し合うスキルの集合です。あわせて、エンジニアリング、Web、ゲーム開発向けのスタンドアロンのスキルも提供しており、必要なものを一つずつインストールできます。これらは独立した、コミュニティによってメンテナンスされているスキルであり、ベンダー公式の製品ではありません。

この手法 · 仕組み · はじめる · タスクから選ぶ · 要件 · すべてのスキル · コントリビュート

この手法

エージェントの失敗には予測可能なパターンがあります。決定が下される前に実装を始め、リポジトリにすでに書かれている内容をあなたに尋ね、自分の作業を自分で評価し、確認せずに公開します。この手法は、それぞれの失敗にルールで対処します。

• イシューがなければ、コードもありません。 小さな依頼も含め、すべての依頼は triage を経て Linear イシューになります。implement はイシューがなければ作業を拒否します。
• 事実は調べ、判断だけを尋ねます。 エージェントは、あなたに質問する前にリポジトリ、Linear、ドキュメントを読みます。あなたが答えるのは、スコープ、受け入れ条件、構成を変える選択肢だけです。
• 実装の前に決定します。 決定に根拠が必要な場合、triage はまず Research または Prototype イシューを計画し、その根拠をもとに決定を下す Interview イシューを続けて作成します。
• テストファーストです。 テストの境界が存在する場合、各動作は失敗するテストから始めます。
• 主張ではなく、証拠を重視します。 独立した読み取り専用のレビュー担当者が、要件、標準、正しさを確認します。エージェント同士の合意は証明にはなりません。実装担当のエージェントがすべての指摘を検証します。
• 鍵はあなたが持ちます。 イシューの公開、プルリクエストの作成、マージ、デプロイは、それぞれあなたの明示的な承認を待ちます。
• ポリシーは一つ、スキルはタスクに特化します。 認可、委任、検証、Git の規約、コードコメントなどの一般ルールは、共通の運用ポリシーに一度だけ記載します。スキルには、そのタスクに固有の内容だけを記載します。

仕組み

flowchart LR
    request([Your request]) --> triage
    triage <-->|open decisions| interview
    triage -->|after your approval| issue[(Linear issue)]
    issue --> implement
    implement -->|by issue type| route{{"debug · prototype<br/>research · interview"}}
    implement --> review[code-review]
    review --> pr([Pull request you approve])
    implement -.->|Need triage| triage

triage は既存の作業を見つけ、イシューの種類を選び、interview を通じて未決事項を解決し、あなたがドラフトを承認したら Todo にイシューを公開します。その後、implement は一度に一つのイシューに取り組み、種類に応じて振り分けます。

イシューの結果やスコープを変える作業は、現在のイシュー内で範囲を広げるのではなく、Need triage ラベルを付けて triage に戻します。 improve-architecture も同じループに加わります。承認済みのリファクタリングを、implement で着手できる Task イシューとして公開します。

はじめに

スキルとサブエージェントに対応したコーディングエージェント、インストーラー用の Node.js と npm、そしてエージェントがアクセスできる Linear ワークスペースが必要です。

1. プロジェクトでターミナルを開き、このメソッドをインストールします。

   npx skills add Firzus/agent-skills --skill setup-harness triage interview implement debug prototype research code-review improve-architecture
   

   インストーラーでエージェントとインストール先を指定します。デフォルトではプロジェクトにインストールされます。グローバルにインストールするには -g を追加してください。

2. setup-harness を一度実行します。変更内容全体を表示してから、共通の運用ポリシーを個人用の指示にインストールします。このメソッドはこのポリシーに依存します。

3. 小さなリクエストに対して triage を実行します。作成された課題を確認し、公開を承認します。

4. 公開済みの課題に対して implement を実行します。作業の検証後、プルリクエストを開くかどうかの確認を求められます。

呼び出したスキルが見つからない場合は、インストール先を確認してセッションを再起動してください。

# Browse the collection without installing it
npx skills add Firzus/agent-skills --list

# Choose skills interactively
npx skills add Firzus/agent-skills

# Manage installed skills
npx skills list
npx skills update implement
npx skills remove implement

タスクに応じて選ぶ

Linear やこのメソッドのほかの要素がなくても、単独で使えるスキルもあります。

単独で使う場合でも、エンジニアリングスキルは共通の運用ポリシーを前提とします。

要件

スキルをインストールしても、説明されているすべてのツールがインストールされたり、実行可能なすべての操作が許可されたりするわけではありません。まず、選択したスキルの前提条件を確認してください。

ホスト側でスキルのインストールがサポートされていても、動作やツールの利用可否が同一であるとは限りません。triage、interview、implement、improve-architecture、setup-harness など、明示的な起動が必要なワークフローは、選択した場合にのみ実行されます。

個人用ハーネスの手順

setup-harness は、設定するハーネスと言語を確認し、変更内容全体をプレビューして、承認を待ちます。組み込みのシステムプロンプトを置き換えることなく、個人用の指示を追加します。バックアップは作成されません。無関係な既存の指示は保持されます。

Cursor のプロジェクト用 AGENTS.md は、グローバル設定の代わりにはなりません。読み込み制限については native destinations を参照し、このスキルを実行する前に shared operating policy を確認してください。

Tauri の補助ツール

tauri スキルは、引き続きエージェント向けのエントリーポイントです。オプションの Windows 診断アプリケーションである tauri-agent-kit はこのリポジトリで保守されていますが、インストール可能なスキルではありません。スキルをインストールしても、MCP サーバーや Rust プラグインはインストールされません。互換性のあるプロジェクトに存在しない場合、スキルはインテグレーションを提案し、承認後にのみインストールします。アプリケーションに組み込む前に、キットの互換性と公開状況を確認してください。

reverse-engineer 補助サーバー

reverse-engineer スキルはシェルコマンドだけでも動作しますが、読み取り専用 MCP サーバーである mcp/reverse-engineer を使うと、より迅速かつ効率的です。スキルをインストールしてもサーバーはインストールされません。README の説明に従って、npm パッケージ reverse-engineer（アルファ版）をエージェントに登録してください。

すべてのスキル

エンジニアリング

Web とアプリの開発

ゲーム開発

貢献

問題を見つけた場合は、スキル名、エージェントとバージョン、期待される結果、実際の結果を添えて、issue を作成してください。 例から秘密情報や非公開のプロジェクトデータを削除してください。

リポジトリを変更する場合は、貢献範囲と検証方法についてAGENTS.mdをお読みください。スキルは skills/<section>/<name>/SKILL.md に配置します。参照資料やヘルパーはスキルのフォルダー内に置いてください。README のカタログとマーケットプレイスのマニフェストを、スキルのフォルダーと一致させてください。

MITライセンスの下で提供されています。