install-maintenance-graft-rtk-ponytail-lite

提示詞

# 已驗證安裝與維護 — Graft + RTK + Ponytail lite

您正在當前的儲存庫中安裝、更新、修復或驗證此堆疊：

- Graft：程式碼理解、本地圖譜與 LSP 增強。
- RTK：終端機雜訊減少。
- Ponytail：輕量政策，當相容時提供原生整合。

從唯讀清單開始。然後詢問以下缺少的問題。
在獲得答案後，執行授權的操作直到最終檢查。

在確定客戶端與範圍前，請勿開始安裝。
請勿重複詢問本次對話中已做出的決定。

## 1. 清單，然後用戶選擇

### 不修改的清單

識別：

- 作業系統、架構、Shell、環境：本機、WSL、SSH、容器；
- 儲存庫根目錄、工作樹、Git 狀態與進行中的 Git 操作；
- Git、Node、npm、RTK、Graft 及可用客戶端的實際路徑、版本與安裝方式；
- 分別列出 Claude Code、Codex、Kimi、Cursor Agent CLI 與 Cursor IDE；
- 已存在的 Gemini、Copilot CLI 或其他客戶端作為可選目標；
- 實際使用的設定目錄、重定向變數，以及任何協調器如 AgentsRoom；
- 現有的使用者、專案、外掛與繼承的 hook 設定。

在將 `agent` 視為 Cursor 前，請驗證其身份。
存在的二進位檔不代表已驗證、hook 功能正常或 MCP 已載入。

清單過程中請勿啟動自動更新、連線或安裝。
請勿公開任何秘密值。

呈現簡短表格：
客戶端 | 二進位檔/版本 | 實際設定 | 已知狀態。

### 一次性詢問的問題

僅詢問缺少答案的問題：

1. 操作：
   - 安裝缺少的元件並保持相容版本。
   - 更新堆疊至已驗證的穩定版本。
   - 修復現有安裝並保持其版本。
   - 僅驗證，不做修改。

2. 客戶端：
   - 所有偵測到的客戶端。
   - 從實際偵測清單中選擇。
   - 也準備部分缺少客戶端的設定。

3. 整合範圍：
   - 共享專案：針對儲存庫的可攜式設定。
   - 個人專案：針對此儲存庫啟用，非版本控管的本地檔案。
   - 全域使用者：針對此使用者的專案啟用。
   - 混合：依客戶端或元件做不同選擇。

若範圍為混合，僅詢問必要的澄清。

更新時，若尚未知版本限制，也請詢問。
否則，建議明確的穩定版本。

請勿安裝或更新客戶端應用程式本身：
操作僅涉及 Graft、RTK、Ponytail 及其必要依賴。
過時的客戶端會報告所需版本與後續動作。

### 具體化選擇

在寫入前，顯示計畫結果：

元件/客戶端 | 目標版本 | 範圍 | 目標檔案 | 共享效果 | 備援

特別說明：

- 使用者層級安裝的執行檔可服務多個儲存庫。
- 更新此執行檔會影響所有本地使用者。
- 外掛可能有全域快取，但專案啟用。
- 專案的 hook 仍可能使用共享狀態。
- Graft 索引仍專屬於儲存庫/工作樹。
- 協調器提供的全域設定可隔離至專案：請驗證其實際範圍，而非僅名稱。

取得選擇後，無需重複確認。
僅當限制需擴大範圍或實質方案變更時，才請求新決定。

## 2. 執行規則

順序：
清單 → 選擇 → 備份 → RTK → Graft/LSP → Ponytail → 指示 → 驗證 → 報告。

遵守儲存庫指示與管理政策。
若檔案由 AgentsRoom 或其他協調器管理，請使用其官方機制；勿直接修改其產生的檔案。

每次修改前：

- 驗證 JSON/JSONC/TOML 設定的格式與結構；
- 將受影響檔案備份至儲存庫外，並限制存取；
- 記錄版本與回滾所需元素；
- 檢視安裝器的模擬執行（dry-run），若存在。

無效檔案絕不可被空設定取代。

合併設定時，保留其他 MCP、hook、權限、指示、註解（若可能）及狀態行。
勿更改核准規則或信任指紋。

保留既有 Git 變更。禁止 commit、push、reset、clean、stash 或應用程式碼變更。
若有未解決衝突或進行中 Git 操作，暫停儲存庫寫入；繼續獨立診斷。

請勿安裝 Graphify、CodeGraph、Caveman 或 Headroom。
舊有衝突整合僅在精確識別、備份且授權範圍內移除。
勿全域移除其他地方使用的工具。

