设置
试用插件
Engineering插件自带/documentation作为起点,已经构建好可以在已连接的来源中展开搜索、引用找到的内容,并在不确定时指出负责人。如果您的管理员负责管理插件,而该插件尚未可用,请跳过此步骤;下面的内容都不需要它。
/documentationWrite and maintain technical documentation./architectureCreate or evaluate an architecture decision record (ADR).连接您的工具
Claude Cowork在直接与您的系统协作时更加强大。您可以控制权限和访问。了解工具访问权限(在新标签页中打开)。
在Cowork中导航到Customize → Connectors进行设置。
设置您的工作文件夹
将支撑该代理的文件(您的服务目录导出文件、团队目录、术语表、"在哪里查找内容"的入职文档)拖入一个文件夹,并让Cowork指向该文件夹。这些文件将成为代理在搜索其他任何地方之前查阅的路由表。从该文件夹创建一个Cowork项目(在新标签页中打开),这样随着代理的演进,目录和基本规则会一直保持关联。
提示
将此内容复制到Claude Cowork中
为工程师构建一个内部"随问随答"代理。当有人问"我如何获取预发布环境的API密钥"、"谁拥有订单表"或"为什么上个月部署变慢了"时,在我们的系统中查找答案,引用来源,并且如果不确定就告诉他们该问谁。先得到一个好答案,然后把它变成一个共享技能。
为什么这样有效
为每种问题类型提供一个示例。 一个操作指南类问题、一个归属查询类问题、一个指标原因类问题:涵盖了工程师实际会问的问题类型。
每次都要引用来源。 工程师信任的是链接,而不是文字描述;引用使答案可验证。
不确定时指明负责人。 要求提供"负责团队或频道",可以让Claude在不确定时有所依靠。您得到的是一个可以跟进的线索,而不是一个需要验证的猜测。
将参考文档放入工作文件夹。 服务目录和团队目录会告诉Cowork去哪里查找以及指向谁。
获得更好的草稿
添加一个匹配的示例。 将您喜欢的示例放入文件夹,Cowork会匹配您的结构和语气。
让它标记不确定的内容。 添加"标记出任何您不确定的内容",这样您在审阅草稿时就知道先看哪里。
让Cowork为您所用
该插件的/documentation是一个通用的起点。一旦第2步能很好地回答您的三个问题,就告诉Cowork编写您自己的技能版本。加入应优先搜索哪些空间和仓库、"不确定"的阈值、语气,以及哪些系统是禁区。经过几分钟的对话,该技能从此就能说您的"行话"了。
把我们在这个任务中目前所做的内容变成一个技能,或者根据我的反馈编辑/documentation技能。
使其可重复
将其作为artifact分享
一旦代理能很好地回答您的测试问题,就将其发布为一个artifact,这样组织中的任何人都可以通过一个链接来提问。该artifact在后台运行共享技能;平台团队拥有该技能并持续对其进行调优。
记录它无法回答的每一个问题
当您知道代理在哪些方面有所欠缺时,它就会变得更好。输入/schedule或在Cowork侧边栏中打开Scheduled,每周运行一次会将未能回答的问题写入您的文件夹,以便平台团队填补这些空白。
/schedule 每周五下午4点,列出本周/documentation无法确信回答的问题,按主题分组,并将它们写入Platform/ask-company/gaps-<week>.md,并为每个问题提供一个建议的负责人。
与您的团队成员分享
您定制的/documentation现在承载着您的来源、您的路由表和您的置信度规则。将其在整个工作区范围内分享,这样每个工程师都能以同样的方式向公司提问,"我该如何……"的答案也不再取决于频道里有谁。