內部規範查詢(House conventions lookup)
此技能回答一個問題:針對某主題,內部規範(house)怎麼說,以及規範檔案位於何處。它讀取渲染步驟產生的索引,從不直接讀取規則檔案本身。這正是索引存在的意義:查詢應該只耗費一個小檔案,而不必讀取 repo 中的所有規則檔案。
預設流程
- 讀取 repo 根目錄的
.house/INDEX.md。請勿開啟.claude/rules/**、docs/handbook/**或plugins/house/modules/**/rules/**下的任何檔案來回答問題。索引包含每個導入規則的檔案、標題以及一行摘要,這本身就足以回答大多數查詢。 - 在索引中搜尋其檔案、標題或一行摘要與問題相符的條目。根據語義和關鍵字進行比對,而非精確字詞。關於提交訊息的問題,即使字詞不同,也應比對到關於提交的標題。
- 列出所有匹配的結果,而非僅第一個。一個主題可能合理存在於多個規則檔案中(例如,文件規則和工程規則都可能涉及同一問題),遺漏真實匹配會因省略而導致答案錯誤。
- 對於每個匹配,照實報告規則檔案路徑、標題以及索引的一行摘要。指出引用位置(
file#slug),讓用戶可以自行開啟真實規則以查看完整文字。 - 在此停止。不要根據記憶或本次工作階段先前讀取的內容,對規則本體進行改寫、擴充或重構。索引的一行摘要就是此技能給出的答案;連結的規則檔案才是完整規則所在。
例外處理
- repo 中沒有
.house/INDEX.md。 直接說明此 repo 尚未採用 house,或是使用的版本是在索引存在之前渲染的。不要根據訓練知識、CLAUDE.md 的快速瀏覽或其他 repo 的規則來猜測答案。在此停止。 - 索引中沒有任何內容與問題匹配。 直接說明 house 對此主題沒有相關規則。不要自己發明規則,也不要將鬆散相關的條目延伸來回答它並未涵蓋的問題。
- 索引看起來過時了。 列表中某個標題不再出現在其規則檔案中,或列表中某個規則檔案完全缺失。說明索引看起來過時了,指出過時的內容,並建議執行
/house-rules:sync。但仍需回報索引中最佳匹配的結果;索引過時是答案的一個注意事項,而非隱瞞答案的理由。 - 用戶想要完整的規則文字,而不只是知道規則在哪裡。 只有在這種情況下,才讀取索引指向的那一個規則檔案。絕對不要為了這件事而開啟整個規則集。在找到索引匹配之後,再讀取單一檔案,而不是在此之前。
禁止事項
- 不要為了回答查詢而載入所有規則檔案。那正是索引存在要避免的成本。
- 不要根據本次工作階段稍早讀取的規則檔案來回答問題。每次都要重新檢查索引;同步可能會改變索引在會話期間的內容。
- 不要從此技能內部編輯
.house/INDEX.md、.claude/rules/house/**或其他任何受管理的檔案。對受管理檔案的本地編輯屬於/house-rules:sync的拒絕流程,而非查詢。 - 當索引對所問問題沒有匹配時,不要捏造內部規範。
- 不要將此變成一個選單。直接回答被問到的問題;只有當問題本身廣泛到涵蓋多個候選模組時,才列出所有候選模組。