ultra-builder-pro-cli 5.0.1 → 6.0.0

package/README.zh-CN.md

@@ -1,440 +1,67 @@
-# Ultra Builder Pro
+# Ultra Builder Pro 6
 
-[English](README.md) | **简体中文**
+意图是源码，计划是编译产物，进度由计算得出，变更是一份 diff。
 
-Ultra Builder Pro 是面向 Claude Code、Codex、OpenCode、Kimi Code、Grok Build
-和 ZCode 的 file-first（文件优先）工程工作流。它实现了与提供商无关的
-**Ultra Core Protocol**：所有者与 Agent 的认知对齐、每项事实的规范权威、
-显式的会话级或持久工作包授权、Agent 之间经过验证的独占式移交、带恢复路径的
-类型化证据，以及在所有者可见预算内终止的 Review。它把产品意图、规格、任务
-合同、证据、决策和恢复说明保存在仓库中，因此不同会话或 Host 可以通过读取文件
-和 Git，从同一组事实继续工作。
-
-Host 模型仍然是工程师。Ultra 提供可复用的方法和可检查的产物；它不会用工作流
-引擎取代推理。每个阶段采用一个还是多个 Agent、使用哪些提供商，均由所有者决定；
-默认由当前 Agent 单独继续。若要把工作包的写入权移交给另一个 Agent，必须通过
-仓库文件和 Git 完成显式、可验证的转移（OFFER → ACK → RESULT）。
-
-## Ultra Builder Pro 5.0
-
-`5.0.1` 是 Ultra 作为真实软件工程认知对齐 Harness 的当前实现。它保留已接受的
-3.0 file-first 与 model-agency 宪法，再让工作流位置、恢复和跨 Agent 执行变得可直接
-观察。它不是去中心化多 Agent 平台，也不规定唯一的 Agent 拓扑。它只承诺五件事：
-
-- 在 Research 进入计划或代码之前，先确立所有者接受的北极星（North Star）；
-- 允许所有者在每个阶段选择一个或多个 Agent，以及所使用的提供商；
-- 通过 `.ultra/` 下的文件与 Git，传递规范意图、决策、任务、证据和恢复信息，
-  让另一个会话或 Host 能够从同一事实继续；
-- 自动化可机械验证的权威、权限、外部 effect、证据、物理限制和恢复，同时把意义
-  与策略留给模型和所有者；以及
-- 约束 Review 与修复，使交付能够收敛，而不是把每个观察都变成下一轮自动实现循环。
-
-5.0 通过一个 Route Contract、明确的 Init/Research/Change/Plan 职责、只依赖文件的
-新会话恢复、installed Skill-local delegation runtime 和可替换的
-`AgentExecutionDriver` 来兑现这些承诺。只有某个 Host 通过有记录的 conformance
-drill 后，才优先选择 stable ACP v1；否则同一 result contract 使用明确报告原因的 CLI
-fallback。可移植协议和原生安装覆盖 Claude Code、Codex、OpenCode、Kimi Code、
-Grok Build 和 ZCode。六个 profile 都暴露 stable ACP v1 candidate，也都有各自当前的
-真实 provider receipt。只有对应 executable 与 candidate identity 仍匹配时才选择 ACP；
-否则返回 typed CLI fallback。ZCode 使用独立安装且锁定源码的 bridge，并保持
-`experimental`。
-
-5.0 明确不加入 daemon、workflow service、语义状态机、A2A 网络、Team Pack、remote
-marketplace 或共享权威存储。Package publication 和真实用户安装仍是需要独立核验的
-effects；仅凭 source version 不能证明任一 effect 已经发生。
-
-## 为什么需要它
-
-长周期 Agent 工程变更通常以四种可重复的方式失败：
-
-- 意图被反复转述，最终交付的产品不再符合所有者原意；
-- 局部层面测试变绿，被误认为端到端路径已经可用；
-- 上下文丢失后，中断任务变成考古工作；
-- 安全机制开始替产品作语义决定，并把主工作流困住。
-
-Ultra 通过简短、所有者可读的文件，渐进式 Skills，真实验证证据和 Git 恢复来解决
-这些问题。产品不包含数据库、MCP server、语义状态机、生成式 prompt 投影或后台
-daemon。
-
-## 产品表面
-
-该软件包精确安装十四个 Skills，分为三类角色。
-
-### 所有者调用的工作流
-
-| Skill | 结果 |
-|---|---|
-| `ultra-init` | 建立项目骨架和原始 Project Brief |
-| `ultra-research` | 建立已接受的 North Star 和有证据支撑的基线 |
-| `ultra-change` | 将一次请求的增量与已接受基线进行协调 |
-| `ultra-plan` | 编写 tracer-bullet 任务、上下文、依赖与 seam |
-| `ultra-dev` | 通过红/绿开发和六个证据维度实现一个任务 |
-| `ultra-test` | 审计全系统接线、E2E 行为、性能和安全性 |
-| `ultra-deliver` | 协调、Review、记录并归档一个已完成的 Change |
-| `ultra-delegate` | 通过另一个受支持的 CLI 执行有界任务、Research 取证或聚合 Review |
-
-### 模型调用的纪律
-
-| Skill | 可复用方法 |
-|---|---|
-| `ultra-grilling` | 每次只问一个关键问题，补齐所有者未明确的意图 |
-| `ultra-domain-modeling` | 在 `CONTEXT.md` 中维护精确的统一语言 |
-| `ultra-tdd` | 证明一条已确认 seam 先红后绿 |
-| `ultra-review` | 运行六个独立 Review lens 并综合 findings |
-| `ultra-think` | 对重要决策进行压力测试并记录持久结果 |
-
-`ultra-status` 是唯一的 router。它根据项目文件、Git 和安装健康状态推断当前 route，
-不会改变工作流状态。
-
-默认情况下，公开工作流由所有者显式选择。在一个已激活且仍有效的所有者
-`Execution Grant`（会话级授权或持久工作包授权）之外，一个公开工作流可以推荐
-下一个工作流，但不会自行启动它。在授权范围内，Host 模型只能选择授权覆盖的
-Change-scoped Research、同一 Change 的 reconcile、Plan、Dev、Test 和仅协调阶段的
-Deliver route；Init、Change intake/evidence/acceptance/abandonment 或 primary transfer、
-Delegate、Deliver finalization、最终归档以及每个外部 effect 始终由所有者选择；
-Status 同样由所有者选择、保持只读且不授予 continuation。每次 public transition 都先显示 derived
-`UBP Route Card`；Host invocation metadata 只负责粗粒度发现，加载后的 Skill 会重新
-验证精确 Mode 与 Grant，而不会创建 route state。模型调用的纪律仍可供 Host
-模型使用，它们不是独立的用户 route。模型在当前任务出现相应触发条件时选择它们：
-意图不完整时使用 grilling，术语冲突时使用 domain modeling，已接受的 seam 使用
-TDD，证据已可 Review 时使用 review，重要且未解决的决策使用 think。具备原生有界
-subagent 的 Host 可以并行运行 Review lens；其他 Host 则顺序运行同一组 lens 资产。
-
-在 `ultra-research` 中，前六个 reference 是六个语义 lens，而不是六个额外 Skill：
-问题验证、机会发现、市场评估、替代方案、产品策略和假设验证。`wayfinding.md` 会在
-这些 lens 与后续证据 lens 之间选择最小且依赖顺序正确的路径。Grilling 仍负责如何
-逐一追问缺失信息，Think 负责一个重要权衡，Domain Modeling 负责词汇；Research
-负责整体问题图、证据收敛、所有者 checkpoint 和基线晋升。
-
-### 原来的 Agents 去哪里了
-
-`5.0.1` 不安装自定义 `agents/` 投影。原来的 Review workers 变成
-`ultra-review/references/` 下六个聚焦文件；Review 协调和综合归属于父级
-`ultra-review` Skill。原来的 debugger 流程位于
-`ultra-dev/references/debugging.md`，测试执行流程位于
-`ultra-tdd/references/test-execution.md`。这些都是所属 Skill 的资产，因此会随
-Skill 到达全部六个 Host。它们保留了有界角色，又不会假装每个 Host 都暴露相同的
-自定义 Agent API。
-
-## 项目权威
-
-一个项目在首次接受 Research 基线后使用以下结构。刚完成 Init 时，`CONTEXT.md`
-尚不存在，North Star 和规格文件仍是空骨架。
-
-```text
-CONTEXT.md
-.ultra/
-├── .gitignore                  # 只忽略 Ultra 派生产物路径
-├── project-brief.md
-├── north-star.md
-├── tasks.json
-├── test-report.json
-├── specs/
-│   ├── product.md
-│   ├── architecture.md
-│   ├── discovery.md
-│   └── research-distillate.md
-├── changes/
-│   ├── active/<change-id>/{intent.md,delivery.md}
-│   ├── archive/<change-id>/{intent.md,delivery.md}
-│   └── abandoned/<change-id>/intent.md  # 包含精确的 Abandonment closure
-├── contexts/task-<task-id>.md
-├── decisions/<decision-id>.md
-├── evidence/<task-id>/...
-└── research/<run-id>/{brief.md,<step-id>.md}
-```
-
-可选的 `brief.md` 是派生导航；被选中的 step report 是引用证据，而晋升后的语义事实
-存在其他规范文件中。Git 提供历史、比较、回滚和归档移动。以下附加路径均为派生产物：
-
-```text
-.ultra/.runtime/
-.ultra/progress/
-.ultra/reviews/
-```
-
-`.ultra/.runtime/` 和 `.ultra/progress/` 可以从当前权威中删除或重建。精确保留当前
-strict Review session，直到 Test 和 Deliver 都成功消费它；只有在两个消费者都
-完成后，才能垃圾回收该 session。如果在两者完成前丢失，必须运行全新的 Review
-和 Test，绝不能重构旧 receipt。
-
-有关 writer、reader、promotion、staleness 和 recovery 规则，请参阅
-[Artifact Authority](docs/ARTIFACT-AUTHORITY.md)。
-
-### 哪个 route 写哪个文档
-
-| Route | 规范写入 | 下一个消费者 |
-|---|---|---|
-| `ultra-init` | 原始 `project-brief.md`、空的 North Star 和规格骨架、空任务/测试 ledger | research、status，以及基线前 Session Hook fallback |
-| `ultra-research` | 已接受的 North Star、首个 domain baseline、被选择且有引用的报告、已协调规格和 distillate | change、plan 和 delivery |
-| `ultra-change` | 一个带稳定 `change_id`、Research Disposition 且只触及增量相关已接受基线章节的 active `intent.md`；或在所有者授权移动前写入精确 Abandonment closure | active：research 到 delivery；abandoned：未来 Change 历史和 status |
-| `ultra-plan` | 为 active `change_id` 追加 `tasks.json` 行、每任务一个 context，以及 active intent 中的 Planning Posture | dev 和所有 resume 路径 |
-| `ultra-dev` | source/tests、类型化任务证据、只在 ledger 中保存的任务状态、Completion、Task Review 和 Resume Note | review、test、status、delivery |
-| `ultra-test` | 唯一的当前 `test-report.json`，绑定 Change id、当前 task ids、intent digest、HEAD 和 product-worktree digest | status 和 delivery |
-| `ultra-deliver` | 先协调 specs/docs，再在 fresh Test snapshot 后写一个 `delivery.md` 并归档 Change 目录 | 所有者和未来 Change 历史 |
-| `ultra-status` | 无 | 根据当前文件推荐最小显式 route |
-| `ultra-delegate` | 派生 runtime receipt 加 isolated worktree diff | primary host 检查和可选集成 |
-
-`ultra-domain-modeling` 是 `CONTEXT.md` 唯一的聚焦 writer；`ultra-think` 只在所有者
-接受后写持久决策。Review packets、Hook progress、compact snapshots 和 delegation
-receipts 都是派生证据，不是额外语义文档。
+UBP 为 Claude Code 和 Codex 提供一个 `ultra` Skill、确定性的 `ubp` 引擎和一个
+SessionStart hook。模型负责判断，引擎从项目文件与可执行检查计算进度。需要 Node.js 22
+或更新版本，以及 Git。
 
 ## 安装
 
