ns-autonomous 是一个面向代码实现的自主执行引擎,可接收本地计划文件、粘贴文本或“自动实现”类指令,也可作为 ns-execution-gitlab-issue 的 Phase 2 引擎被调用。用途上,它负责把计划转成实际代码改动,并在隔离环境中完成实现、评审与交付前的闭环。
主要能力包括:规划深度自行判断(单个工作单元,或生成 light requirements.md、tasks/task-NNN-*.md 与 execution-plan.md,放在 docs/versions/{version_san}/sdd/ 下);疑问处理先自查、优先查文档与规格,可自行回答非破坏性疑问,破坏性疑问则升级;多智能体分派,1 个单元在本会话按 ns-coder 执行,≥2 个单元时可用则必须分派 coder-agent(否则 ns-coder),仅对无 DAG 依赖且文件范围不重叠的单元并行;每个顺序单元或并行批次做一次 checkpoint commit。评审门禁在版本收尾时执行,可用时用 reviewer-agent(否则 ns-reviewer),最多 3 轮,Code Review: Approved 为 10 分,9 分即 Rejected,需修复后重审;Code Review 通过后本会话执行 ns-judge。
使用方式上,独立场景下流程为:解析描述符(本地计划路径或粘贴文本,无 MCP 调用)、推断 change_kind、分配版本、必要时创建 sdd 文档、基于解析出的基线分支创建 .worktrees/{version_san}/ 与 work/{version_san} 分支,再执行规划、疑问处理、分派与评审循环。Engine 模式下输入由调用方解析:issue payload、WORKTREE_ROOT、WORK_BRANCH、SOURCE_BRANCH。
限制与强制规则:除非人类明确说就地工作,否则不得在主产品检出、main/master/base/SOURCE_BRANCH 上写应用代码;worktree 创建失败、CWD/分支仍为主检出或基线时停止,不得退回主检出或 .cursor/ 路径;同 {run_id} 的 worktree 冲突需显式恢复;评审 Blocked 或 3 轮耗尽时报告阻塞,不得伪造成功;禁止使用非 ns-reviewer 的代码门禁替代,禁止在 Code Review 通过前跑 ns-judge。GitLab 来源的 issue 走 ns-execution-gitlab-issue 端到端,本技能仅作其 Phase 2 引擎,独立流水线不触碰 GitLab 状态,除非存在 gitlab-sync-config.md 且人类明确要求。