ChatGPT ADR 写作技能：记录架构决策、代价和备选方案
EnglishChatGPT 安装步骤
- 打开固定提交的 .claude/skills/adr-writing/SKILL.md，核对原文的输入和输出。
- 在 ChatGPT 打开「插件 → 技能 → 创建 → 使用编辑器创建」。
- 按下面的工作流程填写技能规则。使用对话中提供的决策记录、任务号和已讨论的选项。
- 保存技能，在新对话输入本页的虚构示例并核对结果。
中文摘要
把结构性技术选择整理成简短的架构决策记录，留下背景、选择、影响和实际讨论过的方案，供后续维护者复查。
SKILL.md 中文导读
可复现示例
虚构项目把三处独立的日期格式逻辑改为公共模块，目的是统一时区转换。团队实际讨论过逐处补丁和公共模块。请写一份关联任务 DATE-17 的 ADR。工作步骤
- 判断是否属于结构性变更。
- 按背景、决定、影响、备选方案起草。
- 核对任务号、已知代价和待验证项。
验收方法
正文列出共用模块带来的维护收益和调用方迁移成本，解释为何放弃逐处补丁，并标记时区测试范围待确认。
GitHub 原文 · 更新日期
适用环境
需要启用了技能创建的 ChatGPT 工作区。这里使用基于 GitHub 原文编写的文本改编。
常见问题
只是移动文件时也要写 ADR 吗？
先检查是否引入了新模式、新依赖或有长期影响的结构选择。单纯改名和移动文件一般用变更说明即可。