-需要 Node.js 22 或更新版本。
-
-```bash
-# 当前项目，单个 Host
-npx ultra-builder-pro-cli@5.0.1 --claude --local
-npx ultra-builder-pro-cli@5.0.1 --codex --local
-
-# 全局安装
-npx ultra-builder-pro-cli@5.0.1 --opencode --global
-npx ultra-builder-pro-cli@5.0.1 --kimi --global
-npx ultra-builder-pro-cli@5.0.1 --grok --global
-npx ultra-builder-pro-cli@5.0.1 --zcode --global
-
-# 所有受支持 Host
-npx ultra-builder-pro-cli@5.0.1 --all --global
+```sh
+npm install -g ultra-builder-pro-cli@6.0.0
+ubp --claude --global
+ubp --codex --global
+# 或一次安装两个宿主：
+ubp --all --global
 ```
 
-把任务通过 ACP 派给 ZCode 还需要独立构建的 bridge 和已安装的 ZCode Desktop。
-Ultra 会随 Skill 提供 ZCode CLI 0.16.5 所需的小型 source patch，但不安装这两个依赖，
-也不会把 provider 凭据写入项目证据：
+使用 `--config-dir <dir>` 隔离安装；`--all` 会为两个宿主分别建立子目录。
+仅 Claude Code 支持 `--local`。Codex 只安装到用户范围：`--codex` 默认采用用户范围；
+`--codex --local` 会报错，除非使用 `--config-dir` 隔离安装。
+用 `ubp --all --global --doctor --json` 检查安装，用
+`ubp --all --global --uninstall` 卸载托管资源。
 
-```bash
-git clone https://github.com/jpalmae/zcode-acp
-git -C zcode-acp checkout 42fe149d4b501469343c01f23ba3801832306d53
-git -C zcode-acp apply \
-  /path/to/installed/ultra-delegate/patches/zcode-acp-0.1.0-zcode-0.16.5.patch
-cargo test --locked --manifest-path zcode-acp/Cargo.toml
-cargo install --locked --path zcode-acp
-```
-
-5.0 已验证 base commit、patch SHA-256
-`174dfd0feafe84320556a84b5ae08b10e44c5515fea4992fd1d58af54cee4e3d`、locked tests、
-fake E2E、release build 和真实 ZCode 0.16.5 session。需确保 binary 位于 `PATH`；非
-macOS 环境使用该平台实际安装的 ZCode CLI path。`--version` 必须返回
-`zcode-acp 0.1.0+ultra.zcode.0.16.5`。
-
-Host 与 provider 是两个概念：ZCode Desktop 是 runtime，模型账号可以是国内智谱
-BigModel，也可以是国际 Z.AI。国内 BigModel Coding Plan 应在
-`~/.zcode/cli/config.json` 中使用官方 Anthropic-compatible endpoint
-`https://open.bigmodel.cn/api/anthropic` 和 BigModel API Key，不能走 Z.AI OAuth。
-5.0 的真实验证使用 `builtin:bigmodel-coding-plan/GLM-5.2`。参见
-[智谱官方 Claude API 兼容文档](https://docs.bigmodel.cn/cn/guide/develop/claude/introduction)。
-
-这些固定版本的 `npx` 命令在发布后解析 registry 中不可变的版本。需要避免修改真实
-用户安装时，源码验证使用 `node bin/install.js --config-dir <isolated-path>`；独立的
-5.0 release drill 还在六个真实 Host home 中验证了 ownership-safe install、Doctor、
-ZCode uninstall 与 reinstall。
-
-使用 Host 原生 Skill picker 或调用语法选择一个所有者工作流。Codex 会暴露带命名空间
-的条目，例如 `$ultra-builder-pro:ultra-init`。安装后的 frontmatter 和 metadata 会
-保持用户 route 显式、模型 discipline 隐式。
-
-### 诊断、更新和卸载
-
-安装过程受管理、具备原子性，并会核验 provenance。
-
-```bash
-# 重新执行安装会更新受管理产物
-npx ultra-builder-pro-cli@5.0.1 --codex --global
-
-# 只读诊断
-npx ultra-builder-pro-cli@5.0.1 --all --global --doctor --json
-
-# 只移除受管理的 Ultra 资产
-npx ultra-builder-pro-cli@5.0.1 --all --global --uninstall
-```
-
-`--config-dir <path>` 会同时隔离主配置和 Host 自有 sidecar。它是测试时的安全选择，
-不会回落到真实 home 目录。选择多个 Host 时，每个 Host 会收到
-`<path>/<runtime>`，避免彼此的原生布局相互覆盖。
-
-卸载会移除受管理插件，并且只清理首次安装前不存在、当前为空的配置目录外壳。
-已有 registry、目录、symlink 以及任何包含所有者数据的路径都会保留。
-
-Kimi Code、Grok Build 和 ZCode 当前只提供用户级插件，所以 `--local` 会在任何修改
-前拒绝它们。Claude Code、Codex 和 OpenCode 支持项目级安装；全部六个 Host 都支持
-受管理的全局安装和隔离 `--config-dir` 验证。
-
-## 典型工作流
-
-已有项目的日常工作从 `ultra-change` 开始，而不是先进入一次无边界的 Research。
-只有建立首个 baseline，或回答同一 active Change 已记录的有界证据问题时，才直接进入
-`ultra-research`。每次 public transition 都先展示派生的 Route Card，明确当前 Mode、
-Position、可观察 Exit condition、material checkpoint 和 Next route。
-
-1. 选择一次 `ultra-init`。它写入骨架，在 Project Brief 中保留所有者原始的一行请求
-   和大致轮廓，在需要时初始化 Git，然后停止，不会开始产品 Research。
-2. 选择 `ultra-research`，把 brief 转化为首个已接受的 North Star、共享词汇以及有
-   证据支撑的产品和架构基线。对于不清晰的多 lens 问题，它会先写派生 Wayfinding
-   brief；对于单个有界证据缺口，则跳过该额外文件。
-3. 对一次请求的增量选择 `ultra-change`。它只在计划前协调该增量触及的基线章节，
-   不会重建项目基线。其 Research Disposition 要么引用充分证据，要么明确必须通过
-   Research 返回的有界问题和退出证据。不会让任何规格语句失真的微小编辑可以留在
-   Ultra 之外；每个被接受的 Change 都会获得由真实 seam、证据、Review 和恢复需要
-   所证明的最小 Plan graph。任何 profile 都不能固定任务数量。该 Change 仍 active
-   时，继续协调同一个稳定 id；不要为另一个请求开启第二个 active Change。
-4. 选择 `ultra-plan`，记录公开 seam，并生成可恢复的 tracer-bullet 任务。最早的可观察
-   slice 必须穿过真实 consumer 和真实 data path，并写明所有者能观察到的结果。模型负责
-   普通技术 seam；只有会改变公开合同或其他重大权衡的 seam 才由所有者决定。
-5. 每次为一个任务选择 `ultra-dev`。`.ultra/tasks.json` 是唯一任务状态权威。Dev 在
-   row 仍为 `in_progress` 时记录类型化 v2 证据并完成 Task Review；只有解决 blocking
-   findings 并刷新受影响证据后，它才写入 `completed`、添加 Completion，并重写
-   Resume Note。
-6. 当 active Change 的任务均以当前 v2 证据和保留的 Task Review provenance 完成后，
-   选择 `ultra-test`。历史 ledger rows 和旧 context Status fields 不进入该审计。本地
-   测试变绿不能代替 wiring 与 E2E 证明。
-7. 选择 `ultra-deliver` 运行聚合 Review 并协调文档。如果这一步改变产品或语义文件，
-   需要重新运行 Test；再在 fresh snapshot 上重新进入 Deliver，写入 delivery metadata
-   并归档稳定 Change id。Commit、push、tag、publication 和 deployment 始终是分别
-   授权的 effects。
-
-对于一个已接受 Change，所有者可以用两种模式激活其精确 `Execution Grant`。
-`session-local` grant 只存在于当前对话：当激活状态丢失——进入新会话、切换 Host
-或发生 compaction——工作会停止，等待所有者重新激活。`durable work-package`
-grant 允许新的 Agent 或 Host 继续一个精确工作包，但 Agent 必须先稳定验证所记录的
-grant 本身。在两种模式下，模型都可以选择授权覆盖的 Change-scoped Research、同一
-Change 的 reconcile、Plan、Dev、Test 和仅协调阶段的 Deliver route，直到下一个语义
-停止点或声明预算；两种模式都不授予
-finalization 或 archive 权限：写入 `delivery.md`、版本或 package posture，以及归档
-始终需要所有者当前显式调用；commit、push、publication、deployment、installation
-和其他任何外部 effect 也一样。
+每个安装后的插件都携带引擎副本。Skill 写明其绝对 Node 调用路径，所有引擎命令始终使用这个副本，
+不采用 PATH 上其他版本的 `ubp`。不需要 Python。
 
-任何时候，`ultra-status` 都可以重建当前位置。新会话先从 repository root 和 `HEAD`
-开始，唯一解析 active Change，再读取 `.ultra/tasks.json`、匹配任务的 `context_file`
-和其中的 `## Resume Note`、`CONTEXT.md`、相关 decisions、specifications、evidence 与
-当前 Git diff；不会因为聊天记忆丢失而重跑已完成的 Research。如果 active authority
-歧义或不可读，Status 转入只读 recovery，指出最早的不安全事实，并给出最便宜的
-repair、retry、cancel、abandon 或 fresh-session 路径，不选择 intent，也不写语义文件。
-archive 或 abandoned Change 中未完成的历史 rows 仍不是当前 frontier。
+## 第一次会话
 
-## 三层独立集成防线
+在 Claude Code 项目中调用 `/ultra`（完整名称 `/ultra-builder-pro:ultra`）；
+在 Codex 中调用 `$ultra-builder-pro:ultra`。运行 `ubp status` 查看当前状态。没有 `.ultra/spec.md`
+的项目从访谈开始，再形成规格、验收检查和里程碑计划。
 
-工作流不会把“测试通过”等同于端到端结论。
+SessionStart hook 仅在 `.ultra/spec.md` 存在时打印进度和使用 `ultra` 的提示；
+它不自动启动工作，也不写项目文件。
 
-- `ultra-plan` 拒绝横向 feature slicing，并确认可观察 seam。
-- `ultra-dev` 把测试、持久化、feature flags、垂直执行和 spec trace 记录为六个独立观察。
-- `ultra-test` 为 changed exports 查找真实的非测试消费者，并让最小 primary flow 穿过边界。
+Codex 用户需先在 `/hooks` 中审阅并信任插件 hook；未信任前会跳过它。定义变更后需重新信任。
+即使尚未信任 hook，Skill 的第一步 `ubp status` 仍会显示进度行。
+详见 [Codex hook 信任规则](https://learn.chatgpt.com/docs/hooks)。
 
-每层防线都可以独立报告缺陷。这些报告是 sensors，不是语义 gates；模型和所有者在
-不抹除证据的前提下决定如何响应。
-
-## Hooks
-
-五个可选 Hooks 会加速文件读取，并保护一个狭窄的 effect 边界：
-
-| Hook | 行为 |
-|---|---|
-| `session_context.py` | 注入已接受的 North Star；Research 前则注入 Project Brief fallback，并附上当前 acceptance |
-| `mid_workflow_recall.py` | 在相关 source 操作前重述 acceptance |
-| `compact_context.py` | 保存和恢复一次可丢弃的 Git/file snapshot |
-| `post_edit_guard.py` | 在编辑后记录机械证据观察 |
-| `block_dangerous_commands.py` | 对受保护分支的增量 publication 给出建议；在精确命令获授权前，拒绝改写历史和具名破坏性 shell effects |
-
-当 `.ultra/` 不存在时，五个 Hooks 都静默退出。详情见
-[Plugin Isolation](docs/PLUGIN-ISOLATION-CONTRACT.md)。
-
-## 委派
-
-委派会写入不可变的 instruction 和 permission envelope，然后选择一个 Host-local
-`AgentExecutionDriver` 并在后台启动。只有 executable stdio endpoint 能协商 stable
-ACP v1，且该 Host 有带 evidence 的 passed conformance record 时才选择 ACP；否则使用
-相同 result contract 的 `CliDriver`，并报告精确 fallback reason。当前六个 Host row
-都已有各自真实 provider 的 passing receipt；executable 缺失或 receipt 缺失/过期时仍
-返回 typed CLI fallback；candidate identity 不匹配也同样 fallback。只有在
-`session/prompt` 之前识别到 `acp_auth_required` 时，才会执行一次有界 CLI path；其他
-ACP failure 一律不重试，因此不会重复派送 provider task。空
-writable roots 选择原生只读模式；声明 roots 则
-选择有界写入模式。模型返回一个
-受 schema 约束的最终响应；launcher 从原生结构化输出中提取它，验证真实 Git diff，
-并在 instruction 旁原子发布 terminal `finished`、`blocked` 或 `failed` result。
-绑定 digest 的 packet 会嵌入 worker prompt，因此严格 Host 不必从 isolated worktree
-之外读取 instruction files。
-
-```bash
-node <loaded-ultra-delegate-skill-dir>/scripts/delegate.cjs run --to codex \
-  --instruction .ultra/.runtime/delegations/D-01/instruction.md \
-  --permission .ultra/.runtime/delegations/D-01/permission.json \
-  --worktree .ultra/.runtime/worktrees/D-01
-```
-
-loaded Skill path 是 canonical runtime；clean `npx` plugin install 后不需要全局 `ubp`，
-也不会通过 `npx` 查找 Ultra；固定版本的 Claude/Codex ACP adapter 本身可以经 `npx`
-运行。`ubp delegate` 只保留一个版本周期的薄兼容
-wrapper。使用 installed Skill 内的 `scripts/delegate_wait.py` 等待 `result.json`，无需把
-worker 中间输出载入父上下文。委派不会授予新权限；writable roots 仍位于 worktree 内，
-permission file 必须声明零外部 effects，且不得放宽 Host sandbox。
-不可变 instruction 可指定任务执行/续做、有界 Research 取证或聚合 Change
-Review/verification。后两类可以只读，也不要求 task row，因此 pre-Plan Research 与
-post-task 跨 family Review 不需要虚构 ledger work 也能执行。
-ZCode 通过独立安装的 `zcode-acp` bridge 只解析 installed Desktop runtime（macOS
-优先 App-bundled CLI，之后才是 `PATH` fallback），并保持 `experimental`。当前
-capability、read-only、permission、cancel/no-orphan、cwd/diff、result parity 与
-redaction drill 均已通过；提升 maturity 仍需要 App-internal runtime 的官方稳定性承诺。
-Doctor 分开报告 runner health、ACP capability、candidate identity、selected driver、
-fallback reason 与 ZCode maturity。
-
-## Host 支持
-
-| Host | Skills | Hooks | 受管理生命周期 |
-|---|---:|---:|---|
-| Claude Code | 14 | 5 个直接 Hooks | install / doctor / update / uninstall |
-| Codex | 14 + 原生 metadata | 5 个 wire adapter Hooks | plugin + personal marketplace |
-| OpenCode | 14 | 5 个原生 JS plugin Hooks | bundle + skill directories |
-| Kimi Code | 14 | 5 个 wire adapter Hooks | managed plugin registry |
-| Grok Build | 14 | 5 个 wire adapter Hooks | 可用时使用原生 plugin registration |
-| ZCode | 14 | 5 个 wire adapter Hooks | inline plugin + local marketplace + reversible config registration |
-
-有关精确路径和 Host 限制，请参阅
-[Runtime Compatibility](docs/RUNTIME-COMPAT-MATRIX.md)。
-
-## 开发
-
-```bash
-# Node contracts、package smoke、Host adapters、delegation 和 Skills
-npm run test:node
-
-# File-first Hook 行为和 wire wrappers
-npm run test:hooks
-
-# 完整 release gate
-npm run verify:release
-
-# 检查精确 publish artifact
-npm pack --dry-run --json
-```
+## 命令
 
-每个发生变化的 Skill 还会通过 Codex Skill Creator validator 验证。发生变化的 Codex
-manifest 会依据 Plugin Creator schema 验证。验证变绿不代表已授权任何 release
-effect；validator 成功只证明结构符合要求，不代表语义已被接受。
+| 命令 | 用途 |
+| --- | --- |
+| `ubp status` | 计算进度和下一步 |
+| `ubp gate` | 校验计划并记录基线 |
+| `ubp check [ids]` | 执行检查并记录证据 |
+| `ubp node done <id>` | 在需求为绿时完成节点 |
+| `ubp context <id>` | 编译节点简报 |
+| `ubp milestone close <id> --owner "原话" --review <file>` | 关闭已评审里程碑 |
+| `ubp approve <items> --owner "原话"` | 记录缩减范围的批准 |
+| `ubp retro` | 列出重复失败类别 |
+| `ubp merge <branch> --expect-head <sha>` | 校验并合并工作分支 |
+| `ubp drive --writer <cmd> [--reviewer <cmd>]` | 无人值守地推进节点，直到下一个需要 Owner 的点 |
 
-## 文档
+引擎命令接受 `--root <dir>` 和 `--json`。文件格式、退出码见
+[引擎合同](engine/FORMATS.md)，工作方法与批准边界见 [ultra](skills/ultra/SKILL.md)。
 
-- [5.0 设计与验收合同](docs/ULTRA-BUILDER-PRO-5.0.zh-CN.md) — 5.0.1 已实现的
-  Route、Skill 职责、continuation、ACP/CLI execution、migration 与 journey 边界。
-- [5.0 journey 结果](docs/evals/ultra-5-0-journey-results.md) — 可观察的 source、
-  isolated-runtime、real-provider、real-HOME 与跨平台结果，以及明确排除的服务部署边界。
-- [当前权威](.ultra/north-star.md) — 本仓库已接受的 North Star
-  `north-star-v2-r3` 是当前规范权威；`.ultra/tasks.json` 以及
-  `.ultra/changes/active/` 或 `.ultra/changes/archive/` 下的稳定 Change 记录当前或
-  已交付的工作 frontier。
-- 冻结的设计历史（不可变的已接受记录，不是实时状态）：
-  [3.0 North Star R3](docs/ULTRA-BUILDER-PRO-3.0-NORTH-STAR-R3.zh-CN.md) —
-  绑定 hash 的已接受 r3 设计；以及已被 r3 取代的
-  [3.0 design](docs/ULTRA-BUILDER-PRO-3.0.zh-CN.md)。
-- [理念](docs/PHILOSOPHY.md)
-- [架构](docs/ARCHITECTURE.md)
-- [产物权威](docs/ARTIFACT-AUTHORITY.md)
-- [工作流生命周期](docs/WORKFLOW-LIFECYCLE.md)
-- [Skill 编写规范](docs/SKILL-AUTHORING.md)
-- [插件隔离](docs/PLUGIN-ISOLATION-CONTRACT.md)
-- [Runtime 兼容性](docs/RUNTIME-COMPAT-MATRIX.md)
-- [对抗性 Review 评估](docs/evals/adversarial-review-2026-08-14.md)
-- [ZCode 自动化评估](docs/evals/zcode-automation-2026-08-14.md)
+## 从 5.x 迁移
 
-## License
+v6 用一个方法替代十四个 `ultra-*` Skills，用一个 Node 提示 hook 替代五个 Python hooks。
+移除了 OpenCode、Kimi、Grok、ZCode 适配器、`run`、`delegate`、ACP/Pi 执行、durable grants、
+wake-up 机制和旧项目模板，避免多个入口争夺下一步；下一步由引擎状态决定。
+旧项目记录不会自动转换为 v6 格式。
 
-[MIT](LICENSE)
+仍需旧工作流时，在独立配置目录使用最后发布的 5.x 版本 5.0.1（5.0.2 从未发布）；旧源码可从 Git 历史恢复。
+另见 [变更记录](CHANGELOG.md) 和 [插件边界](docs/PLUGIN-ISOLATION-CONTRACT.md)。

package/adapters/_shared/frontmatter.cjs

@@ -1,7 +1,6 @@
 'use strict';
 
 // YAML frontmatter parsing / serialization for markdown assets.
-// Every runtime adapter consumes this — OpenCode lowercases keys while
 // Claude Code and Codex preserve their native metadata contracts.
 
 const yaml = require('js-yaml');
@@ -33,20 +32,4 @@ function serialize(fm, body = '') {
   return `${DELIMITER}\n${yamlBody}\n${DELIMITER}\n${body}`;
 }
 
-function lowercaseKeys(obj) {
-  if (Array.isArray(obj)) return obj.map(lowercaseKeys);
-  if (obj === null || typeof obj !== 'object') return obj;
-  const out = {};
-  for (const [k, v] of Object.entries(obj)) {
-    out[k.toLowerCase()] = lowercaseKeys(v);
-  }
-  return out;
-}
-
-function patch(text, patchFn) {
-  const { fm, body } = parse(text);
-  const nextFm = patchFn(fm ? { ...fm } : {});
-  return serialize(nextFm, body);
-}
-
-module.exports = { parse, serialize, lowercaseKeys, patch };
+module.exports = { parse, serialize };