adr

ADR 技能为软件工程团队提供了一套简洁的命令行接口，用于在开发工作流程中直接记录、追踪与管理架构决策记录 (ADR)。通过捕捉关键技术选择的背景、理由与后续影响，此工具成为维持架构一致性、协助新成员快速上手以及避免重蹈覆辙的核心利器。它专为需要轻量级、版本控制方法来归档设计模式、函数库选择与基础设施变更的开发人员、架构师与技术主管所设计。

• 支持标准化的 ADR 目录结构初始化（支持常见路径如 docs/adr 或 architecture/decisions）。

• 通过一致的模板快速建立新的决策记录，包含情境描述、决策分析与影响评估。

• 内建生命周期管理功能，包含取代过时记录以及追踪决策状态（提案中、已采纳、已弃用、已取代）。

• 强大的搜索功能，可按关键词、标题或决策内容查询既有的架构历史。

• 提供列表与检视指令，让使用者无需离开终端机即可浏览项目的设计演进。

• 使用者需通过 /adr 指令搭配如 new、list 或 search 等动作进行互动。

• ADR 模板可在项目层级进行设定，确保团队成员间的文件质量统一。

• 强烈建议将 ADR 文件纳入 Git 版本控制，以便与源代码同步保存架构变更的历史轨迹。

• 本工具相容于主流 AI 辅助开发环境，包含 Claude Code、Cursor 以及各类基于 CLI 的开发工作流程。

• 输入通常包括新记录的标题或搜索词，输出则为格式化的 Markdown 文件，可作为项目文档与可搜索的知识库使用。