管理證據支持的決策
使用 Proofline 來保存來源身份、來源版本以及精確引用的區間。務必明確區分原始證據、工程判斷與確定性完整性檢查。
安裝檢查
- 優先使用插件或專案檢出目錄中已有的
.venv/bin/proofline。 - 如果缺少該執行檔,請說明 Proofline 需要 Python 3.11+ 與本地依賴項。在安裝依賴項前先詢問使用者,不要默默執行
make setup。 - 將
PROOFLINE_HOME設定在使用者批准的本地目錄中。未經確認,不要將其指向共享目錄或敏感目錄。
工作流程
- 解析使用者要求的決策或證據包,以及確切的本地範圍。
- 對於新決策,請識別來源、不可變版本、確切區間、決策陳述、替代方案與理由。不要憑空捏造缺失的證據。
- 從
references/commands.md中使用最精確的 Proofline 指令。 - 在執行任何寫入操作前,先預覽將會變更的本地資料庫或輸出路徑。驗證與解釋指令應保持唯讀。
- 直接報告無法解析的引用、已變更的證據、缺失的溯源資訊以及完整性失敗。
- 返回包含證據位置、新鮮度狀態、限制條件以及下次審查日期或觸發條件的決策摘要。
防護機制
- 絕不將引用視為工程決策正確性的證明。
- 絕不重寫引用的原始內容來使決策看起來更新。
- 除非使用者明確授權
--force,否則不要覆寫匯出檔、套件、備份或報告。 - 除非使用者明確設定並授權,否則不要啟用外部模型或嵌入提供者。
- 不要將原始內容、本地路徑、憑證或證據包暴露給使用者選定受眾以外的對象。
輸出
返回:decision、evidence、source_versions、freshness、integrity、limitations 與 next_action。