| name | external-brief |
| description | 「上司向け週次報告」「クライアント向け進捗まとめ」「外向きステータス」「マネージャーに送る report」「お客さんに見せる進捗」と頼まれたら、opshub MCP の task.list (state=completed, updated_after=対象期間開始) と decision.list (recorded_after=対象期間開始) を組み合わせて完了タスク + 意思決定を引き、brief で外向き tone のまとめを返す。persist なし、本 skill は手順書のみで実処理を持たない。pair: personal-brief (自分向け) と対をなす外向き skill。 |
external-brief — 上司 / クライアント向けの進捗まとめを opshub から組み立てる
opshub MCP server (opshub mcp serve、ADR-0022) 経由で「外向き」の進捗 / 完了 / 意思決定をまとめる Tier 1 skill。Phase 12 H3 (docs/phase-12-plan.md §3 H3) で personal-brief の pair として導入。personal-brief が自分向け (粒度細かめ、進行中タスクや未処理 inbox も含む) なのに対し、external-brief は外向き (完了済みの動き / 確定した意思決定が中心、未処理 inbox は基本的に出さない)。
外向き report は text 返却のみ (persist なし、ADR-0016 改訂 §決定 (l) draft 系統一方針)。host LLM が user に提示し、user が手動で SaaS や docs に転記する。opshub 側では外部 SaaS への書き戻し経路を持たない (ADR-0010 §禁止事項 7、緊張点③)。
何が起きるか (host 側の流れ)
- ユーザーが「上司向け週次報告」「クライアント向け進捗まとめ」「外向きステータス」のような表現で問い合わせる
- 外部ホスト (Claude Code 等) が本 skill を発火させる
- ホストが対象期間を ISO 8601 timestamp に解釈する (今週 / 先週 / 今月 / 先月、デフォルト直近 7d)
- ホストが下記「呼び出し順」に従って opshub MCP read tool を呼び出す
- 戻り値を集約し、外向き tone (要点先出し / 進捗 + 確定事項 / 主観や進行中タスクの混入を抑制) でユーザー向けに整形する
opshub 側で能動的に「週次報告を送る」runtime は走らない (ADR-0004 §(a) 形A)。本 skill はリクエスト駆動で、ユーザーが問い合わせた瞬間にホストがツールを叩く。
期間の解釈 (ホスト側)
ユーザー発言からホストが ISO 8601 timestamp を解釈する：
| ユーザー語彙 | 期間（半開区間） | フィルタ |
|---|
| 今週 / 週次報告 (デフォルト) | 今週月曜 00:00 (local TZ) 〜 now | *_after=今週月曜00:00 |
| 先週 | 先週月曜 00:00 〜 先週日曜 23:59 | *_after=先週月曜 / *_before=今週月曜 |
| 今月 / 月次報告 | 月初 00:00 〜 now | *_after=今月1日00:00 |
| 先月 | 先月 1 日 〜 今月 1 日 | *_after=先月1日 / *_before=今月1日 |
| 直近 (デフォルト) | 直近 7d | *_after=now-7d |
各 tool は physical-column ベースの独立した argument 名を持つ (ADR-0022 改訂 §決定、Phase 12 H1)：
task.list: updated_after / updated_before（→ tasks.updated_at）decision.list: recorded_after / recorded_before（→ decisions.recorded_at）
注: task.list の時間フィルタは physical column tasks.updated_at ベース (Phase 12 H1)。completed_at 列は projection に存在しないため、「期間内に完了した task」は state="completed" + updated_after の組合せで近似する (期間内に completed 化されたものは updated_at も更新されるため、実用上 hit する)。
呼び出し順 (MCP tool)
Step 1: 期間内に完了した task を列挙
tool: task.list
input:
state: "completed"
updated_after: "<期間開始 ISO 8601>"
updated_before: "<期間終了 ISO 8601>" # オプション (今週なら不要、先週なら必要)
limit: 50
戻り値の items[] を外向き report の「完了した作業」セクションに使う。ホスト側で title / body / external_link を整形して提示する。completed_at 列が無いため厳密には「期間内に状態が completed になった task」ではなく「completed 状態かつ期間内に更新された task」を返す近似であることに留意 (Phase 12 H3 plan の注、§3 H3)。
Step 2: 期間内に記録された decision を列挙
tool: decision.list
input:
recorded_after: "<期間開始 ISO 8601>"
recorded_before: "<期間終了 ISO 8601>" # オプション
limit: 20
戻り値の items[] を外向き report の「確定した意思決定 / コミットメント」セクションに使う。decisions は ADR-0002 で immutable のため recorded_at が唯一の時間アンカー。
Step 3: 一発要約は brief を使う (外向き tone 指示)
LLM backend が configured なら、brief 一発で対象期間 + 外向きトーン指示を含む topic を投げて Markdown 要約を取る。Step 1 + Step 2 で取得した task / decision の id / title を topic 文字列に含めると、brief が graph 補強で関連 source を辿って文脈付きで要約する。
tool: brief
input:
topic: "<期間ラベル> の外向き進捗報告。完了 task: <title list>、確定 decision: <title list>。上司 / クライアント向けに要点先出しでまとめる"
format: "md"
max_sources: 30
graph 拡張 (task / decision に紐づく source も拾う) は default で常時走る (ADR-0017 §(e)+(f)、epic #470 で expand_graph param 削除)。
戻り値: {"format":"md", "briefing_id":"...", "markdown":"...", "source_count": N}。LLM 未設定 / token 不足の場合は失敗するので、Step 1 + Step 2 の素材だけでホスト LLM が組み立てる fallback に切り替える。
重要: brief の topic 引数に「外向き」「上司向け」等のトーン指定を含めて誘導すること。これにより、自分向け (personal-brief) と外向き (external-brief) の出力差分が、同じ brief MCP tool を使っても確実に出る (host LLM が tone shift を実現する責務)。
出力フォーマット (ホスト側)
ホストが以下のような構造でユーザーに返す。具体的な文面はホスト側 LLM が決める (本 skill は構造のみ pin)。
# <期間ラベル>の進捗報告
## ハイライト
- <要点先出し、3-5 行>
## 完了した作業
- [<title>] (<completed date>) — <一行サマリ>
- ...
## 確定した意思決定
- [<title>] (<recorded date>) — <意図 / 理由 / 影響>
- ...
## 次の見通し (任意)
- <短い見通し or 進行中の主要作業>
進行中の task や未処理 inbox は 混ぜない（混ぜると personal-brief と差分がなくなる）。それらが欲しい場合は personal-brief の責務。
自律範囲
- 自律 OK — すべて read 系 tool (
task.list / decision.list / brief、ADR-0022 §(c) readOnlyHint=true)。確認なしで呼んでよい。
- durable state を変える tool (
task.create / inbox.add / connector.sync / propose.apply) は本 skill では呼ばない。
できないこと / やらない
- 外部 SaaS への投稿 / 通知送信 (ADR-0010 §禁止事項 7、Phase 10 plan §1 #6)。生成した report は user が手動で SaaS や docs に転記する
- 期間の動きを能動的に push する (ADR-0004 §(a)、能動機能は当面持たない)
- 推論結果を opshub の durable state に書き戻す (ADR-0016 改訂 §決定 (l)、handoff-draft / announcement-draft と並んで persist なし)
- 進行中タスクや未処理 inbox を外向き report に混ぜる →
personal-brief skill の責務
- 個別 task の詳細経緯 →
decision-rationale skill (decision 経緯) や meeting-prep (会議準備) の責務
参考
- ADR-0004 (Agent Runtime Boundary、形A)
- ADR-0016 改訂 §決定 (l) draft 系統一方針 (Phase 12 H1、persist 境界は「返信元 source の有無」で切る)
- ADR-0022 改訂 (MCP Server Surface、Phase 12 H1 で physical-column 時間フィルタ追加)
- ADR-0010 §禁止事項 7 (外部 SaaS 書き戻し禁止)
- ADR-0002 (Append-only Event Log、decision immutability)
- Phase 10 plan §3-D (skill ↔ MCP tool マッピング)
- Phase 12 plan (
docs/phase-12-plan.md §3 H3)
- docs/assistant-agent.md (Skill catalog SSOT、15 skills 責務マップ)
- pair:
docs/skills/personal-brief/SKILL.md (自分向け)
