maggy

maggy skill の概要

maggy ができること

maggy は、claude-bootstrap 内で使うローカル AI エンジニアリング・コマンドセンターです。Issue の受付をそのまま実行につなげたいチーム向けに設計されています。maggy skill は、AI 優先の受信箱、ローカルの Claude Code 実行への素早い引き継ぎ、そして別の運用スタックを組まずに毎日の競合インテリジェンス・ブリーフィングを回したい人に向いています。

どんな人に向いているか

GitHub Issues、Asana、または同種のトラッカーをまたいでエンジニアリング作業を管理していて、一回ごとのプロンプトではなく継続的なワークフローがほしいなら maggy を使う価値があります。特に Project Management では、トリアージ、優先順位付け、実行状況の追跡を一か所で行いたい場合に有効です。

インストール前に確認すべきこと

maggy の主な価値は、単なるチャット支援ではありません。Issue の順位付け、コンテキスト注入、ローカル実行をひとつにまとめている点です。導入判断で最も重要なのは、execute 実行中に Claude に書き込み権限や shell 権限を付与する可能性があるワークフローを、チームが受け入れられるかどうかです。

maggy skill の使い方

maggy をインストールする

maggy skill は次のコマンドでインストールします:
npx skills add alinaqi/claude-bootstrap --skill maggy

きれいに maggy を導入するか判断するには、追加する前に、本当にリポジトリやトラッカーに結びついたローカルのコマンドセンター型ワークフローが必要かどうかを確認してください。チームが必要としているのが単一タスクのプロンプト改善だけなら、maggy は機構が大きすぎる可能性があります。

先に読むべきファイル

まず SKILL.md を読んで、想定されるワークフローと安全モデルを理解してください。この repository には追加の rules/、resources/、補助スクリプトがないため、skill ファイル自体が主な正本です。README.md や他のトップレベル文書は、後から repository に追加されていれば軽く確認する程度で十分です。

maggy にうまく指示するコツ

maggy への良い指示は、あいまいな依頼ではなく、具体的な運用目標から始まります。次の情報を含めてください:

• 優先順位をつけたい tracker や inbox
• maggy に対象としてほしい repo もしくは codebase の root
• チームにとっての「urgent」の定義
• 実行、レビュー、branch 扱いに関する制約

より強い入力例: 「billing service の open な GitHub Issues を、release risk と customer impact で順位付けして、上位の bug だけを TDD コンテキスト付きで実行して」
これは「tickets の管理を手伝って」と言うよりずっとよい指示です。判断基準が明確になるからです。

実用的なワークフロー

maggy は 2 段階で使うのが基本です。まずトリアージ、次に execute です。local Claude Code run を起動させる前に、まず inbox の順位付けを任せてください。というのも、この skill は issue のシグナルがすでに絞り込まれていて、対象 repo が明確なときに最も力を発揮するからです。Project Management で使う場合も、計画からエンジニアリング実行への引き継ぎがより安定します。

maggy skill の FAQ

maggy は Project Management 専用ですか?

いいえ。maggy skill は Project Management のワークフローを支援しますが、実際には issue のトリアージと local code execution を必要とするエンジニアリングチーム向けです。単なる status dashboard だけが欲しいなら、もっと軽いツールで足ります。

maggy は通常の prompt と何が違いますか?

通常の prompt でも ticket の要約はできますが、maggy は、優先順位付き inbox、execute への引き継ぎ、競合ブリーフィングという再現可能なワークフローを前提に設計されています。毎日同じ手順で回したいとき、毎回指示を書き直さなくて済むので、より実用的です。

maggy は安全にインストールできますか?

この skill には重要な権限モデル上の注意点があります。execute では、途中でローカル編集や shell コマンドが止められないように、Claude を --dangerously-skip-permissions 付きで実行する場合があります。強力ではありますが、codebase の root と tracker の入力が管理された環境でのみ使うべきです。

どんなときに maggy を使うべきではありませんか?

単発の簡易分析だけが必要な場合、環境がローカル書き込みを許容できない場合、あるいは issue データが雑すぎて優先順位を安定してつけられない場合は、maggy は選ばないでください。そのようなケースでは、より狭い prompt か、実行しないワークフローのほうが適しています。

maggy skill を改善する方法

maggy の順位付けシグナルを強くする

maggy の品質は、優先順位の定義がどれだけ明確かに大きく左右されます。出力をよくしたいなら、customer impact、blocker 状態、期限、OKR との整合性など、明示的な順位付け基準を渡してください。そうすることで、maggy skill はチームが信頼できる形で tickets を並べ替えやすくなります。

実行対象を絞り込む

弱い結果の多くは、repo のスコープがあいまいなことに起因します。どの codebase root、branch、service が対象なのかを maggy に正確に伝え、作業内容が bug fix なのか、test 修正なのか、feature work なのかも明記してください。これにより、別の repo が active worktree と誤認されるリスクを下げられます。

最初の実行品質を上げる

maggy に execute を依頼するときは、issue の本文、acceptance criteria、関連する file paths、既知の制約を含めてください。「壊れている test を直して」のようなざっくりした依頼より、「packages/api の billing test を修正し、挙動は変えず、現在の public API を維持して」のほうがはるかに有用です。

1 回目の実行後に改善する

maggy の結果が惜しいところまで来ているなら、プロンプト全体を書き直すより、1 つ足りない判断基準を追加して再調整してください。よくある失敗は、優先順位ラベルが曖昧なこと、tracker の文脈が不十分なこと、権限に関する期待がはっきりしないことです。こうした入力を絞り込むほうが、より広い答えを求めるより次の実行結果を改善しやすくなります。