设置
试用插件
Engineering 插件内置了 /system-design 作为起点,已经构建好结构,可以填写 RFC 模板并在您的 wiki 中查找先前方案。如果您的管理员负责管理插件,而该插件尚未可用,请跳过此步骤;下面的内容都不需要它。
/system-designDesign systems, services, and architectures./architectureCreate or evaluate an architecture decision record (ADR).连接您的工具
当 Claude Cowork 直接与您的系统协同工作时,它会更加强大。您可以控制权限和访问权限。了解工具访问权限(在新标签页中打开)。
在 Cowork 中导航至 Customize → Connectors 进行设置。
设置您的工作文件夹
将您要使用的文件(您的 RFC 模板、已经写好的一页纸摘要或笔记、相关的过往 RFC、服务的架构图)拖入一个文件夹,并让 Cowork 指向该文件夹。Cowork 会从那里读取内容,并将草稿、备选方案对比表和图表写回该文件夹。从您的 RFCs 文件夹创建一个 Cowork 项目(在新标签页中打开),这样您的模板、评审清单和团队的写作规范就会一直保留在其中。
提示
将此内容复制到 Claude Cowork 中
为将我们的事件管道从批处理迁移到流处理撰写一份设计文档。查找先前方案和架构限制条件,然后按照我们的 RFC 模板起草提案:问题、目标与非目标、两到三种带有权衡取舍的方案、建议方案,以及待解决的问题。我会填写只有我才知道的部分。
为什么这样有效
明确要求查找先前方案。 Cowork 会搜索您的 wiki 和过往的 RFC,使文档能够引用之前尝试过的方法。
强制要求两到三种方案。 这样您得到的是真正的权衡取舍对比表,而不是对第一个想法的推销说辞。
说明哪些部分由您来填写。 Cowork 负责处理结构和查找工作;您则把时间花在真正需要判断的地方。
提供您的模板供其遵循。 输出内容会遵循您的章节和标题结构,让评审者看到他们所期望的结构。
获得更好的草稿
添加一个示例以供参照。 将您喜欢的示例放入文件夹,Cowork 就会匹配您的结构和语气风格。
要求它标记不确定之处。 添加"标记出任何您不确定的内容",这样您在审阅草稿时就知道应该先看哪里。
让 Cowork 为您所用
插件技能只是一个起点——您可以用自己的实践经验和专业知识对其进行定制。只需几分钟的对话,此后它就会按照您的标准运行。
把我们在这个任务中目前所做的内容变成一个技能,或者根据我的反馈编辑 /system-design 技能。
让它可重复执行
从任意一页纸摘要运行
设计文档往往始于 Slack 讨论串中的一段话,或一份笔记文件。输入 /schedule 或在 Cowork 侧边栏中打开 Scheduled,定制后的技能就会监视您的 RFCs/inbox 文件夹,并将任何新的一页纸摘要转化为结构化的初稿。
/schedule 工作日上午9点,检查 RFCs/inbox 中是否有新的一页纸摘要,对每一份运行 /system-design,并将结构化草稿写入 RFCs/ 下的编号文件夹中。
工作日上午9点,从 RFCs/inbox 中获取新的一页纸摘要,运行带有先前方案查找功能的 /system-design,并将结构化草稿写入编号的 RFC 文件夹中。
与您的团队成员共享
您定制的 /system-design 现在已经包含了您的模板、先前方案来源,以及评审者的常规问题。分享它,这样每位技术负责人的 RFC 都会以相同的形式呈现,架构评审就能把时间花在决策上,而不是格式上。