載入中

建立一個「詢問公司」代理程式

針對您的 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 和 runbook 中搜尋已記錄的答案。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 中

為工程師建立一個內部的「什麼都能問」代理程式。當有人問「我該如何取得 staging API 金鑰」、「誰擁有 orders 資料表」或「為什麼上個月的部署變慢了」時,在我們的系統中找出答案,引用來源,並在不確定時告訴他們該問誰。先取得一個好答案,再將其轉變成共用技能。

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
排程任務啟用中
詢問公司缺口報告

每週列出代理程式無法回答的問題,依主題分組,並撰寫附有建議負責人的缺口報告。

每週五下午 4:00在 Cowork 中開啟

與您的團隊成員分享

您自訂的 /documentation 現在已經承載了您的來源、路由表和信心規則。將其分享到整個工作區,讓每位工程師都以相同的方式詢問公司,「我該如何…」的答案不再取決於頻道中有誰在。

對組織而言有何改變