earmark は何をしますか？
プロジェクトのエージェントは、.earmark/内の1つのイシューボードを共有し、earmark CLIを介してのみアクセスします。エージェント同士が直接メッセージを送ることはありません。作業、依存関係、ハンドオフはすべてボード上で管理されます。出力はエージェント向けにプレーンテキストで最適化されています。エラーの場合はerror:とhint:を表示し、次に実行すべきコマンドを示します。
開始
earmark info。コマンドが見つからない場合: このファイルの横にあるearmarkランチャーを使用してください。それもない場合: ユーザーにuv tool install git+https://github.com/hec-ovi/earmark-skillの実行を依頼してください。自分でインストールしないでください。earmark join <profile> --cli <claude-code|codex|grok|agy|opencode>を、ユーザーが指定したプロファイルで実行します。指定がない場合はworkerを使用します。ブリーフィングにあなたのハンドル、役割プロンプト、スコープ、ループが表示されるので、それに従ってください。no boardと表示された場合は、ユーザーがボードを要求した場合にのみearmark initを実行します。- 以降のすべてのコマンドには
--as <handle>を渡します。各シェル呼び出しはクリーンな状態で開始されます。ハンドルを忘れた場合:earmark team。
変更された部分のみにトークンを使用する
| 必要な操作 | コマンド |
|---|---|
| 作業開始: イシューをクレームし、未読コメントを確認 | earmark next |
| 自分に関連する変更点をイシューごとに1行で表示 | earmark check |
| 特定のフィールドや一部のみを、複数イシュー同時に表示 | earmark show KEY [KEY…] -f status,title · -f comments --new · -f attachments |
| ファイル（画像、音声、ログ） | earmark attachments KEY を実行し、出力されたパスを自分のツールで開く |
| 特定の領域を、まれに参照 | earmark topics PATH --depth 2 · earmark ls -t PATH --ready |
コマンドが · N changes for you で終了した場合、およびイシュー間で earmark check を実行してください。ボード全体をリスト表示したり、既に見たものを再度読み直したりしないでください。自分のイシューが参照しているコードのみを読んでください。
Worker ループ
earmark nextで最適な準備完了イシューをクレームし、未読コメントとともに表示します。Exit 4: 6へ進む。- そのイシューのみを処理します。長時間の作業の場合、30～60分ごとに
earmark comment KEY "<done, next>" --kind progressを実行します。これによりリースが更新されます（デフォルト120分）。サイレント状態のクレームは期限切れとなり、他のエージェントに取得されます。 - 他の専門家にしかできない作業（画像、音声、コピーなど）が必要な場合:
earmark need KEY "<what, format, where it goes>" -t <topic> [--assign <handle>]を実行します。KEYは保留状態になり、そのイシューが完了するとnextに戻ります。1へ進む。 決定が必要な場合:earmark comment KEY "<question>" --kind questionを@<handle>付きで実行します。可能な作業を続行します。ボード外の要因でブロックされている場合:earmark move KEY blocked -m "<what>"を実行します。 - 完了: まず成果物を添付し (
earmark attach KEY FILE…)、その後earmark review KEY -m "<what changed> · <files> · <how to verify>" --nextを実行します。これによりハンドオフし、同じ呼び出しで次のイシューをクレームします。Exit 4: 6へ進む。 - 再開されたイシューに
blocked by: KEY2 (done)と表示されている場合:earmark show KEY2 -f comments,attachments --last 3でその結果を取得します。 earmark next --reviewで他の誰かのハンドオフをクレームします（自分のものは不可）。以下の要領でレビューします。- それでも Exit 4 の場合:
earmark checkを実行し、あなたを必要とするもの（質問、却下）を処理します。 - 他に何もない場合:
earmark leaveを実行し、3行で報告します: 完了、レビュー中、未着手またはブロック。待機を指示された場合のみ:earmark wait --timeout 9m(10分間許可) を実行し、1へ進む。
Reviewer ループ
earmark next --reviewで次のハンドオフをクレームし、handoffノートとともに表示します。Exit 4: worker ステップ7と8へ進む。- ノートが主張する内容を正確に検証します。テストや手順を実行し、変更されたすべてのファイルを読みます。
- 合格:
earmark approve KEY -m "<what you checked>" --next。不合格:earmark reject KEY -m "<each defect: file:line, expected, actual>" --next。これにより同じワーカーに戻ります。自分で修正しないでください。3回目の却下はPMまたはオーナー用に保留されます。
PM ループ
earmark triage: トリアージされていないバックログ、未割り当てのTodo、期限切れのクレーム、レビューキュー、ブロック、期限超過、レビューを使い果たしたもの、アイドル状態のエージェント。上から順に処理します。- 整形:
earmark edit KEY -t <topic> -p <priority> --type <type>、その後earmark move KEY todo。重複:earmark link KEY duplicates KEY2、その後earmark cancel KEY -m "duplicate of KEY2"。 - スコープに基づいて割り当て:
earmark assign KEY <handle>を、プロファイルとCLIが作業に適したエージェントに対して実行します。期限切れのクレーム:earmark move KEY todo -m "<why>"、その後割り当てます。 - レビューを使い果たした場合: イシューを明確にし、再割り当て、分割 (
earmark new "<title>" --parent KEY)、またはキャンセルします。earmark rank KEY --topまたは--before KEY2でキューを順序付けます。 - トリアージが完了したら:
earmark leaveと3行のサマリー、またはworkerステップ8のように待機します。
終了コード
| コード | 意味 | 対処 |
|---|---|---|
| 1 | 無効なリクエスト、ID、権限 | hint: を読み、コマンドを1回修正する |
| 2 | 見つからない | キーまたはトピックを確認してください。エラーに類似の候補が表示されます |
| 3 | 競合: 誰かが保持している、またはバージョンが移動した | 別のイシューを earmark next するか、show してやり直す |
| 4 | 空: クレームするものがない、または待機がタイムアウト | ループの次のステップへ |
| 5 | ビジー: ボードがロックされたまま | 数秒後に同じコマンドを再試行する |
ルール
- 同時にクレームできるイシューは1つだけです。放棄する場合:
earmark release KEY -m "<why>"。 - コメントは情報提供のためのものです。チャットではありません。自分宛ての質問にのみ、1回だけ回答してください。謝辞や感謝を投稿しないでください。2回のやり取りで合意に至らない場合: PMまたはオーナーに委ねてください。
- コメントは短く具体的に: 変更内容、パス、ID（
#1190）。ログのダンプは避け、添付してください。 - スコープ外の発見:
earmark new "<title>" -b "<evidence>" -t <topic>。ついでに修正しないでください。 - 他の誰かが保持しているイシューのコード、フィールド、ステータスを編集しないでください。代わりにコメントしてください。
- ボードには
earmarkを介してのみアクセスし、.earmark/に直接アクセスしないでください。
参考: commands.md (すべてのコマンド、フラグ、出力形式) ·
workflow.md (ステータス、リース、nextの順序、レビューフロー、カーソル)。