cot-lint：檢測代碼倉庫中的思維鏈泄露

智能體在編碼時，往往會在代碼周圍留下“會話記錄殘留物”。這些痕跡是思維鏈的泄露，表現爲對已關閉會話的引用、版本變更的敘述，或者是在文檔中討論設計決策的片段。只有當時在場的人才能理解這些內容，普通審閱者會感到困惑。cot-lint 專門用於檢測並修復這些泄露。

是什麼¶

cot-lint 是一個用於檢測代碼倉庫中思維鏈泄露的 Linter。它針對的是智能助手在文檔、註釋和 JSDoc 中留下的會話記錄殘留物。

• 所屬類別：admin-security
• 維護者：YuanyuanMa03
• 許可證：MIT
• 定位：零依賴的命令行工具，支持 Node.js 環境。

核心功能¶

1. 檢測思維鏈泄露：識別文檔和註釋中的思維鏈殘留，這些內容在脫離特定會話上下文後將變得不可理解。
2. 識別過時引用：定位死掉的引用，例如設計會話的引用（如 design §4.7）、棧或 PR 中的特定視角、以及版本標記（如 v1 refactor）。
3. 包含修復技能：插件內置了 cot-trim 修復技能，用於自動清理和修正發現的泄露。
4. 零依賴：無需安裝額外依賴，兼容 Node.js >= 20。

安裝與啓用¶

通過 DeepSeek Harness 的插件系統安裝：

dsh plugin add cot-lint

安裝後，cot-trim 技能會通過插件的技能提供者加載，可用於自動修復發現的泄露。

典型用法¶

cot-lint 支持多種命令行參數，以適應不同的掃描場景。

基礎掃描¶

掃描倉庫中的 Markdown 和散文文件：

npx cot-lint

機器可讀輸出¶

用於 CI 或 Agent 處理，輸出 JSON 格式：

npx cot-lint --json

擴展文件掃描¶

指定文件擴展名進行逐行掃描，例如 TypeScript 和 Python：

npx cot-lint --ext ts,py

深度掃描¶

包含隱藏目錄（如 .agents/）：

npx cot-lint --hidden

退出碼說明¶

• 0：倉庫檢查通過，無泄露。
• 1：發現泄露或需要修復的問題。
• 2：用法錯誤或參數錯誤。

適用場景與注意事項¶

• 適用場景：任何使用智能體輔助編碼的團隊，需要在代碼審查前過濾掉臨時的思維痕跡；或者需要保持文檔整潔的 CI 流程。
• 注意事項：
  • 插件以當前 dsh 進程的權限運行。
  • 需要確保本地環境 Node.js 版本 >= 20。
  • 插件默認豁免部分內容，不會誤報：
    • Issue 引用。
    • 標記爲 TODO / FIXME / XXX 的內容。
    • 引用 RFC 等外部標準的 § 引用。
    • 包含 cot-lint-ignore 註釋的行。

總結¶

cot-lint 將發現與修復（cot-trim）結合在一起。它通過嚴格的規則判斷哪些內容是必須保留的（如標準的 RFC 引用），哪些是必須刪除的思維鏈殘留。這有助於保持代碼庫的文檔整潔，使代碼對未來的維護者具有可讀性。

• 插件目錄頁
• GitHub 倉庫