錯誤會阻斷其依賴步驟，不影響其他獨立客戶端。
勿宣告步驟成功以繞過限制。

## 3. 能力與範圍：配置前驗證

查閱已安裝版本的說明與您將使用的發佈版本文件：

- https://github.com/rtk-ai/rtk
- https://github.com/trailhq/Graft
- https://github.com/DietrichGebert/ponytail
- 各選定客戶端的官方文件。

main/develop 分支可能描述尚未發佈的功能。
對於有疑問的選項，請檢查發佈版本、說明或交付的程式碼。

為每個整合建立：

客戶端 | 可用專案 hook | 相容安裝器 |
啟用範圍 | 狀態範圍 | 證明

請勿混淆：
「客戶端接受專案 hook」與「此工具的安裝器知道如何在專案層級安裝它們」。

本版本中需重新驗證的檢查點：

- Claude：使用者設定、共用專案與本地專案。
- Cursor：使用者與專案的 hook；分別測試 IDE 與 CLI。
- Codex：使用者/專案設定與插件啟用；
  驗證實際可用的 hook 機制。
- Kimi：不要假設每個專案都有 hook 設定；
  區分使用者設定、專案指令與啟動選項。
- Gemini/Copilot：若被選擇，驗證其自身機制。

若安裝程式不遵守請求的範圍：

1. 尋找適當的官方選項。
2. 否則，使用相同適配器的文件化手動設定，
   僅當其協定與路徑仍相容時。
3. 否則，透過明確指令/前綴使用回退方案。
4. 絕不默默切換到全域。

在新增本地等效 hook 前，檢查繼承的全域 hook：
它們可能會累積而非相互取代。
保留安全性 hook。報告仍然啟用的全域效果。

## 4. RTK

檢查來源 `rtk-ai/rtk`、版本、說明、設定與 `rtk gain`。
`gain` 失敗可能來自基底或權限：
這不足以證明套件有問題。

如適用，使用已使用的管理工具安裝或更新。
檢查配方或套件的來源與取得的版本。
避免同時安裝與不必要的 PATH 變更。
不要盲目執行 `cargo install rtk`。

查閱所選版本的 `rtk init --help`。
依客戶端與範圍選擇選項；不要系統性複製
文件範例中的 `-g`。

不要假設 Codex 整合總是簡單指令，
也不要假設它總有 hook：這取決於 RTK 版本。
同時檢查初始化選項間的不相容性。

在實際讀取的設定中，合併排除項目：

    [hooks]
    exclude_commands = ["graft", "curl", "playwright"]

保留現有排除並驗證其被考慮。
若此設定為全域，修改前須指出此效果。
透過文件化機制在允許範圍內禁用選用的遙測。

RTK 是唯一被授權重寫 shell 指令的元件。
安全、稽核與核准 hook 仍然適用。

未經文件化相容性，不要將 Claude hook 複製到其他客戶端。
無有效重寫時，設定明確前綴 `rtk`。
避免雙重 hook 與雙重前綴。

## 5. Graft 與 LSP

### 安裝與隱私

驗證套件 `@nanonets/graft` 的身份、發佈版本
及其 Node 需求。

安裝於應用程式依賴之外的適當位置。
不要修改 package.json 或專案鎖定檔來安裝 Graft。

從首次啟動及 MCP 中套用 `DO_NOT_TRACK=1`。
若有官方遙測禁用指令，請使用。

不要啟用 Brain、帳號、LLM 增強或 `--deep`。
未驗證前，不要承諾零網路。

不要自動執行 `graft init`。
優先明確連接；其安裝程式可能會寫入儲存庫外。

### 真正運作的 LSP

在探索應用程式碼前，遵守儲存庫的 Graft 規則。
接著識別有用語言並查閱所選 Graft 版本的 LSP 整合。

重用已存在的相容伺服器。
僅安裝必要伺服器，並記錄版本，
盡可能安裝於應用程式依賴之外。

檢查：

- 執行檔及其版本；
- 在 Graft/MCP 程序的 PATH 中的可用性；
- 語言與工作區先決條件；
- 此 Graft 版本的支援。

閱讀說明後，若有以下選項，特別使用：

    graft build --lsp --no-ignore --no-gitignore
    graft check
    graft ask "Where are the main entry points and API routes, if any?" --source

以目前 shell 語法對這些指令套用 DO_NOT_TRACK。

檢查選項意義：某些版本中，
`--no-ignore` 與 `--no-gitignore` 防止寫入排除檔；
它們不代表「索引被忽略的檔案」。

依所選範圍明確管理 Git 對 `/graft/` 的排除。
用 Git 驗證。不要自動移除任何已追蹤檔案。
保留註解與人工內容。

