熟练制作文档

背景与摘要

大多数商业文档（从演示文稿到备忘录）通常设计糟糕，无法有效传达信息。为了解决这一痛点，Anil Dash 在他早先提出的“制作更好的文档”的理念基础上，创建了一个名为 Better Documents skills.md 的开源文件。该文件利用大语言模型（如 Claude）的“代理技能（agent skills）”机制，通过五项核心测试指导 AI 助手自动生成或审查符合最佳实践的商业文档，以确保文档在目标受众、结构、格式和命名上更加专业和清晰。

Summary

大多数商业文档——从演示文稿到备忘录——设计得很糟糕，无法进行有效的沟通。在之前工作的基础上，Anil Dash 创建了一个开源的 Better Documents skills.md 文件，旨在帮助用户通过提示 AI 工具（如 Claude）来生成或审查高质量的商业文档。利用“代理技能 (agent skills)”的概念，该工具应用了五个核心测试来确保更好的受众考量、结构、格式和命名规范。

Most business documents—from presentations to memos—are poorly designed and fail to communicate effectively. Building on his previous work, Anil Dash has created an open-source Better Documents skills.md file designed to help users prompt AI tools (like Claude) to generate or review high-quality business documents. Utilizing the concept of "agent skills," the tool applies five core tests to ensure better audience consideration, structure, formatting, and naming conventions.

The Problem with Business Documents

人们用于开展业务的绝大多数文档真的非常糟糕：

The vast majority of the documents people use to do business are really quite poor: * 让人昏昏欲睡的演示文稿。 * Presentations that make your eyes glaze over. * 令人费解或含糊不清的备忘录。 * Memos that are inscrutable or unclear. * 反映其创建方式而非其意图传达之信息的产物。 * Artifacts that reflect how they were created rather than the message they are meant to convey.

这种持续的挫败感激发了最初的那篇文章——制作更好的文档，其中收录了一系列关于创建有效文档的实用建议，使文档能够服务于你的目标，而不是与你的目标背道而驰。

This persistent frustration inspired the original essay, Make Better Documents, which captured a list of practical suggestions for creating effective documents that work for your goals rather than against them.

Introducing the Better Documents AI Skill

在这些初步建议获得了热烈的反响之后，一个新工具应运而生：Better Documents skills.md 文件。

Following the warm response to those initial suggestions, a new tool has been created: the Better Documents skills.md file.

该资源帮助那些使用 LLM 工具（如 Claude）的人们提示他们的 AI 助手，默认生成更好的商业文档。

This resource helps people who use LLM tools (like Claude) prompt their AI assistants to produce better business documents by default.

How Agent Skills Work

如果你对它们还不熟悉，代理技能 (agent skills) 是简单的文本文件（用 Markdown 编写——进一步证明了 Markdown 是如何接管世界的），它们描述了 LLM 在执行任务期间要使用的新能力或流程。

If you aren't familiar with them, agent skills are simple text files (written in Markdown—further proof of how Markdown is taking over the world) that describe new capabilities or processes for LLMs to use during tasks.

Better Documents 技能将宽泛的设计原则提炼为五个必要的测试：

The Better Documents skill distills broad design principles into five essential tests: 1. 目标受众考量 1. Target audience consideration 2. 结构完整性 2. Structural integrity 3. 格式克制 3. Formatting restraint 4. 清晰直观的命名 4. Clear and intuitive naming 5. 生成符合规范的新文件或根据最佳实践审查现有草稿 5. Generation of compliant new files or review of existing drafts against best practices

A Versatile Tool for Everyone

虽然很简单，但该工具已被证明对于常规的文档改进是有效的。特别是对于那些不希望让 LLM 从头开始起草文档，但又欣赏类似于拼写检查或语法检查等软件辅助功能的人来说，它非常有用。

While straightforward, this tool has proven effective for routine document improvement. It is particularly useful even for those who prefer not to have an LLM draft documents from scratch, but who appreciate software assistance similar to a spell-checker or grammar-checker.

Open Source and Collaboration

如果您熟悉代理技能，安装过程既简单又标准。

If you are familiar with agent skills, the installation process is simple and standard.

免费且开源： 该工具完全免费，没有任何限制。
- Free & Open Source: The tool is completely free with no restrictions.
欢迎贡献： 程序员可以在 GitHub 上发送 Pull Request，而非程序员也欢迎通过电子邮件或社交媒体分享反馈、修复或建议。
- Contributions Welcome: Coders can send a pull request on GitHub, while non-coders are welcome to share feedback, fixes, or suggestions via email or social media.

希望我们大家都能少忍受些糟糕透顶的演示文稿！

Here’s to us all enduring fewer terrible presentations!