CopperSunDev

BrassCoders 每次掃描後都會寫入 .brass/ai_instructions.yaml — 純 YAML，無專有編碼，無需外掛程式。Claude Code 會自動在專案目錄中讀取它。Cursor 和 Continue 使用者可以將它作為上下文檔案引用。三種情況下的格式都相同：依嚴重程度排序的發現，每一項都包含檔案路徑、行號和修復說明。

一次掃描、一個檔案、三種編輯器。

什麼是 YAML-First 模式

BrassCoders 會掃描您的 Python 程式碼庫，執行 12 種靜態分析掃描器，並將依嚴重程度排序的發現寫入 .brass/ai_instructions.yaml；該檔案為純文字，沒有任何編碼或專有結構，因此任何能讀取本地檔案的 AI 助理都可以將它作為上下文使用。

模式是：開啟編輯器前先掃描，將編輯器指向該檔案，然後對掃描器發現的問題進行分類。AI 助理會讀取嚴重程度順序、行號和修復說明 — 從確認而非發現開始。這在所有編輯器之間都能運作，因為格式不依賴任何編輯器專屬功能。它只是一個檔案。編輯器讀取檔案。

Claude Code：自動專案上下文

BrassCoders 會將 .brass/ai_instructions.yaml 寫入專案目錄，而 Claude Code 會自動讀取專案目錄中的檔案作為上下文；無需額外設定即可將發現呈現在模型面前。

執行 brasscoders --offline scan /path/to/project，然後在同一目錄中開啟 Claude Code。.brass/ai_instructions.yaml 檔案會作為會話的專案上下文提供。請 Claude Code 處理或分類這些發現，它會讀取檔案，優先識別關鍵嚴重程度的項目，並依嚴重程度順序處理。

發現檔案會在會話之間持續存在。下次您在同一目錄中開啟 Claude Code 時，檔案仍然存在，除非您重新掃描並修復已標記的問題。與聊天提示不同，關閉編輯器時發現不會重置。

Cursor：@file 引用

Cursor 支援 @file 引用，可將本地檔案的內容加入 AI 聊天會話的上下文；指向 .brass/ai_instructions.yaml 可為 Cursor AI 提供與 Claude Code 自動讀取相同的依嚴重程度排序的發現佇列。

在 Cursor 聊天會話中，輸入 @file .brass/ai_instructions.yaml 即可將發現作為上下文包含。Cursor AI 會將檔案讀取為結構化的發現清單，能優先處理最高嚴重程度的發現，並帶有可導航至標記位置的行號。這與 Claude Code 工作流程的模式相同 — 差異在於您手動加入上下文引用，而非編輯器自動取得。

實用提示：在修復發現後開啟新的 Cursor 會話前，請重新執行 brasscoders --offline scan。.brass 檔案不會自動更新。已修復的發現會保留在檔案中，直到重新執行掃描並覆寫。

Continue：聊天中的上下文

Continue 在其聊天面板中支援 @file 引用，可讓您將任何本地檔案作為問題的上下文包含；.brass/ai_instructions.yaml 的運作方式相同 — 在 Continue 聊天中輸入 @file 並導航至發現檔案。

對於 Continue 是 VS Code 中共享 AI 助理的團隊而言，這使得 BrassCoders 的發現可在會話中共享，而無需在每台機器上重新執行掃描。一個人執行 brasscoders --offline scan，將 .brass/ai_instructions.yaml 檔案提交至分支，團隊即可在他們的 Continue 會話中引用它。對於在同一分支上工作的每個人，發現都是一致的。

請查閱 Continue 的文件，了解您版本中目前的 @file 語法，因為上下文提供者行為已在各版本中演進。

三種編輯器的一致性

無論哪種編輯器使用，結構都相同：嚴重程度排序、行錨點、修復方向。BrassCoders 在寫入檔案前會將關鍵發現排在高嚴重程度發現之上，再排在中嚴重程度發現之上。每個讀取檔案的編輯器都會繼承此優先順序。

行號欄位在三種編輯器中的運作方式相同：AI 助理讀取標記的行號，從該位置提取原始碼上下文，並根據實際程式碼判斷發現是否真實。檔案路徑欄位的運作方式也相同：它是從專案根目錄的相對路徑，任何在專案目錄中運作的工具都能讀取。

修復欄位在三種編輯器中都相同：修復方向在任何工具讀取檔案前就已寫入，依據掃描器匹配的模式。AI 助理讀取修復說明、讀取程式碼，然後產生修復或將發現駁回為誤報。

一次掃描。一個檔案。任何能讀取檔案的編輯器。

pip install brasscoders
brasscoders --offline scan /path/to/your/project

進入全螢幕模式 退出全螢幕模式