Community编程与开发github.com

getedgehq/top-down-comms

自上而下的客户沟通技能,帮助你优先组织论点,而不是仅仅调整语气。

top-down-comms 是什么?

该技能专注于解决文档结构问题:即使语气完美,如果论点顺序错误(例如以免责声明开头),文档仍会失败。它基于明托金字塔原理,强调将核心观点放在第一句,使用行动标题代替主题标签,并确保每个段落支持中心论点。技能支持站式和逻辑检查,如“标题阅读测试”和“MECE原则”,帮助用户构建清晰、有力的沟通内容,适用于提案、报告等需要逻辑说服力的场景。

兼容平台~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:行动标题,而非主题标签

每个章节标题陈述其结论。只读标题的读者必须得到完整的论点。这是最高杠杆率的举措,也是最常被跳过的。

主题标签(弱)行动标题(正确)
背景瓶颈是产能,而不是需求
打分逻辑五个标准决定订单的实际价值
示例同一个早上两个请求,相同努力,不同利润率
测试可在1小时内检查,在构建任何东西之前
工作几天到运行

仅标题测试。 剥离正文。按顺序阅读标题。如果它们不能形成一个连贯的论点,结构就是错误的,任何正文都无法挽救。

规则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

相关技能