加载中

构建一个"询问公司"代理

用通俗易懂的语言回答关于您的wiki、代码和数据仓库的问题。

10 分钟工程Claude Cowork
加载中

设置

试用插件

Engineering插件自带/documentation作为起点,已经构建好可以在已连接的来源中展开搜索、引用找到的内容,并在不确定时指出负责人。如果您的管理员负责管理插件,而该插件尚未可用,请跳过此步骤;下面的内容都不需要它。

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

连接您的工具

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

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

Confluence
首先在wiki和运行手册中搜索已记录的答案。Confluence的访问权限通过Atlassian Rovo连接器(Jira和Confluence)获得。
连接
GitHub
阅读代码、README文件和CODEOWNERS文件,以回答"X是如何工作的"和"谁拥有X"这类问题。
连接
Snowflake可选
查询数据仓库以回答"有多少"和"为什么指标发生变化"这类问题。
连接

设置您的工作文件夹

将支撑该代理的文件(您的服务目录导出文件、团队目录、术语表、"在哪里查找内容"的入职文档)拖入一个文件夹,并让Cowork指向该文件夹。这些文件将成为代理在搜索其他任何地方之前查阅的路由表。从该文件夹创建一个Cowork项目,这样随着代理的演进,目录和基本规则会一直保持关联。

Platform / ask-company
service-catalog.yamlApr 18, 202694 KB
glossary.mdMar 2, 202611 KB
team-directory.mdApr 1, 20266 KB
在 Cowork’s 聊天栏中:Platform / ask-company

提示

将此内容复制到Claude Cowork中

为工程师构建一个内部"随问随答"代理。当有人问"我如何获取预发布环境的API密钥"、"谁拥有订单表"或"为什么上个月部署变慢了"时,在我们的系统中查找答案,引用来源,并且如果不确定就告诉他们该问谁。先得到一个好答案,然后把它变成一个共享技能。

Platform / ask-company

为什么这样有效

提示词

为每种问题类型提供一个示例。 一个操作指南类问题、一个归属查询类问题、一个指标原因类问题:涵盖了工程师实际会问的问题类型。

提示词

每次都要引用来源。 工程师信任的是链接,而不是文字描述;引用使答案可验证。

提示词

不确定时指明负责人。 要求提供"负责团队或频道",可以让Claude在不确定时有所依靠。您得到的是一个可以跟进的线索,而不是一个需要验证的猜测。

来源

将参考文档放入工作文件夹。 服务目录和团队目录会告诉Cowork去哪里查找以及指向谁。

获得更好的草稿

练习

添加一个匹配的示例。 将您喜欢的示例放入文件夹,Cowork会匹配您的结构和语气。

练习

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

让Cowork为您所用

该插件的/documentation是一个通用的起点。一旦第2步能很好地回答您的三个问题,就告诉Cowork编写您自己的技能版本。加入应优先搜索哪些空间和仓库、"不确定"的阈值、语气,以及哪些系统是禁区。经过几分钟的对话,该技能从此就能说您的"行话"了。

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

Platform / ask-company

使其可重复

将其作为artifact分享

一旦代理能很好地回答您的测试问题,就将其发布为一个artifact,这样组织中的任何人都可以通过一个链接来提问。该artifact在后台运行共享技能;平台团队拥有该技能并持续对其进行调优。

记录它无法回答的每一个问题

当您知道代理在哪些方面有所欠缺时,它就会变得更好。输入/schedule或在Cowork侧边栏中打开Scheduled,每周运行一次会将未能回答的问题写入您的文件夹,以便平台团队填补这些空白。

/schedule 每周五下午4点,列出本周/documentation无法确信回答的问题,按主题分组,并将它们写入Platform/ask-company/gaps-<week>.md,并为每个问题提供一个建议的负责人。

Platform / ask-company
定时任务活跃
Ask-company差距报告

每周列出代理无法回答的问题,按主题分组,并撰写一份带有建议负责人的差距报告。

每周五下午4:00在 Cowork 中打开

与您的团队成员分享

您定制的/documentation现在承载着您的来源、您的路由表和您的置信度规则。将其在整个工作区范围内分享,这样每个工程师都能以同样的方式向公司提问,"我该如何……"的答案也不再取决于频道里有谁。

对组织而言有何变化