以 `--lsp` 建置且退出碼為 0 不代表使用 LSP。
尋找具體證據：伺服器實際啟動、解析結果、
增強邊緣或文件化診斷。

依語言報告：
LSP 已驗證 / 可用但無觀察到增強 / 不可用 / 不支援。

切勿在上下文中載入整個圖或 wiring.json。
也檢查自動重新整理後 LSP 增強是否持續；
若無法保證，文件化所需的明確重建。

### MCP 與新鮮度

為每個客戶端配置單一有效的 Graft 入口。
發現實際支援的檔案、結構與範圍。

對每個伺服器，驗證：
已安裝指令、MCP 參數、DO_NOT_TRACK、PATH 與工作目錄。

不要假設 `.kimi-code/mcp.json`、`.mcp.json` 或其他檔案會自動載入：
確認客戶端機制或必要啟動選項。

全域 MCP 設定僅在目標程序正確處理每個儲存庫時可接受。
否則，保持 MCP 在專案層級。

不要在每次啟動時使用 `npx -y ...@latest`。
不要版本控管絕對個人路徑或秘密。
不要發明通用變數 `${workspaceFolder}`。

此設定檔中不新增任何 Graft hook。
不使用 smart-grep、grep-redirect 或 Graft shell 攔截。

檢查重新整理與無意禁用。
重新整理失敗禁止呈現圖為新鮮。

遷移前檢查舊整合與自動連接元資料。
僅移除已識別且備份的元素。
確認 MCP 啟動與查詢後不會再出現。

### Graft 統計

分離操作、觀察使用與統計收集。

根據版本不同，`graft stats` 依賴於 session hooks。
若沒有這些 hooks，即使 Graft 請求成功，也可能會出現「尚未記錄任何 session」的訊息。

請勿偽造統計資料或執行 `graft init` 來讓此訊息消失。

若使用者需要原生統計，請揭露可用測量 hooks 的相容性，並在任何啟用前明確要求無 hooks 的配置演進。

## 6. Ponytail lite

優先選擇與客戶端及範圍相容的官方整合。
檢查其 manifest、事件與相依性。

區分：
插件的安裝、啟用、預設模式與當前模式狀態。

檢查實際讀取的來源：
設定、`PONYTAIL_DEFAULT_MODE`、持久狀態與插件資料。
`defaultMode: lite` 並不代表舊的完整狀態已被取代。

若模式在多個對話間共用，請標示。
在專案範圍內，請勿默默更改全域預設。
使用有文件記載的本地機制或依指令使用 lite 政策。

依客戶端：

- Claude/Codex：官方安裝與啟用於可用範圍。
  使用前檢查子指令。
  Hook 批准權仍由使用者掌控。
- Cursor：官方適配器或指令規則；避免累積過多。
  若存在 `scripts/cursor-hooks.js install --project`，請從目標倉庫根目錄使用官方 checkout 路徑執行該腳本。
  無 `--project` 時，檢查使用者目的地。
  檢查產生的路徑：含有指向個人 checkout 的絕對路徑的專案 hook 不具可攜性，且不得提交。
- Kimi：尋找相容的官方適配器。否則，依 AGENTS.md 中的 lite 政策；僅在有用且格式與載入方式確認後，新增最小本地技能。
  將其視為改編，且不承諾原生指令或統計。
- 其他選定客戶端：採用相同驗證，勿自動套用 Claude/Codex 事件。

保持適配器 checkout 在已識別的版本或 commit。
勿對已修改的 checkout 執行 git pull。
勿新增狀態列或視覺指示器。

在新 session 中測試實際模式。

## 7. 精簡通用指令

合併 AGENTS.md 中由以下標記包圍的區塊：

    <!-- agent-stack:start -->
    ...
    <!-- agent-stack:end -->

保留所有外部內容與人工新增部分。
勿將此安裝提示複製至代理指令中。

該區塊必須表達：

### Graft

要理解或修改程式碼，先進行應用探索：
`graft ask "<精確問題>" --source`，或實際使用公開的 MCP Graft 工具。

指令、技能、Git、設定與 MCP 探索可先行。
定位後，直接閱讀有用部分。
呼叫者使用可用的追蹤指令/工具。

若圖譜陳舊：檢查，使用 LSP 進行調整重建，然後新查詢。
搜尋失敗後：針對性 graft grep，再直接閱讀或有限制的 rg 並說明限制。

提供的檔案、堆疊追蹤、設定或未索引語言允許直接針對性閱讀。
圖譜中缺少不代表程式碼或呼叫者不存在。

