使用專案的結論登記冊,或是 starter 中的 context/CLAIMS.md。命名陳述、狀態、確切的輸入修訂版、證據路徑與命令、作者、驗證者(如適用)、日期與範圍限制。整合維護者負責維護;其他人則提議基於證據的變更。
狀態:
- VERIFIED:接受標準已通過,且獨立的人員、代理或適度獨立的自動化檢查已重現相關結果。請註明驗證者與方法。
- PROVISIONAL:存在支持證據,但指定的檢查或依賴項仍處於待處理狀態。
- NOT SHOWN:指定的測試未能建立該陳述。保留觀察到的結果與失敗原因。
- VOID:證據或假設已被否定或取代。保留原因與替代參考。
區分「測試通過」與「生產環境安全」,以及「在工作負載 X 上更快」與「普遍加速」。陳述最狹義的支持結論。作者的第二輪執行可強化證據,但不構成獨立驗證。
在可行的情況下,請隨證據一起更新條目。不要在得出新結果後無聲地覆蓋結論;請記錄過渡過程與原因。報告中可包含登記冊之外的新工作,但需清楚標示為未經驗證。當證據仍然支持現有陳述時,無需進行編輯。