Briefing Outline說明提綱

Distill one long report or many docs into a high-altitude 說明提綱 a manager can grasp, then drill into把厚重的來源文件收斂成一份高空俯瞰的說明提綱,讓主管一眼掌握全貌、需要時再往下鑽

繁中Model-invoked模型叫用
Read SKILL.md on GitHub在 GitHub 看 SKILL.md

Briefing Outline distills one long report or a whole set of source documents into a single 說明提綱 — a high-altitude overview a manager or committee can grasp at a glance, with every part still pointing back down to the source for detail.

Install

npx skills add https://github.com/leoluyi/skills -g -a briefing-outline -y

To pull updates later:

npx skills update briefing-outline

Source

What it does

Given one or more sources — separate documents, or the sections of one long report — it inventories what each holds, then lays out a MECE spine (一、二、三…) where each source's essence lives in exactly one section. Each section is drafted purpose-first: a label naming the intent (目的/要驗證/要達成), then the essence, then a pointer down — 「(詳《source》)」— for anything that belongs in the source instead: 逐項標準、權重、SOP、原始碼、完整明細. The result reads as one coherent document, not a stitched summary, and stays stable when a source is revised because only the affected section needs a re-run.

When to use

Reach for it when you need to condense one or more source documents into a navigable briefing that a manager or committee can grasp at a glance and drill into when they need more — a project proposal bundle, a long evaluation report broken into its own sections, or an existing 提綱 whose sources just changed and needs re-syncing.

When not to

Not for authoring a single formal document from scratch (use formal-doc-structure), for an RFP or 需求規格書 (use rfp-writing), for lowering one term or passage to a non-technical reader (use plain-speak), or for pure language cleanup with no structural work (use humanizer-zh).

How it works

Each item earns its space rather than getting a flat treatment: a paragraph is justified only when the item is non-obvious (the reader can't reconstruct it from the label alone), self-arguing (it carries a rationale that pre-empts an objection), or decision-bearing (it embeds a choice the reader must approve). Everything else collapses to a label and a pointer down. A number survives at altitude by function, not size — it stays only if it is or proves a decision, not if it merely parameterizes one.

Re-syncing works the same way: when a source changes, only the sections it feeds get steps re-run, because the MECE spine already guarantees each source maps to exactly one section — there's no need to re-derive the whole outline to absorb one update.

Related skills

  • formal-doc-structure — use it instead when you're authoring a single formal document (簽呈, 會議紀錄, 評估報告) from scratch, not distilling existing sources.
  • rfp-writing — use it instead for a 需求規格書 or 招標規格, which has its own structural rules that conflict with a 提綱's.
  • plain-speak — use it instead when the job is lowering one term or passage for a lay reader, not restructuring a whole document.
  • humanizer-zh — use it instead (or as this skill's own step 6) for stripping AI-writing patterns once the outline's structure is already settled.

說明提綱把一份長報告或一整組來源文件收斂成單一份高空俯瞰的說明提綱——讓主管或委員會一眼掌握全貌,每一段又都能往下指路,回到來源查細節。

安裝

npx skills add https://github.com/leoluyi/skills -g -a briefing-outline -y

之後要更新版本:

npx skills update briefing-outline

原始碼

它做什麼

給定一份或多份來源——可以是各自獨立的文件,也可以是一份長報告底下的各個章節——它先盤點每份來源裝了什麼,再排出一條 MECE 骨架(一、二、三…),讓每份來源的精華恰好落在一個章節裡,不重不漏。每一節都以目的先行的方式撰寫:先標出意圖(目的/要驗證/要達成),再寫精華,最後用「(詳《來源》)」把該下沉的內容——逐項標準、權重、SOP、原始碼、完整明細——指回來源。成果讀起來是一份連貫的文件,而不是拼貼摘要;來源改版時也很穩定,因為只需重跑受影響的那一節。

何時使用

當你要把一份或多份來源文件收斂成主管或委員會能一眼掌握、需要時又能往下鑽的說明提綱時使用——例如一個專案提案的文件包、一份被拆成多個章節的長篇評估報告,或是一份既有提綱在來源改版後需要重新同步。

何時不要

不要用於從零撰寫單一正式文件(用 formal-doc-structure)、撰寫 RFP 或需求規格書(用 rfp-writing)、把單一術語或段落白話化給非技術讀者看(用 plain-speak)、或只是純語言層清理而不涉及結構調整(用 humanizer-zh)。

運作方式

每個項目要自己「賺到」篇幅,而不是齊頭式處理:只有當該項目是非顯而易見的(讀者無法只靠標籤重建內容)、自帶論證的(它承載了預先化解讀者疑慮的理由),或涉及決策的(它包裹著讀者必須核准的選擇或政策),才值得寫成一段。其餘一律收斂成一個標籤加指路。一個數字在這個高度上能不能留下來,看的是它的功能而非篇幅——它必須本身就是決策,或是用來證明決策,只是用來調參的數字則下沉。

再同步時道理一樣:來源一改版,只需重跑它所餵養的那幾節,因為 MECE 骨架早已保證每份來源恰好對應一節——不必為了吸收一次更新而重新推導整份提綱。

相關技能

  • formal-doc-structure — 當你是從零撰寫單一正式文件(簽呈、會議紀錄、評估報告),而不是收斂既有來源時,改用這個。
  • rfp-writing — 當你要寫需求規格書或招標規格時改用這個,它有一套與提綱互相衝突的結構規則。
  • plain-speak — 當任務只是把單一術語或段落白話化給非技術讀者看,而不是重整整份文件結構時,改用這個。
  • humanizer-zh — 當提綱結構已經定案,只需去除 AI 寫作痕跡時改用這個(本技能第六步也會呼叫它)。