external-brief
Skill2 starsChanged 5 months agoMITView on GitHub
「上司向け週次報告」「クライアント向け進捗まとめ」「外向きステータス」「マネージャーに送る report」「お客さんに見せる進捗」と頼まれたら、opshub MCP の task.list (state=completed, updated_after=対象期間開始) と decision.list (recorded_after=対象期間開始) を組み合わせて完了タスク + 意思決定を引き、brief で外向き tone のまとめを返す。persist なし、本 skill は手順書のみで実処理を持たない。pair: personal-brief (自分向け) と対をなす外向き skill。
In this repository32 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- announcement-draftSkill
- catchupSkill
- decision-rationaleSkill
- find-documentSkill
- handoff-draftSkill
- inbox-triageSkill
- meeting-followupSkill
- meeting-prepSkill
- next-actionsSkill
- personal-briefSkill
- pr-reviewSkill
- reply-draftSkill
- researchSkill
- source-extractSkill
- announcement-draftSkill
- catchupSkill
- decision-rationaleSkill
- external-briefSkill
- find-documentSkill
- handoff-draftSkill
- inbox-triageSkill
- meeting-followupSkill
- meeting-prepSkill
- next-actionsSkill
- personal-briefSkill
- pr-reviewSkill
- reply-draftSkill
- researchSkill
- source-extractSkill
The file
Files
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: 30graph 拡張 (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-briefskill の責務 - 個別 task の詳細経緯 →
decision-rationaleskill (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(自分向け)
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

