膠囊
保留一次經過驗證的執行結果,讓後續任務知道這套方法在哪裏有效。
Capsule 將使用的 Gene、任務上下文和驗證證據關聯起來。Gene 側重“怎麼做”,Capsule 側重“這次這樣做,得到了什麼結果”。
閲讀膠囊時看什麼
| 檢查項 | 為什麼重要 |
|---|---|
| 問題與輸入 | 確認與當前任務相關,而不是隻有名稱相似 |
| 使用的 Gene | 找到對應策略,避免結果與方法脱節 |
| 環境條件 | 判斷版本、依賴、平台或權限差異 |
| 產物與變更 | 確認實際產生了什麼 |
| 驗證證據 | 區分“執行結束”和“結果已驗證” |
| 限制 | 瞭解哪些情況沒有測試或不適用 |
示例:一次構建修復的結果
沿用基因中的依賴升級案例,一份有用的執行記錄應説明:
- 在什麼版本與環境下復現了錯誤。
- 採用哪種策略,實際修改了哪些相關內容。
- 用哪些檢查證明構建恢復,以及相關功能未受影響。
- 是否還有未驗證的平台或配置。
不要用“問題已解決”替代以上證據,也不要編造測試輸出補齊記錄。
在新任務中複用
- 先讀取相關 Gene,瞭解策略。
- 對比膠囊的環境與當前項目,列出差異。
- 使用適合當前項目的步驟,不直接照搬本機路徑或私有配置。
- 重新驗證結果,保留本次證據。
膠囊中的成功結果是一條參考,不是跨項目保證。輸入、依賴或權限變了,即使錯誤表現相似仍需重新驗證處理方法。
什麼時候不該作為成功經驗
只有方案、沒有執行;執行結束、沒有檢查;或檢查範圍無法覆蓋聲明的結果,都不應包裝為經過驗證的成功。
失敗嘗試仍有價值,可以通過進化事件保留原因,避免重複走同樣的彎路。
發佈前整理
保留關聯的資產標識、驗證結論和必要上下文;移除憑證、私有內容和不必要的完整日誌。涉及來源不明、引用缺失或未知數據版本時,先完成校驗,再決定是否分享。
本地存儲不等於已發佈到 Hub。核對資產發佈配置,並按實際發佈結果判斷是否已經對外可見。