時間就是金錢｜AI's time is money
用一個本機 Excel 工作簿維護 Agent 已完成工作的價值帳本。Agent 負責發現、去重、估算和更新；使用者只需審閱異常項目，不手動逐條填寫。
設計邊界
- 只依賴本機 Excel；不依賴 Feishu、Base、資料庫或外部同步服務。
- 帳本記錄「可稽核的時間替代價值」，不把估算金額表述成現金收入、利潤或確定收益。
- 預設對外顯示保守低值
saved_minutes_low與saved_cny_low；中、高值只放在 Excel 的參考區間。 - 只記錄有明確完成狀態或交付成果的工作。需求討論、偏好記錄、失敗嘗試、重複維護和只有建議沒有產出的對話預設跳過。
- 不儲存完整聊天、敏感原文、憑證、私密財務明細或不必要的個人資料；證據只儲存短標題、日期、來源 ID、本機路徑或交付成果類型。
工作簿結構
優先使用隨 Skill 提供的 assets/agent-value-ledger-template.xlsx。使用者已有工作簿時，先讀取並保持其結構；缺少必要工作表時再補建。
彙總：低值主結論、週/月彙總、參考區間、低信賴度和待審閱數量。全部由公式驅動。任務明細：一行一項已完成任務。時間、價值、信賴度、證據和假設分欄保存。規則：時薪、預設成本、分類、信賴度和估算邊界。改規則後應保留更新時間。執行狀態：最近掃描時間、掃描視窗、已處理來源數、最近錯誤和待審閱說明。用來支援回掃，不依賴額外 state 檔案。執行日誌：僅記錄短事件、結果和錯誤摘要，不寫入完整原文。
必要欄位與公式請見 references/workbook-schema.md。估算口徑請見 references/estimation-policy.md，脫敏與證據邊界請見 references/redaction-and-evidence.md。
標準流程
1. 讀取工作簿與規則
- 找到使用者指定的
.xlsx；未指定時在目前工作目錄或設定目錄尋找agent-value-ledger.xlsx。 - 先讀取
規則、執行狀態、任務明細和彙總，確認公式、欄位和最近執行狀態。 - 若工作簿不存在，從範本複製到使用者明確的本機路徑；不要悄悄寫入個人目錄。
- 讀取目前日期、時區、時薪和 reporting policy。不得把 Skill 內的範例時薪當作使用者實際時薪。
2. 掃描與回掃
- 掃描可用的本機對話摘要、任務記錄、專案日誌、交付成果目錄和版本記錄。
- 預設回掃最近 7 個自然日，覆蓋「摘要晚於對話完成時間落盤」的情況；每次都以
任務ID、來源 ID 和交付成果指紋去重。 - 先形成候選清單，再判斷完成狀態。不要邊掃描邊直接寫入 Excel。
- 對每項候選標記
accepted、skipped或needs_review，並保留一句原因。
3. 形成任務記錄
每條任務至少寫入：任務 ID、工作日期、任務標題、短摘要、分類、來源、交付成果、信賴度、三檔人工耗時、三檔使用者投入、三檔審核返工、時薪、分攤成本、假設、證據狀態和去重鍵。
計算規則：
saved_minutes = max(0, manual_minutes - user_active_minutes - review_minutes)
saved_cny = saved_minutes / 60 * hourly_rate_cny - allocated_cost_cny
Excel 中保留公式，不把計算結果硬編碼。若無法分攤訂閱/API 成本，成本填 0，並在假設中寫明「未分攤訂閱/API成本」。
4. 寫入前檢查
- 任務 ID、去重鍵或交付成果指紋已經存在：更新證據或跳過，不新增重複價值。
- 缺少完成證據：進入
needs_review，不計入主彙總。 saved_minutes小於 0：按 0 處理並記錄異常。- 低值高於中值或中值高於高值：停止寫入並修正估算。
- 手工輸入的「程式碼行數、檔案數、執行時長」只能作為證據，不能直接等價成節省時間。
5. 更新與驗證
- 先寫
任務明細，再讓彙總公式重算。 - 記錄
執行狀態與執行日誌，包括掃描視窗、候選數、新增數、跳過數、待審閱數和錯誤摘要。 - 回讀新增行、彙總關鍵儲存格和公式錯誤掃描結果。
- 發生檔案不可讀、公式錯誤、來源不可存取或寫入失敗時，停止猜測；在
執行日誌標記失敗和未驗證範圍。 - 對使用者只報告低值主結論、實際新增任務數、待審閱項目和阻塞；不要輸出原始 JSON 或長日誌。
任務分類
使用 規則 工作表的分類表。預設分類包括：
simple_lookup_or_command：簡單查詢、解釋、一條指令feishu_lookup_or_schedule：訊息、行程、任務和工作台查詢doc_wiki_minutes_synthesis：文件、Wiki、會議記錄、翻譯和結構整理report_or_research：調研、分析、方案和判斷框架automation_or_workflow_setup：自動化、資料管線、批次處理、部署和流程搭建coding_or_debugging：程式碼修改、排障、測試、發布和修復local_setup_or_cleanup：本機安裝、清理、遷移和維護
安全與發布邊界
- 脫敏後才允許進入公開倉庫：移除姓名、Email、手機號碼、路徑中的使用者名稱、令牌、Base URL、內部域名、公司客戶名和私有文件標題。
- 範例工作簿只能使用虛構任務和範例數字；不得從使用者真實帳本複製歷史記錄。
- GitHub 發布前執行敏感資訊掃描、Excel 公式錯誤掃描、Skill 結構驗證和公開內容複審。
- GitHub 發布不是本 Skill 的自動副作用；只有使用者明確要求發布並完成審閱後才執行。
資源
- references/workbook-schema.md：工作簿欄位、公式和狀態值。
- references/estimation-policy.md：三檔估算、價值校準和反作弊邊界。
- references/redaction-and-evidence.md：脫敏、證據最小化和公開發布檢查。
- scripts/build_template.mjs：產生或重建脫敏 Excel 範本。