协作头脑风暴
brainstorming
在实现前澄清需求、探索设计选择,并形成清晰的开发方向。
business-writing【开发与工程】Use when writing anything at work that needs a reader to decide, approve, act or understand — emails, Teams and Slack messages, one-pagers, proposals, status updates, executive summaries, slide text and meeting requests. Covers leading with the outcome rather than the chronology, naming the ask, the so-what test, structure for skim-readers, subject a…
独立 GitHub 快照 · 自动分类 · 以原作者文档为准
Verified 2026-07-29.
Load the user's recorded preferences before drafting — register, formatting and house style are already captured per domain:
python3 ~/.claude/skills/user-preferences/scripts/prefs.py load email # or presentations, tone
A live instruction always overrides a stored preference.
Lead with the outcome. Not the background, not the chronology, not the process.
Most workplace writing is assembled in the order the work happened — context, then what we tried, then what we found, then what it means. Readers consume in the opposite order and most stop early. Senior readers skim, and they skim from the top.
✗ "Following the review we began in March, we assessed four vendors against
the criteria agreed with the working group, and after testing..."
✓ "Recommend we go with Vendor B. £40k cheaper over three years and the only
one that meets the retention requirement. Decision needed by 14 Aug.
Detail below."
BLUF — bottom line up front. Answer first, then the reasoning that supports it, then the evidence that supports that. Someone who stops after one paragraph should still have the thing you needed them to know.
The honest caveat: brevity can cut something load-bearing. BLUF is not "make it short" — it is "put the conclusion first". A risk, a caveat or a dependency the reader must act on belongs above the fold, not sacrificed to it.
Every piece of workplace writing has exactly one of four jobs. Naming it first is what makes the draft write itself:
| Job | The reader should finish and… |
|---|---|
| Decide | Know the options, your recommendation, and by when |
| Approve | Know the cost, the risk, and what they are signing |
| Act | Know exactly what to do, and by when |
| Be informed | Know what changed and whether it affects them |
If you cannot name the job, do not send it yet — that is the actual reason a draft feels wrong.
Then write the ask as a sentence, not an implication. "Let me know your thoughts" converts to nothing, because nobody knows what agreeing looks like. "Can you approve the £12k by Friday so we can order?" does.
Where an ask is buried at the end, the reader who skims never reaches it — and skimming is the normal case, not the rude one.
Answer → because → evidence. Each layer supports the one above it, and each is optional to the reader.
The lead-with-the-outcome rule never changes. Length and formality do.
| Surface | Shape |
|---|---|
| Subject carries the message. Ask in the first two lines. Detail beneath a break | |
| Teams / Slack | One message, not five. Ask up front. Thread the detail rather than the channel |
| Status update | What changed · what it means · what you need. Never a task list |
| One-pager | Problem · recommendation · options considered · cost and risk · the ask · timeline |
| Proposal | As above plus what happens if we do nothing, which is the question that gets asked |
| Exec summary | Standalone. Must work for someone who reads nothing else — and many will not |
| Slide text | Headline states the finding, not the topic. "Costs rose 12% in Q3", not "Q3 costs" |
| Meeting request | Purpose, decision required, pre-read, who must attend and why |
The subject line is the only text guaranteed to be read. Make it the message:
Approval needed: Vendor B, £12k, by Fri 14th beats Vendor update. Front-load it — mobile
notifications truncate at around forty characters.
On chat: the "hello, are you free?" opener wastes a round-trip. Ask in the first message.
Every paragraph must answer: so what, for this reader? Anything that fails is your interest, not theirs — process detail, how hard the work was, who was in which meeting.
Lead with it. Burying bad news is the single most damaging habit in workplace writing, because the reader discovers it later, usually from someone else, and now the concealment is the story.
Order: what happened · impact · what you are doing · what you need · when you will next update.
Match the reader, not the org chart. Peers, senior stakeholders and external clients need different formality; none of them need jargon.
If a draft reads as AI-written, the fix is specificity, not vocabulary — details only you could
know. See human-voice-writing.
Write it, then cut a third. Nearly every first draft carries a third it does not need.
Cut first, in this order: throat-clearing openings · restating the question · process narration · anything the reader already knows · adverbs · sentences that only introduce the next sentence.
If it will not fit, the problem is usually that you have not decided what you are asking for (§2). Length is a symptom.