用途:按 Metabase 的对话式、清晰、以用户为中心的风格创建或编辑文档文件(Markdown、MDX 等)。写作前先明确读者是谁、他们需要什么、自己学习时遇到过哪些常见问题,并据此匹配复杂度。
主要能力与写法:先写步骤或说明,再解释原因;标题直接表明要点,例如“Set SAML before adding users”,避免“SAML configuration timing”这类含糊标题。编辑时朗读检查语气,删去无助于读者的内容,确保每段只有一个明确目的,并验证示例确实可用。润色时使用描述性链接(不要用“here”),反引号只用于代码或变量,粗体用于 UI 元素,采用美式拼写和序列逗号,图片尽量少且范围紧凑。
使用方式:编辑完成后运行 yarn prettier --write <file-path> 统一格式。常见模式包括用代码块分步给出命令,而不是把“记得先运行 X”埋在段落里。
限制与注意:不要把任务描述为“easy”;谈 Metabase 功能时不要用“we”,应使用“Metabase”或“it”;避免“utilize”“reference”“offerings”等正式用语和过多感叹号;不要把动作埋在解释中;不要给出会报错的示例或会过时的数字。资料未提供安装方式、收费、平台支持等更多信息。