Communitygithub.com

Navdeepgambhir9023/nav

跨目标组合的只读报告:优先级、风险标记和阻塞项,覆盖 `.loop/registry.json` 中所有目标,而不仅仅是当前活跃目标。

nav 是什么?

这是一个按需生成的跨目标组合报告技能,实现了 `skills/portfolio/manager.md` 中定义的“经理视角”。它的核心功能是读取 `.loop/registry.json` 文件中的全部目标(而不仅仅是活跃目标),并使用 `impact × confidence × alignment ÷ effort` 公式(来源自 ROADMAP.md 的资源分配部分)计算每个目标的优先级。对于缺失必要字段的目标,技能会报告为“未评分(缺少 <字段>)”,而不会虚构数值。它还检测风险(BLOCKED、ESCALATED 或基于历史活动窗口的停滞状态)和阻塞项(通过检查 `depends_on` 字段中的依赖是否仍然开放)。报告按优先级排序输出,未评分的目标排在最后。此技能由 `/portfolio` 命令触发,完全只读,不会修改任何文件或目标。它适用于 Claude Code、Cursor 等 AI 代理平台,为用户提供全面的目标组合健康状况概览。

兼容平台~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,则将该目标报告为“优先级:未评分(缺少 <字段>)”,而不是编造一个数字。
  3. 标记风险 —— 状态为 BLOCKED 或 ESCALATED 的目标,以及在相对于该目标自身历史记录而言异常长的窗口内没有注册表活动的目标(停滞)。
  4. 标记阻塞项 —— 对于任何拥有非空 depends_on 字段的目标,检查其依赖项是否仍然开放;如果是,则将该依赖项命名为阻止一个其他方面已准备就绪的目标的阻塞项。
  5. 报告,按优先级排序(未评分的目标排在最后,按注册表顺序排列):
<goal-id>  priority=<分数或“未评分”>  status=<状态>
  risk: <无 | BLOCKED | ESCALATED | 停滞(<持续时间>)>
  blocked by: <依赖目标ID,或“无”>

此技能不写入任何文件。报告就是输出。

与其他技能的关系

/portfolio 读取 .loop/registry.json,与 /goal(在“注册”步骤 22 中写入)以及 /loop//verify(在目标进展时更新)写入的是同一个文件。它没有其他耦合——它不读取 research.md、contract.json 或任何目标的计划。

相关技能