Context Cartographer
建立一個小型文件系統，讓未來的代理只載入所需的上下文。
範圍邊界
- 將此技能用於文件系統的設置、審計、遷移、清理、重組或所有權不明確的情境。
- 當目標擁有者檔案已知時，請勿在例行編輯中使用此技能。
- 當
AGENTS.md、CLAUDE.md、Cursor 規則、docs/architecture.md或docs/code_rules.md已要求自動持久維護時，請勿使用此技能。請直接套用那些本地指令。 - 當使用者明確呼叫
context-cartographer時，務必使用此技能。
核心規則
- 在讀取專案檔案前，先解析專案根目錄並盤點真實路徑。請勿從目前目錄或其他專案猜測路徑。
- 重複使用任務期間已讀取的檔案。僅重新讀取已變更的檔案、截斷的輸出或特定的未讀取範圍。
- 保持根代理指令檔案簡短。將持久的詳細主題放入
docs/下的擁有者檔案中。 - 使用
AGENTS.md給 Codex，CLAUDE.md給 Claude Code，.cursor/rules/context-cartographer.mdc給 Cursor，或為選定的多代理目標使用精簡的適配器。 - 在提出變更前，先以唯讀方式檢查。
- 保留現有的專案特定規則，並進行精確編輯。
- 未經核准，不得覆寫、移動、合併或刪除現有的指令或文件檔案。
- 僅建立在專案證據支援且當前需要的檔案。
- 將未知事實標記為
TODO: clarify；切勿憑空捏造專案事實。 - 預設情況下，將專案記憶文件保留為本機檔案，並將其加入儲存庫忽略檔案中，除非使用者明確要求追蹤或發佈。
- 編輯後驗證連結、擁有者路由、忽略規則和過時參考。
必要決策
在創建或取代根代理指令之前，請先解決以下問題：
- 代理目標；
- 程式碼規則模式：使用
docs/code_rules.md或不使用； - 文件維護模式：
自動持久維護或僅按請求維護； - 對現有文件的處理：保持原樣、僅審計、核准後遷移，或讓代理決定；
- 專案記憶文件是僅保留在本機還是受追蹤。
請勿推斷程式碼規則模式或文件維護模式。當遺漏超過兩個決策時，請使用配套問卷。
生成的根指令必須讓例行維護獨立於此技能：
- 在
自動持久維護下，每當完成的工作變更了持久行為、架構、設置、部署、暫存、測試資料、存取、匯入/匯出、公開 URL、操作者工作流程、資料模型、公開介面、代理工作流程或文件擁有權時，請在同一任務中更新對應的擁有者文件。 - 在
僅按請求維護下，僅在明確要求時更新文件，並標記可能過時的文件。 - 說明例行維護直接使用根指令和現有擁有者文件，無需呼叫
context-cartographer。 - 如果沒有適合的現有擁有者檔案，請呼叫此技能並遵循缺少擁有者協定。在自動持久維護下，分類並自動建立最小且合理的擁有者，無需僅為了建立 Markdown 檔案而徵求許可。
- 此後僅在設置、審計、遷移、清理、重組、明確使用或真正不明確的所有權時，才呼叫此技能。
參考路由
- 對於初次設置，務必讀取
references/setup-workflow.md；它會引導到其他必要的參考。 - 對於審計、遷移、清理、重組或所有權不明確，務必讀取
references/existing-docs-workflow.md；它會引導到其他必要的參考。 - 在選擇檔案或所有權之前，先讀取
references/doc-map.md。 - 在創建根指令或
docs/*.md之前，先讀取references/file-templates.md。 - 在審計現有儲存庫之前，先讀取
references/audit-checklist.md。 - 在分割、合併、刪除或重新命名文件之前，先讀取
references/cleanup-rules.md。 - 在創建問卷 JSON 之前，先讀取
references/question_schema.md。 - 僅在調整問卷流程時，才讀取
references/questionnaire_usage_examples.md。
工作流程
- 使用
rg --files解析專案根目錄並盤點路徑。 - 分類專案概況、選定的代理目標、現有文件、所有權、程式碼規則模式和維護模式。
- 對於現有文件，在編輯前顯示目前檔案、主題擁有者以及計畫的建立/更新/刪除動作的簡潔地圖。
- 在使用者授權範圍內，套用最小且合理的文件系統變更。
- 驗證連結、過時檔案名稱、擁有者覆蓋率、僅本機忽略規則以及獨立的例行維護指令。
對於新系統，請遵循 references/setup-workflow.md。
對於審計、清理、遷移、重組或所有權不明確，請遵循 references/existing-docs-workflow.md。
問卷
對於涉及兩個以上遺漏決策的廣泛設置工作：
- 根據
references/question_schema.md建立.project-questionnaire/questions.json。 - 將
language設定為使用者或專案語言。 - 使用
python3 <this-skill>/scripts/questionnaire_server.py --input .project-questionnaire/questions.json --validate-only進行驗證。 - 在
127.0.0.1上使用自動埠執行伺服器。 - 在使用者儲存並表示完成後，在繼續之前讀取兩個答案檔案。
程式碼規則模式和文件維護模式必須是必要的選擇，不能有預設值或推薦選項。
更新檢查
每天最多執行一次 python3 <this-skill>/scripts/check_update.py --json。在安裝可用的更新前先詢問。當發佈已安裝使用者應接收的變更時，請更新 VERSION。
退出標準
報告：
- 建立或變更的檔案；
- 已檢查的連結、路由和過時參考；
- 已檢查的僅本機忽略政策；
- 已檢查的獨立自動維護路由；
- 已執行的驗證以及任何未執行的檢查。