[YanZhiwei]

摘要

将固定的 Spec Kit Delivery Bundle 从 v0.1.4 升级到 v0.2.2，接入 Slice 计划/Gate、可持久化的 Handoff 正文和 v0.2.2 随包中文 PR 模板；项目继续保持单 PR、required linear history 的交付策略。

动机

无关联 Issue；按维护者要求升级到已发布的固定 Release。v0.2.2 只把 Delivery 随包 PR 模板改为中文；命令面、Workflow 输入、Review 维度、快照和修复预算不变。变更保持安装来源、授权边界、核心任务定制和 Python 包行为不变。

变更类型

• 新功能或新组件
• Bugfix 或契约修正
• 重构或简化
• 文档或治理
• 发布准备

当前设计（变更前）

• 入口或组件：Bundle v0.1.4；Delivery 扩展 8 条命令；Feature Workflow 从 tasks 直接进入 analyze/Ralph；Handoff 只保证对话输出；项目使用自己的中文 PR 模板。
• 归属与依赖方向：安装器/Bundle 拥有扩展、Workflow 和生成命令；项目拥有 *-config.yml、Constitution、核心任务模板和 .github/pull_request_template.md。
• 当前约束与不变量：tasks.md 是唯一执行队列；Specs 本地化；串行 Ralph；禁止自动 push/merge/发布；auto_execute_hooks: false。

变更内容

位置	变更	原因
.specify/{extension,workflow,bundle}-catalogs.yml、bundle-records.json、extensions/.registry	固定到 v0.2.2；Bundle 记录 13 个组件	可追溯的 Release 安装
.specify/extensions/**、.specify/workflows/**、.opencode/commands/**	刷新 10 个扩展到 0.2.2；新增 speckit.delivery.slice 和 templates/slices.md；Feature 增加 slice/slice-gate	接入 v0.2.0 切片、v0.2.1 Handoff 和 v0.2.2 中文模板
.specify/extensions/delivery/delivery-config.yml	设置 pr_slicing: "off"、Slice 预算、stack_provider: manual、merge_policy、code_context 和 pull_request_template	匹配单 PR、线性历史和无 Merge Queue 的仓库事实
.github/pull_request_template.md	替换为 v0.2.2 随包中文模板的字节副本	让 GitHub UI 与 Handoff 默认使用同一中文模板
README.md、AGENTS.md、harness/README.md、docs/development/spec-kit-delivery.md、ADR-0004	更新版本、Slice/Handoff 契约、模板策略和限制说明	保持治理文档与 HEAD 一致
harness/evidence/delivery-v022-upgrade.md、harness/build-log.md	新增 v0.2.2 evidence；v0.2.1 evidence 标记为 superseded	绑定安装来源、命令和验证结果

影响

维度	影响	证据
公共 API、命令、配置	新增 speckit.delivery.slice 和 Delivery 配置字段；原生命令 35 → 36	specify bundle list --json；命令闭包检查
持久化或迁移	无数据迁移；Specs 仍为本地 ephemeral	Delivery 配置；ADR-0002
兼容性与升级路径	现有单 PR 路径保留；Stacked/Integration 未启用	pr_slicing: "off"、stack_provider: manual、final: squash
安全与权限	未新增网络写入、密钥、Hook 或自动 push/merge	auto_execute_hooks: false；安装和验证仅只读下载
性能与资源	无运行时性能变化	仅开发工具、Prompt/Workflow 资源和 PR 模板
依赖与供应链	固定 GitHub Release v0.2.2；10 个 ZIP 的 SHA-256 与 Release API 一致	v0.2.2 evidence

设计

N/A。本次不改变 Python 包结构、公共 API 或运行时依赖，只更新安装器管理的交付工具资源和项目 PR 模板。

架构决策

• 已链接相关 ADR，并与 HEAD 的实现一致。
• 没有架构决策变化。

依据：ADR-0004。

行为与验收

需求	结果	证据
Bundle 升级到 v0.2.2	13 个组件均为预期版本（Bug 1.0.1，其余 0.2.2）	specify bundle list --json
Slice 命令/Gate 与模板可用	speckit.delivery.slice、templates/slices.md、Feature slice/slice-gate 已安装	fixture/target verification
Handoff 正文可持久化	生成命令包含 PR_BODY_PATH、PR_CREATE_HINT: gh pr create 和 --body-file	生成命令断言
PR 模板为中文 SD 模板	随包模板和 .github 副本均为中文，SHA-256 一致	模板哈希检查 ee175915...
项目配置与定制保留	安装器保留 14 个受保护文件；仅显式更新 Delivery 配置	protected hash 对比
旧 PR 模板可恢复	旧项目模板保留在 Git 历史中	Git history

验证

检查	结果	证据
构建	通过	完整 scripts/quality.ps1 四包矩阵；wheel 构建、隔离安装和 import 通过
测试	通过	scripts/test-quality.ps1 9 场景；test-governance.ps1 23 场景；test-static.ps1 3 场景
规范与 Spec 审查	仅本地范围评估	已检查安装器/项目归属、依赖方向、Hook 和远端写入边界；独立 Review 未运行
ADR 一致性	通过	ADR-0004 已更新到 v0.2.2 和中文模板策略
变更范围的简化检查	未运行	本次仅工具/配置变更，未触及 Python 表面

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

完整记录：v0.2.2 evidence。

文档

• 源文档已更新。
• 生成文档已同步。
• 不需要文档变更。

当前没有生成文档投影；变更均为手工维护的权威文档。

回滚

将 Catalog 固定回 v0.1.4 并执行 specify bundle update speckit-delivery，或 revert 本 PR。回滚也会从 Git 历史恢复旧的项目 PR 模板；Python 包不受影响。

AI 辅助

• 未使用 AI 辅助。
• 使用了 AI 辅助，且每一行变更都已审阅和验证。

本 PR 由 AI 辅助完成安装、自动验证和文档更新；自动化检查已通过，但仍需维护者在评审中完成人工确认。

评审说明

• 确认 pr_slicing: "off"、stack_provider: manual、use_queue: false、final: squash 与 required linear history / 单 PR 策略一致。
• 确认安装器生成资源保持发布原样，项目只修改 delivery-config.yml、项目 PR 模板和治理文档。
• 确认 specify integration status 的 32 个 project-modified managed files 是既有核心技能/模板定制，不是本次安装缺失。
• v0.2.2 相对 v0.2.1 只改随包 PR 模板为中文；命令面、Workflow、Review 和权限边界不变。
• .github/pull_request_template.md 是随包中文模板的静态副本；未来模板升级需要显式刷新。

检查清单

• 验收条件已覆盖。
• 阻断性评审问题已解决。
• ADR 与 HEAD 的实现一致。
• 已附相关验证证据。
• 外发 diff 与已审阅范围一致。