Community研究與資料分析github.com

管理證據支持決策

使用 Proofline 建立、審查、解釋、匯出、驗證或檢查有證據支持的工程決策是否仍具時效性。適用於 ADR、架構決策、精確來源引用、溯源審查、過時決策檢查、可攜式決策證據包,以及請求解釋哪些不可變證據支持了某項決策。

管理證據支持決策 是什麼?

此技能旨在協助開發人員與 AI 代理透過 Proofline 工具,管理具備完整證據鏈的工程決策。它強調區分原始證據、工程判斷與確定性完整性檢查,確保決策的透明性與可追溯性。支援的作業包含建立新決策時標記來源的不可變版本與精確引用範圍、審查現有決策的證據新鮮度(是否過時)、匯出或驗證決策證據包(Decision Evidence Package),以及解釋特定決策所依據的不可變證據。此技能適用於使用 Proofline CLI 的本地或 CI 環境,並遵循嚴格的防護機制:絕不將引用視為決策正確性的證明、不擅自改寫證據內容、不覆寫檔案除非使用者明確授權 --force,以及不將證據或路徑暴露給未授權的對象。輸出會包含決策陳述、證據位置、來源版本、新鮮度狀態、完整性結果與後續行動建議。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thangldw/proofline/tree/main/skills/manage-evidence-decisions

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

管理證據支持的決策

使用 Proofline 來保存來源身份、來源版本以及精確引用的區間。務必明確區分原始證據、工程判斷與確定性完整性檢查。

安裝檢查

  1. 優先使用插件或專案檢出目錄中已有的 .venv/bin/proofline。
  2. 如果缺少該執行檔,請說明 Proofline 需要 Python 3.11+ 與本地依賴項。在安裝依賴項前先詢問使用者,不要默默執行 make setup。
  3. 將 PROOFLINE_HOME 設定在使用者批准的本地目錄中。未經確認,不要將其指向共享目錄或敏感目錄。

工作流程

  1. 解析使用者要求的決策或證據包,以及確切的本地範圍。
  2. 對於新決策,請識別來源、不可變版本、確切區間、決策陳述、替代方案與理由。不要憑空捏造缺失的證據。
  3. 從 references/commands.md 中使用最精確的 Proofline 指令。
  4. 在執行任何寫入操作前,先預覽將會變更的本地資料庫或輸出路徑。驗證與解釋指令應保持唯讀。
  5. 直接報告無法解析的引用、已變更的證據、缺失的溯源資訊以及完整性失敗。
  6. 返回包含證據位置、新鮮度狀態、限制條件以及下次審查日期或觸發條件的決策摘要。

防護機制

  • 絕不將引用視為工程決策正確性的證明。
  • 絕不重寫引用的原始內容來使決策看起來更新。
  • 除非使用者明確授權 --force,否則不要覆寫匯出檔、套件、備份或報告。
  • 除非使用者明確設定並授權,否則不要啟用外部模型或嵌入提供者。
  • 不要將原始內容、本地路徑、憑證或證據包暴露給使用者選定受眾以外的對象。

輸出

返回:decision、evidence、source_versions、freshness、integrity、limitations 與 next_action。

相關技能