ChatGPT ADR 技能:把架构选择写成决策记录
EnglishChatGPT 安装步骤
- 从固定版本 GitHub 原文下载 pm-execution/skills/adr/SKILL.md。将它作为 adr 的独立文本技能,保留名称、描述及正文。
- 在已启用技能和上传权限的 ChatGPT 工作区,打开「插件 → 技能 → 创建 → 从电脑上传」,选用文件选择器接受的技能包格式。也可在「使用编辑器创建」中录入原名称、描述和文本指令。
- 完成扫描后,确认 adr 出现在已安装列表。在新对话输入 @ 并选择此技能,使用页面的虚构示例检查输出。
中文摘要
用 Nygard ADR 格式记录一项技术或产品选择,保留上下文、被考虑的方案、最终决定和实施后果。适合将会议结论整理成可回查的 Markdown 文件。
SKILL.md 中文导读
可复现示例
虚构库存服务每晚导出约 500 行。方案 A 每次请求即时生成 CSV,预计峰值会拖慢列表。方案 B 每晚生成并缓存文件,允许最多 24 小时延迟。团队选 B。请起草 ADR-012,并明确下一次重新评估的条件。工作步骤
- 给出一项已决定或待决定的问题,说明背景和限制。
- 整理选项,写清选了什么以及带来的正负后果。
- 核对状态、日期和重新评估条件,将确认稿保存到项目的决策记录中。
验收方法
输出应写明选择 B、允许的数据延迟、即时生成的备选方案,以及缓存失败后的处理或待确认项。写清何时需重看决定,例如业务改为要求小时级数据。
GitHub 原文 · 更新日期
适用环境
需要有技能创建权限的合资格 ChatGPT 工作区,选择上传时还需相应权限。这份纯文本移植的安装路径按 OpenAI 文档核对,工作区运行待验证。
常见问题
已经生效的决定能用同一份 ADR 吗?
可以。把状态写为已接受并记录决定日期。若后续选择改变,创建新记录并将旧记录标记为已被替代,保留原先的决策依据。