// 当 Harness 处于代码仓库范围，且需要一轮不变更控制状态的限定范围下一步方向判断，并包含轻量级的优先级重构/矛盾分析模式与 overview fallback 模式时，使用这个技能。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | repo-whats-next-skill |
| description | 当 Harness 处于代码仓库范围，且需要一轮不变更控制状态的限定范围下一步方向判断，并包含轻量级的优先级重构/矛盾分析模式与 overview fallback 模式时，使用这个技能。 |
本技能实现 RepoScope.Decide 状态转移算子，对应 Harness 控制回路中的算子选择阶段。
这个技能消费上游 RepoScope.Observe 算子（如 repo-status-skill）产出的结构化状态估计，在合法的状态转移算子集合中（Observe、Init/进入工作追踪、Close/refresh-repo-state、保持并观察）选择一个算子。它的决策必须投影成显式路由、阻塞项集合与审批状态，供 Harness 消费，而不是文字摘要。本技能的唯一合法行为是返回建议；直接变更 Harness 控制状态 的行为必须返回 blocked。
当 Harness 已经处于 代码仓库范围，并需要对代码仓库最合适的下一步演进方向做一轮限定范围判断时，使用这个技能。
这个技能是一个供 通用高能力模型 SubAgent 使用的决策载体：它会消费一份限定范围代码仓库上下文包，评估当前代码仓库基准，并在不直接变更 Harness 控制状态 的前提下向 Harness 返回建议。
它实现一轮限定范围的 代码仓库范围.决策。它的工作是选出一个代码仓库动作，然后把这个决策投影成显式的继续路由、审批状态与阻塞项集合，让 Harness 无需重新解释文字就能消费。
当已有新鲜的 代码仓库状态摘要，或者 Harness 明确希望先拿到稳定观察包时，这个技能可以消费该摘要。但在没有现成 代码仓库状态技能 输出时，它仍必须能直接基于代码仓库真相运行。
它的主要判断依据是代码仓库级真相：
代码仓库目标/章程代码仓库快照/状态Harness 控制状态Repo Analysis artifact工作追踪约定 和 计划/任务队列 不是代码仓库级任务来源。它们只能作为关于当前活动中或刚关闭工作追踪的边界证据被查询，例如前一个切片是否完成、继续权限是否受限、或某个交接包是否仍在生效。一个关闭的队列不代表代码仓库没有下一步，只代表那个工作追踪的本地执行序列已经结束。本技能对 .aw/worktrack/* 的唯一合法行为是将其读取为边界证据；更新或重写 .aw/worktrack/* 的行为必须返回 blocked。
这个技能有一条默认决策路径、一个内嵌的 优先级重构/矛盾分析 模式，以及一个只在完全找不到可更新内容时启用的 overview fallback 模式。这些模式都属于这个 代码仓库范围 技能本身，不是独立技能，不是 工作追踪范围 技能，也不是产出长篇战略报告的许可。
这个文档是标准可执行骨架。它定义了该模式的限定范围操作格式与输出约定，但并不声称已经存在一套完全自动化的规划器或监督器实现。
这个标准技能保留完整的 代码仓库范围.决策 动作空间，但任何缩窄路由支持范围的已部署负载配置，仍然是当前轮次的活动约定。
当这个技能通过一个被收窄的部署配置被消费时，应把该配置视为硬路由边界，而不是可选的适配器元数据。对当前 agents 第一波配置而言，有效的 支持的代码仓库动作 子集是：
进入工作追踪保持并观察在这个第一波边界下：
刷新代码仓库状态 作为标准可能性保留下来，但在当前轮中标记为 范围外保持并观察，并在 决策约束、继续阻塞项 或 最小缺失信息 中解释缺失的配置支持或审批边界当当前问题不是"谁来执行某个工作项"，而是"代码仓库在 代码仓库范围 下下一步应该做什么"时，使用这个技能：
工作追踪范围代码仓库范围，直到缺失证据被补齐Harness；只有当所选路由真正跨越正式审批边界时，才显式提出程序员审批当以下至少一个条件成立时，使用内嵌的 优先级重构/矛盾分析 模式：
工作追踪范围 刚关闭或停滞，代码仓库级优先级可能需要重构本技能的输出仅限于一轮 代码仓库范围 判定；把它当成工作追踪规划或执行分派替代品的行为禁止出现。它仍然是一轮 代码仓库范围 判定。
当默认 下一步方向 模式与 优先级重构/矛盾分析 模式都无法找到可信的可更新内容时，才启用 overview fallback 模式：
保持并观察overview fallback 可参考基本面与矛盾分析方法（如当前部署中可用的 project-dialectic-planning-skill 等全局分析技能），唯一合法行为是压缩为 repo 级下一步判定输出；扩展成大型战略报告的行为必须返回 blocked。该外部参考为可选增强路径；不存在时，唯一合法行为是继续执行 overview fallback 的正常流程；阻塞行为必须标记为超出本技能权限。
代码仓库范围 判定，而不是 工作追踪范围 规划或执行。代码仓库状态摘要 已经存在，应优先使用；仅允许将其作为可选增强输入，禁止将其设为硬前置条件。Repo Analysis artifact，可以把它作为结构化判定输入；它必须从属于 代码仓库目标/章程 与 代码仓库快照/状态；替代目标真相或工作追踪队列的行为禁止出现。Harness 控制状态 读取当前 继续权限 策略，尤其是在前一个工作追踪刚在 约定边界 收束时。工作追踪约定 或 计划/任务队列 字段。工作追踪产物的唯一合法角色是判定边界证据；把它们重新当成代码仓库的全局待办列表的行为禁止出现。支持的代码仓库动作，要先记录这个收窄后的子集，再去推理下一步。下一步方向 模式优先级重构/矛盾分析 模式overview fallback 模式通用高能力模型 推理轮构建一份限定范围代码仓库判定包。进入工作追踪刷新代码仓库状态保持并观察约定后自动性：最小委派 正在生效，那么任何自动 进入工作追踪 建议都必须被限制在已批准的低风险类别中的一个同目标限定范围切片。milestone_acceptance_verdict 为 blocked 或 proceed_blockers 非空，应在 继续阻塞项 中反映 Milestone 阻塞状态；如果活跃 Milestone 的 handback_required 为 true，应将 需要审批 置为真、将 handback_required 加入 继续阻塞项、阻止自动 进入工作追踪（即使存在剩余 autonomy budget），返回控制权等待 developer 验收。进入工作追踪 时，从 Goal Charter 的 Engineering Node Map 给出 suggested_node_type 与理由，交给 init-worktrack-skill 进行最终绑定；如果无法建议节点类型，应把缺口暴露为初始化风险。Harness 返回一份固定格式的 代码仓库下一步判定。至少在以下任一条件成立时停止并返回控制权：
保持并观察需要审批 置为 真当这个模式启用时，把本轮压缩成一次限定范围的代码仓库级矛盾判定：
事实、推断 与 未知项当前主要矛盾主要方面当前最高优先级不要做的事 列表，用于剔除干扰而不是给答案注水建议代码仓库动作最小缺失信息如果本轮消费 Repo Analysis artifact，必须先检查它的 baseline 是否仍匹配当前 代码仓库快照/状态。如果 baseline 过期，只能把它作为历史参考，不能直接沿用其中的 recommended_repo_action。
如果证据太弱，无法支持决定性的代码仓库动作，就建议 保持并观察 并附带最小缺失信息。如果矛盾只能通过改变代码仓库目标才能解决，唯一合法行为是返回 保持并观察，并在 决策约束 中说明目标级变更必须由外部请求触发 ChangeGoal；本 skill 内部处理目标变更的行为必须返回 blocked。如果矛盾已经准备好进入执行，就建议进入 工作追踪范围；当下一条路由已经获批且安全时，监督器继续推进可以在无需额外程序员交接的情况下继续。
如果活动路由边界比宽泛的标准答案更窄，唯一合法行为是在活动路由边界内推荐路由；仅仅因为在概念上正确就输出不受支持路由的行为必须返回 blocked。应把不受支持的分支保留在 范围外，解释约束，并回退到 保持并观察，除非当前配置明确允许更宽的路由。
当当前矛盾是"已批准的工作追踪已完成，但当前目标仍允许一个明显的低风险后续切片"时，只有在以下条件全部满足时才允许自动继续：
约定后自动性：最小委派自动范围：仅当前目标验证加固文档与代码对齐打包与入口清理不改变行为的小重构如果这些条件有任意一个失败，唯一合法行为是路由到 保持并观察；把 继续工作 重新解释成发明新范围许可的行为必须返回 blocked；应改为路由到 保持并观察。
当默认模式和优先级重构模式都无法找到可更新内容时，本模式用于提高未来可用 worktrack 的发现效率。它只产出候选建议和一个推荐方向，不创建工作追踪，不修改 .aw/worktrack/*，不改变 Harness 控制状态。
使用本模式时：
references/overview-fallback-mode.mdFacts / Inferences / Unknowns 区分事实、推断和未知项top_candidaterecommended_repo_action、recommended_next_route、approval 字段与 continuation 字段如果活动路由边界不允许进入工作追踪，就必须把候选作为建议返回，并把实际 recommended_repo_action 降级为 保持并观察。
工作追踪范围 的行为必须返回 blocked。代码仓库目标/章程、代码仓库快照/状态 和 Harness 控制状态 当作主要输入；只把工作追踪产物当作边界证据。计划/任务队列 的输出角色仅限于工作追踪本地执行序列记录；将其当成代码仓库待办列表的行为，或将 队列状态：已完成 当成代码仓库没有下一步证据的行为禁止出现。Harness 控制状态 或重写 .aw/worktrack/* 的行为必须返回 blocked。overview fallback 启用才合法；默认模式或优先级重构模式已有明确下一步时，启用 overview fallback 的行为必须返回 blocked。overview fallback 只能生成未来 worktrack 候选建议，不能直接创建或执行 worktrack。使用这个技能时，产出一份至少包含以下章节的 代码仓库下一步判定：
模式模式触发原因事实推断未知项当前主要矛盾主要方面当前最高优先级不要做的事overview_trigger_reasonoverview_scancandidate_worktrackstop_candidatetop_candidate_reason建议代码仓库动作路由/审批判定最小缺失信息返回 Harness结果中至少应包含以下字段或等价表达：
当前阶段模式模式触发理由事实推断未知项当前主要矛盾主要方面当前最高优先级不要做的事建议代码仓库动作suggested_node_typesuggested_node_type_reason允许的下一路由建议下一路由建议下一范围允许的代码仓库动作路由边界来源约定后自动性自动候选类别剩余自动预算范围内范围外决策约束选择依据选择理由最小缺失信息请求变更控制状态可继续继续阻塞项需要审批审批范围审批理由需要程序员审批如何审查当活动部署配置缩窄了路由空间时，允许的代码仓库动作、允许的下一路由、范围外 与 决策约束 必须反映这个收窄后的子集，而不是完整的标准动作空间。
如果默认模式已经足够，且不需要完整的矛盾重构，就与矛盾相关的章节必须保持简短；展开成报告的行为必须返回 blocked。输出仍应保持限定范围且面向判定。
如果启用 overview fallback，必须显式设置 模式：overview-fallback，并说明为什么默认模式和优先级重构模式都不足以发现可用下一步。
使用当前 Harness 控制状态、当前 代码仓库目标/章程 与当前 代码仓库快照/状态 作为本轮判定的主要输入。若当前 代码仓库状态摘要 可用，就使用它；仅允许将其作为可选输入，禁止将其设为前置条件。只有当当前代码仓库判定依赖于一个活动中或刚关闭工作追踪的边界时，才读取 工作追踪约定 或 计划/任务队列，并把它们视为本地边界证据，而不是代码仓库级任务库存。只有当本轮实际进入 优先级重构/矛盾分析 模式时，才读取 references/priority-reframe-mode.md；只有当默认模式和优先级重构都找不到可用更新方向时，才读取 references/overview-fallback-mode.md。