Codex ADR 技能:记录架构选择的理由与后果
EnglishCodex 安装步骤
- 从固定 GitHub 提交复制 `skills/codexkit-architecture-decision-writer/` 完整目录到项目 `.agents/skills/codexkit-architecture-decision-writer/`。
- 在 Codex 指定决策状态、影响范围和已有 ADR 格式,先列决策因素。
中文摘要
按 ADR 结构记录架构背景、比较条件、选项、决定及迁移与运营后果。
SKILL.md 中文导读
可复现示例
为本地演示项目写缓存 ADR,比较进程内缓存和共享缓存。输入多实例一致性、运维成本与预计访问量,保持决定为 Proposed。工作步骤
- 在同一组约束下比较候选方案,给采纳方案关联关键证据。
- 补上正面与负面影响、退出或回看触发条件。
验收方法
ADR 能指出选项、证据、成本与复查条件,Proposed 状态与实际确认程度一致。
GitHub 原文 · 更新日期
适用环境
准备团队已确认的选择或待定方案、现有技术约束和能够核对的来源。
常见问题
旧 ADR 内容要随着新决定改写吗?
保留旧决定的历史理由。在新 ADR 记录替代关系和时间。