Community程式設計與開發github.com

getedgehq/top-down-comms

這項技能教您如何建構從上而下的客戶溝通文件,確保論點清晰、有力,並避免常見的結構陷阱。

top-down-comms 是什麼?

這項「從上而下溝通」技能專注於文件論點的組織結構,而非語調或風格。它解決了一個核心問題:即使文章措辭完美,如果論點順序錯誤,仍然會失敗。技能基於麥肯錫顧問常用的金字塔原理與SCR(情境-複雜化-解決方案)架構,提供七條明確規則,包括:首要思想必須開門見山、使用行動標題而非主題標籤、將排除事項視為元數據而非開場白、以及確保每個章節都有可驗證的下一步。支援任何文件撰寫平台(如Google Docs、Notion、Markdown),並提供一個可操作的檢查清單,幫助開發者、顧問或AI代理在使用者生成提案、報告或客戶溝通文件時,立即提升說服力與結構清晰度。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/getedgehq/skills/tree/main/top-down-comms

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

從上而下的客戶溝通

語氣技能告訴你聽起來如何;這項技能告訴你什麼該先說,以及為什麼。一份語氣完美的文件,若論點順序顛倒,依然會失敗。

這項技能要解決的失敗案例

某次審查中,一位審查員針對一份已經通過三輪視覺修改的提案頁面說: 「現在好多了,但修正故事線。為什麼要從這裡開始?請以麥肯錫顧問、BCG顧問和從上而下溝通的角度思考。」

該頁面以 「不對來源影像進行自動化分析」 開頭——這是一個範圍排除條款。這樣寫有其好理由:收件方的專家曾在機器基準測試中勝出,而責任歸屬是他們當下的主要顧慮。但讀者的第一印象卻是一個關於「文件不包含什麼」的免責聲明,他們必須讀到第三節才知道實際提出的方案是什麼。

防禦性的開場感覺負責任,但讀起來卻顯得軟弱。 把排除事項前置的直覺,正是需要壓制的直覺。

規則 1:首要思想必須先說

明托金字塔原則。第一個實質句子必須是答案,而非背景、主題或排除事項。其餘所有內容都為支持此答案而存在。

開場方式評價
「不對來源影像進行自動化分析。」排除。說明它『不是』什麼。
「按貢獻利潤率排列來單」主題標籤。命名主題,未作任何論述。
「在滿載產能下,關鍵不在於接受多少訂單,而在於接受哪些。提案:根據預期貢獻利潤率,自動為每筆傳入請求評分。」答案。建議 + 理由,放在頁面最前方。

測試:如果讀者在讀完第一句話後停止,他們是否知道你想要他們做什麼?如果不是,請改寫第一句話。

規則 2:行動標題,而非主題標籤

每個章節標題應陳述其結論。只讀標題的讀者必須能獲得完整的論點。這是槓桿最高但最常被忽略的技巧。

主題標籤(弱)行動標題(正確)
背景瓶頸在產能,而非需求
評分邏輯五項標準決定訂單的實際價值
範例同一個早上兩個請求,相同努力,不同利潤
測試可在一小時內驗證,無需先建置任何東西
努力數天即可運作

僅標題測試。 移除正文,按順序閱讀標題。如果它們無法形成連貫的論證,表示結構錯誤,再多正文也無法挽救。

規則 3:SCR,且複雜化是核心工作

情境(雙方同意的事實)→ 複雜化(為何不能維持現狀)→ 解決方案(你的建議)。多數薄弱文件有情境和解決方案,卻沒有複雜化,導致建議顯得缺乏動機。

複雜化應盡可能量化:「如果你按訂單到達順序而非利潤率處理,那麼每接受一個低利潤訂單,就會損失一個高利潤訂單。」 這是一個讀者可以驗證的機制,而非一個必須接受的陳述。

規則 4:排除事項與免責聲明應為元數據

它們應放在靠近頂部的掃描條中,或文件末尾的編號章節中。永遠不能放在開場位置,也不能在建議之前作為標題。

「一覽」掃描條解決了這個問題:在主要思想下方直接放置一個四列的行。

範圍內            範圍外              資料來源            下一步
訂單處理順序      來源影像的自動化     會計匯出資料,       20 到 30 張發票,
                  分析                非專案資料夾        約 1 小時

排除事項在第一屏即可見,因此無人可指責其被隱藏,但它被定位為「範圍」而非「道歉」。如果該異議足夠嚴重,可以在文件末尾給予一個完整章節。

規則 5:為章節編號

01、02、03。顧問這麼做是因為它讓文件在會議中可被引用(「回到 02」)。這也強迫你注意到當你有十一個章節時,表示你沒有論證,只有一份清單。

規則 6:一個可被否證的下一步

以具體、微小且可能失敗的內容結尾。不是「我們討論一下」。最有力的結尾會指明失敗條件:

如果排序錯誤,則邏輯錯誤,此構想宣告失敗。

一個可能失敗的提議,比一個不可能失敗的提議更具可信度,尤其是在一個已經被說服的房間裡。

規則 7:MECE,並刪減至承重章節

章節之間不得重疊,且不得在論證中留下缺口。如果兩個章節表達相同觀點,請合併。如果某章節不支持其上層論點,請刪除。

來自同一文件的實際測試:一份關於訂單優先級排序的提案中間,夾雜了一個不相關的參考案例。審查員的評語是:「這段文字很隨機……要嘛放在電子郵件中,如果放在這裡,必須有明確的上下文。」 它支持的是不同的主要思想,因此應歸屬於不同的文件。它被移到封面郵件中,頁面因此變得更短、更強。

