Communitygithub.com

flivideo/flivideo

管理產品負責人(PO)與開發(Dev)Agent 之間的交換溝通,透過中央佇列檔案進行。適用於 PO 需要將工作連同完整上下文交接給 Dev、Dev 需要讀取佇列中指派的工作、Dev 需要標記完成並附上備註,以及 PO 需要處理已完成項目並更新變更日誌。

flivideo 是什麼?

Handover Queue 是一個基於檔案的協作工具,專為 AI Agent(如 Claude Code)設計,用於產品負責人(PO)與開發者(Dev)之間的溝通,特別適用於需要清晰交接工作脈絡的場景。其核心機制是維護一個位於 `docs/handover-queue.md` 的中央佇列,讓 PO 可以創建包含問題描述、實作細節、接受標準等的完整手遞(handover)項目,並由 Dev 讀取、開始執行。Dev 完成工作後,可將項目狀態改為已完成,並附加實作摘要、修改檔案與測試備註。PO 則能批次處理已完成項目,將其整合進 changelog 與 backlog,最後可選擇歸檔或移除。此技能強調自我包含、單一事實來源與乾淨的流程轉換,確保資訊流一致且無需在檔案間反覆查找。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/flivideo/flivideo/tree/HEAD/.claude/skills/handover-queue

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

交接佇列

PO 與 Dev Agent 之間基於中央檔案的溝通機制。

檔案位置

佇列檔案:docs/handover-queue.md(相對於專案根目錄)

若檔案不存在:詢問使用者是否要建立。若是,則參考 references/queue-format.md 中的範本進行建立。

指令

PO:建立交接

當 PO 說「交接 FR-XX」或類似內容時:

  1. 讀取 docs/handover-queue.md
  2. 在 ## Pending 區段新增一筆項目:
### FR-XX:標題
**建立日期:** YYYY-MM-DD
**狀態:** 待處理

**問題:** [一句話說明]

**實作:**
[完整的實作細節—檔案、程式碼片段、驗收標準]
[必須完整且自足—Dev 僅憑此即可開始工作]

---
  1. 確認交接已新增

Dev:讀取佇列

當 Dev 說「我的佇列中有什麼?」或開始工作時:

  1. 讀取 docs/handover-queue.md
  2. 顯示 ## Pending 區段的項目
  3. 若開始處理特定 FR-XX,則將狀態更新為「進行中」

Dev:完成工作

當 Dev 說「標記 FR-XX 完成」或提供交接時:

  1. 讀取 docs/handover-queue.md
  2. 將 FR-XX 項目從 ## Pending 移至 ## Completed
  3. 更新項目內容:
### FR-XX:標題
**建立日期:** YYYY-MM-DD
**完成日期:** YYYY-MM-DD
**狀態:** 完成

**問題:** [原始內容]

**實作:** [原始內容]

**完成備註:**
[實際實作了什麼]
[修改的檔案]
[測試備註]

---

PO:處理已完成項目

當 PO 說「處理已完成項目」或類似內容時:

  1. 讀取 docs/handover-queue.md
  2. 對 ## Completed 中的每個項目:
    • 向 PO 顯示摘要
    • 協助更新 docs/changelog.md
    • 協助更新 docs/backlog.md 的狀態
  3. 處理完成後,從 ## Completed 區段移除項目
  4. 可選擇移至 ## Archived 以保留歷史紀錄

佇列檔案格式

完整範本與範例請參閱 references/queue-format.md。

關鍵原則

  • 自足交接:Dev 僅憑佇列內容即可工作,無需在其他檔案中搜尋
  • 單一事實來源:所有進行中的交接集中在同一處
  • 乾淨的流程轉換:項目依序流轉為待處理 → 已完成 → 歸檔/移除

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能