yak-shaving-triage

ヤクシェービングのトリアージ

広く気づきを拾います。現在の問題を解決します。それ以外は維持します。

モデルまたはユーザーが選んだものにかかわらず、エンジニアリングタスクから始めます。後続の呼び出しは現在のタスクに合流します。ユーザーの問題が解決するか、ユーザーがこのスキルを停止するまで作業を続けます。ユーザーの問題とは、現在許可されている成果とその境界のことです。そのワークフローでは、必要な調査、実装、検証を行います。通常の作業では、繰り返し範囲を報告するのではなく、内部で確認します。

investigate-with-evidence とともにインストールされた Assess Findings を使って、評価、関係性、推奨事項を確認します。Just または Explore ですでに作成された評価があれば再利用します。依存関係が不足している場合、判断は保留したまま、実行可能な主要作業を続けます。

1. 記録を開始し、次の分岐に備える

作業記録の契約を読み、ユーザーが選択したリポジトリ、プロジェクトの識別情報、保存・コミットの権限、既存の記録レイアウトを確認します。既存の設定を再利用します。保存先が存在しない場合は、主要タスクを続けながら一度だけ確認します。その阻害要因が解決するまでは、未保存の観察事項を保持します。アクティブなタスクの履歴に関する制約で許可されている場合に限り、過去の調査結果を読みます。セットアップは任意であり、自動では実行されません。

具体的な手がかりや検討中のタスク切り替えを、それぞれユーザーの問題と照らし合わせます。Just を使う場合は、宣言されたバッチに従います。必要な調査はそのバッチ内に残し、独立した新たな成果は今後の作業のために保存します。残りの副次的な調査結果によって、バッチの範囲を広げたり、完了を妨げたりしないでください。必要な調査や修正は、必要な深さで主要ワークフローに含めます。独立した観察事項は最終評価の前に記録できます。具体的な証拠がない疑いは、確定した調査結果ではなく、メモとして扱います。未解決の手がかりを範囲を定めて確認する場合や、ユーザーから明示的に探索を依頼された場合は、発見の観点を使います。すでに十分な証拠がある場合は、それを再利用します。

意味のあるチェックポイントで、独立した観察事項とその証拠を、設定済みの記録に保存するか、コーディネーターに更新情報として返します。事実、仮説、現在の評価、実装の進捗は分けて記録します。破棄可能な整理作業に進む前に、重要な証拠を保存します。作業記録は正式な課題ではありません。課題として扱える状態かどうか、正規情報との照合、トラッカーへの公開については、課題の記録に従います。

完了条件： 各分岐が主要タスクに属しているか、保存済みまたは明示的に保留中の観察事項があるか、あるいは証拠に基づく理由を示して対象外となっていること。主要タスクを続けます。

2. 重複作業をせずに評価・照合する

共有の調整方法を使用してください。コーディネーターは、役割ごとに別のエージェントを必須とするのではなく、タスクへの適合性に基づいて、直接作業するか、範囲を限定したワーカーを割り当てるかを選びます。調査ワーカーは具体的な手掛かりを1つ確認し、Assess の担当者はその結果と関連性を判断し、照合ワーカーは既存の記録と実装状況を検索します。これらの割り当てでは、それぞれ異なる問いに取り組み、既存の結果を再利用します。いずれも、独立して副次的な問題を修正したり、公開したりはしません。

正規トラッカーを調査する前に、検索の実施条件を確認してください。条件を満たし、メインタスクの進行中に独立した検索を実行できる場合は、バックグラウンド照合を使用してください。それ以外の場合は、適切なチェックポイントで範囲を限定して検索するか、理由と次のアクションを添えて保留にします。閉じられたゲートはワーカーにも適用されます。保留中の作業は、ゲートの変更時、再開時、完了時に見直してください。

Assess はアクションの価値と推奨優先度を担い、Yak は記録の同一性、照合の処置、報告の順序、承認済みのトラッカーへの公開を担います。検索で得られた重要な結果とデリバリー範囲を同じ評価担当者に返し、評価全体をやり直すのではなく、影響を受ける判断を修正してください。確認済みの問題については、Assess を通じて推奨優先度を依頼し、その尺度と制限を維持してください。関連する問題は原因を共有していても、それぞれの受け入れ基準は個別に保てます。

作業履歴へのアクセスが許可されている場合は、作業記録の契約に従って PR のリンクを照合してください。把握済みのリモート状態は日付付きの観測であり、永続的な事実ではありません。Tracker Guidance が欠けている場合、正式な照合はできませんが、許可された作業記録への記録は可能です。下書きを保持し、正規の記録先に関する判断は完了時まで保留してください。

完了条件： 実施条件を満たすすべての所見に、担当者と結果、または保留理由と次のアクションがあり、共有記録に返却された証拠が反映され、通常の副次作業が User Problem に取って代わっていないこと。

3. 終了して引き継ぐ

メインタスクの実際の状況を報告し、割り当てた作業を回収して、保留中の所見を見直してください。進展のない正規検索は、それぞれの制限を明記して「照合ブロック」として終了してください。結果の報告契約に従って所見を提示し、確認済みの不具合、機会、未解決の観測を分けてください。正規記録との一致だけでなく、記録されたパスや保存・コミットの失敗も示してください。

正式なトラッカー変更については、正確な下書きを提示し、issue capture に基づく Tracker Write Approval を取得してください。既存の記録を再利用する場合、変更は不要です。正規のガイダンスがない場合は、記録先についての質問を1つにまとめて確認し、書き込みを提案する前に照合してください。許可された作業記録には、公開を意味することなく、証拠と保留中のトラッカー下書きを保持できます。

一時停止または停止する場合は、ディスパッチと影響を受けるワーカーを速やかに停止し、チェックポイントを保持し、所有するリソースを引き継ぐかクリーンアップしてください。Yak だけを停止しても、メインのワークフローは既存の権限のもとで継続します。完了済みの検索を繰り返すのではなく、記録された状態と引き継いだ証拠ゲートをもとに再開してください。後から得られた証拠によりアーカイブまたは再開が妥当となった場合は、作業記録のライフサイクルに従ってください。PR のマージだけでは受け入れは確定しません。

完了条件： タスクの状況、各観測の評価と永続化の状態、実施条件を満たす照合結果またはブロッカー、承認済みのトラッカー変更それぞれの実際の結果が明確で、後から確認できること。

緊急の所見

信頼できるセキュリティリスク、データ損失リスク、または破壊的なリスクがある場合は、直ちにユーザーに通知し、リスクを現実化させるアクションを停止して、サニタイズ済みの証拠を保持してください。独立性ゲートとトラッカー公開要件を維持してください。修正によって範囲を変更するのは、ユーザーが許可した場合に限ります。