用途
gitnexus-plan 用于为一项工程任务产出“可直接实施”的计划。它把三类信息分层使用:GitNexus 作为导航层(该看哪里),语句级 PDG 作为约束层(什么门控并驱动行为),而对当前源码的定向阅读作为验证层(现在实际是什么样)。最终输出是一份计划文档,外加一份紧凑、机器可读的实现上下文包,供后续实现代理(gitnexus-work 或任意执行器)消费,从而不必重复调研。
该技能只做规划,从不实现。运行期间不得修改生产代码、测试或配置。它唯一写入的仓库文件是计划文档(仓库外的工作账本也可以)。唯一允许的其他状态变更是通过 analyze --index-only 刷新索引,且只写入 .gitnexus 索引存储;不得构建分析器 dist/ 输出,也不得改动源码、测试、配置或评估数据。
主要能力
- 按任务类别确定姿态(深度、计划形式、工具调用预算、新鲜度),类别包括:局部缺陷修复、功能、重构/共享 API 变更、性能、安全、依赖升级/迁移、并发/事务、测试改进/文档、架构变更/探索。
- 通过 GitNexus 图导航阶梯定位概念、执行流、模块与相关测试,并对候选主符号做 360° 上下文分析、影响面分析、路径追踪。
- 对变更最核心的 1–3 个函数构建有界的语句级 PDG 上下文切片,支持安全与性能模式。
- 对计划将引用的源码范围做定向验证,核对测试、构建/测试命令与仓库约定。
- 生成计划文档与实现上下文包,并附带强制性的证据溯源信息(全局脏摘要与引用路径清单)。
- 支持 Deepen 模式,对已有计划文档进行就地强化。
使用方式
基本调用:
/gitnexus-plan <task description>
带参数覆盖:
/gitnexus-plan impact_depth:3 depth:deep <task description>
在交互式会话中,若调用未携带明确的深度信号(没有 depth:、form: 或 freshness: 参数,且不是 Deepen 模式),会在第一阶段前询问一次深度:Quick(depth:narrow form:compact freshness:accept)、Standard(按类别姿态)、Deep(depth:deep form:full freshness:strict)。显式参数优先并跳过该提问。无头运行从不询问,直接套用类别姿态。
Deepen 模式:
/gitnexus-plan deepen <plan-path>
用于就地强化已有计划,而不是新建计划。
适用场景
需要为代码变更制定深入、可实施工程计划的场景,尤其是重构、共享 API 变更、性能、安全、并发/事务、架构变更等需要影响面与依赖分析的任务。对于局部缺陷修复或测试/文档改进,通常只需最窄的图操作甚至不做影响面或 PDG 分析。
限制
- 只规划,不实现;不得修改生产代码、测试或配置。
- 唯一写入的仓库文件是计划文档;唯一允许的其他状态变更是 analyze --index-only 索引刷新。
- 不得构建分析器 dist/ 输出,不得改动源码、测试、配置或评估数据。
- 分析器溯源若陈旧,只作为“源码加权限制”披露,绝不在规划运行中修复。
- 禁止编造符号、文件名、测试名、工具结果或 PDG 边;未知项归入假设与开放问题。
- 禁止范围蔓延:任务未要求的相邻重构归入计划 §12 作为显式延后的后续项。
- 计划文档只能通过指定辅助脚本写入,不得直接写目标路径或回退到外部输出路径。
- 每个规划会话在 Phase 1 最多一次 --index-only 刷新,Phase 3 最多一次 --pdg 升级。
- 工具调用预算按类别限定;预算耗尽仍有未决问题时,记录到 §12 而非继续深挖。
- 若 GitNexus 完全不可用,切换到 Fallback 模式。
暂未提供
资料未提供该技能的收费、价格、平台支持范围、具体效果指标或安装步骤等事实。