用途:把 GitHub 仓库或由多个仓库组成的产品,转化为可据以行动的产品路线图。核心是把散落在代码库与 issues/PR 中的上下文收拢成图,让方向由图谱推导,而不是罗列工单。
主要能力:流程为——确定范围并引导图 → 建模当前产品(vartamana 现状底座)→ 采集 milestones、issues、PR → 按作者权重排序 → 写入图(shabda 录入)→ 组装区分方向 → 渲染(图 + Markdown + HTML)→ 校验。技能组合 iskronify(理解代码库)、intake(录入纪律)、assembly(区分方向),自身增加 GitHub 适配器与路线图渲染。支持单仓库或多仓库(组织或指定仓库集合),跨仓库产品只保留一个焦点环,每个仓库作为顶层子系统,跨仓库流程作为主干。
使用方式:需 gh CLI 已认证(gh auth status),目标仓库可访问;每个仓库需本地浅克隆(git clone --depth 1,私有仓库用 gh repo clone);需要 iskron_* 工具。使用 gh api repos/<owner>/<repo>/milestones?state=open 先取里程碑,再 gh issue list 与 gh pr list 采集数据。每次写入前先定位已有节点,只新增真正新内容,已交付项标记关闭。引用规范:真实 issue/PR 编号用 #N,多仓库须带仓库前缀(如 backend#1)。
适用场景:维护者需要将代码现状与积压工作串成方向,识别结构化风险(如无产出的能力、接力缺口、无角色的动作),并在多仓库间找出跨仓库断链。
限制:不得凭空编造积压项,空或稀疏的积压如实说明;建模当前产品必须引用真实代码基元,无法引用则降级或丢弃;不得把功能请求当作已实现能力;作者身份须由 API 确认而非推断;发布前需通过 references/self-checks.md 完整校验。adhimoksha 仅在图所有者本人明示时成立。