加载中

撰写设计文档或 RFC

一份结构化的提案,已填入先前方案和权衡取舍。

10 分钟工程Claude Cowork
加载中

设置

试用插件

Engineering 插件内置了 /system-design 作为起点,已经构建好结构,可以填写 RFC 模板并在您的 wiki 中查找先前方案。如果您的管理员负责管理插件,而该插件尚未可用,请跳过此步骤;下面的内容都不需要它。

EngineeringStreamline engineering workflows — standups, code review, architecture decisions, incident response, and technical documentation. Works with your existing tools or standalone.
添加
/system-designDesign systems, services, and architectures.
在 Cowork 中打开
/architectureCreate or evaluate an architecture decision record (ADR).
在 Cowork 中打开

连接您的工具

当 Claude Cowork 直接与您的系统协同工作时,它会更加强大。您可以控制权限和访问权限。了解工具访问权限。

在 Cowork 中导航至 Customize → Connectors 进行设置。

Confluence
查找先前的 RFC 和架构页面,并将新文档直接写入您的工程空间。Confluence 访问权限通过 Atlassian Rovo 连接器(Jira 和 Confluence)提供。
连接
GitHub
读取相关代码和过去的 ADR,使提案能够参照系统的实际情况。
连接
Notion可选
提取 RFC 模板,并将草稿发布到您的设计评审数据库中。
连接

设置您的工作文件夹

将您要使用的文件(您的 RFC 模板、已经写好的一页纸摘要或笔记、相关的过往 RFC、服务的架构图)拖入一个文件夹,并让 Cowork 指向该文件夹。Cowork 会从那里读取内容,并将草稿、备选方案对比表和图表写回该文件夹。从您的 RFCs 文件夹创建一个 Cowork 项目,这样您的模板、评审清单和团队的写作规范就会一直保留在其中。

RFCs / 0087-streaming-events
rfc-template.mdJan 4, 20262 KB
notes-streaming-migration.mdApr 24, 20265 KB
current-pipeline-diagram.pngMar 11, 2026142 KB
在 Cowork’s 聊天栏中:RFCs / 0087-streaming-events

提示

将此内容复制到 Claude Cowork 中

为将我们的事件管道从批处理迁移到流处理撰写一份设计文档。查找先前方案和架构限制条件,然后按照我们的 RFC 模板起草提案:问题、目标与非目标、两到三种带有权衡取舍的方案、建议方案,以及待解决的问题。我会填写只有我才知道的部分。

RFCs / 0087-streaming-events

为什么这样有效

提示词

明确要求查找先前方案。 Cowork 会搜索您的 wiki 和过往的 RFC,使文档能够引用之前尝试过的方法。

提示词

强制要求两到三种方案。 这样您得到的是真正的权衡取舍对比表,而不是对第一个想法的推销说辞。

提示词

说明哪些部分由您来填写。 Cowork 负责处理结构和查找工作;您则把时间花在真正需要判断的地方。

来源

提供您的模板供其遵循。 输出内容会遵循您的章节和标题结构,让评审者看到他们所期望的结构。

获得更好的草稿

练习

添加一个示例以供参照。 将您喜欢的示例放入文件夹,Cowork 就会匹配您的结构和语气风格。

练习

要求它标记不确定之处。 添加"标记出任何您不确定的内容",这样您在审阅草稿时就知道应该先看哪里。

让 Cowork 为您所用

插件技能只是一个起点——您可以用自己的实践经验和专业知识对其进行定制。只需几分钟的对话,此后它就会按照您的标准运行。

把我们在这个任务中目前所做的内容变成一个技能,或者根据我的反馈编辑 /system-design 技能。

RFCs

让它可重复执行

从任意一页纸摘要运行

设计文档往往始于 Slack 讨论串中的一段话,或一份笔记文件。输入 /schedule 或在 Cowork 侧边栏中打开 Scheduled,定制后的技能就会监视您的 RFCs/inbox 文件夹,并将任何新的一页纸摘要转化为结构化的初稿。

/schedule 工作日上午9点,检查 RFCs/inbox 中是否有新的一页纸摘要,对每一份运行 /system-design,并将结构化草稿写入 RFCs/ 下的编号文件夹中。

RFCs
定时任务活跃
RFC 收件箱转草稿

工作日上午9点,从 RFCs/inbox 中获取新的一页纸摘要,运行带有先前方案查找功能的 /system-design,并将结构化草稿写入编号的 RFC 文件夹中。

工作日上午9:00在 Cowork 中打开

与您的团队成员共享

您定制的 /system-design 现在已经包含了您的模板、先前方案来源,以及评审者的常规问题。分享它,这样每位技术负责人的 RFC 都会以相同的形式呈现,架构评审就能把时间花在决策上,而不是格式上。

设计评审会有什么变化