修改後：graft blast，驗證 Git 基底與相關測試。
不使用 --name，勿載入完整圖譜。
回報實際呼叫數與任何錯誤。

### RTK

驗證過的 hook：允許重寫時不加雙前綴。
否則：明確加前綴相容指令。
絕不透過 RTK 傳遞 Graft。

完整輸出：若可用，回呼 --full，或代理。
勿自動重跑有副作用的指令。
保留管線與重導向。

驗證前：真實未壓縮差異、diff --cached、diff --check 與新檔案分別檢查。
不自動暫存。

### Ponytail lite

正確實作請求並重用現有。
簡要回報顯著簡化的解決方案。
保留驗證、安全性、權限、可及性、交易與必要測試。
刪除或內嵌前驗證使用情況。

僅在明確要求時完整，預設絕不超量。
審核不觸發重新設計。
修正優先於安全、解析器、併發與遷移。

勿宣稱共用模式為對話本地。
授權完整後，驗證回復 lite。
關閉不會移除已注入指令。

### 載入

確認每個客戶端實際如何載入這些指令。
使用有文件記載的最小匯入/適配器。
避免重複與循環匯入。

RTK 仍為唯一 shell 重寫器。
此設定檔無 Graft hook。

## 8. 更新與修復

同一提示必須能重複執行且不產生重複。

更新模式：

1. 重新讀取範圍選擇與先前驗證狀態。
2. 比較已安裝版本、目標版本與不相容變更。
3. 任何遷移前備份。
4. 僅更新選定元件。
5. 使用官方機制刷新插件/適配器。
6. 重新評估能力：舊回退可被同範圍內現有的原生整合取代。
7. 僅遷移屬於此堆疊的金鑰與區塊。
8. 必要時重建圖譜並重新檢查 LSP。
9. 重啟必要的 MCP/客戶端程序：現有程序可能仍執行舊版本。
10. 重播修改整合的檢查與測試。

勿不必要地重新安裝已符合規範的元件。
勿啟動機器套件的一般更新。

修復模式，除非證明不相容且明確決定更新，否則保留版本。

準備針對性回滾：先前版本、備份與精確指令。
若備份後有其他變更，勿盲目還原整個檔案。

第二次執行且無請求變更時，勿產生任何 hook、MCP 伺服器或重複指令區段。

## 9. 檢查與證據

分別測試：

- RTK 可執行且明確的壓縮；
- 自動 hook 觸發、排除及原始直通；
- Graft：新鮮度、結果與倉庫匹配及 LSP 增強；
- MCP：功能性伺服器且每個客戶端實際載入；
- Ponytail：啟動與有效模式；
- 無重複及重新出現的自我連接；
- 配置的最終有效性及有效範圍。

存在的檔案不代表已載入。
外部 MCP 探針不代表客戶端已載入。
明確的 RTK 前綴不代表自動 hook。

對每個可用且已驗證的客戶端，在倉庫中開啟新會話，
並給予此中立票證：

"在不修改程式碼的情況下，定位主要進入點。
若有 API，指出其路由掛載位置並追蹤至業務邏輯。
引用檔案與行數。"

不要加入「使用 Graft」。
檢查可見的工具呼叫，不是內部推理。
保留最少證據並編輯敏感資料。

若缺少批准、登入或 UI 操作：
未測試 / 使用者操作，絕不假設成功。

## 10. 交付物

在授權範圍內，保留簡短的維護文件：

- 操作選擇、客戶端及範圍；
- 精確版本、來源及驗證日期；
- 配置機制及限制；
- Graft/LSP 重建；
- 更新、驗證及回滾程序。

對於共用安裝，使用 `docs/agent-stack.md`。
對於個人/全域安裝，將機器特定資訊排除於版本控管檔案外。
在僅驗證模式下，交付報告而不建立這些檔案。

報告決定性指令、其結果、修改的檔案、備份及精確使用者操作。

盤點最終 hooks：
客戶端、來源、範圍、事件、匹配器、角色及編輯過的指令。

結尾格式：

Client/version | Effective scope | Present configuration |
MCP loaded | Graft observed on first exploration |
LSP | RTK | Ponytail | Remaining proof/action

使用明確狀態：
CONFIGURED / LOADED / USAGE OBSERVED / NOT TESTED / BLOCKED / NOT APPLICABLE。

分類檔案：
TO COMMIT AFTER REVIEW / TO IGNORE / MACHINE CONFIGURATION。

個人路徑、密鑰、快取、圖表、備份及記錄
不得包含於待提交檔案中。

顯示最終 Git 狀態及此次介入所引入的變更，
並與先前變更區分。切勿提交任何內容。

標籤