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-copilotContext:[为什么需要这个决策]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 的标准未证实满足不得推进到 N1。**但哪些标准有效取决于组件的体制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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考