mcpField
P
progress-check

progress-check

github.com/tjcagesエージェントワークフロー685 回インストール2 週間前に更新
リポジトリ

progress-check について

長時間の作業における進捗報告を、経過時間ではなく観測可能なマイルストーンと証拠に基づいて整えるスキルです。依頼に応じたグローバル導入方法も示します。

主な機能

  1. 01観測可能なマイルストーンの設定
  2. 02進捗報告のタイミング規則
  3. 03ブロッカーと完了の迅速な報告
  4. 04単一の進捗バーによる書式
  5. 05グローバル導入手順の案内

活用シーン

  1. 01長時間タスクの進捗報告
  2. 02エージェントセッション間での報告統一
  3. 03作業のブロッカーの通知
  4. 04複数プロジェクトへの進捗ルール導入

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tjcages/skills --skill progress-check

インストール後、Claude Code で/progress-checkを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

進捗確認

全メソッド:METHODOLOGY.md。チャット形式: RESPONSE.md。例:EXAMPLES.md。

モードを選択する

  • 進捗を報告する: 条件に該当する長時間作業では、デフォルトで選択します。
  • グローバルにインストールする: ユーザーがこの動作をエージェント間またはプロジェクト間で維持するよう求めた場合に限ります。

進捗を報告する

  1. パーセンテージを見積もる前に、観測可能なマイルストーンを少数設定します。 経過時間ではなく、作業量とリスクに基づいて重み付けします。
  2. スコープを把握したら、基準となる進捗を1回報告します。
  3. 定期的な進捗報告は、30分以上経過し、かつ次のいずれかに該当する場合に限ります:マイルストーンが完了した、検証済みの進捗が10パーセントポイント以上上昇した、または次のアクションが大きく変わった。
  4. ユーザーが対処できる新しいブロッカーはすぐに報告します。完了もすぐに報告します。
  5. 変化のない進捗バーを繰り返したり、「作業を継続中」といった定期メッセージを送ったりしてはいけません。

各進捗報告は、完了した作業の根拠、現在の作業、次のステップまたはブロッカーのうち、最大3つの短い項目にまとめます。最後に、次のような全体進捗バーをインラインコード形式で、単独の行にちょうど1つ記載します。

Performance rollout [██████████████████░░] 90%

インラインコードのスタイルには、バッククォートを1組使用します。行頭に4つのスペースを付けたり、フェンス付きコードブロックを使ったりしないでください。どちらも独立したブロックになり、インターフェースによってラベルが付けられたり、コピー可能になったりする場合があります。

  • ラベルは、タスクに合った短いものに置き換えます。
  • 20セルを使います。完了分は█、残りは░で表します。
  • 完了を示す根拠がない限り、最も近い5%単位に切り下げます。
  • ユーザーからサブタスク別の進捗バーを求められない限り、全体の進捗バーのみ表示します。
  • 複数エージェントで作業する場合、全体の進捗バーを表示するのはコーディネーターのみです。
  • 進捗行を進捗報告の最後の内容にします。その直後に、注記、要約、締めくくりを加えずに終了します。

グローバルにインストールする

サポートされているエージェント間で同じソースを使えるよう、利用可能なAgent Skills CLIを使ってこのスキルをグローバルにインストールすることを優先します。

npx skills add tjcages/skills --skill progress-check -g --agent '*'

ユーザーがネイティブの常時有効な指示を明示的に求めた場合は、代わりに次の手順を実行します。

  1. インストール済みの各エージェントについて、文書化されているユーザーレベルの指示設定方法を確認します。
  2. 既存の指示を上書きせずに、進捗ルールを統合します。
  3. 変更を冪等にし、リポジトリレベルの指示ファイルは作成しません。
  4. UIで管理するルールにしか対応していないエージェントの場合、ファイルパスを捏造せず、正確な設定場所とコピーして使えるブロックを提示します。
  5. 変更した各設定先を確認し、新しいセッションが必要かどうかを伝えます。

対応していないエージェントを設定したと主張してはいけません。関係のない設定は変更しないでください。

コメント