AI Skills
indexion-agent-orient

indexion-agent-orient

生成並使用編輯前的結構摘要，讓程式碼代理在實作前了解可能的負責人、消費者介面及不安全的編輯位置。

1星標
2分支
更新於 2026/7/11
獲取技能源代碼

相關技能

homelab-vlan-segmentation24萬backend-code-review15萬ecommerce-image-workflow9.2萬
SKILL.md
唯讀
名稱
indexion-agent-orient
描述

生成並使用編輯前的結構摘要，讓程式碼代理在實作前了解可能的負責人、消費者介面及不安全的編輯位置。

Agent Orientation Workflow

在開始實作不熟悉或模糊的程式碼庫部分之前，請使用此技能。

為什麼

程式碼代理經常錨定在使用者提示中的路徑或名詞，並在了解儲存庫的擁有權結構之前就開始編輯。indexion agent orient 會在選定的程式碼庫中建立增量導向地圖，然後呈現一份簡短、有證據支持的摘要，可以貼入 AGENTS.md、CLAUDE.md、Claude 斜線命令、Codex 技能或子代理提示中。

呈現的 --limit 僅是顯示限制。擁有者推斷必須來自完整的預建地圖，包括程式碼結構、套件 README 以及由 wiki pages update、wiki pages ingest 和 plan reconcile 維護來源的 wiki 頁面。

擁有者設定檔使用套件文件和擁有者專屬的 wiki 頁面。具有多個來源根目錄的廣泛 wiki 頁面可作為有用的背景資訊，但不應視為每個引用的套件都擁有該任務的證據。

流程

  1. 確認已安裝的 CLI 具有此工作流程：

    indexion agent orient --help

    如果缺少此命令，請先更新或重建 indexion。PATH 中有較舊的 indexion 二進位檔不足以使用此技能。

  2. 產生摘要：

    indexion agent orient --task-file task.md --output=.indexion/cache/agent/orient.md .

    第一次執行會寫入 .indexion/cache/agent/orient-map.json。後續執行只會重新整理已變更的檔案和受影響的擁有者設定檔。當您有意查詢已儲存的地圖而不重新整理時，請使用 --no-update。當零知識代理需要從最新的預建地圖立即獲得擁有者猜測時，應使用此模式。

    對於簡短任務：

    indexion agent orient --task "add a name/content drift audit" .

    如果使用者任務的語言或措辭未出現在儲存庫的識別碼和 README 文章中，請在筆記中保留原始任務，並將簡短的程式碼庫詞彙註解傳遞給 --task。該註解應描述目標，而非懷疑的擁有者。例如，說「偵測名稱與實作內容之間的漂移」，而不是命名您尚未確認的套件。

    不要將支援基礎設施的限制放入擁有者推斷的 --task 註解中。將原始請求、所需工具和實作限制保留在您的筆記或子代理提示中。註解僅是用於查詢預建地圖的目標詞彙，例如：

    indexion agent orient --no-update --task "name/content drift scoring and remediation planning" .

  3. 在編輯前閱讀以下章節：

    • Likely Implementation Owners：應擁有領域行為的核心套件。
      除非後續證據矛盾，否則將第一個條目視為初始擁有者假設。
    • Knowledge Sources：與任務匹配的版本說明、wiki 頁面、README 或其他文件。將這些作為上下文；不要將僅有文件的路徑視為實作領域行為的位置。
    • Consumer Surfaces：可能呼叫核心的 CLI、技能、文件或適配器。
    • Do Not Implement Here：應避免作為領域實作目標的檔案。
    • Required Preflight：代理在修補前應讀取的檔案。
    • Orientation Map：確認顯示截斷前使用的總檔案/擁有者/文件語料庫。

  4. 使用聚焦工具確認擁有者：

    indexion doc graph --format=text <likely-owner>
indexion grep --semantic=name:<term> .
indexion search "<task concept>" .

    使用摘要和使用者任務中的區別術語，而不僅是廣泛的基礎設施詞彙。如果搜尋結果偏向支援系統而非可能的擁有者，請在更改擁有者之前，使用實際定義任務的名稱/內容、漂移、分歧或領域特定術語來優化查詢。

  5. 門控實作：

    • 如果預期的編輯路徑出現在 Do Not Implement Here 中，請停止並解釋衝突。
    • 如果預期的擁有者未出現在 Likely Implementation Owners 中，請使用 doc graph、grep、search 或 explore 收集更多證據。
    • 除非摘要和後續證據顯示 CLI 擁有該行為，否則保持 CLI 程式碼精簡。

  6. 用於零知識委派：

    僅將任務和產生的導向摘要提供給子代理，然後在分配實作工作前對其進行測驗。它應立即說出核心實作擁有者、一個知識來源、一個不安全的編輯位置和一個預先檢查的證據路徑。通過該測驗表示預建地圖已傳遞正確的擁有權假設。

外部代理對應

  • Claude Code：將穩定的指導儲存在 CLAUDE.md 中，專案命令儲存在 .claude/commands/ 中，專案子代理儲存在 .claude/agents/ 中。
  • Codex：將穩定的指導儲存在 AGENTS.md 或技能中，並將導向摘要貼入委派任務的上下文中。
  • 多代理工作流程：使用摘要作為結構化的交接負載，以便每個隔離的代理從相同的儲存庫特定假設開始。