Confluence
Confluence 頁面讀寫
Andy 如何讀取 Confluence 頁面、建立新頁面、編輯既有頁面、處理附件。
當 Andy 在已連結 Confluence space 的工作空間中處理任務時,可以把頁面內容拉進對話,也可以視需求寫回 Confluence。通常這是 Slack 對話或網頁任務的一部分,不需要走獨立的 Confluence 流程。
讀取頁面
引用頁面的方式跟平常一樣。在訊息中貼 Confluence URL:
@MeetAndy summarize https://acme.atlassian.net/wiki/spaces/ENG/pages/123/Deploy+Runbook@MeetAndy use the deploy runbook to plan rollback steps for this PRAndy 會從 Confluence 取得頁面,把標題、內文、標題層級、表格、程式碼區塊、附加圖片等內容當作脈絡使用。
如果你已經把 Confluence space 連到 MeetAndy 工作空間,也可以直接用標題引用:
@MeetAndy what does the deploy runbook say about database migrations?建立頁面
請 Andy 寫一個新頁面,並說明放在哪:
@MeetAndy create a Confluence page in the ENG space summarizing what changed in PR-123預設 Andy 會建立草稿。在你親自發布之前,頁面不會出現在 Confluence space。草稿讓你有機會在他人看到之前審閱與修改。
要 Andy 直接發布:
@MeetAndy create and publish a Confluence page in the ENG space summarizing PR-123Andy 會回傳頁面 URL(草稿的話會附草稿連結),方便你直接打開。
更新頁面
Andy 可以編輯既有頁面:加段落、置換內容、改標題、更新標籤。用 URL 或標題引用頁面:
@MeetAndy add the rollback section we just discussed to the deploy runbook更新預設會發布。要存成未發布的草稿就明確說:
@MeetAndy update the deploy runbook with the new rollback section, save as a draft附件與內嵌圖片
Andy 建立或更新頁面時可以加附件和內嵌圖片:
- 附件出現在頁面的 Attachments 區,跟其他 Confluence 附件一樣可下載。
- 內嵌圖片會嵌在內文中合適的位置。例如 Andy 在摘要中產生圖表或截圖時,會直接嵌入而不是只當附件。
你不必特別指定,Andy 會根據需求自行決定要附加還是內嵌。
一般頁面與 Live Docs
Andy 同時支援一般 Confluence 頁面與 Live Docs(Confluence 較新的即時協作格式)。