jb-adr
jb-adr 是一个用于创建和管理 MADR(Markdown 架构决策记录)的技能,帮助开发者在编码项目中以结构化方式记录重要的设计决策。当用户提到 ADR、MADR、决策记录、架构决策、设计决策、技术决策或记录架构选择时,可触发使用。它提供最小模板与完整模板两种格式,最小模板包含标题、状态、上下文、决策和后果五个部分;完整模板额外包含备选方案、优缺点和相关决策,可通过读取 references/full-template.md 加载。文件命名采用四位数字编号加小写连字符标题,如 0001-use-postgres.md,存放于项目根目录的 docs/adr/ 或 adr/ 目录,并建议从 README 的 ADR 索引链接。最佳实践包括每个决策一份 ADR、面向未来开发者解释原因、记录备选方案优缺点、链接相关 ADR,以及在决策被取代时更新状态。