ADR 是一个用于编写架构决策记录(Architecture Decision Record)的技能,触发关键词包括 ADR、架构决策、决策纪录等。每次调用只写一份 ADR,不用于批量补写历史决策;功能级技术设计应使用 /tech-spec,任务进度跟踪应使用 /create-request。
工作流程分五阶段:解析功能、计算编号、收集内容、写入 ADR、必要时处理 Superseded 双向链接、最后报告。编号需扫描功能根目录及 archived/ 子目录下的 adr-*.md,取数字最大值加一并补零为三位,须运行 node skills/adr/scripts/next-adr-number.js docs/features/<key>,不可手工计算或按字符串排序。
内容包含标题、Context、Decision、Status(默认 Proposed)、Consequences、Alternatives considered,写入 docs/features/<key>/adr-<NNN>-<title>.md,H1 需含 ADR 字样。若新 ADR 取代旧 ADR,需在同一轮次双向更新两文件的 Status 与链接。
写入前需运行分类守卫,仅传文件名,确认 classifyByPath 返回类型为 adr;若标题含 runbook、checklist 或结尾为 -fp-brief/-tech-brief 会误分类,需用户改写标题,最多重试 3 次。找不到功能、目录不存在或编号冲突时触发人工确认。资料未提供收费、平台或性能相关信息。