[YanZhiwei]

概要

把项目固定安装的 Delivery Bundle 更新到 speckit-delivery v0.1.4：13 个组件（9 个 Delivery 扩展 + Bug 1.0.1 + 3 条 Workflow）与 35 条 OpenCode 原生命令保持一致，并修复 v0.1.3 生成的 Doctor 指向错误的 Reviewer 模板路径。

动机

v0.1.3 引入了范围取证（speckit.delivery.explore）、有界修复复审（speckit.delivery.review-fix）和快照绑定的独立 Review，但其 Doctor 把共享 Reviewer 模板误指向 .specify/extensions/delivery/templates/reviewer.md，导致即使 Review 正确安装模板也会出现错误的就绪阻塞。v0.1.4 只修正该引用，不改变命令面、配置格式、评审维度、快照或修复预算。

Closes #

变更类型

• Feature 或新组件
• Bugfix 或契约修正
• 重构或简化
• 文档或治理
• 依赖升级

当前设计（改前）

• 入口或组件：.opencode/commands/speckit.* 由 Specify CLI 1.2.3 从固定 Release Catalog 渲染；.specify/ 保存安装状态、项目配置与 Workflow。
• 所有者与依赖方向：安装器/Bundle 拥有组件与生成命令，项目拥有 *-config.yml、Constitution、核心任务技能与模板；不引入新的运行时依赖。
• 当前约束与不变量：auto_execute_hooks: false、空 hooks、artifact_policy: ephemeral、auto_push/auto_merge 关闭、Specs 本地化、禁止自动远端写入。

本次改动

位置	改动	原因
.specify/{extension,workflow,bundle}-catalogs.yml、bundle-records.json、extensions/.registry	固定到 v0.1.4，登记 13 个组件	可追溯的固定 Release 安装
.specify/extensions/**	刷新 9 个扩展清单与资源，新增 exploration.md、reviewer.md、bugfix-review-repair.md	上游发布内容
.opencode/commands/**	刷新受影响命令，新增 speckit.delivery.explore、speckit.delivery.review-fix	宿主渲染
.specify/workflows/**	三条 Lane 一起更新，加入范围确认、有界修复复审与最终 Review Gate	保持 Workflow 与组件同版本
README.md、AGENTS.md、harness/README.md、docs/development/spec-kit-delivery.md	当前版本、新输入（delivery_run/bug_slug）、三门快照证据要求、Doctor 路径核对	使用者可复现
docs/decisions/engineering/0004-...md	记录 v0.1.4 安装与边界不变	长期决策与现状一致
harness/evidence/delivery-v014-upgrade.md、harness/build-log.md	记录实际命令、退出码、来源与限制；历史记录标记 superseded	证据绑定真实范围

影响范围

维度	影响	依据
公共 API、命令、配置	命令数 33 → 35；配置格式不变	specify bundle list --json、specify extension list
持久化或迁移	无数据迁移；.specify/delivery/<delivery_run>/ 为本地忽略文件	上游发布说明
兼容性与升级路径	直接 Workflow 现要求 delivery_run，Bugfix 另需 bug_slug；命令面其余不变	v0.1.3/v0.1.4 Release notes
安全与权限	无新增权限；自动 Hook 仍关闭，未推送任何私有内容	.specify/extensions.yml
性能与资源	无影响（仅 Prompt/Workflow 资源）	无运行时依赖变化
依赖与供应链	无 Python 依赖变化；新增固定 Release 来源与 SHA-256 校验记录	10 个 ZIP 摘要与 Release API 一致

设计

N/A：仅替换安装器管理的组件与文档，没有持久结构变化。

架构决策

• 相关 ADR 已链接，且与 HEAD 的实现一致。（ADR-0004）
• 本次没有改变架构决策。

行为与验收

需求	结果	证据
安装 v0.1.4 且组件版本一致	13 个组件：9 扩展 0.1.4、Bug 1.0.1、3 Workflow 0.1.4	specify bundle list --json
保持项目定制	14 个受保护文件（配置、Constitution、核心任务技能/模板、集成设置）字节不变	target-verification.json
发布内容未漂移	53 个非配置扩展文件与发布 ZIP 字节一致；3 条 Workflow 与 Tag 一致	临时审计脚本
Doctor 指向正确 Reviewer	生成命令含 .specify/extensions/review/templates/reviewer.md，旧 Delivery 路径不存在	渲染结果检查
原生命令可用	35 条点号命令，含 delivery.explore、delivery.review-fix	opencode api get /api/command

验证

检查	结果	证据
Quality Gate	未运行（本机缺 PSScriptAnalyzer 1.25.0，静态检查实际失败）；由 PR CI 执行	harness/evidence/delivery-v014-upgrade.md
针对性测试	通过：Release 摘要、隔离副本升级、内容比对、命令闭包、Doctor 路径	同上
治理与文档	通过：治理 0 错误 / 0 告警；文档 66 文件 / 180 目标	quality.ps1 -Check governance|docs
构建与隔离安装	未运行；本次不改 Python 源码、依赖或共享工具配置	git diff --name-only -- packages scripts .github pyproject.toml 为空
git diff --check	通过（仅 LF/CRLF 提示）	CI 与本机

pwsh -NoProfile -File scripts/quality.ps1
pwsh -NoProfile -File scripts/quality.ps1 -Check governance
pwsh -NoProfile -File scripts/quality.ps1 -Check docs
git diff --check

文档

• 源文档已更新。
• 生成投影已同步。
• 无需文档改动。

回滚

将三类 Catalog 指回 v0.1.3 后执行 specify bundle update speckit-delivery 即可回到上一固定版本；项目配置与定制未被改写，无需反向迁移。回滚同样不授权自动执行或远端写入。

AI 使用披露

• 未使用 AI 辅助。
• 使用了 AI 辅助，且每一行改动都经过人工审阅和验证。

评审重点

• 受保护配置、Constitution、核心任务技能/模板是否确实未变（应为字节一致）。
• 三条 Workflow 是否与 v0.1.4 Tag 一致，且引用的命令都能解析。
• 证据是否如实区分「安装一致性通过」与「Doctor 因环境阻塞」，没有把安装完成当作交付就绪。
• 直接 Workflow 的 delivery_run/bug_slug 输入说明是否足够让使用者复现。

Checklist

• 验收条件已覆盖。
• 阻塞性评审发现已处理。
• ADR 与 HEAD 一致。
• 验证证据已附。
• outgoing diff 与评审范围一致。