DevArtsLab/devartslab-linear-research-refine

Linear 研究優化 (Linear Research Refinement)

針對一個進行中的 Linear 研究票券執行一次每日品質層級的優化處理。預設目標：DEV-47（將工作追蹤器產品化為 DevArts Lab 工作區上的多租戶 SaaS，使用 Cloudflare）。傳入不同的問題識別碼即可重複用於其他票券。

優化協議 (Pass protocol)

1. 擷取票券：透過 linear-mcp-server（使用 get_issue 或 list_issues 並指定識別碼）取得票券。首先閱讀完整的描述與所有評論。

2. 選擇一個焦點領域：選擇具有低信心度的最高優先級開放性問題，或是研究發現中最久未經驗證的論述。深入探討一個領域，而非觸及所有項目。

3. 僅使用權威來源進行研究：官方文件、變更記錄、供應商定價頁面、上游儲存庫/議題。使用 web_search + webfetch 工具。記錄每個來源的 URL 與查閱日期。

4. 就地更新票券（使用 save_issue 修補）：

   • 以 [verified YYYY-MM-DD: source] 格式標記已驗證的論述
   • 更正過時或錯誤的論述
   • 將已解答的問題移至決策記錄，包含：日期、決策、證據、信心度，以及可能改變決策的因素
   • 新增發現的開放性問題（說明其重要性與優先級）
   • 若證據支持，則更新階段/計劃

5. 每次優化添加一條評論（使用 save_comment）：說明焦點領域、更改了什麼、下一步該查看什麼。將產品判斷的決策（如定價、範圍、隱私權衡）標記給使用者，而非自行決定。

6. 保持有限範圍：進行一次性的增量更新。每日的優化處理會逐步累積。

規則

• 僅進行研究與票券更新。請勿修改程式碼或儲存庫。
• 絕不虛構來源或能力。將無法驗證的論述標記為「未驗證」，並說明缺少的證據。
• 保留票券的既有結構；就地編輯，絕不全面改寫。
• 如果所有問題都已解決：重新驗證最久經確認的論述（它們會隨時間衰減），或深化實作計劃。
• 工作區儲存庫可為取得上下文而讀取，但不可編輯。

排程

排程副本會由 agent-research-kit（位於 ~/projects/devartslab/agent-research-kit/install.sh）按專案產生，該工具會將 templates/prompt.md.tmpl 模板與每個專案的議題 ID 結合渲染。本文件為互動式參考；而 kit 的提示模板為排程主控。