適應主要框架更新
套件的核心測試:輔助並改進主要框架,絕不與之重複或衝突,除非是刻意宣告,並指明原始框架。主要框架的發行可能以三種方式破壞此測試:它可能原生提供某個規則或機制的功能,導致規則變成重複;可能改變規則所描述的行為,導致規則變成衝突;或者新增一個規則應引用的框架。新的模型也可能導致規則的提示風格過時,即使其中的每個事實仍然成立。此技能會找出所有這四種情況並進行修復。
預設路徑
- 在執行任何其他操作之前,先從
origin/main建立一個工作樹。 調查工作流程需要讀取一個乾淨的檢出副本,因此請將它們指向一個無人編輯的第二個工作樹。 - 找出基準線。 最後一次調查的版本和日期記錄在
docs/handbook/sources/harness-survey.md的最後一個日期章節中。最新的重新調查章節會命名研究庫目錄。記錄中的模型事實位於docs/handbook/claude-code.md的「階梯」段落中。npm run check:harness會印出該基準線以及自此之後的每個變更記錄版本,而排程的harness-watchAction 會在列表非空時建立一個harness-update議題。當設定了HARNESS_ROUTINE_URL和HARNESS_ROUTINE_TOKEN秘密時,該 Action 也會觸發一個雲端常式。該常式會執行增量附錄路徑,並在claude/harness-addendum-<version>上開啟一個草稿 PR。當該 PR 存在時,請從它開始,而不是重新分類。同時也要與claude --version進行比對。 - 在新的 CLI 下執行閘道檢查,然後再閱讀任何內容:在一個乾淨的檢出副本上執行
npm run verify。外掛驗證器會以--strict模式執行,因此發行版本新增的警告會導致閘道檢查失敗,而變更記錄分類可以將該條目解讀為雜訊。 - 將差異收集到暫存區,每個來源由一個代理負責:
- 自基準線以來的 Claude Code 變更記錄區段(取自 https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md),這是唯一能標註變更日期的來源;
- 模型概覽和模型配置頁面,用於取得新模型、預設值、價格和努力程度;
- 主要框架自身對這個儲存庫的提示審計(在一個工作階段中執行
/doctor prompt-audit)。它會報告過時的路徑、失效的命令、矛盾的指示以及為較舊模型編寫的提示模式。
- 選擇深度。 使用下面的判斷標準。說明你選擇了哪一個以及原因。
- 分類和歸類。 每個候選項都會被賦予一個處置:DUPLICATE(重複)、CONFLICT(衝突)、COMPLEMENT(補充)或 UNIQUE(唯一)(定義見 references/dispositions.md)。在規則檔案、
plugins/house/orchestration/ORCHESTRATION.md、代理、鉤子、技能和評估中搜尋任何描述舊行為的文字。 - 驗證。 只有當兩個懷疑論者都無法反駁時,DUPLICATE 或 CONFLICT 才算成立。一個懷疑論者檢查文件準確性,另一個檢查執行現實,並且當不確定時,兩者都預設為反駁。然後,工作階段會讀取被引用的那一行和規則文字本身。任何可以透過執行來解決的問題(例如
--help、帶有真實負載的鉤子、檢查器),請直接執行。 - 根據處置採取行動。 解決規則或鉤子中的衝突。淘汰重複項,或將其保留為宣告的重複項,並指明原始框架。僅在規則聲明或暗示某個框架時,才重新措辭補充項,並引用該事實。記錄唯一項並保留它。提示審計的發現只會更改措辭,不會更改規則的宣稱,並且它必須符合檢查器所執行的規則格式。在接受代理的偏離、審查者的「非阻塞」註解或「已知限制」之前,請指出管轄它的內部規則或文件建議,並除非你能說明原因,否則應採取建議的選項。
- 記錄到 references/recording-and-release.md 中描述的三個位置。然後按照其中的發行流程進行發行。
選擇深度
增量附錄(預設)。僅分類自基準線以來的變更記錄區段和模型變更,每個來源由一個研究人員負責。將命中點與規則表面進行分類,然後撰寫一個帶有日期的 ## Addendum 章節。這適用於一個或兩個修復和小功能的發行版本,以及一個影響等級和努力程度的模型變更。
完整重新調查。 從文件重新研究每個主要框架領域,分類每個規則標題和機制,進行驗證、綜合,並執行完整性評論。然後針對評論者指出的任何內容進行缺口分析。同時執行來自增量路徑的變更記錄分類:文件頁面沒有日期,因此沒有變更記錄,完整的執行無法區分當前頁面和過時頁面。表示附錄不足的信號:
- 差異同時觸及多個領域;
- 新的模型系列或預設值到來;
- 提示審計標記了跨多個檔案的模式;
- 附錄在一個其庫存事實早於變更的領域中發現了衝突;
- 上一次重新調查的評論者列出了一些自從以來無人研究的領域。
腳本是 scripts/house-vs-harness-audit.js(主要)和 scripts/house-vs-harness-gap-audit.js(缺口)。每個腳本都接受 args.repo(乾淨工作樹的絕對路徑)和 args.date。缺口執行也接受來自評論者發現的 args.areas 和 args.targets,以及一個可選的 args.context 句子,說明主要執行的結果作為其附錄。它們透過 Workflow 工具執行,這需要使用者明確同意。在詢問之前,請說明代理數量:主要執行是每個領域一個研究人員,每個模組一個 Opus 分類器加上一個用於機制的分類器,每個重複或衝突聲明兩個懷疑論者,以及兩個綜合代理。
風險提示
- 大多數發現是歸因問題,而非實質問題。 目前為止最大的重新調查沒有發現重複和衝突,但確實發現了 27 處重新措辭,其中某個規則聲稱了一個文件未說明的原始框架。在任何規則說主要框架做了什麼之前,該事實必須存在於庫存中或從抓取的頁面上取得。
- 懷疑論者只看重複和衝突。 補充項目的建議重新措辭在未經驗證的情況下就會送達報告,並且它可能和舊文字一樣容易誇大主要框架。在每個重新措辭發行之前,請派遣一個反駁者根據庫存事實進行檢查。
- 天真的標題計數會跳過規則。 每個規則檔案都以
## Don't結尾,而有些真實規則以「Don't」開頭。請透過精確匹配來計數標題,而不是透過前綴。 - 文件頁面沒有日期。 在每個引用旁邊記錄抓取日期。如果變更記錄和頁面不一致,則在時間上相信變更記錄,在內容上相信頁面。
- 模型設定存在於儲存庫之外。 子代理的基礎能力和每個模型的努力程度是使用者設定。當模型變更移動它們時,告訴使用者要設定什麼;永遠不要從這裡編輯他們的設定。新發行的模型會以其自己的預設努力程度執行,直到套用每個模型的等級為止。
- 提示審計的發現可能與規則格式衝突。 對禁止列表或硬數字的審計標記是風格信號。
## Don't章節和長度上限是已檢查的格式和棘輪,因此更改它們是 ADR 下的套件決策,而不是重新措辭。 - 分支防護會讀取命令文字。 使用 Write 工具編寫在分支名稱附近提及 git 動詞的 PR 主體和提交訊息,然後使用
--body-file或-F傳遞它們。 - 子代理不會提交。 工作階段會提交並推送代理準備的任何內容。
此處的編輯何時生效
此技能是儲存庫本地的。編輯會影響到下一個透過名稱呼叫它的工作階段,並且不會發送給採用者。傳遞給採用者的是它產生的規則和機制變更,透過發行版本和每個採用者的 render --apply 來實現。