Communitygithub.com

Navdeepgambhir9023/nav

跨目標組合報告,讀取並回報所有目標的優先順序、風險標記與阻礙因素,僅供檢視,不做任何修改。

nav 是什麼?

這是一個專門用於生成跨目標組合報告的 AI 技能,可讀取 `.loop/registry.json` 中所有目標(不限於 `ACTIVE`)的狀態、優先權分數、風險標記與阻礙因素。它實作了 `skills/portfolio/manager.md` 定義的管理者視角,支援 `/portfolio`、"how are we doing across goals" 等觸發詞。此技能為唯讀操作,嚴格禁止修改任何目標資料夾或 registry 檔案,當 `impact`、`alignment` 或 `effort` 缺失時,會報告「unscored」而非憑空猜測分數。它只讀取 registry,不依賴 `research.md`、`contract.json` 或其他目標計畫,因此可安全地在任何時刻調用,不會干擾其他技能流程。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Navdeepgambhir9023/nav/tree/HEAD/skills/portfolio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

/portfolio — 跨目標組合報告

獨立、按需生成的報告。不隨 /goal、/plan、/loop 或 /verify 執行,也不會阻擋或限制上述任一流程。請參閱 skills/portfolio/manager.md 以瞭解本技能所實作的視角定義。

流程

  1. 完整讀取 .loop/registry.json — 每個目標、每個狀態,不限於 ACTIVE。
  2. 為每個目標計算優先權分數(當所需資料存在時): impact × confidence × alignment ÷ effort(公式來自 ROADMAP.md 的資源分配章節)。confidence 取自該目標本身的 classification_confidence。若條目中缺少 impact、alignment 或 effort,則將該目標報告為「priority: unscored (missing <欄位>)」,而非捏造數字。
  3. 標記風險 — 狀態為 BLOCKED 或 ESCALATED 的目標,以及相對於該目標自身歷史而言、在 registry 中無活動的時間異常長的目標(停滯)。
  4. 標記阻礙因素 — 對於任何具有非空 depends_on 的目標,檢查其依賴項目是否仍處於開放狀態;若是,則將該依賴項命名為阻礙一個原本已就緒目標的阻塞者。
  5. 生成報告,按優先權排序(未評分目標排在最後,依 registry 順序):
<goal-id>  priority=<score 或 "unscored">  status=<status>
  risk: <none | BLOCKED | ESCALATED | stalled (<duration>)>
  blocked by: <dependency goal-id, 或 "none">

此技能不寫入任何檔案。報告即為輸出。

與其他技能的關係

/portfolio 讀取的 .loop/registry.json 與 /goal 在註冊(步驟 22)時寫入的檔案相同,/loop//verify 也隨目標進度更新該檔案。除此之外沒有其他耦合 — 它不讀取 research.md、contract.json 或任何目標的計畫。

相關技能