發布前檢查清單

  1. 第一個實質句子是建議,而非背景或排除事項。
  2. 單獨閱讀標題時能形成完整論證。
  3. 有明確的複雜化,最好能量化。
  4. 排除事項位於掃描條或結尾章節,絕不在開場。
  5. 章節已編號且符合 MECE。
  6. 結尾是具體、可被否證的下一步。
  7. 頁面上沒有任何內容支持不同的主要思想。

未涵蓋內容

語調和措辭:此技能關於論點順序,而非語氣。短客戶訊息的長度限制,以及共享頁面的建置和發布機制,屬於其他範疇。

Individual skills in this repo

This repo contains 18 individual skills — each has its own dedicated page.

getedgehq/agent-evals

Build evals for an AI agent that already does real work. Use when someone asks "how do I know my agent is right", wants to test an agent before trusting it, compare models on cost versus quality, or turn production failures into tests. Walks from first tasks and yes/no verifiers, to isolated environments, to a trace-driven improvement loop.

getedgehq/cli-ux-review

Audit a command-line tool for user-friendliness — clear situation / next-step / options in every output, colour-highlighted runnable commands, no raw jargon, no silent hangs. Invoke for "CLI UX audit", "review my CLI", "is this CLI intuitive", or before any CLI release.

getedgehq/generate-image

Generate images with OpenAI GPT Image 2 via the Codex CLI, billed through the user's ChatGPT Plus subscription (no OpenAI API key, no per-image API cost). Use when the user asks to create, generate, or make an image, picture, illustration, icon, hero graphic, or concept art from a text prompt.

getedgehq/harness-first

Diagnose and fix an unreliable, expensive, or unsafe LLM agent by auditing its harness (golden set, judge, cost caps, data layer, action approvals, tracing) before blaming or swapping the model. Use when someone says an agent is "burning tokens", "hallucinating", "brittle", gives inconsistent answers, asks whether to switch to a cheaper/better model, or wants to ship an agent or prompt change to customers.

getedgehq/http-error-triage

Run before concluding anything from an HTTP error on a third-party API. Separates a real credential/entitlement problem from a CDN or WAF block, a wrong endpoint, or a client-signature ban. Use whenever an API returns 401/403/402/429 and you are about to say "the key is dead", "credits are exhausted", "the plan lacks access", or "we are rate limited".

getedgehq/linkedin-media-prep

Convert, crop, resize, and compress images and videos for optimal LinkedIn upload quality and file size. Use when the user wants to prepare a photo, image, or video for LinkedIn (profile picture, cover photo, post image, article featured image, post video, or video ad), optimize file size for LinkedIn, crop and resize for LinkedIn dimensions, convert HEIC/RAW/PNG/MOV to LinkedIn-ready JPEG or MP4, or mentions LinkedIn media requirements, specs, or limits.

getedgehq/monid

>-

getedgehq/opendraft

An 18-agent pipeline that turns one topic line into a drafted

getedgehq/people-search

Find and rank professional people for recruiting, partnerships, sales, or research from user-provided data, public web sources, an authenticated search session, or a connected provider. Use for people discovery, LinkedIn or Sales Navigator search design, profile-list ranking, or provider filter translation.

getedgehq/rocketlist

Turn a CV into a shortlist of live startup roles from Rocketlist's public job board, including adjacent job titles the person would never have searched for, each with its published salary, the evidence for the fit, and a direct apply link. Use for "find roles I would be a strong fit for", career pivots, remote or VC-backed job hunts, and salary-visible role discovery.

getedgehq/security-audit-checklist

Run a comprehensive security audit across application code, cloud infrastructure, containers, CI/CD pipelines, and infrastructure-as-code. Covers privacy compliance, OWASP basics, secret leakage, API security, IAM misconfigurations, storage exposure, Kubernetes hardening, and network security. Use when the user asks to audit, review, or harden app or cloud security, check for secrets, scan for XSS/SQLi, verify security headers, review Terraform/CloudFormation, audit AWS/GCP/Azure configs, or perform any security-focused review.

getedgehq/shadcn-first

>-

getedgehq/skills

Develop or review a branded long-form YouTube channel using Simon Kaiser's public creator-led approach: audience fit, recurring formats, natural brand integration, Time with Brand, and an organic, paid, and Shorts strategy. Use for channel strategy, format briefs, and pilots.

getedgehq/skills

Build a YouTube strategy, evidence-backed idea slate, and title plus thumbnail package using Paddy Galloway's public method. Use when planning a channel, choosing concepts, or preparing a video before filming.

getedgehq/skills

Build or review a buyer-centered strategic narrative using Andy Raskin's public method. Use for sales or investor deck stories, homepage positioning, keynotes, launch narratives, and why-now messaging.

getedgehq/skills

Turn a product URL, launch brief, or approved script into a production-ready launch video. Use for product reveals, feature announcements, SaaS launches, and narrated product films; not for generic explainers or editing existing footage.

getedgehq/strip-image-ai-metadata

Strip C2PA and AI-generation metadata from images (PNG, JPEG, WebP) to remove "Generated by AI" / "ChatGPT" / "DALL-E" labels that platforms like LinkedIn, Instagram, and X display. Use when the user wants to clean AI-generated images before posting, remove AI attribution from photos, strip C2PA manifests, sanitize image metadata for professional use, or verify whether an image contains C2PA data.

getedgehq/workplan

Create, update, or close work plans for multi-step tasks. Use when starting refactors, bug lists, feature work, migrations, or any task with 2+ steps. Also use after auto-compaction to re-orient. Triggers: "workplan", "work plan", "create a plan", "what's the plan", "where was I", or when Claude detects

相關技能