YYLO Ledger

YYLO Ledger 直接將任務主體、狀態、回應、標籤、關係與提交證據儲存在 Git 中，使記錄保持版本化且可檢查。

依賴感知

阻塞項與關係被明確建模，團隊能發現可執行工作，並在派發前依拓撲順序排列任務。

智能體友善輸出

結果可以 JSON、NDJSON、XML 或表格形式輸出，便於腳本、智能體與人工操作者消費資料。

保留歷史

變更歷史被完整保留，已完成工作被移入不可變的冷封存包，形成持久的工程記憶。

• 編碼團隊：將任務意圖、狀態與阻塞項儲存在 Git 中，讓每個智能體和開發人員看到同一真相來源。
• AI 智能體操作者：在多次自動化運行中追蹤派發的工作與提交證據，而不會遺失狀態。
• 工程負責人：浮現阻塞項與可執行工作，以規劃並依拓撲順序排列下一輪任務。
• 合規與稽核：保留變更歷史，並將已完成工作封存到不可變的冷封存包中供日後審查。
• 交接：提供持久的任務記憶記錄，即使對話或團隊成員發生變化也能延續。

YYLO Ledger 是什麼？

YYLO Ledger 是一款本地、依賴感知的真相來源，用於記錄任務意圖、狀態、阻塞項、回應、歷史、封存與提交證據。它將任務真相原生儲存在 Git 中，因此記錄持久、可版本化，人和編碼智能體都能檢查。

如何安裝 YYLO Ledger？

使用指令 pip install yylo-ledger==0.2.1rc1 安裝同步的開源發佈版本。版本與連結直接從儲存庫真相來源同步，因此你總能取得目前發佈版。

如何開始使用？

從一個有邊界的結果開始，例如 yy ledger create "Verify the release" --status todo。保持首次變更較小，能在擴展到更多任務前更容易驗證與審查。

它如何儲存任務資料？

它直接將任務主體、狀態、回應、標籤、關係與提交證據儲存在 Git 中。任務間會建立依賴關係，以便在派發給智能體前依拓撲順序排列。

為什麼它是依賴感知的？

阻塞項會被明確建模，使團隊能找到可執行工作，並在派發前正確排列任務順序。這降低了協調成本，讓編碼智能體的工作流程保持確定性。

它支援哪些輸出格式？

它可以 JSON、NDJSON、XML 或表格形式輸出結果。這些格式旨在讓腳本、編碼智能體與人工操作者輕鬆消費。

它如何保留歷史？

變更歷史被保留在 Git 原生記錄中，已完成工作被移入不可變的冷封存包，從而建立長期工程記憶。

• 使用 pip install yylo-ledger==0.2.1rc1 安裝同步發佈版本，以取得目前開源版本。
• 透過執行 yy ledger create "Verify the release" --status todo 作為第一個任務，從一個有邊界的結果開始。
• 將任務主體、狀態、阻塞項、回應、標籤與關係直接記錄到 Git 中，形成持久的真相。
• 讓 Ledger 浮現阻塞項與可執行工作，然後在派發給智能體之前依拓撲順序排列任務。
• 審查保留的歷史，並將已完成工作封存到不可變的冷封存包中，以建立長期工程記憶。