advisor-update-writer

アドバイザー向け進捗報告の作成

アドバイザー、メンター、共同研究者、研究室のメンバーが判断を下しやすくなる、簡潔な研究進捗報告を作成します。

以下の場合にこのスキルを使用します。

• ユーザーが週次報告、アドバイザー宛てのメール、研究室の進捗報告、ミーティングのメモ、共同研究者向けの状況報告を必要としている
• 実験結果、執筆の進捗、査読上の懸念、実装の阻害要因を要約する必要がある
• 判断、フィードバック、リソース、計算資源、論文の位置づけに関する助言、優先事項の選択を求める報告を作成する
• プロジェクトの記録を、読みやすい進捗報告にまとめる
• アルゴリズム、実験、執筆、査読、反論、成果物、リリースなど、複数のフィードバックループを整理する必要がある

実験レポート全体の作成には、このスキルを使用しないでください。主な成果物が詳細な技術レポートである場合は、experiment-report-writer を使用してください。主な成果物が意思決定を促すコミュニケーションである場合に、このスキルを使用してください。

このスキルは、以下と組み合わせて使用してください。

• research-project-memory：現在の状況、決定事項、主張、根拠、リスク、アクションを把握する
• experiment-report-writer：実験の詳細な根拠資料が必要な場合に使用する
• figure-results-review：アドバイザーに図表を見せる場合に使用する
• result-diagnosis：否定的または曖昧な結果について判断が必要な場合に使用する
• paper-positioning-planner：論文のストーリーや投稿先についてのフィードバックを求める場合に使用する
• paper-evidence-board：執筆と実験の不足事項について、連動したアクションリストが必要な場合に使用する
• work-timeline-planner：進捗報告に過去のタイムラインの根拠を含める必要がある場合に使用する

スキルのディレクトリ構成

<installed-skill-dir>/
├── SKILL.md
└── references/
    ├── decision-framing.md
    ├── memory-writeback.md
    └── update-template.md

段階的な読み込み

• 保存する報告や重要度の高い報告を作成する前に、必ず references/decision-framing.md と references/update-template.md を読みます。
• 報告によって今後も保持すべき決定事項、アクション、永続的なフィードバックが生じる場合は、references/memory-writeback.md を読みます。

基本原則

• 前回の報告以降に生じた、意思決定に関わる変化から始めます。
• 事実、解釈、リスク、依頼事項を分けます。
• 依頼事項を埋もれさせないでください。アドバイザーに求める入力を明確にします。
• 実験の生データは根拠と示唆にまとめ、必要に応じて詳細なレポートへのリンクを記載します。
• プロジェクトの判断に影響する場合は、否定的な結果も含めます。
• ミーティングや返答の後に、フィードバックをアクションと記録の更新につなげます。
• 対象者に合わせます。アドバイザー向けの報告は率直で意思決定を重視し、研究室向けの報告はより多くの背景を含め、共同研究者向けのメモでは担当と引き継ぎを明確にします。

ステップ 1 - 報告の種類を分類する

形式を選びます。

• weekly：前回の報告以降の進捗、現在の阻害要因、来週の計画
• decision：選択肢、根拠、推奨案、明確な依頼
• meeting：アジェンダ、議論の要点、必要な決定事項、ミーティング後のメモ
• email：背景、状況、依頼事項、添付ファイルを含む簡潔なメッセージ
• lab：より広い背景、重要な結果、対象者に覚えておいてほしいこと

以下を特定します。

• 対象者と想定される長さ
• 期限またはミーティングの時刻
• プロジェクトのフェーズ
• 前回の報告以降に得られた重要な根拠
• 未解決の決定事項
• アドバイザーに求める対応
• ファイルが必要な場合は保存先

保存する場合、パスが指定されていなければ、以下を使用します。

docs/updates/advisor_update_YYYY-MM-DD.md

ステップ 2 - 現在の状況を把握する

利用可能な場合はプロジェクトの記録を優先し、その後に一次資料を確認します。

以下を確認します。

• memory/current-status.md
• memory/decision-log.md
• memory/claim-board.md
• memory/evidence-board.md
• memory/risk-board.md
• memory/action-board.md
• 実験レポート、論文の草稿、査読者のコメント、反論のメモ、最近の git コミット

以下を抽出します。

• 何が変わったか
• その変化を裏付ける根拠は何か
• 何が失敗したか、または不確かなままか
• 今、どのような決定が必要か
• ユーザーの推奨案は何か
• 次に何が起きるか

ステップ 3 - 決定事項を整理する

references/decision-framing.md を読みます。

各決定事項について、以下を作成します。

• 判断すべき問い
• 選択肢
• 各選択肢を支持する根拠と反対する根拠
• 決定が遅れた場合のリスク
• 推奨する選択肢
• アドバイザーへの具体的な依頼
• はい／いいえ／別案で回答を得た後の次のアクション

決定が不要な場合は、進捗、リスク、次のアクションを中心に報告を構成します。

ステップ 4 - 更新内容の草案を作成する

references/update-template.md を読みます。

基本構成：

• 1 行のステータス
• 主な進捗
• 根拠と解釈
• ブロッカーまたはリスク
• 判断事項／依頼
• 次のアクション

メールでは、冒頭の段落だけで「私に何をしてほしいのか」が分かるようにします。

会議メモでは、会議がすでに行われている場合、アジェンダと会議後の決定事項の両方を記載します。

ステップ 5 - 更新内容を確認する

最終確定する前に、次の点を確認します。

• 重要な主張すべてに根拠があるか、解釈として明記されている
• 依頼事項が明確である
• ブロッカーに担当者または次のステップ案がある
• 方針に影響する否定的な結果を隠していない
• 対象者にとって十分に簡潔である
• 添付ファイルやリンクに名前が付いている
• 判断事項やフィードバックがメモリへの書き戻しに備えられている

ステップ 6 - フィードバック後に書き戻す

メモリがある場合は、references/memory-writeback.md を読みます。

アドバイザーからの返答後、または会議メモの最終確定後に、決定事項、アクション、リスク、ステータスを更新します。