設定
試用外掛程式
Engineering 外掛程式內建 /documentation 作為起點,已經設計成能夠在已連接的來源中展開搜尋、引用其找到的內容,並在不確定時指出負責人。如果您的管理員負責管理外掛程式,而此功能尚未提供,請跳過此步驟;以下內容皆不需要它。
/documentationWrite and maintain technical documentation./architectureCreate or evaluate an architecture decision record (ADR).連接您的工具
Claude Cowork 在直接與您的系統搭配運作時會更強大。您可以控制權限和存取權。了解工具存取權(在新分頁中開啟)。
在 Cowork 中前往 Customize → Connectors 進行設定。
設定您的工作資料夾
將支撐此代理程式的檔案(您的服務目錄匯出檔、團隊目錄、詞彙表、「如何找到東西」的新人導覽文件)拖曳到同一個資料夾中,並讓 Cowork 指向該資料夾。這些檔案會成為代理程式在搜尋其他地方之前所參考的路由表。從該資料夾建立一個 Cowork 專案(在新分頁中開啟),讓目錄和基本規則在代理程式演進時持續保持關聯。
提示
將此複製到 Claude Cowork 中
為工程師建立一個內部的「什麼都能問」代理程式。當有人問「我該如何取得 staging API 金鑰」、「誰擁有 orders 資料表」或「為什麼上個月的部署變慢了」時,在我們的系統中找出答案,引用來源,並在不確定時告訴他們該問誰。先取得一個好答案,再將其轉變成共用技能。
為什麼這樣有效
為每種問題類型提供一個範例。 操作方法、所有權查詢、指標原因:涵蓋了工程師實際會問的問題類型。
每次都要引用來源。 工程師信任的是連結,而不是文字敘述;引用讓答案可以被驗證。
不確定時指出負責人。 要求提供「擁有的團隊或頻道」,能讓 Claude 在沒有信心時有個依靠。您得到的是一個可以追蹤的指引,而不是一個需要驗證的猜測。
將參考文件放在工作資料夾中。 服務目錄和團隊目錄會告訴 Cowork 該去哪裡查找,以及該指向誰。
取得更好的草稿
加入一個範例來比對。 將您喜歡的範例放入資料夾,Cowork 就會比對您的結構和語氣。
要求它標記不確定之處。 加入「標記任何您沒有信心的內容」,這樣您在檢視草稿時就知道該先看哪裡。
讓 Cowork 為您所用
外掛程式的 /documentation 是一個通用的起點。一旦第 2 步能妥善回答您的三個問題,就告訴 Cowork 撰寫您專屬版本的技能。加入應優先搜尋哪些空間和儲存庫、「我不確定」的門檻、語氣,以及哪些系統是禁區。只需幾分鐘的對話,此後該技能就會說您的技術堆疊的語言。
將我們在這項任務中目前為止所做的事情變成一個技能,或根據我的回饋編輯 /documentation 技能。
讓它可重複執行
以 artifact 形式分享
一旦代理程式能妥善回答您的測試問題,就將其發布為 artifact,讓組織中的任何人都能透過一個連結提問。該 artifact 會在背後執行共用技能;平台團隊擁有此技能並持續調校它。
記錄每一個它無法回答的問題
當您知道代理程式的不足之處時,它就會變得更好。輸入 /schedule 或在 Cowork 側邊欄中開啟 Scheduled,每週執行一次會將未能回答的問題寫入您的資料夾,讓平台團隊能夠填補這些缺口。
/schedule 每週五下午 4 點,列出本週 /documentation 無法有信心回答的問題,依主題分組,並將其寫入 Platform/ask-company/gaps-<week>.md,並為每個問題建議一位負責人。
與您的團隊成員分享
您自訂的 /documentation 現在已經承載了您的來源、路由表和信心規則。將其分享到整個工作區,讓每位工程師都以相同的方式詢問公司,「我該如何…」的答案不再取決於頻道中有誰在。