ADR: [决策标题]

ADR: [决策标题]

【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot

• Context:[为什么需要这个决策]
• Decision:[我们选择了什么，以及它属于决策框架哪一层]
• Alternatives considered:[还评估了什么，为什么落选]
• Consequences:[接受的权衡]

#### Phase 4：逐功能迁移分析 对架构文档识别出的每个主要功能/领域，产出覆盖以下内容的小节（SKILL.md「Phase 4」）： 1. **当前实现**——一段总结，带文件引用； 2. **迁移策略**——Phase 2 的 A/B 选择（Freeze-then-lift vs Beachhead/行走骨架），加战术：绞杀无花果、大爆炸重写、抬升与平移、增量重构、或原地不动； 3. **可测试性状态**——该组件的 **Testability Milestone** 落在哪、**安全阶梯档位**（L0–L4）及残余风险； 4. **依赖与耦合**——什么会随之破裂或必须随之移动； 5. **工作量估算**——T 恤尺寸（XS/S/M/L/XL）附论证； 6. **风险评估**——可能出什么问题、数据迁移顾虑、用户影响； 7. **验收标准**——如何判定迁移成功（**对照所选 oracle/接缝契约表述**，而非对照还没活过来的测试套件）。 #### Phase 5：分阶段实施计划 产出有序、分阶段的计划。每个阶段应**可独立部署**（不允许出现无法在生产运行的一半迁移状态）。 **阶段门禁与体制相关（适用于每个阶段）**——在计划顶部声明此规则，并在每个阶段的退出标准中遵守。一个阶段在其 Verification & Exit Criteria 通过之前**不算完成**。这些标准必须 (a) **客观可验证**；(b) 下一阶段开始前**确实执行并记录**；(c) **有门禁**——阶段 N 的标准未证实满足不得推进到 N+1。**但哪些标准有效，取决于组件的体制（Phase 2c）**： - **可测试性之后（“明区”）阶段**：退出标准是可运行命令/绿 CI——**阶段分支/PR 上的绿 CI 是权威信号**。 - **可测试性之前（“暗区”）阶段**：组件还没活过来，绿 CI 测试门禁是**范畴错误**。退出标准来自可达的安全阶梯档位——捕获的接缝/oracle 快照、证明存在的可逆性脚手架、通过的冒烟清单、记录在案的评审。**不要**用一个还跑不起来的测试套件阻塞暗区阶段。 对通过/失败未知的阶段要如实报告，不要假设它通过了。 **第一阶段建立的是最大*可达*安全——而非固定的“绿遗留门禁”。** 不要硬编码“复活一切并让 CI 变绿”。根据 Phase 2 输出按组件塑形第一阶段： - **策略 A（先冻结后抬升），组件可复活**：第一阶段*就是*经典的安全网与基线——纯增量、零行为变更：在**接缝**处的特征化/黄金/契约测试（固定当前可观察行为：协议轨迹、API 快照、输出黄金）；CI + lint + formatter 接好且绿（为后续明区阶段充当权威门禁）；**钉住依赖 / 提交 lockfile** 并记录已知良好基线（版本、工具链、今天如何构建运行）；**“证明网会失效”**——故意变异代码（如改一个协议码或返回值），确认新测试**变红**，然后还原。从不失败的网什么也证明不了——证明它有牙齿。 - **策略 B（滩头/行走骨架），组件已死**：第一阶段是**“以最小切片达到可测试性里程碑”**——把最薄的全链路路径驱动到现代技术栈直到构建、启动、≥1 个真实测试变绿，同时从旧系统捕获接缝/oracle 契约用于验证。**不要试图网住尸体。** 其退出标准是可达安全档位并点名残余风险——**被祝福的降级不是失败。** 只有第一阶段标准达成（无论在哪个档位），后续基础设施与功能阶段才开始。 每个阶段按如下模板结构化（直接取自 SKILL.md）： ```markdown ### Phase N: [名称]（T 恤尺寸：M） **Goal:** [一句话] **Regime:** [pre-testability ("dark") | post-testability ("lit")] —— 按组件 **Safety rung:** [L0–L4，低于 L4 需点名残余风险] **Prerequisites:** [哪些阶段必须先完成] **Duration estimate:** [相对而非日历——如 "2-4 sprints"] #### Tasks | ID | Task | Component | Blocked by | |----|------|-----------|------------| | N.1 | ... | ... | — | | N.2 | ... | ... | N.1 | #### Risks & Mitigations - **Risk:** ... → **Mitigation:** ... #### Decisions made - [本阶段依赖的每个子决策，都在这里解决并记录，使阶段无需更多用户输入即可实现。对任何裁剪项显式说明 "dropped" vs "deferred"。] #### Verification & Exit Criteria (Definition of Done) - [ ] [体制适配的标准。LIT 阶段：可运行命令 / 绿 CI 检查，引用 Commands & Verification Inventory 中的实际命令。DARK 阶段：可达安全档位的证据——捕获的接缝/oracle 快照、证明的可逆性、通过的冒烟清单——而非组件还跑不起来的绿测试套件。] - [ ] [凡旨在保持行为不变的变更，包含对照所选 oracle 的 parity/characterization 检查。] - [ ] [若纯增量，显式断言："no behavior/dependency/logic changed."] - [ ] [若低于 L4 退出，说明残余风险及哪个后续阶段关闭它。]

【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot